QtGraphs3D Namespace

Le module QtGraphs3D fournit des énumérations utilisées par l'API 3D de QtGraphs. En savoir plus...

En-tête :	`#include <qgraphs3dnamespace.h>`

CMake :	`find_package(Qt6 REQUIRED COMPONENTS Graphs)` `target_link_libraries(mytarget PRIVATE Qt6::Graphs)`
qmake :	`QT += graphs`

Membres obsolètes
QtGraphs3D fait partie de Qt Graphs Classes C++ pour la 3D.

Types

enum class	CameraPreset { NoPreset, FrontLow, Front, FrontHigh, LeftLow, …, DirectlyBelow }
`(since 6.12)` enum class	DragMode { Rotate, Pan }
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 sur le type

enum class QtGraphs3D::CameraPreset

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

Constante	Valeur	Description
`QtGraphs3D::CameraPreset::NoPreset`	`0`	Utilisée pour indiquer qu'aucun préréglage n'a été défini ou que la scène a été pivotée librement.
`QtGraphs3D::CameraPreset::FrontLow`	`1`	Les rotations x et y de la caméra sont toutes deux égales à 0.
`QtGraphs3D::CameraPreset::Front`	`2`	La rotation X est de 0 et la rotation Y est de 22,5 degrés.
`QtGraphs3D::CameraPreset::FrontHigh`	`3`	La rotation X est de 0 et la rotation Y est de 45 degrés.
`QtGraphs3D::CameraPreset::LeftLow`	`4`	La rotation X est de 90 degrés et la rotation Y est de 0 degré.
`QtGraphs3D::CameraPreset::Left`	`5`	La rotation X est de 90 degrés et la rotation Y de 22,5 degrés.
`QtGraphs3D::CameraPreset::LeftHigh`	`6`	La rotation autour de l'axe X est de 90 degrés et celle autour de l'axe Y est de 45 degrés.
`QtGraphs3D::CameraPreset::RightLow`	`7`	La rotation autour de l'axe X est de -90 degrés et celle autour de l'axe Y est de 0 degré.
`QtGraphs3D::CameraPreset::Right`	`8`	La rotation X est de -90 et la rotation Y est de 22,5 degrés.
`QtGraphs3D::CameraPreset::RightHigh`	`9`	La rotation autour de l'axe X est de -90 degrés et celle autour de l'axe Y est de 45 degrés.
`QtGraphs3D::CameraPreset::BehindLow`	`10`	La rotation autour de l'axe X est de 180 degrés et celle autour de l'axe Y est de 0 degré.
`QtGraphs3D::CameraPreset::Behind`	`11`	La rotation autour de l'axe X est de 180 degrés et celle autour de l'axe Y est de 22,5 degrés.
`QtGraphs3D::CameraPreset::BehindHigh`	`12`	La rotation autour de l'axe X est de 180 degrés et celle autour de l'axe Y est de 45 degrés.
`QtGraphs3D::CameraPreset::IsometricLeft`	`13`	La rotation autour de l'axe X est de 45 degrés et celle autour de l'axe Y est de 22,5 degrés.
`QtGraphs3D::CameraPreset::IsometricLeftHigh`	`14`	La rotation autour de l'axe X est de 45 degrés et celle autour de l'axe Y est de 45 degrés.
`QtGraphs3D::CameraPreset::IsometricRight`	`15`	La rotation autour de l'axe X est de -45 degrés et celle autour de l'axe Y est de 22,5 degrés.
`QtGraphs3D::CameraPreset::IsometricRightHigh`	`16`	La rotation autour de l'axe X est de -45 degrés et celle autour de l'axe Y est de 45 degrés.
`QtGraphs3D::CameraPreset::DirectlyAbove`	`17`	La rotation autour de l'axe X est de 0 degré et celle autour de l'axe Y est de 90 degrés.
`QtGraphs3D::CameraPreset::DirectlyAboveCW45`	`18`	La rotation autour de l'axe X est de -45 degrés et celle autour de l'axe Y est de 90 degrés.
`QtGraphs3D::CameraPreset::DirectlyAboveCCW45`	`19`	La rotation X est de 45 degrés et la rotation Y est de 90 degrés.
`QtGraphs3D::CameraPreset::FrontBelow`	`20`	La rotation X est de 0 et la rotation Y est de -45 degrés. Dans Q3DBarsWidgetItem, à partir de la section « FrontBelow », ces paramètres ne fonctionnent que pour les graphiques comportant des valeurs négatives. Pour les valeurs strictement positives, ils agissent comme « CameraPreset...Low ».
`QtGraphs3D::CameraPreset::LeftBelow`	`21`	La rotation X est de 90 degrés et la rotation Y est de -45 degrés.
`QtGraphs3D::CameraPreset::RightBelow`	`22`	La rotation X est de -90 degrés et la rotation Y de -45 degrés.
`QtGraphs3D::CameraPreset::BehindBelow`	`23`	La rotation X est de 180 degrés et la rotation Y est de -45 degrés.
`QtGraphs3D::CameraPreset::DirectlyBelow`	`24`	La rotation X est de 0 et la rotation Y de -90 degrés. Se comporte comme « FrontLow » pour les barres ne comportant que des valeurs positives.

`[since 6.12]` enum class QtGraphs3D::DragMode

Détermine la manière dont les événements de glissement à la souris ou au toucher sur le graphique sont interprétés.

Constante	Valeur	Description
`QtGraphs3D::DragMode::Rotate`	`0`	Le glissement fait pivoter le graphique.
`QtGraphs3D::DragMode::Pan`	`1`	Le glissement permet de faire défiler le graphique.

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

enum class QtGraphs3D::ElementType

Type d'un élément du graphe.

Constante	Valeur	Description
`QtGraphs3D::ElementType::None`	`0`	Élément non défini.
`QtGraphs3D::ElementType::Series`	`1`	Un élément d'une série.
`QtGraphs3D::ElementType::AxisXLabel`	`2`	L'étiquette de l'axe des x.
`QtGraphs3D::ElementType::AxisYLabel`	`3`	L'étiquette de l'axe des y.
`QtGraphs3D::ElementType::AxisZLabel`	`4`	L'étiquette de l'axe z.
`QtGraphs3D::ElementType::CustomItem`	`5`	Un élément personnalisé.

enum class QtGraphs3D::GridLineType

Constante	Valeur	Description
`QtGraphs3D::GridLineType::Shader`	`0`	Les lignes de la grille sont rendues par le GPU dans un shader.
`QtGraphs3D::GridLineType::Geometry`	`1`	Les lignes de la grille sont rendues à l'aide de modèles 3D.

enum class QtGraphs3D::OptimizationHint

Conseil d'optimisation pour le rendu.

Constante	Valeur	Description
`QtGraphs3D::OptimizationHint::Default`	`0`	Offre l'ensemble complet des fonctionnalités avec l'instanciation, tout en garantissant de bonnes performances.
`QtGraphs3D::OptimizationHint::Legacy`	`1`	Offre l'ensemble complet des fonctionnalités avec des performances raisonnables. À utiliser si OptimizationHint.Default présente de mauvaises performances ou ne fonctionne pas.

enum class QtGraphs3D::RenderingMode

Constante	Valeur	Description
`QtGraphs3D::RenderingMode::DirectToBackground`	`0`	Indique que le graphique sera affiché directement sur l’arrière-plan de la fenêtre et que les éléments QML seront affichés par-dessus. L’utilisation d’un élément QML non transparent comme arrière-plan masquera le graphique. Efface l’intégralité de la fenêtre avant d’afficher le graphique, y compris les zones situées en dehors de celui-ci. 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 QML non standard. Par exemple, les graphiques ne respectent pas l’ordre de superposition (z-order) des éléments QML et la valeur d’opacité n’a aucun effet sur eux.
`QtGraphs3D::RenderingMode::Indirect`	`1`	Indique que le graphique sera d’abord rendu sur une surface hors écran, qui sera ensuite dessinée lors du rendu normal des éléments QML. L’image rendue est lissée à l’aide de la méthode de multisampling si celle-ci 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 à l'aide de l'opérateur « OU ».

Constante	Valeur	Description
`QtGraphs3D::SelectionFlag::None`	`0x00`	Mode de sélection désactivé.
`QtGraphs3D::SelectionFlag::Item`	`0x01`	La sélection met en surbrillance un seul élément.
`QtGraphs3D::SelectionFlag::Row`	`0x02`	La sélection met en surbrillance une seule ligne.
`QtGraphs3D::SelectionFlag::ItemAndRow`	`Item \| Row`	Indicateur combiné permettant de mettre en surbrillance à la fois l’élément et la ligne avec des couleurs différentes.
`QtGraphs3D::SelectionFlag::Column`	`0x04`	La sélection met en surbrillance une seule colonne.
`QtGraphs3D::SelectionFlag::ItemAndColumn`	`Item \| Column`	Indicateur de combinaison permettant de surligner à la fois l'élément et la colonne avec des couleurs différentes.
`QtGraphs3D::SelectionFlag::RowAndColumn`	`Row \| Column`	Indicateur de combinaison permettant de mettre en surbrillance à la fois la ligne et la colonne.
`QtGraphs3D::SelectionFlag::ItemRowAndColumn`	`Item \| Row \| Column`	Indicateur de combinaison permettant de mettre en surbrillance l'élément, la ligne et la colonne.
`QtGraphs3D::SelectionFlag::Slice`	`0x08`	L'activation de cet indicateur de mode indique que le graphique doit gérer automatiquement l'affichage des tranches. Si vous souhaitez contrôler vous-même la vue par tranches via Q3DScene, ne définissez pas cet indicateur. Lorsque vous définissez cet indicateur de mode, vous devez également définir soit `Row`, soit `Column`, mais pas les deux. Le découpage en tranches est pris en charge uniquement par Q3DBarsWidgetItem et Q3DSurfaceWidgetItem. Lorsque cet indicateur est défini, le mode de découpage en tranches est activé dans les situations suivantes : Lorsque la sélection est modifiée explicitement via l'API des séries pour choisir 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::MultiSeries`	`0x10`	L’activation de ce mode signifie que les éléments de toutes les séries situés à la même position sont mis en surbrillance, et non plus uniquement l’élément sélectionné. La sélection effective dans les autres séries ne change pas. Lors de l’activation de cet indicateur de mode, un ou plusieurs des 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 OR de valeurs SelectionFlag.

enum class QtGraphs3D::ShadowQuality

Qualité des ombres.

Constante	Valeur	Description
`QtGraphs3D::ShadowQuality::None`	`0`	Les ombres sont désactivées.
`QtGraphs3D::ShadowQuality::Low`	`1`	Les ombres sont rendues en basse qualité.
`QtGraphs3D::ShadowQuality::Medium`	`2`	Les ombres sont rendues en qualité moyenne.
`QtGraphs3D::ShadowQuality::High`	`3`	Les ombres sont rendues en haute qualité.
`QtGraphs3D::ShadowQuality::SoftLow`	`4`	Les ombres sont rendues en basse qualité avec des contours adoucis.
`QtGraphs3D::ShadowQuality::SoftMedium`	`5`	Les ombres sont rendues en qualité moyenne avec des contours adoucis.
`QtGraphs3D::ShadowQuality::SoftHigh`	`6`	Les ombres sont rendues en haute qualité avec des contours adoucis.

`[since 6.10]` enum class QtGraphs3D::SliceCaptureType

Type de tranche à extraire d'une image.

Constante	Valeur	Description
`QtGraphs3D::SliceCaptureType::NoImage`	`0`	Le type de tranche à capturer n'est pas défini.
`QtGraphs3D::SliceCaptureType::RowImage`	`1`	Capturer une tranche pour les lignes.
`QtGraphs3D::SliceCaptureType::ColumnImage`	`2`	Capturer une 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 graphes à surfaces transparentes, utilisez « Approximate » ou « Accurate ». Utilisez « Default » pour les autres types de graphes.

Constante	Valeur	Description
`QtGraphs3D::TransparencyTechnique::Default`	`0`	Indique 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 lorsque `optimizationHint` est défini sur `{QtGraphs3D::OptimizationHint::Default}`.
`QtGraphs3D::TransparencyTechnique::Approximate`	`1`	Indique 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 en termes de performances doit être inférieur à celui de l’utilisation d’une transparence indépendante de l’ordre précise.
`QtGraphs3D::TransparencyTechnique::Accurate`	`2`	Indique qu’une transparence indépendante de l’ordre précise est utilisée. À utiliser lorsqu’un rendu de transparence parfait 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.