Scene3D QML Type
Der Typ „Scene3D“ enthält eine Beschreibung der visualisierten 3D-Szene. Mehr...
| Import Statement: | import QtDataVisualization 1.12 |
| Since: | QtDataVisualization 1.0 |
| In C++: | Q3DScene |
| Status: | Deprecated |
Dieser Typ ist veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.
Eigenschaften
- activeCamera : Camera3D
- activeLight : Light3D
- devicePixelRatio : real
- graphPositionQuery : point
- invalidSelectionPoint : point
- primarySubViewport : rect
- secondarySubViewport : rect
- secondarySubviewOnTop : bool
- selectionQueryPosition : point
- slicingActive : bool
- viewport : rect
Ausführliche Beschreibung
Die 3D-Szene enthält eine einzige aktive Kamera und eine einzige aktive Lichtquelle. Es wird davon ausgegangen, dass sich die visualisierten Daten an einem festen Ort befinden.
Die 3D-Szene verfolgt außerdem den Viewport, in dem die Visualisierung gerendert wird, den primären Subviewport innerhalb des Viewports, in dem sich die Hauptansicht der 3D-Datenvisualisierung befindet, sowie den sekundären Subviewport, in dem sich die 2D-Schnittansicht der Daten befindet.
Außerdem verfügt die Szene über ein Kennzeichen, mit dem verfolgt wird, ob die sekundäre 2D-Schnittansicht derzeit aktiv ist oder nicht.
Hinweis: Nicht alle Visualisierungen unterstützen die sekundäre 2D-Schnittansicht.
Dokumentation zu den Eigenschaften
activeCamera : Camera3D
Die derzeit aktive Kamera in der 3D-Szene. Wenn in der Eigenschaft ein „Camera3D“-Objekt festgelegt wird, wird dieses automatisch als untergeordnetes Element der Szene hinzugefügt.
activeLight : Light3D
Die derzeit aktive Lichtquelle in der 3D-Szene. Wenn in der Eigenschaft ein „Light3D“ festgelegt wird, wird dieses automatisch als untergeordnetes Element der Szene hinzugefügt.
devicePixelRatio : real
Das aktuell verwendete Geräte-Pixel-Verhältnis, das bei der Zuordnung von Eingabekoordinaten zu Pixelkoordinaten verwendet wird.
graphPositionQuery : point
Die Koordinaten der Benutzereingabe, die von der Szene als Abfrage nach einer Grafikposition verarbeitet werden sollen. Wenn diese Eigenschaft auf einen anderen Wert als „ invalidSelectionPoint “ gesetzt ist, versucht die Grafik, eine Grafikposition mit dem angegebenen Punkt innerhalb des primären Ansichtsbereichs abzugleichen. Nach dem Renderdurchlauf wird diese Eigenschaft auf ihren Standardwert „ invalidSelectionPoint “ zurückgesetzt. Die abgefragte Grafikposition kann nach dem nächsten Renderdurchlauf über die Eigenschaft „ AbstractGraph3D::queriedGraphPosition “ ausgelesen werden.
Da es keine einzige korrekte 3D-Koordinate gibt, die einer bestimmten Bildschirmposition entspricht, erfolgen die Abfragen aus Gründen der Konsistenz stets an den Innenseiten eines unsichtbaren Kastens, der das Diagramm umgibt.
Hinweis: BeiBalkendiagrammen sind Abfragen der Diagrammposition nur auf der Diagrammbodenebene zulässig.
Siehe auch AbstractGraph3D::queriedGraphPosition.
invalidSelectionPoint : point
Eine konstante Eigenschaft, die einen ungültigen Punkt für die Auswahl bereitstellt.
primarySubViewport : rect
Das aktuelle Rechteck des Unter-Viewports innerhalb des Viewports, auf das die primäre Ansicht der Datenvisualisierung ausgerichtet ist.
Wenn „ slicingActive “ auf „ false “ gesetzt ist, entspricht der primäre Teilansichtsbereich dem Ansichtsbereich. Wenn „ slicingActive “ auf „ true “ gesetzt ist und der primäre Teilansichtsbereich nicht explizit festgelegt wurde, beträgt er ein Fünftel des Ansichtsbereichs.
Hinweis: Wird „primarySubViewport“ größer als oder außerhalb des Viewportsfestgelegt , wird die Größe des Viewports entsprechend angepasst.
secondarySubViewport : rect
* * * Das Rechteck des sekundären Ansichtsfensters innerhalb des Ansichtsfensters. Das sekundäre Ansichtsfenster * wird in einigen Visualisierungen zum Zeichnen der 2D-Schnittansicht verwendet. Wenn es nicht * explizit festgelegt wurde, ist es null. Wenn slicingActive true ist, entspricht es * dem Ansichtsfenster. *
Hinweis: Ist der sekundäre Teil-Viewport größer als der * Viewport oder liegt er außerhalb desselben, wird der Viewport entsprechend angepasst.
secondarySubviewOnTop : bool
Legt fest, ob die 2D-Schnittansicht oder die 3D-Ansicht im Vordergrund dargestellt wird.
selectionQueryPosition : point
Die Koordinaten der Benutzereingabe, die von der Szene als Auswahl verarbeitet werden sollen. Wenn diese Eigenschaft auf einen anderen Wert als „ invalidSelectionPoint “ gesetzt ist, versucht der Graph, ein Datenelement an der angegebenen Stelle innerhalb des primären Ansichtsfensters auszuwählen. Nach dem Rendering-Durchlauf wird die Eigenschaft wieder auf ihren Standardzustand „ invalidSelectionPoint “ zurückgesetzt.
slicingActive : bool
Legt fest, ob die 2D-Slicing-Ansicht derzeit aktiv ist. Wenn „ true “ gesetzt ist, muss bei „ AbstractGraph3D::selectionMode “ entweder „ AbstractGraph3D.SelectionRow “ oder „ AbstractGraph3D.SelectionColumn “ auf eine gültige Auswahl eingestellt sein.
Hinweis: Nicht alle Visualisierungen unterstützen die 2D-Slicing-Ansicht.
viewport : rect [read-only]
Das aktuelle Ansichtsfenster-Rechteck, auf das die gesamte 3D-Darstellung ausgerichtet ist.
© 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.
