Auf dieser Seite

Camera3D QML Type

Darstellung einer Kamera im 3D-Raum. Mehr...

Import Statement: import QtDataVisualization 1.12
Since: QtDataVisualization 1.0
In C++: Q3DCamera
Status: Deprecated

Dieser Typ ist veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.

Eigenschaften

Ausführliche Beschreibung

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

Informationen zu den Enums von „Camera3D“ finden Sie unter Q3DCamera::CameraPreset.

Dokumentation der Eigenschaften

cameraPreset : Camera3D.CameraPreset

Die derzeit aktive Kameravoreinstellung, die zu Camera3D.CameraPreset gehört. Ist keine Voreinstellung aktiv, lautet der Wert Camera3D.CameraPresetNone.

maxZoomLevel : real

Legt den maximal zulässigen Zoomfaktor der Kamera fest. Wenn der neue Maximalwert unter dem bestehenden Minimalwert liegt, wird auch der Minimalwert an den neuen Maximalwert angepasst. Liegt der aktuelle Wert „ zoomLevel “ außerhalb der neuen Grenzen, wird er ebenfalls angepasst. Der Standardwert ist „ 500.0f “.

Siehe auch „ zoomLevel “ und „ minZoomLevel “.

minZoomLevel : real

Legt den minimal zulässigen Zoomfaktor der Kamera fest. Wenn der neue Mindestwert höher ist als der bisherige Höchstwert, wird auch der Höchstwert an den neuen Mindestwert angepasst. Liegt der aktuelle Wert „ zoomLevel “ außerhalb der neuen Grenzen, wird er ebenfalls angepasst. Der Wert „minZoomLevel“ kann nicht unter „ 1.0 “ festgelegt werden. Der Standardwert ist „ 10.0 “.

Siehe auch „ zoomLevel “ und „ maxZoomLevel “.

target : vector3d [since QtDataVisualization 1.2]

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

Gültige Koordinatenwerte liegen im Bereich von -1.0...1.0, wobei die Randwerte die Grenzen des entsprechenden Achsenbereichs angeben. Werte außerhalb dieses Bereichs werden auf den Randwert begrenzt.

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 Minimal- und Maximalgrenzen bei der X-Drehung. Standardmäßig wechselt die X-Drehung vom Minimalwert zum Maximalwert und vom Maximalwert zum Minimalwert.

Bei der Einstellung „ true “ wird die X-Drehung der Kamera vom Minimalwert zum Maximalwert und vom Maximalwert zum Minimalwert umgeschaltet. Bei der Einstellung „ false “ wird die X-Drehung der Kamera auf den durch den Minimal- und Maximalwert bestimmten Sektor beschränkt.

wrapYRotation : bool

Das Verhalten der Minimal- und Maximalgrenzen bei der Y-Drehung. Standardmäßig ist die Y-Drehung auf den Minimal- und Maximalwert begrenzt, ohne dass ein Umschwung erfolgt.

Wenn „ true “ gesetzt ist, wird die Y-Drehung der Kamera vom Minimalwert zum Maximalwert und vom Maximalwert zum Minimalwert umgeschaltet. Wenn „ false “ gesetzt ist, ist die Y-Drehung der Kamera auf den durch den Minimal- und Maximalwert bestimmten Sektor beschränkt.

xRotation : real

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

yRotation : real

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

zoomLevel : real

Der Zoomfaktor der Kamera in Prozent. Der Standardwert „ 100.0 “ bedeutet, dass in der Kamera kein Zoom ein- oder ausgezoomt ist. Der Wert wird durch die Eigenschaften „ minZoomLevel “ und „ maxZoomLevel “ begrenzt.

Siehe auch „ minZoomLevel “ und „ maxZoomLevel “.

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