Camera QML Type

씬을 렌더링할 뷰 포인트를 정의합니다. 더 보기...

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

Entity

Status: Deprecated

속성

방법

상세 설명

속성 문서

aspectRatio : real

카메라의 현재 종횡비를 보유합니다.


bottom : real

카메라의 현재 하단을 보유합니다.

이 프로퍼티는 projectionTypeCameraLens.OrthographicProjection 일 때만 관련됩니다.


exposure : real

카메라의 현재 노출을 보유합니다.

기본값은 0.0입니다.

Qt 3D Extras의 MetalRoughMaterial 는 현재 카메라 노출을 사용하는 유일한 제공된 머티리얼입니다. 음수 값은 머티리얼을 더 어둡게, 양수 값은 더 밝게 만듭니다.

커스텀 머티리얼은 이 값을 다르게 해석하도록 선택할 수 있습니다.


farPlane : real

카메라의 현재 카메라 원거리 평면을 유지합니다. 원거리 평면보다 카메라에서 멀리 있는 오브젝트는 렌더링되지 않습니다.


fieldOfView : real

카메라의 현재 수직 시야를 도 단위로 보유합니다.

이 프로퍼티는 aspectRatio 와 함께 카메라에 표시되는 씬의 범위를 결정합니다. 이 점에서 캡처하려는 장면의 크기에 따라 광각(넓은 수평 시야) 또는 망원(좁은 수평 시야) 렌즈를 선택하는 것과 비슷하다고 생각할 수 있습니다.

fieldOfView는 projectionTypeCameraLens.PerspectiveProjection일 때만 관련이 있습니다.


left : real

카메라의 현재 왼쪽을 유지합니다.

이 프로퍼티는 projectionTypeCameraLens.OrthographicProjection 일 때만 관련됩니다.


lens : CameraLens [read-only]

카메라의 CameraLens 컴포넌트를 유지합니다.


nearPlane : real

카메라의 현재 카메라를 카메라의 평면에 가깝게 유지합니다. 근거리 평면보다 카메라에 더 가까운 오브젝트는 렌더링되지 않습니다.


position : vector3d

카메라의 현재 위치를 부모 엔티티를 기준으로 한 좌표로 유지합니다.


projectionMatrix : matrix4x4

카메라의 현재 투영 매트릭스를 보유합니다.


projectionType : enumeration

카메라 투영의 유형을 보유합니다. 기본값은 CameraLens.PerspectiveProjection입니다.

  • CameraLens.직교 투영 - 평행선을 평행하게 표시합니다. 개체는 거리에 관계없이 같은 크기로 표시됩니다.
  • CameraLens.PerspectiveProjection - 평행선이 원거리에서 만나는 것처럼 보입니다. 오브젝트는 카메라에서 멀어질수록 축소되어 나타납니다.
  • CameraLens.프러스텀투영
  • CameraLens.CustomProjection

Qt3DRender::QCameraLens::ProjectionType참조하십시오 .


right : real

카메라의 현재 오른쪽을 유지합니다.

이 프로퍼티는 projectionTypeCameraLens.직교 투영일 때만 관련됩니다.


top : real

카메라의 현재 상단을 유지합니다.

이 프로퍼티는 projectionTypeCameraLens.직교 투영일 때만 관련됩니다.


transform : Transform [read-only]

카메라의 트랜스폼 컴포넌트를 보유합니다.


upVector : vector3d

카메라의 현재 위쪽 벡터를 부모 엔티티를 기준으로 한 좌표로 유지합니다.

위쪽 벡터는 카메라의 상단이 어느 방향을 향하고 있는지를 나타냅니다. 사진을 찍는다고 생각해보세요. 자신의 위치를 정하고 카메라를 대상에 맞춘 후 카메라를 왼쪽이나 오른쪽으로 회전하여 세로 또는 가로(또는 앵글!) 사진을 찍을 수 있습니다. upVector를 사용하면 이러한 유형의 움직임을 제어할 수 있습니다.


viewCenter : vector3d

카메라의 현재 뷰 중심을 부모 엔티티를 기준으로 한 좌표로 유지합니다.

직관적으로 뷰센터는 카메라가 가리키고 있는 위치입니다.


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)

카메라의 롤 또는 Z축의 왼쪽/오른쪽 회전을 조정하기 위해 입력한 angle 을 기준으로 계산된 롤 회전을 각도 단위로 반환합니다.


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)

카메라의 기울기 또는 X축의 위/아래 회전을 조정하기 위해 입력한 angle 에 대해 계산된 기울기 회전을 반환합니다.


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)

viewCentercenter 이 되고 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.