Qt3DRender::QTextureImage Class
class Qt3DRender::QTextureImage이미지 소스를 사용하여 OpenGL 텍스처 이미지를 생성하는 데 필요한 정보를 포함합니다. 더 보기...
| 헤더: | #include <qtextureimage.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3drender) target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake: | QT += 3drender |
| QML에서: | TextureImage |
| 상속: | Qt3DRender::QAbstractTextureImage |
| 상태: | 사용 중단 |
이 클래스는 더 이상 사용되지 않습니다. 새로운 코드에서는 이 클래스를 사용하지 않는 것을 강력히 권장합니다.
공개 유형
| enum | Status { None, Loading, Ready, Error } |
속성
공개 함수
| QTextureImage(Qt3DCore::QNode *parent = nullptr) | |
| bool | isMirrored() const |
| QUrl | source() const |
| Qt3DRender::QTextureImage::Status | status() const |
공개 슬롯
| void | setMirrored(bool mirrored) |
| void | setSource(const QUrl &source) |
신호
| void | mirroredChanged(bool mirrored) |
| void | sourceChanged(const QUrl &source) |
| void | statusChanged(Qt3DRender::QTextureImage::Status status) |
보호된 함수
| void | setStatus(Qt3DRender::QTextureImage::Status status) |
멤버 유형 문서
enum QTextureImage::Status
이 열거형은 텍스처 이미지 로딩에 대한 상태 값을 지정합니다.
| 상수 | 값 | 설명 |
|---|---|---|
Qt3DRender::QTextureImage::None | 0 | 텍스처 이미지 로딩이 아직 시작되지 않았습니다. |
Qt3DRender::QTextureImage::Loading | 1 | 텍스처 이미지 로딩이 시작되었지만 아직 완료되지 않았습니다. |
Qt3DRender::QTextureImage::Ready | 2 | 텍스처 이미지 로딩이 완료되었습니다. |
Qt3DRender::QTextureImage::Error | 3 | 텍스처 이미지 로딩 중에 오류가 발생했습니다. |
속성 설명
mirrored : bool
이 속성은 이미지를 불러올 때 이미지를 거울 반전시킬지 여부를 지정합니다. 이는 렌더링 API에서 사용하는 텍스처 좌표의 원점을 맞추기 위해 이미지를 별도로 조작할 필요가 없도록 하는 편의를 위한 기능입니다. 기본적으로 이 속성은 true로 설정되어 있습니다. GPU 압축 텍스처 형식을 사용할 때는 이 속성이 아무런 영향을 미치지 않습니다.
경고: 이 속성은 PNG와 같은 비압축 또는 CPU 압축 이미지 형식을 로드할 때 런타임 성능 저하를 초래합니다. 이러한 성능 저하를 피하려면 이 속성을 false로 설정하고 미리 거울 반전 처리된 텍스처 에셋을 로드하는 것이 좋습니다.
참고: OpenGL은 텍스처 좌표의 원점을 왼쪽 하단 모서리로 지정하는 반면, DirectX는 왼쪽 상단 모서리를 사용합니다.
참고: 큐브 맵 텍스처를 사용할때는 큐브 맵 샘플러가 일반 텍스처 좌표 대신 방향을 사용하므로 미러링 기능을 비활성화하는 것이 좋습니다.
액세스 함수:
| bool | isMirrored() const |
| void | setMirrored(bool mirrored) |
알림 신호:
| void | mirroredChanged(bool mirrored) |
source : QUrl
이 속성은 텍스처 이미지의 데이터를 불러올 소스 URL을 저장합니다.
액세스 함수:
알림 신호:
| void | sourceChanged(const QUrl &source) |
[read-only] status : Status
이 속성은 텍스처 이미지 로딩 상태를 나타냅니다.
- TextureImage.None
- TextureImage.Loading
- TextureImage.Ready
- TextureImage.Error
액세스 함수:
| Qt3DRender::QTextureImage::Status | status() const |
알림 신호:
| void | statusChanged(Qt3DRender::QTextureImage::Status status) |
멤버 함수 설명서
[explicit] QTextureImage::QTextureImage(Qt3DCore::QNode *parent = nullptr)
parent 를 부모로 하는 새로운 Qt3DRender::QTextureImage 인스턴스를 생성합니다.
bool QTextureImage::isMirrored() const
미러링이 활성화되어 있는지 여부를 반환합니다.
참고: ` mirrored` 속성에 대한게터 함수입니다.
[slot] void QTextureImage::setMirrored(bool mirrored)
미러링 설정을 mirrored 로 설정합니다.
참고: 이는 내부적으로 데이터 생성기를 업데이트하는 호출을 트리거합니다.
참고: mirrored 속성에 대한세터 함수입니다.
isMirrored()도 참조하십시오 .
[slot] void QTextureImage::setSource(const QUrl &source)
텍스처 이미지의 소스 URL을 source 로 설정합니다.
참고: 이 작업은 내부적으로 데이터 생성기를 업데이트하는 호출을 트리거합니다.
참고: source 속성에 대한세터 함수입니다.
source()도 참조하십시오 .
[protected] void QTextureImage::setStatus(Qt3DRender::QTextureImage::Status status)
상태를 ‘ status ’로 설정합니다. status
status()도 참조하십시오 .
QUrl QTextureImage::source() const
텍스처 이미지의 데이터를 불러올 소스 URL을 반환합니다.
참고: source 속성의게터 함수입니다.
참조: ` setSource()`.
Qt3DRender::QTextureImage::Status QTextureImage::status() const
현재 상태를 반환합니다.
참고: status 속성의게터 함수입니다.
setStatus()도 참조하십시오 .
© 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.
