QSurface3DSeries Class
La classe QSurface3DSeries représente une série de données dans un graphique de surface 3D. Plus d'informations...
| En-tête : | #include <QSurface3DSeries> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS DataVisualization)target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake : | QT += datavisualization |
| Depuis : | QtDataVisualization 1.0 |
| En QML : | Surface3DSeries |
| Hérites : | QAbstract3DSeries |
Types publics
Propriétés
|
|
Fonctions publiques
| QSurface3DSeries(QObject *parent = nullptr) | |
| QSurface3DSeries(QSurfaceDataProxy *dataProxy, QObject *parent = nullptr) | |
| virtual | ~QSurface3DSeries() |
| QSurfaceDataProxy * | dataProxy() const |
| QSurface3DSeries::DrawFlags | drawMode() const |
| bool | isFlatShadingEnabled() const |
| bool | isFlatShadingSupported() const |
| QPoint | selectedPoint() const |
| void | setDataProxy(QSurfaceDataProxy *proxy) |
| void | setDrawMode(QSurface3DSeries::DrawFlags mode) |
| void | setFlatShadingEnabled(bool enabled) |
| void | setSelectedPoint(const QPoint &position) |
| void | setTexture(const QImage &texture) |
| void | setTextureFile(const QString &filename) |
| void | setWireframeColor(const QColor &color) |
| QImage | texture() const |
| QString | textureFile() const |
| QColor | wireframeColor() const |
Signaux
| void | dataProxyChanged(QSurfaceDataProxy *proxy) |
| void | drawModeChanged(QSurface3DSeries::DrawFlags mode) |
| void | flatShadingEnabledChanged(bool enable) |
| void | flatShadingSupportedChanged(bool enable) |
| void | selectedPointChanged(const QPoint &position) |
| void | textureChanged(const QImage &image) |
| void | textureFileChanged(const QString &filename) |
| void | wireframeColorChanged(const QColor &color) |
Membres publics statiques
| QPoint | invalidSelectionPosition() |
Description détaillée
Cette classe gère les éléments visuels spécifiques à la série, ainsi que les données de la série (via un proxy de données).
Si aucun proxy de données n'est défini explicitement pour la série, celle-ci crée un proxy par défaut. La définition d'un autre proxy détruira le proxy existant et toutes les données qui y ont été ajoutées.
Le maillage de l'objet défini via la propriété QAbstract3DSeries::mesh définit la forme du pointeur de sélection dans une série de surfaces.
QSurface3DSeries prend en charge les balises de format suivantes pour QAbstract3DSeries::setItemLabelFormat() :
| @xTitle | Titre de l'axe des x |
| @yTitle | Titre de l'axe des y |
| @zTitle | Titre de l'axe des z |
| @xLabel | Valeur de l'élément formatée selon le format de l'axe des x. Pour plus d'informations, voir QValue3DAxis::setLabelFormat(). |
| @yLabel | Valeur de l'élément formatée selon le format de l'axe des y. Pour plus d'informations, voir QValue3DAxis::setLabelFormat(). |
| @zLabel | Valeur de l'élément formatée en utilisant le format de l'axe des z. Pour plus d'informations, voir QValue3DAxis::setLabelFormat(). |
| @seriesName | Nom de la série |
Par exemple, le nom de la série :
proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f"));
Voir également Qt Data Visualization Data Handling.
Type de membre Documentation
enum QSurface3DSeries::DrawFlag
flags QSurface3DSeries::DrawFlags
Mode de dessin de la surface. Les valeurs de cette énumération peuvent être combinées avec l'opérateur OR.
| Constante | Valeur | Description |
|---|---|---|
QSurface3DSeries::DrawWireframe | 1 | Seule la grille est dessinée. |
QSurface3DSeries::DrawSurface | 2 | Seule la surface est dessinée. |
QSurface3DSeries::DrawSurfaceAndWireframe | DrawWireframe | DrawSurface | La surface et la grille sont toutes deux dessinées. |
Le type DrawFlags est un typedef pour QFlags<DrawFlag>. Il stocke une combinaison OU de valeurs DrawFlag.
Documentation sur les propriétés
dataProxy : QSurfaceDataProxy*
Cette propriété contient le proxy de données actif.
La série assume la propriété de tout proxy qui lui est associé et supprime tout proxy précédemment défini lorsqu'un nouveau proxy est ajouté. Le proxy ne peut pas être nul ou associé à une autre série.
Fonctions d'accès :
| QSurfaceDataProxy * | dataProxy() const |
| void | setDataProxy(QSurfaceDataProxy *proxy) |
Signal de notification :
| void | dataProxyChanged(QSurfaceDataProxy *proxy) |
drawMode : DrawFlags
Le mode de dessin.
Les valeurs possibles sont celles de DrawFlag. L'effacement de tous les drapeaux n'est pas autorisé.
Fonctions d'accès :
| QSurface3DSeries::DrawFlags | drawMode() const |
| void | setDrawMode(QSurface3DSeries::DrawFlags mode) |
Signal de notification :
| void | drawModeChanged(QSurface3DSeries::DrawFlags mode) |
flatShadingEnabled : bool
Cette propriété indique si l'ombrage plat de la surface est activé.
La valeur par défaut est true.
Lorsque cette propriété est désactivée, les normales de la surface sont interpolées, ce qui donne aux bords un aspect arrondi. Lorsqu'elle est activée, les normales sont conservées à l'identique sur un triangle, ce qui rend la couleur du triangle solide. Cela rend les données plus lisibles à partir du modèle.
Remarque : les surfaces ombrées plates nécessitent au moins la version 1.2 de GLSL avec l'extension GL_EXT_gpu_shader4. La valeur de la propriété flatShadingSupported indique si l'ombrage plat est pris en charge au moment de l'exécution.
Fonctions d'accès :
| bool | isFlatShadingEnabled() const |
| void | setFlatShadingEnabled(bool enabled) |
Signal de notification :
| void | flatShadingEnabledChanged(bool enable) |
[read-only] flatShadingSupported : bool
Cette propriété indique si l'ombrage plat des surfaces est pris en charge par le système actuel.
L'ombrage plat des surfaces nécessite au moins la version 1.2 de GLSL avec l'extension GL_EXT_gpu_shader4. Si true, l'ombrage plat des surfaces est pris en charge.
Remarque : cette propriété en lecture seule prend sa valeur correcte après la première passe de rendu. Jusque-là, la valeur est toujours true.
Fonctions d'accès :
| bool | isFlatShadingSupported() const |
Notifier signal :
| void | flatShadingSupportedChanged(bool enable) |
selectedPoint : QPoint
Cette propriété contient le point de la grille de surface qui est sélectionné dans la série.
Fonctions d'accès :
| QPoint | selectedPoint() const |
| void | setSelectedPoint(const QPoint &position) |
Signal de notification :
| void | selectedPointChanged(const QPoint &position) |
texture : QImage
Cette propriété contient la texture de la surface sous forme de QImage.
La définition d'un QImage vide efface la texture.
Fonctions d'accès :
| QImage | texture() const |
| void | setTexture(const QImage &texture) |
Signal de notification :
| void | textureChanged(const QImage &image) |
textureFile : QString
Cette propriété contient la texture de la surface sous forme de fichier.
La définition d'un nom de fichier vide efface la texture.
Fonctions d'accès :
| QString | textureFile() const |
| void | setTextureFile(const QString &filename) |
Signal de notification :
| void | textureFileChanged(const QString &filename) |
[since 6.3] wireframeColor : QColor
Cette propriété définit la couleur de l'image filaire de la surface.
Cette propriété a été introduite dans Qt 6.3.
Fonctions d'accès :
| QColor | wireframeColor() const |
| void | setWireframeColor(const QColor &color) |
Signal Notifier :
| void | wireframeColorChanged(const QColor &color) |
Member Function Documentation
[explicit] QSurface3DSeries::QSurface3DSeries(QObject *parent = nullptr)
Construit une série 3D de surface avec le parent parent.
[explicit] QSurface3DSeries::QSurface3DSeries(QSurfaceDataProxy *dataProxy, QObject *parent = nullptr)
Construit une série 3D de surface avec le proxy de données dataProxy et le parent parent.
[virtual noexcept] QSurface3DSeries::~QSurface3DSeries()
Supprime la série 3D de surface.
[static] QPoint QSurface3DSeries::invalidSelectionPosition()
Renvoie la valeur QPoint indiquant une position de sélection non valide. La propriété selectedPoint permet d'effacer la sélection de cette série.
Voir également QAbstract3DGraph::clearSelection().
void QSurface3DSeries::setSelectedPoint(const QPoint &position)
Sélectionne un point de grille de surface à la position position dans le tableau de données de la série spécifiée par une ligne et une colonne.
Un seul point peut être sélectionné à la fois.
Pour annuler la sélection de cette série, invalidSelectionPosition() est défini comme position. Si cette série est ajoutée à un graphique, celui-ci peut ajuster la sélection en fonction de l'interaction de l'utilisateur ou si elle devient invalide.
La suppression ou l'insertion de lignes dans la série avant la ligne du point sélectionné ajustera la sélection de manière à ce que le même point reste sélectionné.
Remarque : fonction de définition de la propriété selectedPoint.
Voir également selectedPoint() et QAbstract3DGraph::clearSelection().
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
