Scene3D QML Type (Uncreatable)
Le type `Scene3D` fournit une description de la scène 3D en cours de visualisation. En savoir plus...
| Import Statement: | import QtGraphs |
| In C++: | Q3DScene |
Remarque : il s'agit d'un type non instanciable. Il ne peut pas être instancié en QML.
- Liste de tous les membres, y compris les membres hérités
- Scene3D fait partie de la bibliothèque «Qt Graphs » de types QML pour la 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 emplacement fixe.
La scène 3D garde également en mémoire la fenêtre d'affichage dans laquelle s'effectue le rendu des graphiques, la sous-fenêtre principale à l'intérieur de la fenêtre d'affichage où se trouve la vue principale des graphiques 3D, ainsi que la sous-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 en coupe 2D secondaire est actuellement active ou non.
Remarque : tous les graphiquesne prennentpas en charge la vue de découpage 2D secondaire.
Documentation des propriétés
devicePixelRatio : real
Le rapport de pixels actuel de l'appareil, utilisé pour convertir les coordonnées d'entrée en coordonnées de pixels.
graphPositionQuery : point
Coordonnées de la saisie utilisateur qui doivent être traitées par la scène comme une requête de position dans le graphe. Si cette propriété est définie sur une valeur autre que « invalidSelectionPoint », le graphe tente de faire correspondre une position du graphe au point donné dans la fenêtre d’affichage principale. Après le passage de rendu, cette propriété revient à son état par défaut : ` invalidSelectionPoint`. La position du graphique interrogée peut être lue à partir de la propriété ` GraphsItem3D::queriedGraphPosition ` après le passage de rendu suivant.
Il n’existe pas de coordonnée 3D unique 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 cadre invisible entourant le graphique.
Remarque : les graphiquesà barres n’autorisent les requêtes de position qu’au niveau du plancher 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 du sous-fenêtre d'affichage actuel à l'intérieur de la fenêtre d'affichage, où est ciblée la vue principale des graphiques.
Si la sous-fenêtre principale n’a pas été explicitement définie, elle occupera un cinquième de la fenêtre d’affichage.
Remarque : si la taille de primarySubViewportest supérieure à celle de la fenêtre d’affichage ous’étend au-delà de celle-ci, la fenêtre d’affichage est redimensionnée en conséquence.
secondarySubViewport : rect
La fenêtre d'affichage secondaire sert à afficher la vue en coupe 2D dans certains graphiques. Si elle n'a pas été définie explicitement, sa taille sera identique à celle de la fenêtre d'affichage.
Remarque : si la fenêtre d'affichage secondaire est plus grande que la fenêtre d'affichage principale ou se trouve en dehors de celle-ci, la fenêtre d'affichage principale est redimensionnée en conséquence.
secondarySubviewOnTop : bool
Détermine si la vue de coupe 2D ou la vue 3D s'affiche au premier plan.
selectionQueryPosition : point
Coordonnées de la saisie utilisateur qui doit être traitée par la scène comme une sélection. Si cette propriété est définie sur une valeur autre que ` invalidSelectionPoint`, le graphe tente de sélectionner un élément de données situé au point indiqué dans la fenêtre d’affichage principale. Une fois le passage de rendu terminé, la propriété reprend sa valeur par défaut, à savoir ` invalidSelectionPoint`.
slicingActive : bool
Détermine si la vue de découpage 2D est actuellement active. Si l'true, Graphs3D::selectionMode doit avoir soit la propriété Graphs3D.SelectionRow, soit la propriété Graphs3D.SelectionColumn définie sur une sélection valide.
Remarque : tous les graphesne prennentpas en charge la vue de découpage 2D.
Documentation sur les signaux
devicePixelRatioChanged(qreal pixelRatio)
Ce signal est émis lorsque devicePixelRatio devient pixelRatio.
Remarque : le gestionnaire correspondant est onDevicePixelRatioChanged.
graphPositionQueryChanged(point position)
Ce signal est émis lorsque graphPositionQuery devient position.
Remarque : le gestionnaire correspondant est onGraphPositionQueryChanged.
primarySubViewportChanged(rect subViewport)
Ce signal est émis lorsque primarySubViewport devient subViewport.
Remarque : le gestionnaire correspondant est onPrimarySubViewportChanged.
secondarySubViewportChanged(rect subViewport)
Ce signal est émis lorsque secondarySubViewport devient subViewport.
Remarque : le gestionnaire correspondant est onSecondarySubViewportChanged.
secondarySubviewOnTopChanged(bool isSecondaryOnTop)
Ce signal est émis lorsque secondarySubviewOnTop devient isSecondaryOnTop.
Remarque : le gestionnaire correspondant est onSecondarySubviewOnTopChanged.
selectionQueryPositionChanged(point position)
Ce signal est émis lorsque l'selectionQueryPosition passe à position.
Remarque : le gestionnaire correspondant est onSelectionQueryPositionChanged.
slicingActiveChanged(bool isSlicingActive)
Ce signal est émis lorsque slicingActive devient isSlicingActive.
Remarque : le gestionnaire correspondant est onSlicingActiveChanged.
viewportChanged(rect viewport)
Ce signal est émis lorsque la fenêtre d'affichage passe à viewport.
Remarque : 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.
