Camera3D QML Type

Repräsentation einer Kamera im 3D-Raum. Mehr...

Import Statement: import QtDataVisualization 1.8
Since: QtDataVisualization 1.0
In C++: Q3DCamera

Eigenschaften

Detaillierte Beschreibung

Camera3D stellt eine einfache 3D-Kamera dar, die um den Mittelpunkt kreist und beim Rendern der Datenvisualisierung verwendet wird. Der Typ bietet einfache Methoden zum Drehen der Kamera um den Ursprung und zum Einstellen der Zoomstufe.

Für Camera3D enums, siehe Q3DCamera::CameraPreset.

Dokumentation der Eigenschaft

cameraPreset : Camera3D.CameraPreset

Die derzeit aktive Kameravoreinstellung, die eine von Camera3D.CameraPreset ist. Wenn keine Voreinstellung aktiv ist, lautet der Wert Camera3D.CameraPresetNone.


maxZoomLevel : real

Legt die maximal zulässige Zoomstufe der Kamera fest. Wenn die neue maximale Stufe niedriger ist als die vorhandene minimale Stufe, wird die minimale Stufe ebenfalls an die neue maximale Stufe angepasst. Wenn die aktuelle zoomLevel außerhalb der neuen Grenzen liegt, wird sie ebenfalls angepasst. Die Standardeinstellung ist 500.0f.

Siehe auch zoomLevel und minZoomLevel.


minZoomLevel : real

Legt die minimal zulässige Zoomstufe der Kamera fest. Wenn die neue Mindeststufe höher ist als die vorhandene Höchststufe, wird die Höchststufe ebenfalls an die neue Mindeststufe angepasst. Wenn die aktuelle zoomLevel außerhalb der neuen Grenzen liegt, wird sie ebenfalls angepasst. Der minZoomLevel kann nicht unter 1.0 gesetzt werden. Der Standardwert ist 10.0.

Siehe auch zoomLevel und maxZoomLevel.


target : vector3d [since QtDataVisualization 1.2]

Das Kameraziel als vector3d. Der Standardwert ist vector3d(0.0, 0.0, 0.0).

Gültige Koordinatenwerte liegen zwischen -1.0...1.0, wobei die Randwerte die Ränder des entsprechenden Achsenbereichs angeben. Alle Werte außerhalb dieses Bereichs werden an den Rand geklemmt.

Hinweis: Bei Balkendiagrammen wird die Y-Koordinate ignoriert und die Kamera zielt immer auf einen Punkt auf dem horizontalen Hintergrund.

Diese Eigenschaft wurde in QtDataVisualization 1.2 eingeführt.


wrapXRotation : bool

Das Verhalten der minimalen und maximalen Grenzen in der X-Drehung. Standardmäßig verläuft die X-Drehung vom Minimalwert zum Maximum und vom Maximum zum Minimum.

Bei der Einstellung true wird die X-Drehung der Kamera vom Minimum zum Maximum und vom Maximum zum Minimum umgeschlagen. Bei der Einstellung false ist die X-Drehung der Kamera auf den durch den Minimal- und Maximalwert bestimmten Sektor begrenzt.


wrapYRotation : bool

Das Verhalten der Minimal- und Maximalwerte bei der Y-Drehung. Standardmäßig wird die Y-Drehung zwischen dem Minimal- und dem Maximalwert begrenzt, ohne dass ein Umbruch stattfindet.

Wenn true angegeben ist, wird die Y-Drehung der Kamera vom Minimum zum Maximum und vom Maximum zum Minimum umbrochen. Bei false ist die Y-Drehung der Kamera auf den durch den Minimal- und den Maximalwert bestimmten Sektor begrenzt.


xRotation : real

Der X-Drehwinkel der Kamera um den Zielpunkt in Grad, ausgehend von der aktuellen Basisposition.


yRotation : real

Der Y-Drehwinkel der Kamera um den Zielpunkt in Grad, ausgehend von der aktuellen Basisposition.


zoomLevel : real

Die Zoomstufe der Kamera in Prozent. Der Standardwert 100.0 bedeutet, dass die Kamera nicht vergrößert oder verkleinert werden kann. Der Wert wird durch die Eigenschaften minZoomLevel und maxZoomLevel begrenzt.

Siehe auch minZoomLevel und maxZoomLevel.


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