이 페이지에서

FrustumCamera QML Type

사용자 정의 프러스텀을 가진 사각뿔( PerspectiveCamera )을 정의합니다. 더 보기...

Import Statement: import QtQuick3D
Inherits:

PerspectiveCamera

속성

상세 설명

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

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

FrustumCamera 타입은 원뿔형 시야(frustum)의 경계를 사용자 정의할 수 있는 ` PerspectiveCamera `를 제공합니다. 이는 비대칭적인 원뿔형 시야를 생성하는 데 유용할 수 있습니다.

far plane다음 예제는 씬 내 [0, 0, 100] 위치에 FrustumCamera를 생성합니다. 원뿔형 시야( near plane )는 카메라 앞쪽 원점으로부터 100 단위 떨어진 곳에 위치합니다. 프러스텀과 근평면(near plane)의 교차 영역은 왼쪽 하단 모서리가 [-5, -5]에, 오른쪽 상단 모서리가 [5, 5]에 위치한 직사각형으로 정의되며, 카메라에서 1000 유닛 떨어진 위치인 [0, 0, -900] 위치에 있습니다.

참고: 원뿔의 각도( vertical field of view )는 카메라와 원뿔의 기저면( near plane ) 사이의 거리, 그리고 근면(near plane)의 좌측 모서리( top )와 우측 모서리( bottom ) 사이의 길이의 곱입니다.

참고: 상단과 하단, 또는 좌우 값이 비대칭인경우 , 원뿔의 정점이 이동하게 되어 결과적으로 카메라가 원래 위치에서 어긋나게 됩니다.

FrustumCamera {
    position: Qt.vector3d(0, 0, 100)
    clipNear: 100
    clipFar: 1000
    top: 5
    bottom: -5
    left: -5
    right: 5
}

관련 항목: PerspectiveCamera, OrthographicCamera, CustomCamera.

속성 설명서

bottom : real

bottom 값은 로컬 좌표계에서 카메라의 위치를 기준으로 한 near clip plane 의 하단 위치를 지정합니다.

left : real

left 값은 로컬 좌표계에서 카메라의 위치를 기준으로 한, near clip plane 의 왼쪽 위치를 지정합니다.

right : real

right 값은 로컬 좌표계에서 카메라의 위치를 기준으로 한 near clip plane 의 위치를 지정합니다.

top : real

top 값은 로컬 좌표계에서 카메라의 위치를 기준으로 한 near clip plane 의 상단 위치를 지정합니다.

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