QRhiTextureRenderTargetDescription Class

QRhiTexture *texture = rhi->newTexture(QRhiTexture::RGBA8, QSize(256, 256), 1, QRhiTexture::RenderTarget);
texture->create();
QRhiTextureRenderTarget *rt = rhi->newTextureRenderTarget({ texture }));

QRhiTexture *texture = rhi->newTexture(QRhiTexture::RGBA8, QSize(512, 512), 1, QRhiTexture::RenderTarget | QRhiTexture::MipMapped);
texture->create();
QRhiColorAttachment colorAtt(texture);
colorAtt.setLevel(2);
QRhiTextureRenderTarget *rt = rhi->newTextureRenderTarget({ colorAtt });

QRhiTexture *shadowMap = rhi->newTexture(QRhiTexture::D32F, QSize(1024, 1024), 1, QRhiTexture::RenderTarget);
shadowMap->create();
QRhiTextureRenderTargetDescription rtDesc;
rtDesc.setDepthTexture(shadowMap);
QRhiTextureRenderTarget *rt = rhi->newTextureRenderTarget(rtDesc);

QRhiTexture *texture = rhi->newTexture(QRhiTexture::RGBA8, QSize(512, 512), 1, QRhiTexture::RenderTarget);
texture->create();
QRhiRenderBuffer *depthStencil = rhi->newRenderBuffer(QRhiRenderBuffer::DepthStencil, QSize(512, 512));
depthStencil->create();
QRhiTextureRenderTargetDescription rtDesc({ texture }, depthStencil);
QRhiTextureRenderTarget *rt = rhi->newTextureRenderTarget(rtDesc);

QRhiRenderBuffer *colorBuffer = rhi->newRenderBuffer(QRhiRenderBuffer::Color, QSize(512, 512), 4); // 4x MSAA
colorBuffer->create();
QRhiRenderBuffer *depthStencil = rhi->newRenderBuffer(QRhiRenderBuffer::DepthStencil, QSize(512, 512), 4);
depthStencil->create();
QRhiTexture *texture = rhi->newTexture(QRhiTexture::RGBA8, QSize(512, 512), 1, QRhiTexture::RenderTarget);
texture->create();
QRhiColorAttachment colorAtt(colorBuffer);
colorAtt.setResolveTexture(texture);
QRhiTextureRenderTarget *rt = rhi->newTextureRenderTarget({ colorAtt, depthStencil });

멤버 함수 문서

[constexpr noexcept] QRhiTextureRenderTargetDescription::QRhiTextureRenderTargetDescription()

빈 텍스처 렌더 타깃 설명을 생성합니다.

QRhiTextureRenderTargetDescription::QRhiTextureRenderTargetDescription(const QRhiColorAttachment &colorAttachment)

colorAttachment 에 설명된 하나의 첨부 파일로 텍스처 렌더 타깃 설명을 구성합니다.

QRhiTextureRenderTargetDescription::QRhiTextureRenderTargetDescription(const QRhiColorAttachment &colorAttachment, QRhiRenderBuffer *depthStencilBuffer)

두 개의 어태치먼트, 즉 colorAttachment 에 설명된 컬러 어태치먼트와 depthStencilBuffer 에 설명된 뎁스/스텐실 어태치먼트로 텍스처 렌더 타깃 설명을 구성합니다.

QRhiTextureRenderTargetDescription::QRhiTextureRenderTargetDescription(const QRhiColorAttachment &colorAttachment, QRhiTexture *depthTexture)

colorAttachment 으로 설명하는 색상 어태치먼트와 depthTexture 으로 설명하는 깊이 어태치먼트로 텍스처 렌더 타깃 설명을 구성합니다.

const QRhiColorAttachment *QRhiTextureRenderTargetDescription::cbeginColorAttachments() const

첨부 파일 목록의 첫 번째 항목을 가리키는 상수 이터레이터를 반환합니다.

const QRhiColorAttachment *QRhiTextureRenderTargetDescription::cendColorAttachments() const

첨부 파일 목록의 마지막 항목 바로 뒤를 가리키는 상수 이터레이터를 반환합니다.

const QRhiColorAttachment *QRhiTextureRenderTargetDescription::colorAttachmentAt(qsizetype index) const

지정된 index 에서 컬러 어태치먼트를 반환합니다.

qsizetype QRhiTextureRenderTargetDescription::colorAttachmentCount() const

현재 설정된 색상 첨부 파일의 수를 반환합니다.

[since 6.8] QRhiTexture *QRhiTextureRenderTargetDescription::depthResolveTexture() const

다중 샘플 깊이(또는 깊이 스텐실) 텍스처(또는 텍스처 배열)가 해결되는 텍스처를 반환합니다. nullptr, 가장 일반적인 경우입니다.

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

setDepthResolveTexture(), QRhiColorAttachment::resolveTexture() 및 depthTexture()도 참조하십시오 .

QRhiRenderBuffer *QRhiTextureRenderTargetDescription::depthStencilBuffer() const

뎁스 스텐실 버퍼로 사용된 렌더버퍼를 반환하거나, 설정되지 않은 경우 nullptr 을 반환합니다.

setDepthStencilBuffer()도 참조하세요 .

QRhiTexture *QRhiTextureRenderTargetDescription::depthTexture() const

현재 참조된 깊이 텍스처를 반환하거나 설정된 것이 없는 경우 nullptr 를 반환합니다.

setDepthTexture()도 참조하세요 .

void QRhiTextureRenderTargetDescription::setColorAttachments(std::initializer_list<QRhiColorAttachment> list)

컬러 첨부 파일의 list 을 설정합니다.

template <typename InputIterator> void QRhiTextureRenderTargetDescription::setColorAttachments(InputIterator first, InputIterator last)

이터레이터 first 및 last 를 통해 색상 첨부 파일 목록을 설정합니다.

[since 6.8] void QRhiTextureRenderTargetDescription::setDepthResolveTexture(QRhiTexture *tex)

깊이(또는 깊이 스텐실) 해상도 텍스처를 설정합니다 tex.

tex 는 2D 텍스처 또는 setDepthTexture()를 통해 설정된 텍스처와 일치하는 형식의 2D 텍스처 배열일 것으로 예상됩니다.

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

depthResolveTexture(), QRhiColorAttachment::setResolveTexture() 및 setDepthTexture()도 참조하십시오 .

void QRhiTextureRenderTargetDescription::setDepthStencilBuffer(QRhiRenderBuffer *renderBuffer)

뎁스 스텐실에 대해 renderBuffer 을 설정합니다. 이 렌더 대상에 대한 렌더 패스의 그래픽 파이프라인에서 뎁스 테스트/쓰기 또는 스텐실 관련 기능이 사용되지 않는 경우와 같이 필수는 아니지만 nullptr 로 설정할 수 있습니다.

2D QRhiTexture 대신 QRhiRenderBuffer 을 깊이 또는 깊이/스텐실 버퍼로 사용하는 것은 매우 일반적이며 애플리케이션에 권장되는 방식입니다. 뎁스 데이터를 나중에 액세스(예: 셰이더에서 샘플링)하거나 multiview rendering 이 관련된 경우(뎁스 텍스처가 텍스처 배열이어야 하므로) QRhiTexture 을 사용하므로 setDepthTexture()가 적절합니다.

depthStencilBuffer() 및 setDepthTexture()도 참조하십시오 .

void QRhiTextureRenderTargetDescription::setDepthTexture(QRhiTexture *texture)

깊이 스텐실에 texture 을 설정합니다. setDepthStencilBuffer ()의 대안으로 QRhiRenderBuffer 대신 적절한 유형(예: QRhiTexture::D32F)의 QRhiTexture 을 제공합니다.

texture 는 2D 텍스처 또는 2D 텍스처 배열일 수 있습니다(텍스처 배열이 지원되는 경우). 텍스처 배열을 지정하는 것은 특히 multiview rendering 와 관련이 있습니다.

depthTexture() 및 setDepthStencilBuffer()도 참조하세요 .