Scene3D QML Type
Der Typ Scene3D liefert eine Beschreibung der zu visualisierenden 3D-Szene. Mehr...
| Import Statement: | import QtGraphs |
| In C++: | Q3DScene |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- Scene3D ist Teil von Qt Graphs QML Types for 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)
Detaillierte 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 auch das Ansichtsfenster, in dem das Diagramm gerendert wird, das primäre Unterfenster innerhalb des Ansichtsfensters, in dem sich die Hauptansicht des 3D-Diagramms befindet, und das sekundäre Unterfenster, in dem sich die 2D-Slicing-Ansicht der Daten befindet.
Außerdem verfügt die Szene über ein Flag, das anzeigt, ob die sekundäre 2D-Slicing-Ansicht gerade aktiv ist oder nicht.
Hinweis: Nicht alle Diagramme unterstützen die sekundäre 2D-Slicing-Ansicht.
Dokumentation der Eigenschaft
devicePixelRatio : real
Das aktuelle Gerätepixelverhältnis, das bei der Zuordnung von Eingabekoordinaten zu Pixelkoordinaten verwendet wird.
graphPositionQuery : point
Die Koordinaten für die Benutzereingabe, die von der Szene als Graphpositionsabfrage verarbeitet werden soll. Wenn diese Eigenschaft auf einen anderen Wert als invalidSelectionPoint gesetzt wird, versucht der Graph, eine Graphposition mit dem angegebenen Punkt innerhalb des primären Ansichtsfensters abzugleichen. Nach dem Rendering-Durchgang wird diese Eigenschaft auf den Standardwert invalidSelectionPoint zurückgesetzt. Die abgefragte Graphenposition kann nach dem nächsten Rendering-Durchgang aus der Eigenschaft GraphsItem3D::queriedGraphPosition gelesen werden.
Es gibt keine einzige korrekte 3D-Koordinate, die einer bestimmten Bildschirmposition entspricht. Um konsistent zu sein, werden die Abfragen immer an den Innenseiten einer unsichtbaren Box durchgeführt, die das Diagramm umgibt.
Hinweis: Bei Balkendiagrammen ist die Abfrage der Diagrammposition nur auf der Ebene der Diagrammböden möglich.
Siehe auch GraphsItem3D::queriedGraphPosition.
invalidSelectionPoint : point [read-only]
Eine konstante Eigenschaft, die einen ungültigen Punkt für die Auswahl liefert.
primarySubViewport : rect
Das aktuelle Sub-Viewport-Rechteck innerhalb des Viewports, auf das die primäre Ansicht der Graphen ausgerichtet ist.
Wenn das primäre Unteransichtsfenster nicht explizit festgelegt wurde, entspricht es einem Fünftel des Ansichtsfensters.
Hinweis: Wird primarySubViewport größer als oder außerhalb des Ansichtsfensters festgelegt, wird die Größe des Ansichtsfensters entsprechend angepasst.
secondarySubViewport : rect
Das sekundäre Ansichtsfenster wird zum Zeichnen der 2D-Slice-Ansicht in einigen Diagrammen verwendet. Wenn er nicht explizit festgelegt wurde, entspricht er der Größe des Ansichtsfensters.
Hinweis: Wenn das sekundäre Sub-Viewport größer ist als das Viewport oder außerhalb desselben liegt, wird die Größe des Viewports entsprechend angepasst.
secondarySubviewOnTop : bool
Legt fest, ob die 2D-Slicing-Ansicht oder die 3D-Ansicht oben gezeichnet wird.
selectionQueryPosition : point
Die Koordinaten für die Benutzereingabe, die von der Szene als Auswahl verarbeitet werden soll. Wenn diese Eigenschaft auf einen anderen Wert als invalidSelectionPoint gesetzt wird, versucht der Graph, ein Datenelement an dem angegebenen Punkt innerhalb des primären Ansichtsfensters auszuwählen. Nach dem Rendering-Durchgang wird die Eigenschaft auf den Standardwert invalidSelectionPoint zurückgesetzt.
slicingActive : bool
Legt fest, ob die 2D-Slicing-Ansicht gerade aktiv ist. Wenn true, muss Graphs3D::selectionMode entweder Graphs3D.SelectionRow oder Graphs3D.SelectionColumn auf eine gültige Auswahl eingestellt sein.
Hinweis: Nicht alle Diagramme unterstützen die 2D-Slicing-Ansicht.
Signal-Dokumentation
devicePixelRatioChanged(qreal pixelRatio)
Dieses Signal wird ausgegeben, wenn devicePixelRatio zu pixelRatio wechselt.
Hinweis: Der entsprechende Handler ist onDevicePixelRatioChanged.
graphPositionQueryChanged(point position)
Dieses Signal wird ausgegeben, wenn graphPositionQuery zu position wechselt.
Hinweis: Der entsprechende Handler ist onGraphPositionQueryChanged.
primarySubViewportChanged(rect subViewport)
Dieses Signal wird ausgegeben, wenn primarySubViewport zu subViewport wechselt.
Hinweis: Der entsprechende Handler ist onPrimarySubViewportChanged.
secondarySubViewportChanged(rect subViewport)
Dieses Signal wird ausgegeben, wenn secondarySubViewport zu subViewport wechselt.
Hinweis: Der entsprechende Handler ist onSecondarySubViewportChanged.
secondarySubviewOnTopChanged(bool isSecondaryOnTop)
Dieses Signal wird ausgegeben, wenn secondarySubviewOnTop zu isSecondaryOnTop wechselt.
Hinweis: Der entsprechende Handler ist onSecondarySubviewOnTopChanged.
selectionQueryPositionChanged(point position)
Dieses Signal wird ausgegeben, wenn selectionQueryPosition zu position wechselt.
Hinweis: Der entsprechende Handler ist onSelectionQueryPositionChanged.
slicingActiveChanged(bool isSlicingActive)
Dieses Signal wird ausgegeben, wenn slicingActive zu isSlicingActive wechselt.
Hinweis: Der entsprechende Handler ist onSlicingActiveChanged.
viewportChanged(rect viewport)
Dieses Signal wird ausgegeben, wenn das Ansichtsfenster zu viewport wechselt.
Hinweis: Der entsprechende Handler ist 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.
