在本页

Camera3D QML Type

摄像机在三维空间中的表现形式。更多

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

属性

详细说明

Camera3D 表示在渲染数据可视化时使用的围绕中心点的基本轨道三维摄像头。该类型提供了围绕原点旋转摄像头和设置缩放级别的简单方法。

有关 Camera3D 枚举,请参阅Q3DCamera::CameraPreset

属性文档

cameraPreset : Camera3D.CameraPreset

当前激活的摄像机预置,是Camera3D.CameraPreset 中的一个。如果没有激活预置,则值为Camera3D.CameraPresetNone

maxZoomLevel : real

设置允许的最大摄像机缩放级别。如果新的最大级别低于现有的最小级别,则最小级别也会调整为新的最大级别。如果当前的zoomLevel 超出了新的范围,也会进行调整。默认为500.0f

另请参阅 zoomLevelminZoomLevel

minZoomLevel : real

设置允许的最小摄像机缩放级别。如果新的最小级别高于现有的最大级别,则最大级别也会调整为新的最小级别。如果当前的zoomLevel 超出了新的范围,也会进行调整。minZoomLevel 不能设置为低于1.0 。默认值为10.0

另请参阅 zoomLevelmaxZoomLevel

target : vector3d [since QtDataVisualization 1.2]

摄像机目标的向量 3d。默认为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 表示摄像机没有设置放大或缩小。该值受minZoomLevelmaxZoomLevel 属性的限制。

另请参阅 minZoomLevelmaxZoomLevel

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