QSGOpaqueTextureMaterial Class

QSGOpaqueTextureMaterial 클래스는 씬 그래프에서 텍스처 지오메트리를 렌더링하는 편리한 방법을 제공합니다. 더 보기...

Header: #include <QSGOpaqueTextureMaterial>
CMake: find_package(Qt6 REQUIRED COMPONENTS Quick)
target_link_libraries(mytarget PRIVATE Qt6::Quick)
qmake: QT += quick
상속합니다: QSGMaterial
상속 대상:

QSGTextureMaterial

공용 함수

QSGOpaqueTextureMaterial()
QSGTexture::AnisotropyLevel anisotropyLevel() const
QSGTexture::Filtering filtering() const
QSGTexture::WrapMode horizontalWrapMode() const
QSGTexture::Filtering mipmapFiltering() const
void setAnisotropyLevel(QSGTexture::AnisotropyLevel level)
void setFiltering(QSGTexture::Filtering filtering)
void setHorizontalWrapMode(QSGTexture::WrapMode mode)
void setMipmapFiltering(QSGTexture::Filtering filtering)
void setTexture(QSGTexture *texture)
void setVerticalWrapMode(QSGTexture::WrapMode mode)
QSGTexture *texture() const
QSGTexture::WrapMode verticalWrapMode() const

상세 설명

Warning: 이 유틸리티 클래스는 Qt Quick 시나리오 그래프의 기본 백엔드로 실행할 때만 작동합니다.

불투명 텍스처 머티리얼은 지오메트리의 모든 픽셀을 제공된 텍스처로 채웁니다. 이 머티리얼은 QSGMaterialShader::RenderState 의 불투명도를 존중하지 않으므로 이 머티리얼을 사용하는 부모 노드 체인의 불투명도 노드는 영향을 받지 않습니다.

불투명 텍스처 머티리얼로 렌더링할 지오메트리에는 속성 위치 0의 버텍스와 속성 위치 1의 텍스처 좌표가 필요합니다. 텍스처 좌표는 2차원 부동 소수점 튜플입니다. QSGGeometry::defaultAttributes_TexturedPoint2D 은 이 머티리얼과 호환되는 어트리뷰트 세트를 반환합니다.

렌더링할 텍스처는 setTexture()를 사용하여 설정할 수 있습니다. 텍스처 렌더링 방법은 setMipmapFiltering(), setFiltering(), setHorizontalWrapMode() 및 setVerticalWrapMode()를 사용하여 지정할 수 있습니다. 렌더링 상태는 텍스처 인스턴스가 바인딩되기 직전에 설정됩니다.

불투명 텍스처 머티리얼은 현재 매트릭스와 텍스처의 알파 채널을 존중합니다. 시나리오 그래프에서 누적된 불투명도를 무시합니다.

텍스처 머티리얼은 씬 그래프에서 머티리얼로 사용되기 전에 텍스처가 설정되어 있어야 합니다.

멤버 함수 문서

QSGOpaqueTextureMaterial::QSGOpaqueTextureMaterial()

새 QSGOpaqueTextureMaterial을 생성합니다.

기본 밉맵 필터링 및 필터링 모드는 QSGTexture::Nearest 으로 설정됩니다. 기본 랩 모드는 QSGTexture::ClampToEdge 으로 설정됩니다.

QSGTexture::AnisotropyLevel QSGOpaqueTextureMaterial::anisotropyLevel() const

이 머티리얼의 애니스트로피 레벨을 반환합니다.

setAnisotropyLevel()도 참조하십시오 .

QSGTexture::Filtering QSGOpaqueTextureMaterial::filtering() const

이 머티리얼의 필터링 모드를 반환합니다.

기본 필터링은 QSGTexture::Nearest 입니다.

setFiltering()도 참조하세요 .

QSGTexture::WrapMode QSGOpaqueTextureMaterial::horizontalWrapMode() const

이 머티리얼의 가로 줄 바꿈 모드를 반환합니다.

기본 가로 줄 바꿈 모드는 QSGTexture::ClampToEdge 입니다.

setHorizontalWrapMode()도 참조하세요 .

QSGTexture::Filtering QSGOpaqueTextureMaterial::mipmapFiltering() const

이 머티리얼의 밉맵 필터링 모드를 반환합니다.

기본 밉맵 모드는 QSGTexture::Nearest 입니다.

setMipmapFiltering()도 참조하세요 .

void QSGOpaqueTextureMaterial::setAnisotropyLevel(QSGTexture::AnisotropyLevel level)

이 자료의 애니스트로피 수준을 level 로 설정합니다.

anisotropyLevel()도 참조하세요 .

void QSGOpaqueTextureMaterial::setFiltering(QSGTexture::Filtering filtering)

필터링을 filtering 로 설정합니다.

필터링 모드는 텍스처가 렌더링을 위해 바인딩되기 직전에 텍스처 인스턴스에서 설정됩니다.

filtering()도 참조하세요 .

void QSGOpaqueTextureMaterial::setHorizontalWrapMode(QSGTexture::WrapMode mode)

가로 줄 바꿈 모드를 mode 로 설정합니다.

가로 줄 바꿈 모드는 텍스처가 렌더링을 위해 바인딩되기 직전에 텍스처 인스턴스에서 설정됩니다.

horizontalWrapMode()도 참조하세요 .

void QSGOpaqueTextureMaterial::setMipmapFiltering(QSGTexture::Filtering filtering)

밉맵 모드를 filtering 로 설정합니다.

밉맵 필터링 모드는 텍스처가 렌더링을 위해 바인딩되기 직전에 텍스처 인스턴스에서 설정됩니다.

텍스처가 밉매핑을 지원하지 않는 경우 밉매핑을 활성화해도 효과가 없습니다.

mipmapFiltering()도 참조하세요 .

void QSGOpaqueTextureMaterial::setTexture(QSGTexture *texture)

이 머티리얼의 텍스처를 texture 로 설정합니다.

이 머티리얼은 텍스처의 소유권을 갖지 않습니다.

texture()도 참조하세요 .

void QSGOpaqueTextureMaterial::setVerticalWrapMode(QSGTexture::WrapMode mode)

세로 줄 바꿈 모드를 mode 로 설정합니다.

세로 줄 바꿈 모드는 텍스처가 렌더링을 위해 바인딩되기 직전에 텍스처 인스턴스에 설정됩니다.

verticalWrapMode()도 참조하세요 .

QSGTexture *QSGOpaqueTextureMaterial::texture() const

이 텍스처 머티리얼의 텍스처를 반환합니다.

setTexture()도 참조하십시오 .

QSGTexture::WrapMode QSGOpaqueTextureMaterial::verticalWrapMode() const

이 머티리얼의 세로 줄 바꿈 모드를 반환합니다.

기본 세로 줄 바꿈 모드는 QSGTexture::ClampToEdge 입니다.

setVerticalWrapMode()도 참조하세요 .

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