QRhiTexture Class

QRhiTexture *texture = rhi->newTexture(QRhiTexture::RGBA8, QSize(512, 512));
if (!texture->create()) { error(); }
QRhiResourceUpdateBatch *batch = rhi->nextResourceUpdateBatch();
QImage image(512, 512, QImage::Format_RGBA8888);
image.fill(Qt::green);
batch->uploadTexture(texture, image);
// ...
commandBuffer->resourceUpdate(batch); // or, alternatively, pass 'batch' to a beginPass() call

// determine newSize, e.g. based on the swapchain's output size or other factors
if (texture->pixelSize() != newSize) {
    texture->setPixelSize(newSize);
    if (!texture->create()) { error(); }
}
// continue using texture, fill it with new data

멤버 함수 문서

int QRhiTexture::arrayRangeLength() const

setArrayRange()가 호출되었을 때 노출된 배열 범위 크기를 반환합니다.

setArrayRange()도 참조하세요 .

int QRhiTexture::arrayRangeStart() const

setArrayRange()가 호출되었을 때 첫 번째 배열 레이어를 반환합니다.

setArrayRange()도 참조하세요 .

int QRhiTexture::arraySize() const

텍스처 배열 크기를 반환합니다.

setArraySize()도 참조하세요 .

[pure virtual] bool QRhiTexture::create()

해당 네이티브 그래픽 리소스를 생성합니다. 해당하는 destroy()가 없는 이전 create()로 인해 이미 리소스가 있는 경우 destroy()가 암시적으로 먼저 호출됩니다.

성공하면 true, 그래픽 작업이 실패하면 false 을 반환합니다. 반환 값에 관계없이 destroy()를 호출하는 것은 항상 안전합니다.

[virtual] bool QRhiTexture::createFrom(QRhiTexture::NativeTexture src)

create()와 유사하지만 새로운 네이티브 텍스처가 생성되지 않는다는 점이 다릅니다. 대신 src 에 지정된 네이티브 텍스처 리소스가 사용됩니다.

이를 통해 외부 그래픽 엔진에서 기존 네이티브 텍스처 객체(그래픽 API에 따라 동일한 디바이스 또는 공유 컨텍스트에 속해야 함)를 가져올 수 있습니다.

지정된 기존 네이티브 텍스처 오브젝트가 비소유 QRhiTexture 로 성공적으로 래핑된 경우 true를 반환합니다.

이 작업의 반대인 QRhiTexture- 생성된 네이티브 텍스처 오브젝트를 외부 엔진에 노출하는 작업은 nativeTexture()을 통해 가능합니다.

int QRhiTexture::depth() const

3D 텍스처의 깊이를 반환합니다.

setDepth()도 참조하세요 .

QRhiTexture::Flags QRhiTexture::flags() const

텍스처 플래그를 반환합니다.

setFlags()도 참조하십시오 .

QRhiTexture::Format QRhiTexture::format() const

텍스처 형식을 반환합니다.

setFormat()도 참조하세요 .

[virtual] QRhiTexture::NativeTexture QRhiTexture::nativeTexture()

이 텍스처의 기본 네이티브 리소스를 반환합니다. 백엔드에서 기본 네이티브 리소스 노출이 지원되지 않는 경우 반환된 값은 비어 있습니다.

createFrom()도 참조하세요 .

QSize QRhiTexture::pixelSize() const

크기를 픽셀 단위로 반환합니다.

setPixelSize()도 참조하세요 .

[since 6.8] QRhiTexture::ViewFormat QRhiTexture::readViewFormat() const

텍스처를 샘플링할 때 사용되는 뷰 포맷을 반환합니다. 호출되지 않으면 뷰 형식은 format()와 동일한 것으로 간주됩니다.

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

setReadViewFormat()도 참조하십시오 .

[override virtual] QRhiResource::Type QRhiTexture::resourceType() const

재구현합니다: QRhiResource::resourceType() const.

리소스 타입을 리턴합니다.

int QRhiTexture::sampleCount() const

샘플 수를 반환합니다. 1은 다중 샘플 앤티앨리어싱이 없음을 의미합니다.

setSampleCount()도 참조하세요 .

void QRhiTexture::setArrayRange(int startIndex, int count)

일반적으로 모든 배열 레이어가 노출되며 sampler2DArray 을 샘플링할 때 texture() GLSL 함수에 전달되는 세 번째 좌표를 통해 레이어를 선택하는 것은 셰이더의 몫입니다. QRhi::TextureArrayRange 이 지원되는 것으로 보고되면 create() 또는 createFrom() 앞에 setArrayRange() 를 호출하면 지정된 범위, count 부터 시작하는 startIndex 요소만 선택하도록 요청합니다. 그러면 셰이더 로직은 이를 고려하여 작성할 수 있습니다.

QRhi::TextureArrayRange 를참조하세요 .

void QRhiTexture::setArraySize(int arraySize)

텍스처를 설정합니다 arraySize.

arraySize()도 참조하세요 .

void QRhiTexture::setDepth(int depth)

3D 텍스처에 depth 을 설정합니다.

depth()도 참조하세요 .

void QRhiTexture::setFlags(QRhiTexture::Flags f)

텍스처 플래그를 f 로 설정합니다.

flags()도 참조하세요 .

void QRhiTexture::setFormat(QRhiTexture::Format fmt)

요청된 텍스처 형식을 fmt 로 설정합니다.

format()도 참조하세요 .

[virtual] void QRhiTexture::setNativeLayout(int layout)

Vulkan과 같은 일부 그래픽 API의 경우 그래픽 API를 직접 사용하는 사용자 정의 렌더링 코드를 통합할 때 이미지 레이아웃에 특별한 주의가 필요합니다. 이 기능을 사용하면 네이티브 렌더링 명령 뒤에 QRhiTexture 을 뒷받침하는 이미지가 예상되는 layout 으로 전달할 수 있습니다.

예를 들어 QRhiCommandBuffer::beginExternal() 및 QRhiCommandBuffer::endExternal()로 둘러싸인 코드 블록에서 Vulkan을 사용하여 QRhiTexture 의 VkImage로 직접 렌더링한 다음 QRhi 기반 렌더 패스에서 텍스처 샘플링에 이미지를 사용하는 경우를 생각해 보겠습니다. 잠재적으로 잘못된 이미지 레이아웃 전환을 방지하기 위해 이 함수는 해당 코드 블록에 기록된 명령이 완료되면 이미지 레이아웃이 어떻게 될지 표시하는 데 사용할 수 있습니다.

이 함수를 호출하는 것은 QRhiCommandBuffer::endExternal() 이후와 후속 QRhiCommandBuffer::beginPass() 앞에만 의미가 있습니다.

이 함수는 기본 그래픽 API가 이미지 레이아웃 개념을 노출하지 않는 QRhi 백엔드에서는 효과가 없습니다.

void QRhiTexture::setPixelSize(const QSize &sz)

픽셀 단위로 지정된 텍스처 크기를 sz 로 설정합니다.

pixelSize()도 참조하세요 .

[since 6.8] void QRhiTexture::setReadViewFormat(const QRhiTexture::ViewFormat &fmt)

셰이더 리소스 뷰 형식(또는 텍스처 샘플링에 사용되는 뷰의 형식)을 fmt 으로 설정합니다. 기본적으로 텍스처 자체와 동일한 형식(및 sRGB)이 사용되며 대부분의 경우 이 함수를 호출할 필요가 없습니다.

이 설정은 TextureViewFormat 기능이 지원되는 것으로 보고된 경우에만 고려됩니다.

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

readViewFormat()도 참조하십시오 .

void QRhiTexture::setSampleCount(int s)

샘플 수를 s 로 설정합니다.

sampleCount()도 참조하세요 .

[since 6.8] void QRhiTexture::setWriteViewFormat(const QRhiTexture::ViewFormat &fmt)

렌더링 대상 뷰 형식을 fmt 로 설정합니다. 기본적으로 텍스처 자체와 동일한 형식(및 sRGB)이 사용되며 대부분의 경우 이 함수를 호출할 필요가 없습니다.

쓰기 뷰 포맷을 제공하는 일반적인 사용 사례 중 하나는 외부에서 제공된 텍스처로 작업하는 경우인데, 이 텍스처는 Vulkan 또는 Direct 3D와 같은 3D API로 sRGB 포맷을 사용하지만 렌더링 엔진은 셰이딩 파이프라인 마지막에 선형화 및 sRGB로의 변환을 처리하도록 이미 준비되어 있습니다. 이 경우 이러한 텍스처로 렌더링할 때 필요한 것은 동일하지만 sRGB 형식이 아닌 렌더링 대상 뷰(예: VkImageView)입니다. (예를 들어 OpenXR 구현에서 VK_FORMAT_R8G8B8A8_SRGB 텍스처를 얻는 경우, 렌더링 엔진의 파이프라인에 필요한 경우 VK_FORMAT_R8G8B8A8_UNORM 뷰를 사용하여 렌더링을 수행해야 할 가능성이 높으며 이 예에서는 QRhiTexture::RGBA8 형식의 ViewFormat 및 srgb 가 false 로 설정되어 이 함수를 호출할 수 있습니다).

이 설정은 TextureViewFormat 기능이 지원되는 것으로 보고된 경우에만 고려됩니다.

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

writeViewFormat()도 참조하십시오 .

[since 6.8] QRhiTexture::ViewFormat QRhiTexture::writeViewFormat() const

텍스처에 쓸 때와 이미지 로드/저장과 함께 사용할 때 사용되는 뷰 형식을 반환합니다. 호출되지 않으면 뷰 형식은 format()와 동일한 것으로 간주됩니다.

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

setWriteViewFormat()도 참조하십시오 .