AbstractGraph3D QML Type
Type de base pour les visualisations 3D. En savoir plus...
| Import Statement: | import QtDataVisualization 1.12 |
| Since: | QtDataVisualization 1.0 |
| Inherited By: | |
| Status: | Deprecated |
Ce type est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.
Propriétés
- aspectRatio : real
(since QtDataVisualization 1.1) - currentFps : int
(since QtDataVisualization 1.1) - customItemList : list<Custom3DItem>
(since QtDataVisualization 1.1) - horizontalAspectRatio : real
(since QtDataVisualization 1.2) - inputHandler : AbstractInputHandler3D
- locale : locale
(since QtDataVisualization 1.2) - margin : real
(since QtDataVisualization 1.2) - measureFps : bool
(since QtDataVisualization 1.1) - msaaSamples : int
- optimizationHints : AbstractGraph3D.OptimizationHints
(since QtDataVisualization 1.1) - orthoProjection : bool
(since QtDataVisualization 1.1) - polar : bool
(since QtDataVisualization 1.2) - queriedGraphPosition : vector3d
(since QtDataVisualization 1.2) - radialLabelOffset : real
(since QtDataVisualization 1.2) - reflection : bool
(since QtDataVisualization 1.2) - reflectivity : real
(since QtDataVisualization 1.2) - scene : Scene3D
- selectedElement : AbstractGraph3D.ElementType
(since QtDataVisualization 1.1) - selectionMode : AbstractGraph3D.SelectionMode
- shadowQuality : AbstractGraph3D.ShadowQuality
- shadowsSupported : bool
- theme : Theme3D
Méthodes
- int addCustomItem(Custom3DItem item)
(since QtDataVisualization 1.1) - void clearSelection()
- bool hasSeries(Abstract3DSeries series)
(since 6.3) - void releaseCustomItem(Custom3DItem item)
(since QtDataVisualization 1.1) - void removeCustomItem(Custom3DItem item)
(since QtDataVisualization 1.1) - void removeCustomItemAt(vector3d position)
(since QtDataVisualization 1.1) - void removeCustomItems()
(since QtDataVisualization 1.1) - Abstract3DAxis selectedAxis()
(since QtDataVisualization 1.1) - Custom3DItem selectedCustomItem()
(since QtDataVisualization 1.1) - int selectedCustomItemIndex()
(since QtDataVisualization 1.1) - int selectedLabelIndex()
(since QtDataVisualization 1.1)
Description détaillée
Type de base pour toutes les visualisations 3D dans QtDataVisualization.
Ce type ne peut pas être créé, mais il contient des propriétés communes à toutes les visualisations 3D.
Voir également Bars3D, Scatter3D, Surface3D et Qt Data Visualization C++ Classes.
Documentation sur les propriétés
aspectRatio : real [since QtDataVisualization 1.1]
Rapport d'échelle du graphique entre l'axe le plus long sur le plan horizontal et l'axe des y. La valeur par défaut est 2.0.
Remarque : n'a aucun effet sur Bars3D.
Cette propriété a été introduite dans QtDataVisualization 1.1.
Voir également horizontalAspectRatio.
currentFps : int [since QtDataVisualization 1.1]
Lorsque la mesure du FPS est activée, les résultats de la dernière seconde sont enregistrés dans cette propriété en lecture seule. Il faut au moins une seconde avant que cette valeur ne soit mise à jour après l'activation de la mesure.
Cette propriété a été introduite dans QtDataVisualization 1.1.
Voir également measureFps.
customItemList : list<Custom3DItem> [since QtDataVisualization 1.1]
Liste des éléments de type « Custom3DItem » ajoutés au graphique. Le graphique prend en charge les éléments ajoutés.
Cette propriété a été introduite dans QtDataVisualization 1.1.
horizontalAspectRatio : real [since QtDataVisualization 1.2]
Rapport d'échelle du graphique entre l'axe x et l'axe z. La valeur « 0.0 » indique une mise à l'échelle automatique en fonction des plages des axes. La valeur par défaut est « 0.0 ».
Remarque : n'a aucun effet sur Bars3D, qui gère la mise à l'échelle sur le plan horizontal via les propriétés barThickness et barSpacing. Les graphiques polaires ignorent également cette propriété.
Cette propriété a été introduite dans QtDataVisualization 1.2.
Voir également aspectRatio, polar, Bars3D::barThickness et Bars3D::barSpacing.
inputHandler : AbstractInputHandler3D
Le gestionnaire d'entrée actif utilisé dans le graphe. Vous pouvez désactiver les gestionnaires d'entrée par défaut en définissant cette propriété sur null.
locale : locale [since QtDataVisualization 1.2]
Définit les paramètres régionaux utilisés pour le formatage des différentes étiquettes numériques. La valeur par défaut est la locale « "C" ».
Cette propriété a été introduite dans QtDataVisualization 1.2.
Voir également ValueAxis3D::labelFormat.
margin : real [since QtDataVisualization 1.2]
Valeur absolue définissant l'espace laissé entre le bord de la zone de tracé du graphique et le bord de l'arrière-plan du graphique.
Si la valeur de la marge est négative, les marges sont déterminées automatiquement et peuvent varier en fonction de la taille des éléments de la série et du type de graphique. La valeur est interprétée comme une fraction de la plage de l'axe des y si les proportions du graphique n'ont pas été modifiées par rapport aux valeurs par défaut. La valeur par défaut est -1.0.
Remarque : le fait de définir une marge inférieure à celle déterminée automatiquement pour un graphique de nuages de points peut entraîner un chevauchement des éléments situés aux bords du graphique avec l’arrière-plan de celui-ci.
Remarque : sur les graphiques de nuages de points et de surface, si la marge est petite par rapport à la taille des étiquettes d’axe, les positions des étiquettes situées aux bords des axes sont ajustées pour éviter tout chevauchement avec les étiquettes des axes voisins.
Cette propriété a été introduite dans QtDataVisualization 1.2.
measureFps : bool [since QtDataVisualization 1.1]
Si true, le rendu s'effectue en continu plutôt qu'à la demande, et la valeur de la propriété currentFps est mise à jour. La valeur par défaut est false.
Cette propriété a été introduite dans QtDataVisualization 1.1.
Voir également currentFps.
msaaSamples : int
Nombre d'échantillons utilisés dans l'anticrénelage multi-échantillons lorsque renderingMode est défini sur « RenderIndirect ». Lorsque renderingMode est défini sur « RenderDirectToBackground » ou « RenderDirectToBackground_NoClear », la valeur de cette propriété est en lecture seule et renvoie le nombre d'échantillons spécifié par le format de surface de la fenêtre. La valeur par défaut est « 4 ».
Voir également renderingMode.
optimizationHints : AbstractGraph3D.OptimizationHints [since QtDataVisualization 1.1]
Indique si le mode par défaut ou le mode statique est utilisé pour l'optimisation du rendu.
Le mode par défaut offre l’ensemble complet des fonctionnalités avec un niveau de performances raisonnable. Le mode statique optimise le rendu des graphiques et est idéal pour les grands ensembles de données immuables. Il est plus lent en cas de modifications dynamiques des données et de rotations d’éléments. La sélection n’étant pas optimisée, il n’est pas recommandé d’utiliser le mode statique avec des ensembles de données volumineux. L'optimisation statique ne fonctionne que sur les graphiques de dispersion. La valeur par défaut est « OptimizationDefault ».
Remarque : dans certains environnements, les graphiques volumineux utilisant l’optimisation statique peuvent ne pas s’afficher, car tous les éléments sont rendus à l’aide d’un seul appel de dessin, et les différents pilotes graphiques prennent en charge un nombre maximal de sommets différent par appel. Ce problème se pose principalement sur les plateformes 32 bits et OpenGL ES2. Pour contourner ce problème, choisissez un maillage d’éléments avec un faible nombre de sommets ou utilisez le maillage de points.
Cette propriété a été introduite dans QtDataVisualization 1.1.
Voir également Abstract3DSeries::mesh et QAbstract3DGraph::OptimizationHint.
orthoProjection : bool [since QtDataVisualization 1.1]
Si la valeur est définie sur « true », la projection orthographique sera utilisée pour l'affichage du graphique. La valeur par défaut est « false ».
Remarque : les ombres seront désactivées lorsque la valeur est définie sur true.
Cette propriété a été introduite dans QtDataVisualization 1.1.
polar : bool [since QtDataVisualization 1.2]
Si true, les axes horizontaux sont remplacés par des axes polaires. L'axe x devient l'axe angulaire et l'axe z devient l'axe radial. Le mode polaire n'est pas disponible pour les graphiques à barres.
La valeur par défaut est « false ».
Cette propriété a été introduite dans QtDataVisualization 1.2.
Voir également orthoProjection et radialLabelOffset.
queriedGraphPosition : vector3d [since QtDataVisualization 1.2]
Cette propriété en lecture seule contient les dernières valeurs de position du graphique le long de chaque axe, interrogées à l'aide de ` Scene3D::graphPositionQuery`. Les valeurs sont normalisées pour s'inscrire dans l'intervalle [-1, 1]. Si la position interrogée se trouve en dehors des limites du graphique, les valeurs ne refléteront pas la position réelle, mais correspondront plutôt à une position indéfinie située en dehors de l'intervalle [-1, 1]. La valeur restera indéfinie jusqu'à ce qu'une requête soit effectuée.
Il n’existe pas de coordonnée 3D unique et correcte correspondant à une position particulière à l’écran ; par souci de cohérence, les requêtes sont donc toujours effectuées par rapport aux côtés intérieurs d’un rectangle invisible entourant le graphique.
Remarque : les graphiquesà barres ne permettent d’interroger la position du graphique qu’au niveau de la base du graphique ; par conséquent, la valeur y est toujours nulle pour les graphiques à barres et les requêtes valides ne peuvent être effectuées qu’à des positions à l’écran qui contiennent la base du graphique.
Cette propriété a été introduite dans QtDataVisualization 1.2.
Voir également Scene3D::graphPositionQuery.
radialLabelOffset : real [since QtDataVisualization 1.2]
Cette propriété spécifie le décalage horizontal normalisé des étiquettes de l'axe polaire radial. La valeur 0.0 indique que les étiquettes doivent être dessinées à côté de la ligne de grille angulaire correspondant à l'angle 0. La valeur 1.0 indique que les étiquettes sont dessinées à leur emplacement habituel, au bord de l'arrière-plan du graphique. Cette propriété est ignorée si la valeur de la propriété `polar` est false. La valeur par défaut est 1.0.
Cette propriété a été introduite dans QtDataVisualization 1.2.
Voir également polar.
reflection : bool [since QtDataVisualization 1.2]
Active ou désactive les reflets au sol. La valeur par défaut est « false ».
Remarque : n'affecte que Bars3D. Cependant, dans les graphiques Bars3D contenant à la fois des valeurs positives et négatives, les reflets ne sont pas pris en charge pour les éléments personnalisés qui coupent le plan du sol. Dans ce cas, les reflets doivent être désactivés pour éviter un rendu incorrect.
Cette propriété a été introduite dans QtDataVisualization 1.2.
Voir également reflectivity.
reflectivity : real [since QtDataVisualization 1.2]
Définit la réflectivité du sol. Plus la valeur est élevée, plus le sol est réfléchissant. La plage de valeurs autorisées est comprise entre [0...1]. La valeur par défaut est 0.5.
Remarque : n’affecte que Bars3D.
Cette propriété a été introduite dans QtDataVisualization 1.2.
Voir également reflection.
scene : Scene3D
Le pointeur Scene3D qui permet de manipuler la scène et d'accéder à ses éléments, tels que la caméra active.
Cette propriété est en lecture seule.
selectedElement : AbstractGraph3D.ElementType [since QtDataVisualization 1.1]
L'élément sélectionné dans le graphe.
Cette propriété permet de récupérer le type de l'élément sélectionné. Ce type reste valable jusqu'à ce qu'une nouvelle sélection soit effectuée dans le graphique et que le signal « selectedElementChanged » soit émis.
Ce signal peut être utilisé, par exemple, pour implémenter une gestion personnalisée des entrées, comme le montre l'exemple « Axis Handling ».
Cette propriété a été introduite dans QtDataVisualization 1.1.
Voir également selectedLabelIndex(), selectedAxis(), selectedCustomItemIndex(), selectedCustomItem(), Bars3D::selectedSeries, Scatter3D::selectedSeries, Scene3D::selectionQueryPosition et QAbstract3DGraph::ElementType.
selectionMode : AbstractGraph3D.SelectionMode
Mode de sélection actif dans la visualisation. L'une des valeurs de l'énumération QAbstract3DGraph::SelectionFlag.
Voir également QAbstract3DGraph::SelectionFlag.
shadowQuality : AbstractGraph3D.ShadowQuality
La qualité des ombres. L'une des valeurs de l'énumération QAbstract3DGraph::ShadowQuality.
Voir également QAbstract3DGraph::ShadowQuality.
shadowsSupported : bool
Cette propriété en lecture seule indique si les ombres sont prises en charge dans la configuration actuelle. Les configurations OpenGL ES2 ne prennent pas en charge les ombres.
theme : Theme3D
Thème actif du graphique.
Voir aussi Theme3D.
Documentation sur les méthodes
[since QtDataVisualization 1.1] int addCustomItem(Custom3DItem item)
Ajoute un élément `Custom3DItem` item au graphe. Le graphe prend en charge la gestion de l'élément ajouté.
Renvoie l'index de l'élément ajouté si l'ajout a réussi, -1 si l'on tente d'ajouter un élément nul, et l'index de l'élément si l'on tente d'ajouter un élément déjà présent.
Cette méthode a été introduite dans QtDataVisualization 1.1.
Voir également removeCustomItems(), removeCustomItem() et removeCustomItemAt().
void clearSelection()
Efface la sélection de toutes les séries associées.
[since 6.3] bool hasSeries(Abstract3DSeries series)
Indique si l'series e a déjà été ajouté au graphe.
Cette méthode a été introduite dans Qt 6.3.
[since QtDataVisualization 1.1] void releaseCustomItem(Custom3DItem item)
Récupère la propriété de item et supprime l'item du graphe.
Remarque : si le même élément est rajouté au graphique, le fichier de texture doit être redéfini.
Cette méthode a été introduite dans QtDataVisualization 1.1.
Voir également Custom3DItem::textureFile.
[since QtDataVisualization 1.1] void removeCustomItem(Custom3DItem item)
Supprime l'item personnalisé. Supprime les ressources qui lui sont allouées.
Cette méthode a été introduite dans QtDataVisualization 1.1.
[since QtDataVisualization 1.1] void removeCustomItemAt(vector3d position)
Supprime tous les éléments personnalisés de la section « position ». Supprime les ressources qui leur sont allouées.
Cette méthode a été introduite dans QtDataVisualization 1.1.
[since QtDataVisualization 1.1] void removeCustomItems()
Supprime tous les éléments personnalisés. Efface les ressources qui leur sont allouées.
Cette méthode a été introduite dans QtDataVisualization 1.1.
[since QtDataVisualization 1.1] Abstract3DAxis selectedAxis()
Permet d'obtenir l'axe sélectionné après réception d'un signal « selectedElementChanged » avec n'importe quel type d'étiquette. La sélection reste valable jusqu'au prochain signal « selectedElementChanged ».
Renvoie l'axe sélectionné, ou null.
Cette méthode a été introduite dans QtDataVisualization 1.1.
Voir également selectedElement.
[since QtDataVisualization 1.1] Custom3DItem selectedCustomItem()
Permet d'obtenir l'élément personnalisé sélectionné après la réception d'un signal « selectedElementChanged » de type « ElementCustomItem ». La propriété de l'élément reste celle du graphe. La sélection reste valable jusqu'au prochain signal « selectedElementChanged ».
Renvoie l’élément personnalisé sélectionné, ou null.
Cette méthode a été introduite dans QtDataVisualization 1.1.
Voir également selectedElement.
[since QtDataVisualization 1.1] int selectedCustomItemIndex()
Permet d'interroger l'index de l'élément personnalisé sélectionné après la réception d'un signal « selectedElementChanged » de type « ElementCustomItem ». La sélection reste valide jusqu'au prochain signal « selectedElementChanged ».
Renvoie l’index de l’élément personnalisé sélectionné, ou -1.
Cette méthode a été introduite dans QtDataVisualization 1.1.
Voir également selectedElement.
[since QtDataVisualization 1.1] int selectedLabelIndex()
Permet d'interroger l'index de l'étiquette sélectionnée après réception d'un signal « selectedElementChanged », quel que soit le type d'étiquette. La sélection reste valide jusqu'au prochain signal « selectedElementChanged ».
Renvoie l'index de l'étiquette sélectionnée, ou -1.
Cette méthode a été introduite dans QtDataVisualization 1.1.
Voir également selectedElement.
© 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.
