Back to Qt.io
Contact Us Blog Download Qt
Sur cette page

AbstractGraph3D QML Type

Type de base pour les visualisations 3D. Plus d'informations...

Import Statement: import QtDataVisualization 1.11
Since: QtDataVisualization 1.0
Inherited By:

Bars3D, Scatter3D, and Surface3D

Propriétés

Méthodes

Description détaillée

Le type de base pour toutes les visualisations 3D dans QtDataVisualization.

Ce type ne peut pas être créé, mais il contient des propriétés qui sont partagées entre les visualisations 3D.

Voir aussi Bars3D, Scatter3D, Surface3D, et Qt Data Visualization C++ Classes.

Documentation sur les propriétés

aspectRatio : real [since QtDataVisualization 1.1]

Le rapport d'échelle du graphique entre l'axe le plus long sur le plan horizontal et l'axe des ordonnées. La valeur par défaut est 2.0.

Note : N'a pas d'effet sur Bars3D.

Cette propriété a été introduite dans QtDataVisualization 1.1.

Voir aussi horizontalAspectRatio.

currentFps : int [since QtDataVisualization 1.1]

Lorsque la mesure du FPS est activée, les résultats de la dernière seconde sont stockés dans cette propriété en lecture seule. Il faut au moins une seconde pour que cette valeur soit mise à jour après l'activation de la mesure.

Cette propriété a été introduite dans QtDataVisualization 1.1.

Voir aussi measureFps.

customItemList : list<Custom3DItem> [since QtDataVisualization 1.1]

La liste des éléments Custom3DItem ajoutés au graphe. Le graphe est propriétaire des éléments ajoutés.

Cette propriété a été introduite dans QtDataVisualization 1.1.

horizontalAspectRatio : real [since QtDataVisualization 1.2]

Le rapport d'échelle du graphique entre l'axe des x et l'axe des z. La valeur 0.0 indique une mise à l'échelle automatique en fonction des plages d'axes. La valeur par défaut est 0.0.

Remarque : cette propriété 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 aussi aspectRatio, polar, Bars3D::barThickness, et Bars3D::barSpacing.

inputHandler : AbstractInputHandler3D

Le gestionnaire d'entrée actif utilisé dans le graphique. Vous pouvez désactiver les gestionnaires d'entrée par défaut en attribuant à cette propriété la valeur null.

locale : locale [since QtDataVisualization 1.2]

Définit la locale utilisée pour le formatage de diverses étiquettes numériques. La valeur par défaut est la locale "C".

Cette propriété a été introduite dans QtDataVisualization 1.2.

Voir aussi ValueAxis3D::labelFormat.

margin : real [since QtDataVisualization 1.2]

Valeur absolue utilisée pour l'espace laissé entre le bord de la zone graphique traçable 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 rapports d'aspect du graphique n'ont pas été modifiés par rapport aux valeurs par défaut. La valeur par défaut est -1.0.

Remarque : si la marge d'un graphique de dispersion est inférieure à la marge déterminée automatiquement, les éléments de dispersion situés sur les bords du graphique risquent de se superposer à l'arrière-plan du graphique.

Note : Dans les graphiques de dispersion et de surface, si la marge est petite par rapport à la taille des étiquettes d'axe, les positions des étiquettes de bord des axes sont ajustées pour éviter le chevauchement avec les étiquettes de bord des axes voisins.

Cette propriété a été introduite dans QtDataVisualization 1.2.

measureFps : bool [since QtDataVisualization 1.1]

Si true, le rendu est effectué en continu et non à 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 aussi currentFps.

msaaSamples : int

Le nombre d'échantillons utilisés dans l'anticrénelage multi-échantillon lorsque renderingMode est RenderIndirect. Lorsque renderingMode est RenderDirectToBackground ou RenderDirectToBackground_NoClear, cette propriété est en lecture seule et renvoie le nombre d'échantillons spécifié par le format de la surface de la fenêtre. La valeur par défaut est 4.

Voir également renderingMode.

optimizationHints : AbstractGraph3D.OptimizationHints [since QtDataVisualization 1.1]

Le mode par défaut ou statique est utilisé pour l'optimisation du rendu.

Le mode par défaut fournit l'ensemble des fonctionnalités à un niveau de performance raisonnable. Le mode statique optimise le rendu des graphiques et est idéal pour les grands ensembles de données qui ne changent pas. Il est plus lent en cas de modifications dynamiques des données et de rotations des éléments. La sélection n'étant pas optimisée, il n'est pas conseillé d'utiliser le mode statique avec des ensembles de données volumineux. L'optimisation statique ne fonctionne que pour les diagrammes de dispersion. La valeur par défaut est OptimizationDefault.

Remarque : dans certains environnements, les grands graphiques utilisant l'optimisation statique peuvent ne pas être rendus, car tous les éléments sont rendus à l'aide d'un seul appel de dessin, et différents pilotes graphiques prennent en charge différents nombres maximaux de vertices par appel. Ce problème se pose principalement sur les plates-formes 32bit et OpenGL ES2. Pour contourner ce problème, choisissez un maillage d'éléments avec un faible nombre de vertex ou utilisez un maillage de points.

Cette propriété a été introduite dans QtDataVisualization 1.1.

Voir aussi Abstract3DSeries::mesh et QAbstract3DGraph::OptimizationHint.

orthoProjection : bool [since QtDataVisualization 1.1]

Si true, la projection orthographique sera utilisée pour afficher le graphique. La valeur par défaut est false.

Remarque : Les ombres seront désactivées si la valeur est true.

Cette propriété a été introduite dans QtDataVisualization 1.1.

polar : bool [since QtDataVisualization 1.2]

Si true, les axes horizontaux sont transformés en 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 diagrammes à 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é à l'aide de Scene3D::graphPositionQuery. Les valeurs sont normalisées en fonction de l'intervalle [-1, 1]. Si la position interrogée se situe en dehors des limites du graphique, les valeurs ne reflèteront pas la position réelle, mais correspondront à une position indéfinie située en dehors de l'intervalle [-1, 1]. La valeur sera indéfinie jusqu'à ce qu'une requête soit effectuée.

Il n'existe pas de coordonnées 3D correctes correspondant à une position particulière de l'écran. Par conséquent, pour des raisons de cohérence, les requêtes sont toujours effectuées par rapport aux côtés intérieurs d'une boîte invisible entourant le graphique.

Remarque : les graphiques à barres ne permettent d'interroger la position du graphique qu'au niveau du sol du graphique, de sorte que la valeur y est toujours nulle pour les graphiques à barres et que les requêtes valides ne peuvent être effectuées qu'à des positions d'écran qui contiennent le sol du graphique.

Cette propriété a été introduite dans QtDataVisualization 1.2.

Voir aussi 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 de l'axe angulaire 0. La valeur 1.0 indique que les étiquettes sont dessinées à leur place habituelle, au bord du fond 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 aussi polar.

reflection : bool [since QtDataVisualization 1.2]

Active ou désactive les réflexions sur le sol. La valeur par défaut est false.

Remarque : cette option n'affecte que Bars3D. Toutefois, dans les graphiques Bars3D contenant des valeurs positives et négatives, les réflexions ne sont pas prises en charge pour les éléments personnalisés qui coupent le plan du sol. Dans ce cas, les réflexions doivent être désactivées pour éviter un rendu incorrect.

Cette propriété a été introduite dans QtDataVisualization 1.2.

Voir aussi reflectivity.

reflectivity : real [since QtDataVisualization 1.2]

Définit la réflectivité du sol. Plus les chiffres sont élevés, plus le sol est réfléchissant. La plage valide est [0...1]. La valeur par défaut est 0.5.

Remarque : affecte uniquement Bars3D.

Cette propriété a été introduite dans QtDataVisualization 1.2.

Voir aussi reflection.

scene : Scene3D

Le pointeur Scene3D qui peut être utilisé pour manipuler la scène et accéder aux éléments de la scène, 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 graphique.

Cette propriété peut être utilisée pour demander le type d'élément sélectionné. Le type est valide jusqu'à ce qu'une nouvelle sélection soit effectuée dans le graphique et que le signal selectedElementChanged soit émis.

Le signal peut être utilisé, par exemple, pour mettre en œuvre une gestion personnalisée des entrées, comme le montre l'exemple de la gestion des axes.

Cette propriété a été introduite dans QtDataVisualization 1.1.

Voir aussi selectedLabelIndex(), selectedAxis(), selectedCustomItemIndex(), selectedCustomItem(), Bars3D::selectedSeries, Scatter3D::selectedSeries, Scene3D::selectionQueryPosition, et QAbstract3DGraph::ElementType.

selectionMode : AbstractGraph3D.SelectionMode

Le mode de sélection actif dans la visualisation. Une des valeurs de l'énumération QAbstract3DGraph::SelectionFlag.

Voir également QAbstract3DGraph::SelectionFlag.

shadowQuality : AbstractGraph3D.ShadowQuality

La qualité des ombres. 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 par la configuration actuelle. Les configurations OpenGL ES2 ne prennent pas en charge les ombres.

theme : Theme3D

Le thème actif du graphique.

Voir aussi Theme3D.

Documentation de la méthode

[since QtDataVisualization 1.1] int addCustomItem(Custom3DItem item)

Ajoute un Custom3DItem item au graphique. Le graphique devient propriétaire de l'élément ajouté.

Retourne l'index de l'élément ajouté si l'ajout a réussi, -1 si l'on essaie d'ajouter un élément nul, et l'index de l'élément si l'on essaie d'ajouter un élément déjà ajouté.

Cette méthode a été introduite dans QtDataVisualization 1.1.

Voir aussi removeCustomItems(), removeCustomItem(), et removeCustomItemAt().

void clearSelection()

Efface la sélection de toutes les séries attachées.

[since 6.3] bool hasSeries(Abstract3DSeries series)

Retourne si le site series 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 item du graphique.

Note : Si le même élément est ajouté au graphique, le fichier de texture doit être réinitialisé.

Cette méthode a été introduite dans QtDataVisualization 1.1.

Voir aussi Custom3DItem::textureFile.

[since QtDataVisualization 1.1] void removeCustomItem(Custom3DItem item)

Supprime le site personnalisé item. 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 à l'adresse 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. Supprime les ressources qui leur sont allouées.

Cette méthode a été introduite dans QtDataVisualization 1.1.

[since QtDataVisualization 1.1] Abstract3DAxis selectedAxis()

Peut être utilisé pour obtenir l'axe sélectionné après avoir reçu le signal selectedElementChanged avec n'importe quel type d'étiquette. La sélection est valable jusqu'au prochain signal selectedElementChanged.

Retourne l'axe sélectionné ou null.

Cette méthode a été introduite dans QtDataVisualization 1.1.

Voir aussi selectedElement.

[since QtDataVisualization 1.1] Custom3DItem selectedCustomItem()

Peut être utilisé pour obtenir l'élément personnalisé sélectionné après avoir reçu un signal selectedElementChanged de type ElementCustomItem. L'élément reste la propriété du graphique. La sélection est 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 aussi selectedElement.

[since QtDataVisualization 1.1] int selectedCustomItemIndex()

Peut être utilisé pour demander l'index de l'élément personnalisé sélectionné après avoir reçu le signal selectedElementChanged avec le type ElementCustomItem. La sélection est valable 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 aussi selectedElement.

[since QtDataVisualization 1.1] int selectedLabelIndex()

Peut être utilisé pour demander l'index de l'étiquette sélectionnée après avoir reçu le signal selectedElementChanged avec n'importe quel type d'étiquette. La sélection est valable 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 aussi 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.