Back to Qt.io
Contact Us Blog Download Qt

Camera QML Type

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

Import Statement: import Qt3D.Render 2.9
In C++: QCamera
Inherits:

Entity

Status: Deprecated

属性

方法

详细说明

属性文档

aspectRatio : real

保存摄像机当前的宽高比。


bottom : real

保存摄像机的当前底部。

此属性仅在projectionType 是CameraLens.OrthographicProjection 时相关。


exposure : real

保存摄像机当前的曝光度。

默认值为 0.0。

Qt 3D Extras 中的MetalRoughMaterial 是目前唯一使用摄像机曝光的素材。负值会使材质变暗，正值会使材质变亮。

自定义材质可以选择不同的值。


farPlane : real

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


fieldOfView : real

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

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

fieldOfView 仅在projectionType 是CameraLens.PerspectiveProjection.


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 时才相关。


transform : Transform [read-only]

保存摄像机的变换分量。


upVector : vector3d

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

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


viewCenter : vector3d

视图中心（viewCenter）：以相对于父实体的坐标表示摄像机的当前视图中心。

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


viewVector : vector3d [read-only]

以相对于父实体的坐标表示摄像机的视图矢量。

该向量描述了从摄像机 (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)

返回计算出的平移旋转角度，以调整摄像机在 Y 轴上的平移或左右旋转时所采用的angle 度为单位。


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 。


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