Qt3DRender::QCameraLens Class
class Qt3DRender::QCameraLensQt3DRender::QCameraLens 3D 씬의 카메라를 정의하는 데 사용될 투영 행렬을 지정합니다. 더 보기...
| 헤더: | #include <Qt3DRender/QCameraLens> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3drender) target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake: | QT += 3drender |
| QML에서: | CameraLens |
| 상속: | Qt3DCore::QComponent |
| 상태: | 사용 중단됨 |
이 클래스는 더 이상 사용되지 않습니다. 새로운 코드에서는 이 클래스를 사용하지 않는 것을 강력히 권장합니다.
공개 타입
| enum | ProjectionType { OrthographicProjection, PerspectiveProjection, FrustumProjection, CustomProjection } |
속성
|
|
공개 함수
| QCameraLens(Qt3DCore::QNode *parent = nullptr) | |
| float | aspectRatio() const |
| float | bottom() const |
| float | exposure() const |
| float | farPlane() const |
| float | fieldOfView() const |
| float | left() const |
| float | nearPlane() const |
| QMatrix4x4 | projectionMatrix() const |
| Qt3DRender::QCameraLens::ProjectionType | projectionType() const |
| float | right() const |
| void | setFrustumProjection(float left, float right, float bottom, float top, float nearPlane, float farPlane) |
| void | setOrthographicProjection(float left, float right, float bottom, float top, float nearPlane, float farPlane) |
| void | setPerspectiveProjection(float fieldOfView, float aspectRatio, float nearPlane, float farPlane) |
| float | top() const |
공개 슬롯
| void | setAspectRatio(float aspectRatio) |
| void | setBottom(float bottom) |
| void | setExposure(float exposure) |
| void | setFarPlane(float farPlane) |
| void | setFieldOfView(float fieldOfView) |
| void | setLeft(float left) |
| void | setNearPlane(float nearPlane) |
| void | setProjectionMatrix(const QMatrix4x4 &projectionMatrix) |
| void | setProjectionType(Qt3DRender::QCameraLens::ProjectionType projectionType) |
| void | setRight(float right) |
| void | setTop(float top) |
신호
| void | aspectRatioChanged(float aspectRatio) |
| void | bottomChanged(float bottom) |
| void | exposureChanged(float exposure) |
| void | farPlaneChanged(float farPlane) |
| void | fieldOfViewChanged(float fieldOfView) |
| void | leftChanged(float left) |
| void | nearPlaneChanged(float nearPlane) |
| void | projectionMatrixChanged(const QMatrix4x4 &projectionMatrix) |
| void | projectionTypeChanged(Qt3DRender::QCameraLens::ProjectionType projectionType) |
| void | rightChanged(float right) |
| void | topChanged(float top) |
멤버 유형 문서
enum QCameraLens::ProjectionType
Qt3DRender::QCameraLens 의 어떤 매개변수를 사용하여 투영 행렬을 계산할지 지정합니다.
| 상수 | 값 | 설명 |
|---|---|---|
Qt3DRender::QCameraLens::OrthographicProjection | 0 | 직교 투영 |
Qt3DRender::QCameraLens::PerspectiveProjection | 1 | 투시 투영 |
Qt3DRender::QCameraLens::FrustumProjection | 2 | 원뿔형 투영 |
Qt3DRender::QCameraLens::CustomProjection | 3 | 사용자 정의 투영 |
속성 설명서
aspectRatio : float
카메라 렌즈의 현재 종횡비를 저장합니다.
참고: 투영 유형이 ` Qt3DRender::QCameraLens::PerspectiveProjection`가 아닌 경우 반환 값이 정의되지 않을 수 있습니다.
액세스 함수:
| float | aspectRatio() const |
| void | setAspectRatio(float aspectRatio) |
알림 신호:
| void | aspectRatioChanged(float aspectRatio) |
bottom : float
카메라 렌즈의 현재 하단 평면을 저장합니다.
참고: 투영 유형이 ` Qt3DRender::QCameraLens::PerspectiveProjection`인 경우 반환 값이 정의되지 않을 수 있습니다.
액세스 함수:
| float | bottom() const |
| void | setBottom(float bottom) |
알림 신호:
| void | bottomChanged(float bottom) |
exposure : float
카메라 렌즈의 현재 노출 값을 유지합니다.
액세스 기능:
| float | exposure() const |
| void | setExposure(float exposure) |
알림 신호:
| void | exposureChanged(float exposure) |
farPlane : float
카메라 렌즈의 현재 근평면을 유지합니다.
액세스 함수:
| float | farPlane() const |
| void | setFarPlane(float farPlane) |
알림 신호:
| void | farPlaneChanged(float farPlane) |
fieldOfView : float
카메라 렌즈의 현재 시야각을 저장합니다.
참고: 투영 유형이 ` Qt3DRender::QCameraLens::PerspectiveProjection`가 아닌 경우 반환 값이 정의되지 않을 수 있습니다.
액세스 함수:
| float | fieldOfView() const |
| void | setFieldOfView(float fieldOfView) |
알림 신호:
| void | fieldOfViewChanged(float fieldOfView) |
left : float
카메라 렌즈의 현재 왼쪽 평면을 유지합니다.
참고: 투영 유형이 ` Qt3DRender::QCameraLens::PerspectiveProjection`인 경우 반환 값이 정의되지 않을 수 있습니다.
액세스 함수:
| float | left() const |
| void | setLeft(float left) |
알림 신호:
| void | leftChanged(float left) |
nearPlane : float
카메라 렌즈의 현재 근평면을 유지합니다.
액세스 함수:
| float | nearPlane() const |
| void | setNearPlane(float nearPlane) |
알림 신호:
| void | nearPlaneChanged(float nearPlane) |
projectionMatrix : QMatrix4x4
카메라 렌즈의 현재 투영 행렬을 저장합니다.
액세스 함수:
| QMatrix4x4 | projectionMatrix() const |
| void | setProjectionMatrix(const QMatrix4x4 &projectionMatrix) |
알림 신호:
| void | projectionMatrixChanged(const QMatrix4x4 &projectionMatrix) |
projectionType : ProjectionType
카메라 투영의 유형을 저장합니다.
액세스 함수:
| Qt3DRender::QCameraLens::ProjectionType | projectionType() const |
| void | setProjectionType(Qt3DRender::QCameraLens::ProjectionType projectionType) |
알림 신호:
| void | projectionTypeChanged(Qt3DRender::QCameraLens::ProjectionType projectionType) |
Qt3DRender::QCameraLens::ProjectionType도 참조하십시오 .
right : float
카메라 렌즈의 현재 우측 평면을 유지합니다.
참고: 투영 유형이 ` Qt3DRender::QCameraLens::PerspectiveProjection`인 경우 반환 값이 정의되지 않을 수 있습니다.
액세스 함수:
| float | right() const |
| void | setRight(float right) |
알림 신호:
| void | rightChanged(float right) |
top : float
카메라 렌즈의 현재 최상위 평면을 저장합니다.
참고: 투영 유형이 ` Qt3DRender::QCameraLens::PerspectiveProjection`인 경우 반환 값이 정의되지 않을 수 있습니다.
액세스 함수:
| float | top() const |
| void | setTop(float top) |
알림 신호:
| void | topChanged(float top) |
멤버 함수 문서
[explicit] QCameraLens::QCameraLens(Qt3DCore::QNode *parent = nullptr)
주어진 값을 사용하여 QCameraLens 객체를 생성합니다. parent
[slot] void QCameraLens::setAspectRatio(float aspectRatio)
투영의 종횡비를 aspectRatio 로 설정합니다. 이로 인해 투영 행렬이 업데이트됩니다.
참고: 투영 유형이 Qt3DRender::QCameraLens::PerspectiveProjection 가 아닌 경우이 설정은 효과가 없습니다.
참고: aspectRatio 속성에 대한세터 함수입니다.
참조: ` aspectRatio()` 함수.
[slot] void QCameraLens::setBottom(float bottom)
투영의 하단 창 좌표를 ` bottom`로 설정합니다. 이 작업은 투영 행렬 업데이트를 유발합니다.
참고: 투영 유형이 ` Qt3DRender::QCameraLens::PerspectiveProjection`인 경우이 설정은 아무런 영향을 미치지 않습니다.
참고: 속성 ` bottom`에 대한세터 함수입니다.
bottom()도 참조하십시오 .
[slot] void QCameraLens::setExposure(float exposure)
카메라 렌즈의 exposure
참고: 속성 ` exposure`에 대한설정 함수입니다.
exposure()도 참조하십시오 .
[slot] void QCameraLens::setFarPlane(float farPlane)
투영의 원거리 평면을 farPlane 로 설정합니다. 이 작업은 투영 행렬의 업데이트를 유발합니다.
참고: farPlane 속성에 대한설정 함수입니다.
farPlane()도 참조하십시오 .
[slot] void QCameraLens::setFieldOfView(float fieldOfView)
투영의 시야각을 fieldOfView 도로 설정합니다. 이 작업은 투영 행렬을 업데이트합니다.
참고: 투영 유형이 Qt3DRender::QCameraLens::PerspectiveProjection 이 아닌 경우이 설정은 효과가 없습니다.
참고: fieldOfView 속성에 대한세터 함수입니다.
참조: fieldOfView().
void QCameraLens::setFrustumProjection(float left, float right, float bottom, float top, float nearPlane, float farPlane)
left, right, bottom, top, nearPlane, farPlane 을 기반으로 한 직교 투영법을 정의합니다.
[slot] void QCameraLens::setLeft(float left)
투영의 왼쪽 아래 창 좌표를 left 로 설정합니다. 이로 인해 투영 행렬이 업데이트됩니다.
참고: 투영 유형이 ` Qt3DRender::QCameraLens::PerspectiveProjection`인 경우이 작업은 아무런 영향을 미치지 않습니다.
참고: 속성 ` left`에 대한설정 함수입니다.
참조: ` left()` 함수.
[slot] void QCameraLens::setNearPlane(float nearPlane)
투영의 근평면을 nearPlane 로 설정합니다. 이로 인해 투영 행렬이 업데이트됩니다.
참고: nearPlane 속성에 대한설정 함수입니다.
nearPlane()도 참조하십시오 .
void QCameraLens::setOrthographicProjection(float left, float right, float bottom, float top, float nearPlane, float farPlane)
left, right, bottom, top, nearPlane, farPlane 을 기반으로 한 직교 투영법을 정의합니다.
void QCameraLens::setPerspectiveProjection(float fieldOfView, float aspectRatio, float nearPlane, float farPlane)
fieldOfView, aspectRatio, nearPlane, farPlane 을 기반으로 한 투시 투영법을 정의합니다.
[slot] void QCameraLens::setProjectionMatrix(const QMatrix4x4 &projectionMatrix)
프로젝션 매트릭스를 ‘ projectionMatrix ’로 설정합니다.
참고: 이렇게 하면 투영 유형이 Qt3DRender::QCameraLens::CustomProjection 로 설정되므로, 지정되었을 수 있는 다른 모든 카메라 매개변수는 무시됩니다.
참고: projectionMatrix 속성에 대한세터 함수입니다.
projectionMatrix()도 참조하십시오 .
[slot] void QCameraLens::setProjectionType(Qt3DRender::QCameraLens::ProjectionType projectionType)
렌즈의 투영 유형 projectionType 을 설정합니다.
참고: Qt3DRender ::QCameraLens::Frustum과 Qt3DRender::QCameraLens::PerspectiveProjection 은 동일한 투영 방식을 지정하는 두 가지 다른 방법입니다.
참고: projectionType 속성에 대한설정 함수입니다.
projectionType()도 참조하십시오 .
[slot] void QCameraLens::setRight(float right)
투영의 우측 상단 창 좌표를 ` right`로 설정합니다. 이 작업은 투영 행렬의 업데이트를 유발합니다.
참고: 투영 유형이 ` Qt3DRender::QCameraLens::PerspectiveProjection`인 경우이 작업은 아무런 영향을 미치지 않습니다.
참고: 속성 ` right`에 대한세터 함수입니다.
참조: right().
[slot] void QCameraLens::setTop(float top)
투영의 상단 창 좌표를 ` top`로 설정합니다. 이렇게 하면 투영 행렬이 업데이트됩니다.
참고: 투영 유형이 ` Qt3DRender::QCameraLens::PerspectiveProjection`인 경우이 작업은 아무런 영향을 미치지 않습니다.
참고: 속성 ` top`에 대한설정자 함수입니다.
참조: ` top()` 함수.
© 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.
