Camera3D QML Type
相机在三维空间中的表示。更多...
| Import Statement: | import QtDataVisualization 1.12 |
| Since: | QtDataVisualization 1.0 |
| In C++: | Q3DCamera |
| Status: | Deprecated |
此类型已弃用。我们强烈建议不要在新代码中使用它。
属性
- cameraPreset : Camera3D.CameraPreset
- maxZoomLevel : real
- minZoomLevel : real
- target : vector3d
(since QtDataVisualization 1.2) - wrapXRotation : bool
- wrapYRotation : bool
- xRotation : real
- yRotation : real
- zoomLevel : real
详细说明
Camera3D 表示一个围绕中心点旋转的基本 3D 摄像机,用于渲染数据可视化。该类型提供了简单的方法,用于围绕原点旋转摄像机以及设置缩放级别。
有关 Camera3D 的枚举,请参阅Q3DCamera::CameraPreset 。
属性文档
cameraPreset : Camera3D.CameraPreset
当前激活的相机预设,该预设属于Camera3D.CameraPreset 之一。如果未激活任何预设,则该值为Camera3D.CameraPresetNone 。
maxZoomLevel : real
设置允许的最高相机缩放级别。如果新设的最高级别低于现有的最低级别,则最低级别也会相应调整为新的最高级别。如果当前的zoomLevel 超出新设的范围,也会进行相应调整。默认值为500.0f 。
另请参阅 zoomLevel 和minZoomLevel 。
minZoomLevel : real
设置允许的最小相机缩放级别。如果新的最小级别高于现有的最大级别,则最大级别也会调整为新的最小级别。如果当前的zoomLevel 超出新范围,也会相应调整。minZoomLevel不能设置为低于1.0 。默认值为10.0 。
另请参阅 zoomLevel 和maxZoomLevel 。
target : vector3d [since QtDataVisualization 1.2]
摄像机目标以 Vector3d 形式表示。默认值为vector3d(0.0, 0.0, 0.0) 。
有效的坐标值范围为-1.0...1.0 ,其中边界值表示相应轴范围的边界。超出此范围的任何值都会被限制在边界内。
注意:对于 条形图,Y坐标将被忽略,且摄像机始终对准水平背景上的某一点。
该属性在 QtDataVisualization 1.2 中引入。
wrapXRotation : bool
X 轴旋转中最小值和最大值的处理方式。默认情况下,X 轴旋转会从最小值循环到最大值,再从最大值循环回最小值。
若设置为true ,摄像机的 X 轴旋转将从最小值循环到最大值,再从最大值循环回最小值。若设置为false ,摄像机的 X 轴旋转将限定在由最小值和最大值确定的扇区内。
wrapYRotation : bool
Y 轴旋转中最小值和最大值的限制行为。默认情况下,Y 轴旋转在最小值和最大值之间受限,且不进行循环。
如果true ,摄像机的 Y 轴旋转将从最小值循环到最大值,再从最大值循环回最小值。如果false ,摄像机的 Y 轴旋转将限制在由最小值和最大值确定的扇区范围内。
xRotation : real
相机以目标点为轴,从当前基准位置开始的X轴旋转角度(单位:度)。
yRotation : real
相机以目标点为轴,从当前基准位置开始的Y轴旋转角度(单位:度)。
zoomLevel : real
摄像机的缩放级别(以百分比表示)。默认值100.0 表示摄像机未设置任何缩放。该值受minZoomLevel 和maxZoomLevel 属性的限制。
另请参阅 minZoomLevel 和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.