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 default] 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 이터레이터를 반환합니다.

const QRhiColorAttachment *QRhiTextureRenderTargetDescription::cendColorAttachments() const

첨부 목록의 마지막 항목 바로 다음을 가리키는 const 이터레이터를 반환합니다.

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

지정된 index 위치에 있는 색상 첨부 파일을 반환합니다.

qsizetype QRhiTextureRenderTargetDescription::colorAttachmentCount() const

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

[since 6.12] int QRhiTextureRenderTargetDescription::depthLayer() const

깊이/스텐실 어태치먼트에 사용될 배열 슬라이스 인덱스를 반환하며, 기본값은 -1입니다.

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

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

[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.12] void QRhiTextureRenderTargetDescription::setDepthLayer(int depthLayer)

깊이/스텐실 어태치먼트에 사용될 배열 슬라이스 인덱스를 설정합니다.

특정 레이어를 대상으로 하지 않으려면 -1(기본값)을 전달합니다. 0 이상의 값으로 설정하면, 렌더 타겟은 깊이 텍스처의 정확히 해당 레이어(슬라이스)를 대상으로 하는 뷰를 부착합니다. 이는 setDepthTexture()를 통해 2D 배열 깊이 텍스처가 제공된 경우에만 유효하며, 그렇지 않으면 해당 값은 무시됩니다.

값은 깊이 텍스처의 배열 크기 범위 내에 있어야 하며, 범위를 벗어난 인덱스를 전달하면 정의되지 않은 동작이 발생합니다. 인덱스는 텍스처 생성 시 지정된 배열 범위에 관계없이 기본 텍스처를 기준으로 절대적인 값입니다.

depthLayer 를 지정하면 깊이 어태치먼트에 대한 레이어드/멀티뷰 렌더링이 비활성화됩니다.

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

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

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

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

tex setDepthTexture()를 통해 설정된 텍스처와 형식이 일치하는 2D 텍스처 또는 2D 텍스처 배열이어야 합니다.

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

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

void QRhiTextureRenderTargetDescription::setDepthStencilBuffer(QRhiRenderBuffer *renderBuffer)

뎁스-스텐실용 renderBuffer 를 설정합니다. 필수 사항은 아닙니다. 예를 들어, 이 렌더 타겟의 모든 렌더 패스에서 그래픽 파이프라인 내에 뎁스 테스트/쓰기 또는 스텐실 관련 기능이 사용되지 않는 경우, 이 값을 nullptr 로 설정해 둘 수 있습니다.

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

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

void QRhiTextureRenderTargetDescription::setDepthTexture(QRhiTexture *texture)

뎁스-스텐실용 texture 를 설정합니다. 이는 setDepthStencilBuffer()의 대안으로, QRhiRenderBuffer 대신 적절한 유형(예: QRhiTexture::D32F)의 QRhiTexture 를 제공합니다.

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

depthTexture() 및 setDepthStencilBuffer()도 참조하십시오 .

[since 6.9] void QRhiTextureRenderTargetDescription::setShadingRateMap(QRhiShadingRateMap *map)

지정된 QRhiShadingRateMap map 와 연결됩니다. 이 기능은 QRhi::VariableRateShadingMap 기능이 지원된다고 보고된 경우에만 작동합니다.

QRhiCommandBuffer::setShadingRate()도 호출된 경우, 각 타일에 대해 두 셰이딩 속도 중 더 높은 쪽이 사용됩니다. 현재 콤바이너의 동작을 제어할 수 있는 방법은 없습니다.

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

shadingRateMap()도 참조하십시오 .

[since 6.9] QRhiShadingRateMap *QRhiTextureRenderTargetDescription::shadingRateMap() const

현재 설정된 ‘ QRhiShadingRateMap ’ 값을 반환합니다. 기본값은 ‘ nullptr ’입니다.

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

setShadingRateMap()도 참조하십시오 .