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 });

Documentation des fonctions membres

[constexpr noexcept default] QRhiTextureRenderTargetDescription::QRhiTextureRenderTargetDescription()

Crée une description de cible de rendu de texture vide.

QRhiTextureRenderTargetDescription::QRhiTextureRenderTargetDescription(const QRhiColorAttachment &colorAttachment)

Crée une description de cible de rendu de texture comportant un élément associé défini par colorAttachment.

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

Crée une description de cible de rendu de texture comportant deux pièces jointes : une pièce jointe de couleur décrite par colorAttachment et une pièce jointe de profondeur/stencil décrite par depthStencilBuffer.

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

Crée une description de cible de rendu de texture comportant deux annexes : une annexe de couleur décrite par colorAttachment et une annexe de profondeur décrite par depthTexture.

const QRhiColorAttachment *QRhiTextureRenderTargetDescription::cbeginColorAttachments() const

Renvoie un itérateur constant pointant vers le premier élément de la liste des pièces jointes.

const QRhiColorAttachment *QRhiTextureRenderTargetDescription::cendColorAttachments() const

Renvoie un itérateur const pointant juste après le dernier élément de la liste des pièces jointes.

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

Renvoie la pièce jointe de couleur située à l'index e indiquée.

qsizetype QRhiTextureRenderTargetDescription::colorAttachmentCount() const

Renvoie le nombre d'attaches de couleur actuellement définies.

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

Renvoie l'index de la tranche de tableau à utiliser pour l'attachement « depth/stencil », ou -1 par défaut.

Cette fonction a été introduite dans Qt 6.12.

Voir également setDepthLayer() et setDepthTexture().

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

Renvoie la texture vers laquelle une texture (ou un tableau de textures) de profondeur à échantillonnage multiple (ou de profondeur-stencil) est résolue. Renvoie « nullptr » s’il n’y en a pas, ce qui est le cas le plus courant.

Cette fonction a été introduite dans Qt 6.8.

Voir également setDepthResolveTexture(), QRhiColorAttachment::resolveTexture() et depthTexture().

QRhiRenderBuffer *QRhiTextureRenderTargetDescription::depthStencilBuffer() const

Renvoie le tampon de rendu utilisé comme tampon de profondeur-stencil, ou nullptr si aucun n'a été défini.

Voir également setDepthStencilBuffer().

QRhiTexture *QRhiTextureRenderTargetDescription::depthTexture() const

Renvoie la texture de profondeur actuellement référencée, ou ` nullptr ` si aucune n'a été définie.

Voir aussi setDepthTexture().

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

Définit l'list e des pièces jointes de couleur.

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

Définit la liste des pièces jointes de couleur à l'aide des itérateurs first et last.

[since 6.12] void QRhiTextureRenderTargetDescription::setDepthLayer(int depthLayer)

Définit l'index de la tranche du tableau à utiliser pour l'association profondeur/stencil.

Passez -1 (valeur par défaut) pour ne cibler aucune couche en particulier. Lorsqu’il est défini sur une valeur non négative, la cible de rendu associe une vue qui cible exactement cette couche (tranche) de la texture de profondeur. Cela n’a d’effet que lorsqu’une texture de profondeur sous forme de tableau 2D est fournie via ` setDepthTexture()` ; sinon, la valeur est ignorée.

La valeur doit se situer dans les limites de la taille du tableau de la texture de profondeur ; le passage d’un index hors plage entraîne un comportement indéfini. L’index est absolu par rapport à la texture sous-jacente, indépendamment de toute plage de tableau qui aurait pu être spécifiée lors de la création de la texture.

La spécification d’une fonction depthLayer désactive le rendu en couches/multivue pour l’attachement de profondeur.

Cette fonction a été introduite dans Qt 6.12.

Voir également ` depthLayer()` et ` setDepthTexture()`.

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

Définit l'tex de la texture de résolution de profondeur (ou de profondeur-stencil).

tex Elle doit être une texture 2D ou un tableau de textures 2D dont le format correspond à celui de la texture définie via ` setDepthTexture()`.

Cette fonction a été introduite dans Qt 6.8.

Voir également depthResolveTexture(), QRhiColorAttachment::setResolveTexture() et setDepthTexture().

void QRhiTextureRenderTargetDescription::setDepthStencilBuffer(QRhiRenderBuffer *renderBuffer)

Définit la valeur « renderBuffer » pour la profondeur-stencil. Ce paramètre n'est pas obligatoire ; par exemple, si aucune fonctionnalité liée au test/à l'écriture de profondeur ou au stencil n'est utilisée dans les pipelines graphiques de l'un des passes de rendu pour cette cible de rendu, il peut rester défini sur « nullptr ».

L’utilisation d’un « QRhiRenderBuffer » plutôt que d’un « QRhiTexture » 2D comme tampon de profondeur ou de profondeur/stencil est très courante, et constitue l’approche recommandée pour les applications. L'utilisation d'un « QRhiTexture » rend alors l'appel à ` setDepthTexture()` pertinent si les données de profondeur sont destinées à être consultées ultérieurement (par exemple, échantillonnées dans un shader), ou en cas d'multiview rendering (car la texture de profondeur doit alors être un tableau de textures).

Voir également depthStencilBuffer() et setDepthTexture().

void QRhiTextureRenderTargetDescription::setDepthTexture(QRhiTexture *texture)

Définit la valeur « texture » pour la profondeur-stencil. Il s'agit d'une alternative à la fonction ` setDepthStencilBuffer()`, où, au lieu d'un objet ` QRhiRenderBuffer `, on fournit un objet ` QRhiTexture ` de type approprié (par exemple, ` QRhiTexture::D32F`).

texture peut être soit une texture 2D, soit un tableau de textures 2D (lorsque les tableaux de textures sont pris en charge). La spécification d’un tableau de textures est particulièrement pertinente avec multiview rendering.

Voir également ` depthTexture()` et ` setDepthStencilBuffer()`.

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

S'associe à l'QRhiShadingRateMap spécifiée map. Cette fonctionnalité n'est disponible que lorsque la prise en charge de la fonctionnalité QRhi::VariableRateShadingMap est signalée.

Lorsque la fonction ` QRhiCommandBuffer::setShadingRate()` est également appelée, c'est le plus élevé des deux taux d'ombrage qui est utilisé pour chaque tuile. Il n'existe actuellement aucun moyen de contrôler le comportement du combinateur.

Cette fonction a été introduite dans Qt 6.9.

Voir également shadingRateMap().

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

Renvoie la valeur actuellement définie pour ` QRhiShadingRateMap`. Par défaut, cette valeur est ` nullptr`.

Cette fonction a été introduite dans Qt 6.9.

Voir également setShadingRateMap().