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()를 호출하면 startIndex 부터 시작하는 count 개의 요소로 구성된 지정된 범위만 선택하도록 요청됩니다. 셰이더 로직은 이를 고려하여 작성할 수 있습니다.

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 설정)이 사용되므로, 대부분의 경우 이 함수를 호출할 필요가 없습니다.

이 설정은 QRhi::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 이고 srgb 가 false 로 설정된 ViewFormat 를 사용하여 이 함수를 호출하게 됩니다.)

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

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

writeViewFormat()도 참조하십시오 .

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

텍스처에 쓰기를 수행하거나 이미지 로드/저장 시 사용되는 뷰 형식을 반환합니다. 이 함수가 호출되지 않으면 뷰 형식은 format()과 동일한 것으로 간주됩니다.

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

setWriteViewFormat()도 참조하십시오 .