QSurface3DSeries Class
La classe QSurface3DSeries représente une série de données dans un graphique en surface 3D. En savoir plus...
| 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érite de : | QAbstract3DSeries |
| Statut : | Obsolète |
Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.
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 explicitement défini 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 ainsi que toutes les données qui y ont été ajoutées.
Le maillage d’objet défini via la propriété QAbstract3DSeries::mesh détermine la forme du pointeur de sélection dans une série de surface.
QSurface3DSeries prend en charge les balises de format suivantes pour la fonction QAbstract3DSeries::setItemLabelFormat():
| @xTitle | Titre de l’axe x |
| @yTitle | Titre de l'axe y |
| @zTitle | Titre de l'axe z |
| @xLabel | Valeur de l'élément mise en forme selon le format de l'axe des x. Pour plus d'informations, consultez QValue3DAxis::setLabelFormat(). |
| @yLabel | Valeur de l'élément mise en forme selon le format de l'axe y. Pour plus d'informations, consultez QValue3DAxis::setLabelFormat(). |
| @zLabel | Valeur de l'élément mise en forme selon le format de l'axe z. Pour plus d'informations, consultez QValue3DAxis::setLabelFormat(). |
| @seriesName | Nom de la série |
Par exemple :
proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f"));Voir également la section «Traitement des données »de Qt Data Visualization .
Documentation sur les types de membres
enum QSurface3DSeries::DrawFlag
flags QSurface3DSeries::DrawFlags
Le mode de dessin de la surface. Les valeurs de cette énumération peuvent être combinées à l'aide de l'opérateur OU.
| 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 OR de valeurs DrawFlag.
Documentation de la propriété
dataProxy : QSurfaceDataProxy*
Cette propriété contient le proxy de données actif.
La série prend possession de tout proxy qui lui est attribué et supprime tout proxy précédemment défini lorsqu'un nouveau proxy est ajouté. Le proxy ne peut pas être nul ni attribué à 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. Il n'est pas possible de désactiver tous les indicateurs.
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 surface est activé.
La valeur par défaut est « true ».
Lorsqu’elle est désactivée, les normales de la surface sont interpolées, ce qui donne un aspect arrondi aux arêtes. Lorsqu’elle est activée, les normales restent identiques sur un triangle, ce qui rend la couleur du triangle uniforme. Cela rend les données du modèle plus lisibles.
Remarque : les surfaces à ombrageplat nécessitent au minimum 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 lors 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 le système actuel prend en charge l'ombrage plat des surfaces.
L'ombrage plat des surfaces nécessite au minimum la version 1.2 de GLSL avec l'extension GL_EXT_gpu_shader4. Si la valeur est « true », l'ombrage plat des surfaces est pris en charge.
Remarque : cette propriété en lecture seule prend sa valeur correcte après le premier passage de rendu. Jusque-là, elle est toujours définie sur « true ».
Fonctions d’accès :
| bool | isFlatShadingSupported() const |
Signal de notification :
| void | flatShadingSupportedChanged(bool enable) |
selectedPoint : QPoint
Cette propriété contient le point de la grille de surface 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é stocke la texture de la surface sous la forme d'un objet de type ` QImage`.
Définir une valeur vide pour « QImage » 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é stocke la texture de la surface sous forme de fichier.
Si vous définissez un nom de fichier vide, la texture est effacée.
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 du filaire de la surface.
Cette énumération a été introduite dans Qt 6.3.
Fonctions d'accès :
| QColor | wireframeColor() const |
| void | setWireframeColor(const QColor &color) |
Signal de notification :
| void | wireframeColorChanged(const QColor &color) |
Documentation des fonctions membres
[explicit] QSurface3DSeries::QSurface3DSeries(QObject *parent = nullptr)
Crée une série de surfaces 3D à partir de l'élément parent « parent ».
[explicit] QSurface3DSeries::QSurface3DSeries(QSurfaceDataProxy *dataProxy, QObject *parent = nullptr)
Crée une série de surfaces 3D à partir du proxy de données dataProxy et de la page parent parent.
[virtual noexcept] QSurface3DSeries::~QSurface3DSeries()
Supprime la série de surfaces 3D.
[static] QPoint QSurface3DSeries::invalidSelectionPosition()
Renvoie l'QPoint, qui indique une position de sélection non valide. Cette valeur est attribuée à la propriété selectedPoint afin d'effacer la sélection de cette série.
Voir également QAbstract3DGraph::clearSelection().
void QSurface3DSeries::setSelectedPoint(const QPoint &position)
Sélectionne un point de la grille de surface situé à 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 effacer la sélection de cette série, la fonction ` invalidSelectionPosition()` est définie sur ` position`. Si cette série est ajoutée à un graphique, celui-ci peut ajuster la sélection en fonction des interactions de l'utilisateur ou si celle-ci 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 ce même point reste sélectionné.
Remarque : fonctionde 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.
