Qt3DExtras::QSkyboxEntity Class
class Qt3DExtras::QSkyboxEntityQt3DExtras::QSkyboxEntity 3D 씬에 스카이박스를 삽입하는 데 사용할 수 있는 편리한 Qt3DCore::QEntity 의 서브클래스입니다. 더 보기...
| 헤더: | #include <Qt3DExtras/QSkyboxEntity> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3dextras) target_link_libraries(mytarget PRIVATE Qt6::3dextras) |
| qmake: | QT += 3dextras |
| QML에서: | SkyboxEntity |
| 상속: | Qt3DCore::QEntity |
| 상태: | 사용 중단됨 |
이 클래스는 더 이상 사용되지 않습니다. 새로운 코드에서는 이 클래스를 사용하지 않는 것을 강력히 권장합니다.
속성
- baseName : QString
- extension : QString
- gammaCorrect : bool
공개 함수
| QSkyboxEntity(Qt3DCore::QNode *parent = nullptr) | |
| QString | baseName() const |
| QString | extension() const |
| bool | isGammaCorrectEnabled() const |
공개 슬롯
| void | setBaseName(const QString &baseName) |
| void | setExtension(const QString &extension) |
| void | setGammaCorrectEnabled(bool enabled) |
신호
| void | baseNameChanged(const QString &path) |
| void | extensionChanged(const QString &extension) |
| void | gammaCorrectEnabledChanged(bool enabled) |
상세 설명
기본 이름과 확장자를 지정하면, Qt3DExtras::QSkyboxEntity 가 런타임에 렌더링될 TextureCubeMap 를 생성해 줍니다. 소스 디렉토리의 이미지는 다음 패턴과 일치해야 합니다: 기본 이름 + * "_posx|_posy|_posz|_negx|_negy|_negz" + 확장자
기본적으로 확장자는 .png로 설정됩니다.
스카이박스 렌더링이 이루어지는 FrameGraph에서 프러스텀 컬링을 반드시 비활성화해야 합니다.
참고: 정사영법으로 스카이박스를 렌더링하려고 해서는 안 됩니다.
속성 설명서
baseName : QString
스카이박스의 기본 이름을 포함합니다.
액세스 함수:
| QString | baseName() const |
| void | setBaseName(const QString &baseName) |
알림 신호:
| void | baseNameChanged(const QString &path) |
extension : QString
스카이박스 이미지의 파일명 확장자를 포함하며, 앞의 '.'도 포함됩니다.
기본값은 .png입니다.
액세스 함수:
| QString | extension() const |
| void | setExtension(const QString &extension) |
알림 신호:
| void | extensionChanged(const QString &extension) |
gammaCorrect : bool
감마 보정이 활성화되었는지 여부를 나타내는 부울 값입니다.
액세스 함수:
| bool | isGammaCorrectEnabled() const |
| void | setGammaCorrectEnabled(bool enabled) |
알림 신호:
| void | gammaCorrectEnabledChanged(bool enabled) |
멤버 함수 문서
[explicit] QSkyboxEntity::QSkyboxEntity(Qt3DCore::QNode *parent = nullptr)
parent 를 부모로 하는 새로운 Qt3DExtras::QSkyboxEntity 객체를 생성합니다.
QString QSkyboxEntity::baseName() const
스카이박스의 기본 이름을 반환합니다.
참고: baseName 속성에 대한게터 함수입니다.
setBaseName()도 참조하십시오 .
QString QSkyboxEntity::extension() const
확장명을 반환합니다
참고: extension 속성에 대한게터 함수입니다.
setExtension()도 참조하십시오 .
bool QSkyboxEntity::isGammaCorrectEnabled() const
이 스카이박스에 감마 보정이 활성화되어 있으면 true를 반환합니다.
참고: gammaCorrect 속성에 대한게터 함수입니다.
[slot] void QSkyboxEntity::setBaseName(const QString &baseName)
기본 이름을 baseName 로 설정합니다.
참고: baseName 속성에 대한세터 함수입니다.
baseName()도 참조하십시오 .
[slot] void QSkyboxEntity::setExtension(const QString &extension)
확장자를 extension 로 설정합니다.
참고: extension 속성에 대한세터 함수입니다.
extension()도 참조하십시오 .
[slot] void QSkyboxEntity::setGammaCorrectEnabled(bool enabled)
감마 보정 활성화 상태를 ` enabled`로 설정합니다.
참고: gammaCorrect 속성에 대한세터 함수입니다.
isGammaCorrectEnabled()도 참조하십시오 .
© 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.
