QSGTexture Class

멤버 함수 문서

QSGTexture::QSGTexture()

QSGTexture 베이스 클래스를 생성합니다.

[override virtual noexcept] QSGTexture::~QSGTexture()

QSGTexture 를 파괴합니다.

QSGTexture::AnisotropyLevel QSGTexture::anisotropyLevel() const

이 텍스처 필터링에 사용 중인 이방성 레벨을 반환합니다.

setAnisotropyLevel()도 참조하세요 .

[virtual, since 6.0] void QSGTexture::commitTextureOperations(QRhi *rhi, QRhiResourceUpdateBatch *resourceUpdates)

대기 중인 이미지 업로드 작업이 있을 경우 이 함수를 호출하여 resourceUpdates 에 이미지 업로드 작업을 대기열에 넣습니다. 새 데이터가 없는 경우(예: 이 함수를 마지막으로 호출한 이후 setImage() 호출이 없었기 때문에) 이 함수는 아무 작업도 수행하지 않습니다.

rhi 텍스처가 포함된 머티리얼은 일반적으로 조건 없이 updateSampledImage() 구현에서 이 함수를 호출하여 state.rhi() 및 state.resourceUpdateBatch() 을 QSGMaterialShader::RenderState 에서 전달해야 합니다.

이 함수는 Qt 6.0에 도입되었습니다.

[pure virtual] qint64 QSGTexture::comparisonKey() const

텍스처 비교에 적합한 키를 반환합니다. 일반적으로 QSGMaterial::compare() 구현에서 사용됩니다.

QSGTexture 포인터를 비교하는 것만으로는 항상 충분하지 않은데, 그 아래에 동일한 네이티브 텍스처 객체를 참조하는 두 개의 QSGTexture 인스턴스도 동일한 것으로 간주해야 하기 때문입니다. 따라서 이 함수가 필요합니다.

이 함수의 구현은 아직 그래픽 리소스(네이티브 텍스처 객체)가 없는 경우 이를 생성하지 않을 것으로 예상되며, 생성해서는 안 됩니다.

아래에 네이티브 텍스처 객체가 없는 QSGTexture 은 일반적으로 다른 QSGTexture 과 같지 않으므로 반환값도 그에 맞게 만들어야 합니다. 특히 아틀라싱이 사용되는 경우(여러 텍스처가 내부적으로 동일한 아틀라스 텍스처를 공유하는 경우)에는 예외가 있으며, 이는 서브클래스 구현에서 적절히 처리해야 합니다.

QRectF QSGTexture::convertToNormalizedSourceRect(const QRectF &rect) const

정규화된 좌표로 변환된 rect 를 반환합니다.

normalizedTextureSubRect()도 참조하세요 .

QSGTexture::Filtering QSGTexture::filtering() const

이 텍스처에 사용할 샘플링 모드를 반환합니다.

setFiltering()도 참조하세요 .

[pure virtual] bool QSGTexture::hasAlphaChannel() const

텍스처 데이터에 알파 채널이 포함되어 있으면 true를 반환합니다.

[pure virtual] bool QSGTexture::hasMipmaps() const

텍스처 데이터에 밉맵 레벨이 포함된 경우 true를 반환합니다.

QSGTexture::WrapMode QSGTexture::horizontalWrapMode() const

이 텍스처에 사용할 가로 줄 바꿈 모드를 반환합니다.

setHorizontalWrapMode()도 참조하십시오 .

[virtual] bool QSGTexture::isAtlasTexture() const

이 텍스처가 아틀라스의 일부인지 여부를 반환합니다.

기본 구현은 false를 반환합니다.

QSGTexture::Filtering QSGTexture::mipmapFiltering() const

이 텍스처에서 샘플링할 때 밉매핑을 사용할지 여부를 반환합니다.

setMipmapFiltering()도 참조하십시오 .

template <typename QNativeInterface> QNativeInterface *QSGTexture::nativeInterface() const

텍스처에 대해 지정된 유형의 네이티브 인터페이스를 반환합니다.

이 함수는 QNativeInterface 네임스페이스에 선언된 QSGTexture 의 플랫폼별 기능에 대한 액세스를 제공합니다:

이를 통해 기본 네이티브 텍스처 오브젝트(예: OpenGL의 경우 GLuint 텍스처 ID 또는 Vulkan의 경우 VkImage 핸들)에 액세스할 수 있습니다.

요청된 인터페이스를 사용할 수 없는 경우 nullptr 이 반환됩니다.

[virtual] QRectF QSGTexture::normalizedTextureSubRect() const

이 텍스처가 정규화된 좌표로 나타내는 textureSize() 내부의 직사각형을 반환합니다.

기본 구현은 너비와 높이가 1인 위치 (0, 0)의 직사각형을 반환합니다.

[virtual] QSGTexture *QSGTexture::removedFromAtlas(QRhiResourceUpdateBatch *resourceUpdates = nullptr) const

이 함수는 아틀라스에서 제거된 현재 텍스처의 복사본을 반환합니다.

현재 텍스처는 변경되지 않으므로 텍스처 좌표를 업데이트할 필요가 없습니다.

아틀라스에서 텍스처를 제거하는 것은 주로 아틀라스 내부의 텍스처 서브렉트 대신 텍스처 좌표 0-1에서 작동하는 셰이더로 텍스처를 전달할 때 유용합니다.

텍스처가 텍스처 아틀라스의 일부가 아닌 경우 이 함수는 0을 반환합니다.

이 함수의 구현은 메모리 사용량을 제한하기 위해 여러 번 호출할 때 동일한 인스턴스를 반환하는 것이 좋습니다.

resourceUpdates 는 선택적 리소스 업데이트 배치로, 텍스처 작업이 있는 경우 이를 대기열에 넣습니다. 머티리얼은 QSGMaterialShader::RenderState 에서 인스턴스를 검색할 수 있습니다. null인 경우 removedFromAtlas() 구현은 자체 배치를 생성하여 즉시 제출합니다. 그러나 유효한 인스턴스가 지정되면 이 함수는 업데이트 배치를 제출하지 않습니다.

[virtual, since 6.0] QRhiTexture *QSGTexture::rhiTexture() const

유효한 텍스처가 내부적으로 아직 생성되지 않았거나 사용 중인 시나리오 백엔드에 해당 개념이 적용되지 않기 때문에 이 QSGTexture 에 대해 QRhiTexture 을 반환하거나, 없는 경우 null을 반환합니다.

이 함수는 QRhiTexture 이 없는 경우 새로 만들지 않을 것으로 예상됩니다. 이 경우 null을 반환해야 합니다. 렌더러에 대한 기대는 null 텍스처를 사용하면 투명한 더미 텍스처를 대신 사용하게 된다는 것입니다.

이 함수는 Qt 6.0에 도입되었습니다.

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

이방성 필터링 수준을 level 으로 설정합니다. 기본값은 QSGTexture::AnisotropyNone 으로, 이방성 필터링이 사용되지 않습니다.

anisotropyLevel()도 참조하세요 .

void QSGTexture::setFiltering(QSGTexture::Filtering filter)

샘플링 모드를 filter 로 설정합니다.

filtering()도 참조하세요 .

void QSGTexture::setHorizontalWrapMode(QSGTexture::WrapMode hwrap)

가로 줄 바꿈 모드를 다음과 같이 설정합니다. hwrap

horizontalWrapMode()도 참조하세요 .

void QSGTexture::setMipmapFiltering(QSGTexture::Filtering filter)

밉맵 샘플링 모드를 filter 로 설정합니다.

텍스처에 밉맵이 없는 경우 밉맵 필터링을 설정해도 효과가 없습니다.

mipmapFiltering() 및 hasMipmaps()도 참조하십시오 .

void QSGTexture::setVerticalWrapMode(QSGTexture::WrapMode vwrap)

세로 줄 바꿈 모드를 다음과 같이 설정합니다. vwrap

verticalWrapMode()도 참조하세요 .

[pure virtual] QSize QSGTexture::textureSize() const

텍스처의 크기를 픽셀 단위로 반환합니다.

QSGTexture::WrapMode QSGTexture::verticalWrapMode() const

이 텍스처에 사용할 세로 줄 바꿈 모드를 반환합니다.

setVerticalWrapMode()도 참조하세요 .