Back to Qt.io
Contact Us Blog Download Qt

Scene3D QML Type

Der Typ Scene3D liefert eine Beschreibung der zu visualisierenden 3D-Szene. Mehr...

Import Statement: import QtGraphs
In C++: Q3DScene

Eigenschaften

Signale

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 Untersichtsfenster innerhalb des Ansichtsfensters, in dem sich die Hauptansicht des 3D-Diagramms befindet, und das sekundäre Untersichtsfenster, 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.

Eigenschaft Dokumentation

devicePixelRatio : qreal

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 sollen. 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 eines unsichtbaren Rahmens durchgeführt, der 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 bereitstellt.


primarySubViewport : rect

Das aktuelle Unteransichtsfenster-Rechteck innerhalb des Ansichtsfensters, auf das die primäre Ansicht des Diagramms ausgerichtet ist.

Wenn das primäre Unteransichtsfenster nicht explizit festgelegt wurde, ist es ein 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 in einigen Diagrammen zum Zeichnen der 2D-Slice-Ansicht verwendet. Wenn er nicht explizit festgelegt wurde, entspricht er der Größe des Ansichtsfensters.

Hinweis: Wenn das sekundäre Sub-Viewport größer als das Viewport ist oder außerhalb des Viewports 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 ist, 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 Standardstatus invalidSelectionPoint zurückgesetzt.


slicingActive : bool

Legt fest, ob die 2D-Slicing-Ansicht derzeit aktiv ist. Falls 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 auf 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 viewport zu viewport wechselt.

Hinweis: Der entsprechende Handler ist onViewportChanged.


© 2025 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.