이 페이지에서

Camera QML Type

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

Import Statement: import Qt3D.Render 2.11
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.OrthographicProjection 일 때만 관련됩니다.

top : real

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

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

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도 참조하세요 .

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