Scene3D QML Type
Le type Scene3D fournit une description de la scène 3D visualisée. Plus d'informations...
| Import Statement: | import QtDataVisualization 1.11 |
| Since: | QtDataVisualization 1.0 |
| In C++: | Q3DScene |
Propriétés
- activeCamera : Camera3D
- activeLight : Light3D
- devicePixelRatio : real
- graphPositionQuery : point
- invalidSelectionPoint : point
- primarySubViewport : rect
- secondarySubViewport : rect
- secondarySubviewOnTop : bool
- selectionQueryPosition : point
- slicingActive : bool
- viewport : rect
Description détaillée
La scène 3D contient une seule caméra active et une seule source lumineuse active. Les données visualisées sont supposées se trouver à un endroit fixe.
La scène 3D garde également la trace de la fenêtre de visualisation dans laquelle le rendu de la visualisation est effectué, de la fenêtre secondaire primaire à l'intérieur de la fenêtre de visualisation où se trouve la vue principale de visualisation des données 3D et de la fenêtre secondaire où se trouve la vue en coupe 2D des données.
La scène dispose également d'un indicateur permettant de savoir si la vue secondaire en coupe 2D est actuellement active ou non.
Remarque : toutes les visualisations ne prennent pas en charge la vue secondaire en coupe 2D.
Documentation sur les propriétés
activeCamera : Camera3D
La caméra actuellement active dans la scène 3D. Lorsqu'un site Camera3D est défini dans la propriété, il est automatiquement ajouté comme enfant de la scène.
activeLight : Light3D
La lumière actuellement active dans la scène 3D. Lorsqu'un Light3D est défini dans la propriété, il est automatiquement ajouté comme enfant de la scène.
devicePixelRatio : real
Le rapport de pixel actuel de l'appareil qui est utilisé lors du mappage des coordonnées d'entrée en coordonnées de pixel.
graphPositionQuery : point
Les coordonnées de l'entrée utilisateur qui doit être traitée par la scène en tant que requête de position du graphique. Si cette propriété est définie sur une valeur autre que invalidSelectionPoint, le graphique tente de faire correspondre une position du graphique au point donné dans la fenêtre d'affichage principale. Après la passe de rendu, cette propriété est ramenée à son état par défaut ( invalidSelectionPoint). La position du graphique interrogée peut être lue à partir de la propriété AbstractGraph3D::queriedGraphPosition après la passe de rendu suivante.
Il n'existe pas de coordonnées 3D correctes correspondant à une position d'écran particulière. Par souci 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 de l'étage du graphique.
Voir également AbstractGraph3D::queriedGraphPosition.
invalidSelectionPoint : point
Une propriété constante fournissant un point non valide pour la sélection.
primarySubViewport : rect
Le rectangle de sous-vue actuel à l'intérieur de la fenêtre de visualisation où la vue principale de la visualisation de données est ciblée.
Si slicingActive est false, la fenêtre secondaire primaire sera égale à la fenêtre. Si slicingActive est true et que la fenêtre secondaire primaire n'a pas été explicitement définie, elle sera égale à un cinquième de la fenêtre.
Remarque : le fait de définir primarySubViewport à une valeur supérieure ou inférieure à celle de l'écran redimensionne l'écran en conséquence.
secondarySubViewport : rect
* * * Le rectangle de la fenêtre secondaire à l'intérieur de la fenêtre de visualisation. La fenêtre secondaire * est utilisée pour dessiner la vue en coupe 2D dans certaines visualisations. S'il n'a pas été * explicitement défini, il sera nul. Si slicingActive est true, il sera * égal à la fenêtre de visualisation. *
Remarque : si le sous-point de vue secondaire est plus grand ou en dehors du * point de vue, le point de vue est redimensionné en conséquence.
secondarySubviewOnTop : bool
Définit si la vue de coupe 2D ou la vue 3D est dessinée en haut.
selectionQueryPosition : point
Les coordonnées de l'entrée utilisateur qui doit être traitée par la scène comme une sélection. Si cette propriété est définie à une valeur autre que invalidSelectionPoint, le graphique tente de sélectionner un élément de données au point donné dans la fenêtre principale. Après la passe de rendu, la propriété est ramenée à son état par défaut, à savoir invalidSelectionPoint.
slicingActive : bool
Définit si la vue de découpage en 2D est actuellement active. Si true, AbstractGraph3D::selectionMode doit avoir une sélection valide dans AbstractGraph3D.SelectionRow ou AbstractGraph3D.SelectionColumn.
Remarque : toutes les visualisations ne prennent pas en charge la vue en coupe 2D.
viewport : rect [read-only]
Le rectangle de visualisation actuel où tous les rendus 3D sont ciblés.
© 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.
