QTextureImage Class
class Qt3DRender::QTextureImage이미지 소스에서 OpenGL 텍스처 이미지를 만드는 데 필요한 정보를 캡슐화합니다. 더 보기...
| 헤더: | #include <QTextureImage> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3drender)target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake: | QT += 3drender |
| QML에서: | TextureImage |
| 상속합니다: | Qt3DRender::QAbstractTextureImage |
| 상태: | Deprecated |
공용 유형
| 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
이 열거형은 텍스처 이미지 로딩의 상태 값을 지정합니다.
| Constant | 값 | 설명 |
|---|---|---|
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 : const 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을 반환합니다.
참고: 프로퍼티 소스에 대한 게터 함수입니다.
setSource()도 참조하세요 .
Qt3DRender::QTextureImage::Status QTextureImage::status() const
현재 상태를 반환합니다.
참고: 속성 상태를 가져오는 함수입니다.
setStatus()도 참조하세요 .
© 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.
