QSGOpaqueTextureMaterial Class
QSGOpaqueTextureMaterial 클래스는 씬 그래프에서 텍스처가 적용된 지오메트리를 렌더링할 수 있는 편리한 방법을 제공합니다. 더 보기...
| 헤더: | #include <QSGOpaqueTextureMaterial> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Quick) target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake: | QT += quick |
| 상속: | QSGMaterial |
| 상속받는 요소: |
- 상속받은 멤버를 포함한 모든 멤버 목록
- QSGOpaqueTextureMaterial은 Qt Quick 시나리오 그래프 머티리얼 클래스의 일부입니다.
공개 함수
| 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 |
상세 설명
경고: 이 유틸리티 클래스는 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()도 참조하십시오 .
© 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.
