Camera QML Type

定义渲染场景的视点。更多

• 所有成员（包括继承成员）列表
• 已废弃成员

属性

• aspectRatio : real
• bottom : real
• exposure : real
• farPlane : real
• fieldOfView : real
• left : real
• lens : CameraLens
• nearPlane : real
• position : vector3d
• projectionMatrix : matrix4x4
• projectionType : enumeration
• right : real
• top : real
• transform : Transform
• upVector : vector3d
• viewCenter : vector3d
• viewVector : vector3d

方法

• void pan(real angle)
• void pan(real angle, vector3d axis)
• void panAboutViewCenter(real angle)
• void panAboutViewCenter(real angle, vector3d axis)
• quaternion panRotation(real angle)
• void roll(real angle)
• void rollAboutViewCenter(real angle)
• quaternion rollRotation(real angle)
• void rotate(quaternion q)
• void rotateAboutViewCenter(quaternion q)
• quaternion rotation(real angle, vector3d axis)
• void tilt(real angle)
• void tiltAboutViewCenter(real angle)
• quaternion tiltRotation(real angle)
• void translate(vector3d vLocal, enumeration 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

保存当前摄像机的远平面。距离摄像机比远平面更远的物体将不会被渲染。

fieldOfView : real

摄像机当前垂直视场的度数。

与aspectRatio 一样，该属性决定了摄像机能看到多少场景。在这方面，您可以认为它类似于选择广角镜头（水平视野宽）或长焦镜头（水平视野窄），这取决于您想捕捉多少场景。

只有当projectionType 是CameraLens.PerspectiveProjection 时，fieldOfView 才有意义。

left : real

当前摄像机左侧的位置。

此属性仅在projectionType 是CameraLens.OrthographicProjection 时才有用。

lens : CameraLens [read-only]

保存摄像机的CameraLens 组件。

nearPlane : real

保存当前摄像机的近平面。距离摄像机比近平面更近的物体将不会被渲染。

position : vector3d

保存摄像机相对于父实体的当前位置坐标。

projectionMatrix : matrix4x4

保存摄像机当前的投影矩阵。

projectionType : enumeration

摄像机投影类型。默认值为CameraLens.PerspectiveProjection。

• CameraLens.OrthographicProjection - 平行线显示为平行。无论距离远近，物体看起来大小相同。
• CameraLens.PerspectiveProjection - 平行线在远处相交。物体距离摄像机越远，看起来就越小。
• CameraLens.透视投影
• CameraLens.自定义投影

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

right : real

保留摄像机当前的右侧位置。

此属性仅在projectionType 是CameraLens.OrthographicProjection 时才有用。

top : real

保持当前摄像机的顶部。

该属性仅在projectionType 是CameraLens.OrthographicProjection.OrthographicProjection.OrthographicProjection.OrthographicProjection.OrthographicProjection.OrthographicProjection 时有效。

transform : Transform [read-only]

保存摄像机的变换分量。

upVector : vector3d

保存摄像机相对于父实体的当前向上矢量坐标。

向上矢量表示相机顶部朝向的方向。想象一下拍照：在定位并将相机对准目标后，您可能会左右旋转相机，从而获得纵向或横向（或倾斜！）的照片。

viewCenter : vector3d

以相对于父实体的坐标形式保存摄像机的当前视图中心。

直观地说，视图中心就是摄像机指向的位置。

viewVector : vector3d [read-only]

保存摄像机相对于父实体的坐标视图向量。

该向量描述了从摄像机 (position) 到目标 (viewCenter) 的位移。

方法文档

void pan(real angle)

通过angle 调整摄像机的摇摄角度，单位为度。

void pan(real angle, vector3d axis)

通过angle 调整摄像机围绕视图中心的摇摄，单位为度，axis 。

void panAboutViewCenter(real angle)

以angle 为单位，调整摄像机围绕视图中心的摇摄角度。

void panAboutViewCenter(real angle, vector3d axis)

通过angle 调整摄像机围绕视图中心的摇摄，单位为度，axis 。

quaternion panRotation(real angle)

返回相对于angle 计算出的摇摄旋转角度，单位为度，用于调整摄像机在 Y 轴上的摇摄或左右旋转。

void roll(real angle)

通过angle 调整相机滚动，单位为度。

void rollAboutViewCenter(real angle)

以angle 为单位，围绕视图中心调整相机滚动。

quaternion rollRotation(real angle)

返回计算出的相对于angle 的滚动旋转角度，以调整摄像机在 Z 轴上的滚动或左右倾斜旋转。

void rotate(quaternion q)

在q 中使用四元数旋转摄像机。

void rotateAboutViewCenter(quaternion q)

使用q 中的四元数将摄像机围绕视图中心旋转。

quaternion rotation(real angle, vector3d axis)

返回计算出的相对于angle 的旋转角度，单位为度，并选择axis 。

void tilt(real angle)

通过angle 调整摄像机的倾斜角度，单位为度。

void tiltAboutViewCenter(real angle)

通过angle （单位：度）调整摄像机围绕视图中心的倾斜度。

quaternion tiltRotation(real angle)

返回相对于angle 计算出的倾斜旋转角度，单位为度，用于调整摄像机在 X 轴上的倾斜或上下旋转。

void translate(vector3d vLocal, enumeration option)

通过vLocal 在本地坐标中平移摄像机的位置和视图矢量。option 允许切换是否要平移视图中心。

• Camera.TranslateViewCenter
• Camera.DontTranslateViewCenter

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

void translateWorld(vector3d vWorld, enumeration option)

通过vWorld 在世界坐标中平移摄像机的位置和视图矢量。option 允许切换是否要平移视图中心。

• Camera.TranslateViewCenter
• Camera.DontTranslateViewCenter

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

void viewAll()

旋转并移动摄像机，使其viewCenter 成为场景边界体的中心，并使整个场景都能在视口中显示。

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

void viewEntity(Entity entity)

旋转并移动摄像机，使其viewCenter 成为实体边界体积的中心，并使整个entity 适合视口。

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

void viewSphere(vector3d center, real radius)

旋转并移动摄像机，使其viewCenter 是center ，并使radius 的球体与视口相吻合。

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