이 페이지에서

PerspectiveCamera QML Type

3D 씬의 콘텐츠를 보기 위한 퍼스펙티브 카메라를 정의합니다. 더 보기...

Import Statement: import QtQuick3D
Inherits:

Camera

Inherited By:

FrustumCamera

속성

상세 설명

Camera 는 3D 씬의 콘텐츠가 View3D 와 같은 2D 표면에 어떻게 투영되는지를 정의합니다. 씬의 콘텐츠를 시각화하려면 최소한 하나의 Camera 가 필요합니다.

Camera 는 씬 내의 다른 공간적 Node 와 마찬가지로 위치와 방향을 조정할 수 있습니다. Node 의 위치와 방향에 따라 Camera 가 씬 내에서 어디에 위치하고 어떤 방향을 향하는지가 결정됩니다. Camera 의 기본 방향은 전방 벡터가 음의 Z축을 향하고, 상향 벡터가 양의 Y축을 향하도록 설정되어 있습니다.

원근법 카메라 투영도

PerspectiveCamera는 표준 투시 투영( Camera ) 유형입니다. 이 카메라는 멀리 있는 물체가 더 작게 보이는 등, 장면을 사실적으로 투영합니다. 원뿔형 시야(frustum)는 fieldOfView 속성과 근거리 및 원거리 클립 평면(near and far clip planes)에 의해 정의됩니다.

다음 예제는 장면 내 위치 [0, 200, 300]에 시야각 90도, 하향 피치 30도의 PerspectiveCamera를 생성합니다.

PerspectiveCamera {
    position: Qt.vector3d(0, 200, 300)
    eulerRotation.x: -30
    fieldOfView: 90
}

Qt Quick 3D - View3D 예제, OrthographicCamera, FrustumCamera 및 CustomCamera도 참조하십시오 .

속성 설명서

clipFar : real

이 속성은 PerspectiveCamera 의 프러스텀(frustum)에 대한 원거리 클립 평면을 정의합니다. 원거리 클립 평면보다 Camera 에서 더 멀리 떨어진 지오메트리는 표시되지 않습니다.

기본값은 10000.0입니다. 단위는 사용자의 지오메트리 단위에 따라 다르며, 이 값은 전역 카메라 위치를 기준으로 합니다.

clipNear : real

이 속성은 PerspectiveCamera 의 프러스텀(frustum)에 대한 근접 클립 평면을 정의합니다. 근접 클립 평면보다 Camera 에 더 가까운 지오메트리는 표시되지 않습니다.

기본값은 10.0입니다. 단위는 사용자의 지오메트리 단위에 따라 다르며, 이 값은 전역 카메라 위치를 기준으로 합니다.

fieldOfView : real

이 속성은 카메라의 시야각을 도(degree) 단위로 저장합니다. 이 값은 ‘ fieldOfViewOrientation ’ 속성이 ‘ PerspectiveCamera.Vertical ’로 설정되었는지, 아니면 ‘ PerspectiveCamera.Horizontal ’로 설정되었는지에 따라 수직 시야각이 되거나 수평 시야각이 됩니다.

기본값은 60.0입니다.

fieldOfViewOrientation : enumeration

이 속성은 카메라 시야각이 지정된 방향을 나타냅니다.

상수설명
PerspectiveCamera.Vertical제공된 시야각은 수직 시야각이며, 이는 시야각이 카메라에서 뷰포트의 상단 중앙까지 이어지는 선과 카메라에서 뷰포트의 하단 중앙까지 이어지는 선 사이의 각도를 의미합니다. 종횡비를 유지하기 위해 가로 종횡비가 조정됩니다.
PerspectiveCamera.Horizontal지정된 시야각은 수평 방향이며, 이는 시야각이 카메라에서 뷰포트의 왼쪽 중앙까지 그은 선과 카메라에서 뷰포트의 오른쪽 중앙까지 그은 선 사이의 각도임을 의미합니다. 종횡비를 유지하기 위해 가로 종횡비가 조정됩니다.

기본값은 PerspectiveCamera.Vertical 입니다.

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