相机 QML 类型

定义了一个视点，通过这个视点将渲染场景。更多信息...

导入语句	import Qt3D.Render 2.7
实例化	QCamera
继承	Entity

属性

aspectRatio : 双精度浮点数
bottom : 双精度浮点数
exposure : 双精度浮点数
farPlane : 双精度浮点数
fieldOfView : 双精度浮点数
left : 双精度浮点数
lens : CameraLens
nearPlane : 双精度浮点数
position : 三维向量
projectionMatrix : 4x4 矩阵
projectionType : 枚举
right : 双精度浮点数
top : 双精度浮点数
transform : 变换
upVector : 三维向量
viewCenter : 三维向量
viewVector : 三维向量

方法

void pan(双精度浮点数 angle)
void pan(双精度浮点数 angle, 三维向量 axis)
void panAboutViewCenter(双精度浮点数 angle)
void panAboutViewCenter(双精度浮点数 angle, 三维向量 axis)
quaternion panRotation(双精度浮点数 angle)
void roll(双精度浮点数 angle)
void rollAboutViewCenter(双精度浮点数 angle)
quaternion rollRotation(双精度浮点数 angle)
void rotate(quaternion q)
void rotateAboutViewCenter(quaternion q)
quaternion rotation(双精度浮点数 angle, 三维向量 axis)
void tilt(双精度浮点数 angle)
void tiltAboutViewCenter(双精度浮点数 angle)
quaternion tiltRotation(双精度浮点数 angle)
void translate(三维向量 vLocal, 枚举 option)
void translateWorld(vector3d vWorld, enumeration option)
void viewAll()
void viewEntity(Entity entity)
void viewSphere(vector3d center, real radius)

详细描述

属性文档

aspectRatio : real

保存相机当前宽高比。

bottom : real

保存相机当前底部。

当 projectionType 是 CameraLens.OrthographicProjection 时，此属性才相关。

exposure : real

保存相机当前曝光度。

默认值是 0.0。

Qt 3D Extras 中的 MetalRoughMaterial 是目前唯一使用相机曝光度的提供材料。负值会使材料变暗，正值会使材料变亮。

自定义材料可能选择不同的解释值。

farPlane : real

保存相机当前远平面。距离相机超过 farPlane 的对象不会被渲染。

fieldOfView : real

保存相机当前垂直视野的度数。

与 aspectRatio 一起，此属性确定场景可视范围。在这方面，你可以将其视为选择广角镜头（宽水平视野）或长焦镜头（窄水平视野），具体取决于你想要捕捉多少场景。

fieldOfView 只有在 projectionType 是 CameraLens.PerspectiveProjection 时才相关。

left : real

保存相机当前左侧。

当 projectionType 是 CameraLens.OrthographicProjection 时，此属性才相关。

lens : CameraLens [只读]

保存相机的 CameraLens 组件。

nearPlane : real

保存相机当前近平面。距离相机较近的对象不会被渲染。

position : vector3d

保存相机相对于父实体的坐标位置。

projectionMatrix : matrix4x4

保存相机当前的投影矩阵。

projectionType : enumeration

保存相机投影的类型。默认值是 CameraLens.PerspectiveProjection。

CameraLens.OrthographicProjection - 平行线看起来平行。无论距离多远，物体看起来都是同样大小。
CameraLens.PerspectiveProjection - 平行线看起来在远处相交。物体离相机越远，看起来越小。
CameraLens.FrustumProjection
CameraLens.CustomProjection

另请参阅 Qt3DRender::QCameraLens::ProjectionType.

right : real

保存相机当前右侧。

当 projectionType 是 CameraLens.OrthographicProjection 时，此属性才相关。

top : real

保存相机当前顶部。

当 projectionType 是 CameraLens.OrthographicProjection 时，此属性才相关。

transform : Transform [只读]

保存相机的变换组件。

upVector : vector3d

保存相机相对于父实体的当前向上向量。

向上向量指示相机顶部朝向哪个方向。想象拍照：在你自己定位并指向目标后，你可能左右旋转相机，得到肖像或风景（或斜角！）拍摄。upVector允许你控制此类移动。

viewCenter : vector3d

保存相机相对于父实体的当前视中心。

直观地，viewCenter是摄像机所指向的位置。

viewVector : vector3d [只读]

保存相对于父实体的相机视向量。

此向量描述了从相机（position）到其目标（viewCenter）的位移。

方法文档

void pan(real angle)

通过angle度数调整相机的平移角。

void pan(real angle, vector3d axis)

通过axis在视中心周围通过angle度数调整相机的平移。

void panAboutViewCenter(real angle)

通过angle度数在视中心周围调整相机的平移。

void panAboutViewCenter(real angle, vector3d axis)

通过axis在视中心周围通过angle度数调整相机的平移。

quaternion panRotation(real angle)

返回根据angle度数计算的平移旋转，用于调整相机的平移或Y轴上的左右旋转。

void roll(real angle)

通过angle度数调整相机的滚动。

void rollAboutViewCenter(real angle)

通过angle度数在视中心周围调整相机的滚动。

quaternion rollRotation(real angle)

返回根据angle度数计算的滚动旋转，用于调整相机的滚动或左右倾斜旋转。

void rotate(quaternion q)

使用 Quaternion q 来旋转相机。

void rotateAboutViewCenter(quaternion q)

使用 Quaternion q 在视中心周围旋转相机。

四元数旋转(实数 angle, 三维向量 axis)

返回与所选angle度数和axis相关的计算旋转。

void 倾斜(实数 angle)

通过angle度数调整相机的倾斜角度。

void 绕视中心倾斜(实数 angle)

通过angle度数调整相机绕视中心的倾斜。

四元数倾斜旋转(实数 angle)

返回与在angle度数调整相机的倾斜或X轴上的上下旋转相关的计算倾斜旋转。

void 平移(三维向量 vLocal, 枚举 option)

通过局部坐标系中的vLocal平移相机的位置和视线向量。该option允许切换是否平移视中心。

Camera.TranslateViewCenter
Camera.DontTranslateViewCenter

另请参阅 Qt3DRender::QCamera::CameraTranslationOption.

void worldTranslate(三维向量 vWorld, 枚举 option)

通过世界坐标中的vWorld平移相机的位置和视线向量。该option允许切换是否平移视中心。

Camera.TranslateViewCenter
Camera.DontTranslateViewCenter

另请参阅 Qt3DRender::QCamera::CameraTranslationOption.

void 查看所有内容()

旋转和移动相机，使其viewCenter是场景边界框的中心，并且整个场景适合在视口中。

注意： 仅在透镜处于透视或正交投影模式时才适用。

另请参阅 Qt3D.Render::Camera::projectionType.

void 查看实体(实体 entity)

旋转和移动相机，使其viewCenter是实体的边界框中心，并且整个entity适合在视口中。

注意： 仅在透镜处于透视或正交投影模式时才适用。

另请参阅 Qt3D.Render::Camera::projectionType.

void 查看球体(三维向量 center, 实数 radius)

旋转和移动相机，使其viewCenter为center，并且一个半径为radius的球体适合在视口中。

注意： 仅在透镜处于透视或正交投影模式时才适用。

另请参阅 Qt3D.Render::Camera::projectionType.