Scene3D QML Type
Le type Scene3D fournit une description de la scène 3D visualisée. Plus d'informations...
| Import Statement: | import QtGraphs |
| In C++: | Q3DScene |
- Liste de tous les membres, y compris les membres hérités
- Scene3D fait partie de Qt Graphs QML Types for 3D.
Propriétés
- devicePixelRatio : real
- graphPositionQuery : point
- invalidSelectionPoint : point
- primarySubViewport : rect
- secondarySubViewport : rect
- secondarySubviewOnTop : bool
- selectionQueryPosition : point
- slicingActive : bool
Signaux
- devicePixelRatioChanged(qreal pixelRatio)
- graphPositionQueryChanged(point position)
- primarySubViewportChanged(rect subViewport)
- secondarySubViewportChanged(rect subViewport)
- secondarySubviewOnTopChanged(bool isSecondaryOnTop)
- selectionQueryPositionChanged(point position)
- slicingActiveChanged(bool isSlicingActive)
- viewportChanged(rect viewport)
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 graphique est effectué, de la fenêtre secondaire principale à l'intérieur de la fenêtre de visualisation où se trouve la vue principale des graphiques 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 active ou non.
Remarque : tous les graphiques ne prennent pas en charge la vue secondaire en coupe 2D.
Documentation sur les propriétés
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é GraphsItem3D::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 GraphsItem3D::queriedGraphPosition.
invalidSelectionPoint : point [read-only]
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 des graphiques est ciblée.
Si la fenêtre secondaire primaire n'a pas été explicitement définie, elle correspondra à un cinquième de la fenêtre.
Remarque : le fait de définir primarySubViewport à une valeur supérieure ou inférieure à celle de la fenêtre permet de redimensionner cette dernière en conséquence.
secondarySubViewport : rect
La fenêtre secondaire est utilisée pour dessiner la vue en coupe 2D dans certains graphiques. S'il n'a pas été explicitement défini, il sera égal à la taille de la fenêtre de visualisation.
Remarque : si la fenêtre secondaire est plus grande que la fenêtre d'affichage ou si elle se trouve en dehors de celle-ci, la fenêtre d'affichage est redimensionnée 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 2D est actuellement active. Si true, Graphs3D::selectionMode doit avoir Graphs3D.SelectionRow ou Graphs3D.SelectionColumn défini sur une sélection valide.
Remarque : tous les graphiques ne prennent pas en charge la vue en coupe 2D.
Documentation sur les signaux
devicePixelRatioChanged(qreal pixelRatio)
Ce signal est émis lorsque devicePixelRatio devient pixelRatio.
Note : Le gestionnaire correspondant est onDevicePixelRatioChanged.
graphPositionQueryChanged(point position)
Ce signal est émis lorsque graphPositionQuery devient position.
Note : Le gestionnaire correspondant est onGraphPositionQueryChanged.
primarySubViewportChanged(rect subViewport)
Ce signal est émis lorsque primarySubViewport devient subViewport.
Note : Le gestionnaire correspondant est onPrimarySubViewportChanged.
secondarySubViewportChanged(rect subViewport)
Ce signal est émis lorsque secondarySubViewport devient subViewport.
Note : Le gestionnaire correspondant est onSecondarySubViewportChanged.
secondarySubviewOnTopChanged(bool isSecondaryOnTop)
Ce signal est émis lorsque secondarySubviewOnTop devient isSecondaryOnTop.
Note : Le gestionnaire correspondant est onSecondarySubviewOnTopChanged.
selectionQueryPositionChanged(point position)
Ce signal est émis lorsque selectionQueryPosition devient position.
Note : Le gestionnaire correspondant est onSelectionQueryPositionChanged.
slicingActiveChanged(bool isSlicingActive)
Ce signal est émis lorsque slicingActive devient isSlicingActive.
Note : Le gestionnaire correspondant est onSlicingActiveChanged.
viewportChanged(rect viewport)
Ce signal est émis lorsque la fenêtre d'affichage passe à viewport.
Note : Le gestionnaire correspondant est onViewportChanged.
© 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.
