이 페이지에서

Qt3DRender::QAbstractTextureImage Class

class Qt3DRender::QAbstractTextureImage

OpenGL 텍스처 이미지를 생성하는 데 필요한 정보를 포함합니다. 더 보기...

헤더: #include <qabstracttextureimage.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
QML에서: AbstractTextureImage
상속: Qt3DCore::QNode
상속하는 클래스:

Qt3DRender::QPaintedTextureImage 그리고 Qt3DRender::QTextureImage

상태: 사용 중단

이 클래스는 더 이상 사용되지 않습니다. 새로운 코드에서는 이 클래스를 사용하지 않는 것을 강력히 권장합니다.

속성

공개 함수

QAbstractTextureImage(Qt3DCore::QNode *parent = nullptr)
Qt3DRender::QAbstractTexture::CubeMapFace face() const
int layer() const
int mipLevel() const

공개 슬롯

void setFace(Qt3DRender::QAbstractTexture::CubeMapFace face)
void setLayer(int layer)
void setMipLevel(int level)

신호

void faceChanged(Qt3DRender::QAbstractTexture::CubeMapFace face)
void layerChanged(int layer)
void mipLevelChanged(int mipLevel)

보호된 함수

virtual Qt3DRender::QTextureImageDataGeneratorPtr dataGenerator() const = 0
void notifyDataGeneratorChanged()

상세 설명

QAbstractTextureImage는 QAbstractTexture 에 이미지 데이터를 제공하는 수단으로 사용되어야 합니다. 이 클래스에는 미프맵 레벨, 레이어, 큐브 면 등 OpenGL 텍스처에 데이터를 적절한 위치에 로드하는 데 필요한 정보가 포함되어 있습니다.

실제 데이터는 백엔드에서 Aspect 작업에 의해 실행될 QTextureImageDataGenerator 를 통해 제공됩니다. QAbstractTextureImage는 펑터와 펑터가 실제 데이터를 로드하는 데 필요한 추가 속성을 제공하기 위해 서브클래스화되어야 합니다.

참고: QAbstractTextureImage는 절대로 공유해서는 안 됩니다. 이 규칙을 준수하지 않을 경우, 최악의 경우 크래시가 발생하거나 정의되지 않은 동작이 나타날 수 있습니다.

속성 문서

face : Qt3DRender::QAbstractTexture::CubeMapFace

텍스처 이미지의 큐브 맵 면을 저장합니다.

참고: 큐브 맵면은 TargetCubeMap 및 TargetCubeMapArray 에서만 의미가 있습니다.

액세스 함수:

Qt3DRender::QAbstractTexture::CubeMapFace face() const
void setFace(Qt3DRender::QAbstractTexture::CubeMapFace face)

알림 신호:

void faceChanged(Qt3DRender::QAbstractTexture::CubeMapFace face)

layer : int

텍스처 이미지의 레이어를 반환합니다.

액세스 함수:

int layer() const
void setLayer(int layer)

알림 신호:

void layerChanged(int layer)

mipLevel : int

텍스처 이미지의 밉맵 레벨을 저장합니다.

액세스 함수:

int mipLevel() const
void setMipLevel(int level)

알림 신호:

void mipLevelChanged(int mipLevel)

멤버 함수 설명서

[explicit] QAbstractTextureImage::QAbstractTextureImage(Qt3DCore::QNode *parent = nullptr)

parent 를 부모로 하는 새로운 QAbstractTextureImage 인스턴스를 생성합니다.

[pure virtual protected] Qt3DRender::QTextureImageDataGeneratorPtr QAbstractTextureImage::dataGenerator() const

이 메서드를 구현하여 텍스처 이미지의 데이터를 제공하는 QTextureImageDataGeneratorPtr 인스턴스를 반환하십시오.

[protected] void QAbstractTextureImage::notifyDataGeneratorChanged()

백엔드로 전송되는 데이터 생성기의 업데이트를 트리거합니다.

[slot] void QAbstractTextureImage::setFace(Qt3DRender::QAbstractTexture::CubeMapFace face)

텍스처 이미지의 면을 face 로 설정합니다. face

참고: face 속성에 대한설정 함수입니다.

face()도 참조하십시오 .

[slot] void QAbstractTextureImage::setLayer(int layer)

텍스처의 레이어를 ` layer`로 설정합니다. layer

참고: layer 속성에 대한세터 함수입니다.

layer()도 참조하십시오 .

[slot] void QAbstractTextureImage::setMipLevel(int level)

텍스처의 밉 레벨을 level 로 설정합니다. level

참고: mipLevel 속성에 대한설정 함수입니다.

mipLevel()도 참조하십시오 .

© 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.