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 |
| 상태: | Deprecated |
공용 유형
| 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 의 매개 변수를 지정합니다.
| Constant | 값 | 설명 |
|---|---|---|
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()도 참조하세요 .
© 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.
