Sur cette page

QtGraphs3D Namespace

Le module QtGraphs3D fournit des enums utilisés par QtGraphs' 3D API. Plus d'informations...

En-tête : #include <QtGraphs3D>
CMake : find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake : QT += graphs

Types

enum class CameraPreset { NoPreset, FrontLow, Front, FrontHigh, LeftLow, …, DirectlyBelow }
enum class ElementType { None, Series, AxisXLabel, AxisYLabel, AxisZLabel, CustomItem }
enum class GridLineType { Shader, Geometry }
enum class OptimizationHint { Default, Legacy }
enum class RenderingMode { DirectToBackground, Indirect }
enum class SelectionFlag { None, Item, Row, ItemAndRow, Column, …, MultiSeries }
flags SelectionFlags
enum class ShadowQuality { None, Low, Medium, High, SoftLow, …, SoftHigh }
(since 6.10) enum class SliceCaptureType { NoImage, RowImage, ColumnImage }
(since 6.9) enum class TransparencyTechnique { Default, Approximate, Accurate }

Description détaillée

Documentation des types

enum class QtGraphs3D::CameraPreset

Positions prédéfinies pour la caméra.

ConstanteValeurDescription
QtGraphs3D::CameraPreset::NoPreset0Utilisée pour indiquer qu'un préréglage n'a pas été défini ou que la scène a été tournée librement.
QtGraphs3D::CameraPreset::FrontLow1Les rotations x et y de la caméra sont toutes deux égales à 0.
QtGraphs3D::CameraPreset::Front2La rotation X est de 0 et la rotation y est de 22,5 degrés.
QtGraphs3D::CameraPreset::FrontHigh3La rotation X est de 0 et la rotation y est de 45 degrés.
QtGraphs3D::CameraPreset::LeftLow4La rotation X est de 90 et la rotation y est de 0 degré.
QtGraphs3D::CameraPreset::Left5La rotation X est de 90 et la rotation y est de 22,5 degrés.
QtGraphs3D::CameraPreset::LeftHigh6La rotation des X est de 90 et la rotation des y est de 45 degrés.
QtGraphs3D::CameraPreset::RightLow7La rotation des X est de -90 et la rotation des y est de 0 degré.
QtGraphs3D::CameraPreset::Right8La rotation des X est de -90 et la rotation des y est de 22,5 degrés.
QtGraphs3D::CameraPreset::RightHigh9La rotation des X est de -90 et la rotation des y est de 45 degrés.
QtGraphs3D::CameraPreset::BehindLow10La rotation X est de 180 et la rotation y est de 0 degré.
QtGraphs3D::CameraPreset::Behind11La rotation X est de 180 et la rotation y est de 22,5 degrés.
QtGraphs3D::CameraPreset::BehindHigh12La rotation X est de 180 et la rotation y est de 45 degrés.
QtGraphs3D::CameraPreset::IsometricLeft13La rotation X est de 45 et la rotation y est de 22,5 degrés.
QtGraphs3D::CameraPreset::IsometricLeftHigh14La rotation X est de 45 et la rotation y est de 45 degrés.
QtGraphs3D::CameraPreset::IsometricRight15La rotation X est de -45 et la rotation y est de 22,5 degrés.
QtGraphs3D::CameraPreset::IsometricRightHigh16La rotation des X est de -45 et la rotation des y est de 45 degrés.
QtGraphs3D::CameraPreset::DirectlyAbove17La rotation des X est de 0 et la rotation des y est de 90 degrés.
QtGraphs3D::CameraPreset::DirectlyAboveCW4518La rotation X est de -45 et la rotation y est de 90 degrés.
QtGraphs3D::CameraPreset::DirectlyAboveCCW4519La rotation X est de 45 et la rotation y est de 90 degrés.
QtGraphs3D::CameraPreset::FrontBelow20La rotation des X est de 0 et la rotation des y est de -45 degrés. Dans Q3DBarsWidgetItem à partir de FrontBelow, elles ne fonctionnent que pour les graphiques comportant des valeurs négatives. Ils agissent comme CameraPreset...Low pour les valeurs positives uniquement.
QtGraphs3D::CameraPreset::LeftBelow21La rotation X est de 90 degrés et la rotation y est de -45 degrés.
QtGraphs3D::CameraPreset::RightBelow22La rotation X est de -90 et la rotation y est de -45 degrés.
QtGraphs3D::CameraPreset::BehindBelow23La rotation X est de 180 et la rotation y est de -45 degrés.
QtGraphs3D::CameraPreset::DirectlyBelow24La rotation des X est de 0 et la rotation des y est de -90 degrés. Agit comme FrontLow pour les barres positives uniquement.

enum class QtGraphs3D::ElementType

Type d'élément dans le graphique.

ConstanteValeurDescription de l'élément
QtGraphs3D::ElementType::None0Aucun élément défini.
QtGraphs3D::ElementType::Series1Un élément d'une série.
QtGraphs3D::ElementType::AxisXLabel2L'étiquette de l'axe des x.
QtGraphs3D::ElementType::AxisYLabel3L'étiquette de l'axe des y.
QtGraphs3D::ElementType::AxisZLabel4L'étiquette de l'axe des z.
QtGraphs3D::ElementType::CustomItem5Un élément personnalisé.

enum class QtGraphs3D::GridLineType

ConstanteValeurDescription
QtGraphs3D::GridLineType::Shader0Les lignes de la grille sont rendues par le GPU dans un shader.
QtGraphs3D::GridLineType::Geometry1Les lignes de la grille sont rendues avec les modèles 3D.

enum class QtGraphs3D::OptimizationHint

L'indice d'optimisation pour le rendu.

ConstanteValeurDescription
QtGraphs3D::OptimizationHint::Default0Fournit l'ensemble des fonctionnalités avec l'instanciation à un bon niveau de performance.
QtGraphs3D::OptimizationHint::Legacy1Fournit l'ensemble des fonctionnalités avec des performances raisonnables. À utiliser si OptimizationHint.Default est peu performant ou ne fonctionne pas.

enum class QtGraphs3D::RenderingMode

ConstanteValeurDescription
QtGraphs3D::RenderingMode::DirectToBackground0Indique que le graphique sera rendu directement sur l'arrière-plan de la fenêtre et que les éléments QML seront rendus par-dessus. L'utilisation d'un élément QML non transparent comme arrière-plan masquera le graphique. Efface toute la fenêtre avant de rendre le graphique, y compris les zones situées à l'extérieur du graphique. Si le format de surface de la fenêtre prend en charge l'anticrénelage, celui-ci sera utilisé (voir QQuick3D::idealSurfaceFormat()). Ce mode de rendu offre les meilleures performances au prix d'un comportement non standard de QML. Par exemple, les graphiques n'obéissent pas à l'ordre z des éléments QML et la valeur d'opacité n'a aucun effet sur eux.
QtGraphs3D::RenderingMode::Indirect1Indique que le graphique sera d'abord rendu sur une surface hors écran qui sera ensuite dessinée pendant le rendu normal des éléments QML. L'image rendue est anticrénelée à l'aide de la méthode de multi-échantillonnage si elle est prise en charge dans l'environnement actuel et si la valeur de la propriété msaaSamples est supérieure à zéro. Ce mode de rendu offre une bonne qualité et un comportement normal des éléments QML au détriment des performances.

enum class QtGraphs3D::SelectionFlag
flags QtGraphs3D::SelectionFlags

Modes de sélection des éléments. Les valeurs de cette énumération peuvent être combinées avec l'opérateur OR.

ConstanteValeurDescription
QtGraphs3D::SelectionFlag::None0x00Mode de sélection désactivé.
QtGraphs3D::SelectionFlag::Item0x01La sélection met en évidence un seul élément.
QtGraphs3D::SelectionFlag::Row0x02La sélection met en évidence une seule ligne.
QtGraphs3D::SelectionFlag::ItemAndRowItem | RowIndicateur de combinaison pour mettre en évidence à la fois l'élément et la ligne avec des couleurs différentes.
QtGraphs3D::SelectionFlag::Column0x04La sélection met en évidence une seule colonne.
QtGraphs3D::SelectionFlag::ItemAndColumnItem | ColumnIndicateur de combinaison pour la mise en évidence d'un élément et d'une colonne avec des couleurs différentes.
QtGraphs3D::SelectionFlag::RowAndColumnRow | ColumnIndicateur de combinaison pour la mise en évidence d'une ligne et d'une colonne.
QtGraphs3D::SelectionFlag::ItemRowAndColumnItem | Row | ColumnIndicateur de combinaison pour la mise en évidence de l'élément, de la ligne et de la colonne.
QtGraphs3D::SelectionFlag::Slice0x08L'activation de cet indicateur de mode signifie que le graphique doit s'occuper automatiquement de la gestion de la vue en coupe. Si vous souhaitez contrôler vous-même l'affichage des tranches via Q3DScene, ne définissez pas cet indicateur. Lorsque vous définissez cet indicateur de mode, vous devez également définir Row ou Column, mais pas les deux. Le découpage en tranches n'est pris en charge que par Q3DBarsWidgetItem et Q3DSurfaceWidgetItem. Lorsque cet indicateur est activé, le mode tranche est activé dans les situations suivantes :
  • Lorsque la sélection est modifiée explicitement via l'API des séries vers un élément visible
  • Lorsque la sélection est modifiée en cliquant sur le graphique
  • Lorsque le mode de sélection change et que l'élément sélectionné est visible
QtGraphs3D::SelectionFlag::MultiSeries0x10L'activation de ce mode signifie que les éléments de toutes les séries à la même position sont mis en évidence, au lieu de l'élément sélectionné uniquement. La sélection actuelle dans les autres séries ne change pas. Lorsque ce mode est activé, un ou plusieurs indicateurs de sélection de base (Item, Row, ou Column) doivent également être activés. La sélection multi-séries n'est pas prise en charge pour Q3DScatterWidgetItem.

Le type SelectionFlags est un typedef pour QFlags<SelectionFlag>. Il stocke une combinaison OU de valeurs SelectionFlag.

enum class QtGraphs3D::ShadowQuality

Qualité des ombres.

ConstanteValeurDescription
QtGraphs3D::ShadowQuality::None0Les ombres sont désactivées.
QtGraphs3D::ShadowQuality::Low1Les ombres sont rendues en basse qualité.
QtGraphs3D::ShadowQuality::Medium2Les ombres sont rendues en qualité moyenne.
QtGraphs3D::ShadowQuality::High3Les ombres sont rendues en haute qualité.
QtGraphs3D::ShadowQuality::SoftLow4Les ombres sont rendues en basse qualité avec des bords adoucis.
QtGraphs3D::ShadowQuality::SoftMedium5Les ombres sont rendues en qualité moyenne avec des bords adoucis.
QtGraphs3D::ShadowQuality::SoftHigh6Les ombres sont rendues en haute qualité avec des bords adoucis.

[since 6.10] enum class QtGraphs3D::SliceCaptureType

Type de tranche à saisir dans une image.

ConstanteValeurDescription
QtGraphs3D::SliceCaptureType::NoImage0Le type de tranche à capturer n'est pas défini.
QtGraphs3D::SliceCaptureType::RowImage1Capture de la tranche pour les lignes.
QtGraphs3D::SliceCaptureType::ColumnImage2Capture de la tranche pour les colonnes.

Cette énumération a été introduite dans Qt 6.10.

[since 6.9] enum class QtGraphs3D::TransparencyTechnique

Spécifie la technique de transparence à utiliser. La valeur par défaut est Default. Lors du rendu de graphiques à surface transparente, utilisez Approximate ou Accurate. Default doit être utilisé pour les autres types de graphiques.

ConstanteValeurDescription
QtGraphs3D::TransparencyTechnique::Default0Indique que les techniques de transparence indépendantes de l'ordre ne sont pas utilisées. Offre les meilleures performances. À utiliser lorsque les graphiques ne contiennent pas de transparence ou lorsqu'un graphique à barres ou à nuages de points utilise également l'instanciation, c'est-à-dire que optimizationHint is {QtGraphs3D::OptimizationHint::Default}.
QtGraphs3D::TransparencyTechnique::Approximate1Indique qu'un graphique tente une approximation de la transparence indépendante de l'ordre. Cette méthode est plus rapide que Accurate et fonctionne sur du matériel plus ancien, mais peut donner des résultats imprécis. À utiliser lorsque la transparence indépendante de l'ordre est nécessaire, mais que le coût des performances doit être inférieur à celui de la transparence indépendante de l'ordre exacte.
QtGraphs3D::TransparencyTechnique::Accurate2Indique que la transparence précise indépendante de l'ordre est utilisée. À utiliser lorsqu'un rendu parfait de la transparence est nécessaire.

Cette énumération a été introduite dans Qt 6.9.

© 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.