Graphs3D QML Type

Énumérations de l'espace de noms Graphs3D. En savoir plus...

Import Statement: import QtGraphs

Liste de tous les membres, y compris les membres hérités
Graphs3D fait partie des types QML pour la 3D d'Qt Graphs .

Description détaillée

L'espace de noms Graphs3D fournit les énumérations suivantes utilisées par l'API 3D d'QtGraphs.

Graphs3D.SelectionFlag

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	Description
`None`	Mode de sélection désactivé.
`Item`	La sélection met en surbrillance un seul élément.
`Row`	La sélection met en surbrillance une seule ligne.
`ItemAndRow`	Indicateur combiné permettant de mettre en surbrillance à la fois un élément et une ligne avec des couleurs différentes.
`Column`	La sélection met en surbrillance une seule colonne.
`ItemAndColumn`	Indicateur de combinaison permettant de mettre en surbrillance à la fois l'élément et la colonne avec des couleurs différentes.
`RowAndColumn`	Indicateur de combinaison permettant de mettre en surbrillance à la fois la ligne et la colonne.
`ItemRowAndColumn`	Indicateur de combinaison permettant de mettre en surbrillance l'élément, la ligne et la colonne.
`Slice`	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 Bars3D et Surface3D. 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
`MultiSeries`	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 Scatter3D.

Graphs3D.ShadowQuality

Qualité et douceur des ombres.

Constante	Description
`None`	Les ombres sont désactivées.
`Low`	Les ombres sont rendues avec une qualité faible.
`Medium`	Les ombres sont rendues avec une qualité moyenne.
`High`	Les ombres sont rendues en haute qualité.
`SoftLow`	Les ombres sont rendues en basse qualité avec des contours adoucis.
`SoftMedium`	Les ombres sont rendues en qualité moyenne avec des contours adoucis.
`SoftHigh`	Les ombres sont rendues en haute qualité avec des contours adoucis.

Graphs3D.ElementType

Type d'un élément dans le graphique.

Constante	Description
`None`	Élément non défini.
`Series`	Un élément d'une série.
`AxisXLabel`	L'étiquette de l'axe des x.
`AxisYLabel`	L'étiquette de l'axe y.
`AxisZLabel`	L'étiquette de l'axe z.
`CustomItem`	Un élément personnalisé.

Graphs3D.OptimizationHint

L'indication d'optimisation pour le rendu.

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

Graphs3D.CameraPreset

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

Constante	Description
`NoPreset`	Utilisée pour indiquer qu’aucun préréglage n’a été défini ou que la scène a été pivotée librement.
`FrontLow`	Les rotations x et y de la caméra sont toutes deux égales à 0.
`Front`	La rotation X est de 0 et la rotation Y est de 22,5 degrés.
`FrontHigh`	La rotation X est de 0 et la rotation Y est de 45 degrés.
`LeftLow`	La rotation X est de 90 degrés et la rotation Y est de 0 degré.
`Left`	La rotation X est de 90 et la rotation Y est de 22,5 degrés.
`LeftHigh`	La rotation autour de l'axe X est de 90 degrés et celle autour de l'axe Y est de 45 degrés.
`RightLow`	La rotation autour de l'axe X est de -90 degrés et celle autour de l'axe Y est de 0 degré.
`Right`	La rotation X est de -90 et la rotation Y est de 22,5 degrés.
`RightHigh`	La rotation autour de l'axe X est de -90 degrés et celle autour de l'axe Y est de 45 degrés.
`BehindLow`	La rotation autour de l'axe X est de 180 degrés et celle autour de l'axe Y est de 0 degré.
`Behind`	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.
`BehindHigh`	La rotation autour de l'axe X est de 180 et celle autour de l'axe Y est de 45 degrés.
`IsometricLeft`	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.
`IsometricLeftHigh`	La rotation autour de l'axe X est de 45 degrés et celle autour de l'axe Y est de 45 degrés.
`IsometricRight`	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.
`IsometricRightHigh`	La rotation autour de l'axe X est de -45 degrés et celle autour de l'axe Y est de 45 degrés.
`DirectlyAbove`	La rotation autour de l'axe X est de 0 et celle autour de l'axe Y est de 90 degrés.
`DirectlyAboveCW45`	La rotation autour de l'axe X est de -45 degrés et celle autour de l'axe Y est de 90 degrés.
`DirectlyAboveCCW45`	La rotation X est de 45 degrés et la rotation Y est de 90 degrés.
`FrontBelow`	La rotation X est de 0 et la rotation Y est de -45 degrés. Dans Bars3D, à 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 ».
`LeftBelow`	La rotation X est de 90 degrés et la rotation Y est de -45 degrés.
`RightBelow`	La rotation X est de -90 degrés et la rotation Y de -45 degrés.
`BehindBelow`	La rotation X est de 180 et la rotation Y est de -45 degrés.
`DirectlyBelow`	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.

Graphs3D.GridLineType

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

Graphs3D.RenderingMode

Constante Description

DirectToBackground Indique 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 l’intégralité de la fenêtre avant de rendre 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.

Indirect 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 suréchantillonnage 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.

Constante	Description
`DirectToBackground`	Indique 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 l’intégralité de la fenêtre avant de rendre 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.
`Indirect`	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 suréchantillonnage 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.

Graphs3D.TransparencyTechnique

Constante	Description
`Default`	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 un nuage de points utilise également l’instanciation, c’est-à-dire lorsque `optimizationHint` est défini sur { `QtGraphs3D::OptimizationHint::Default` }.
`Approximate`	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.
`Accurate`	Indique que la transparence indépendante de l’ordre précise est utilisée. À utiliser lorsqu’un rendu de transparence parfait est nécessaire.

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