Scene3D QML Type (Uncreatable)
Der Typ „Scene3D“ enthält eine Beschreibung der visualisierten 3D-Szene. Mehr…
| Import Statement: | import QtGraphs |
| In C++: | Q3DScene |
Hinweis: Dies ist ein nicht erstellbarer Typ. Er kann in QML nicht instanziiert werden.
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- „Scene3D“ ist Teil von „Qt Graphs “ – QML-Typen für 3D.
Eigenschaften
- devicePixelRatio : real
- graphPositionQuery : point
- invalidSelectionPoint : point
- primarySubViewport : rect
- secondarySubViewport : rect
- secondarySubviewOnTop : bool
- selectionQueryPosition : point
- slicingActive : bool
Signale
- devicePixelRatioChanged(qreal pixelRatio)
- graphPositionQueryChanged(point position)
- primarySubViewportChanged(rect subViewport)
- secondarySubViewportChanged(rect subViewport)
- secondarySubviewOnTopChanged(bool isSecondaryOnTop)
- selectionQueryPositionChanged(point position)
- slicingActiveChanged(bool isSlicingActive)
- viewportChanged(rect viewport)
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 einer festen Position befinden.
Die 3D-Szene verwaltet außerdem den Viewport, in dem die Grafikdarstellung erfolgt, den primären Subviewport innerhalb des Viewports, in dem sich die Hauptansicht der 3D-Grafiken befindet, sowie den sekundären Subviewport, in dem sich die 2D-Schnittansicht der Daten befindet.
Außerdem verfügt die Szene über ein Kennzeichen, um zu verfolgen, ob die sekundäre 2D-Schnittansicht derzeit aktiv ist oder nicht.
Hinweis: Nicht alle Diagramme unterstützen die sekundäre 2D-Schnittansicht.
Dokumentation zu den Eigenschaften
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 Ansichtsfensters 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 „ GraphsItem3D::queriedGraphPosition “ ausgelesen werden.
Da es keine einheitliche 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 Diagrammgrundebene möglich.
Siehe auch GraphsItem3D::queriedGraphPosition.
invalidSelectionPoint : point [read-only]
Eine konstante Eigenschaft, die einen ungültigen Punkt für die Auswahl bereitstellt.
primarySubViewport : rect
Das aktuelle Rechteck des Teilansichtsbereichs innerhalb des Ansichtsbereichs, auf das die Hauptansicht der Diagramme ausgerichtet ist.
Wenn der primäre Teilansichtsbereich nicht explizit festgelegt wurde, entspricht er einem Fünftel des Ansichtsbereichs.
Hinweis: Wird „primarySubViewport“ größer als der Viewport oder außerhalb desselbenfestgelegt , wird die Größe des Viewports entsprechend angepasst.
secondarySubViewport : rect
Der sekundäre Ansichtsbereich wird in einigen Diagrammen zum Zeichnen der 2D-Schnittansicht verwendet. Wenn er nicht explizit festgelegt wurde, entspricht er der Größe des Ansichtsbereichs.
Hinweis: Ist der sekundäre Teil-Viewport größer als der Viewport oder liegt er außerhalb dessen, 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 wird, 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 „Graphs3D::selectionMode“ entweder „ Graphs3D.SelectionRow “ oder „ Graphs3D.SelectionColumn “ auf eine gültige Auswahl gesetzt sein.
Hinweis: Nicht alle Diagramme unterstützen die 2D-Slicing-Ansicht.
Signal-Dokumentation
devicePixelRatioChanged(qreal pixelRatio)
Dieses Signal wird ausgelöst, wenn sich „ devicePixelRatio “ in „ pixelRatio “ ändert.
Hinweis: Der entsprechende Handler lautet onDevicePixelRatioChanged.
graphPositionQueryChanged(point position)
Dieses Signal wird ausgelöst, wenn sich graphPositionQuery in position ändert.
Hinweis: Der zugehörige Handler lautet onGraphPositionQueryChanged.
primarySubViewportChanged(rect subViewport)
Dieses Signal wird ausgelöst, wenn sich „ primarySubViewport “ in „ subViewport “ ändert.
Hinweis: Der entsprechende Handler lautet onPrimarySubViewportChanged.
secondarySubViewportChanged(rect subViewport)
Dieses Signal wird ausgelöst, wenn sich „ secondarySubViewport “ in „ subViewport “ ändert.
Hinweis: Der entsprechende Handler lautet onSecondarySubViewportChanged.
secondarySubviewOnTopChanged(bool isSecondaryOnTop)
Dieses Signal wird ausgelöst, wenn sich „ secondarySubviewOnTop “ in „ isSecondaryOnTop “ ändert.
Hinweis: Der zugehörige Handler lautet onSecondarySubviewOnTopChanged.
selectionQueryPositionChanged(point position)
Dieses Signal wird ausgelöst, wenn sich „ selectionQueryPosition “ in „ position “ ändert.
Hinweis: Der entsprechende Handler lautet onSelectionQueryPositionChanged.
slicingActiveChanged(bool isSlicingActive)
Dieses Signal wird ausgelöst, wenn sich „ slicingActive “ in „ isSlicingActive “ ändert.
Hinweis: Der entsprechende Handler lautet onSlicingActiveChanged.
viewportChanged(rect viewport)
Dieses Signal wird ausgelöst, wenn sich die Ansicht auf viewport ändert.
Hinweis: Der entsprechende Handler lautet „ 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.
