QRhiGraphicsPipeline Class

QRhiShaderResourceBindings *srb;
QRhiRenderPassDescriptor *rpDesc;
QShader vs, fs;
// ...

QRhiVertexInputLayout inputLayout;
inputLayout.setBindings({ { 3 * sizeof(float) } });
inputLayout.setAttributes({ { 0, 0, QRhiVertexInputAttribute::Float3, 0 } });

QRhiGraphicsPipeline *ps = rhi->newGraphicsPipeline();
ps->setShaderStages({ { QRhiShaderStage::Vertex, vs }, { QRhiShaderStage::Fragment, fs } });
ps->setVertexInputLayout(inputLayout);
ps->setShaderResourceBindings(srb);
ps->setRenderPassDescriptor(rpDesc);
if (!ps->create()) { error(); }

Documentation des fonctions membres

const QRhiShaderStage *QRhiGraphicsPipeline::cbeginShaderStages() const

Renvoie un itérateur `const` pointant vers le premier élément de la liste des étapes de shader.

const QRhiGraphicsPipeline::TargetBlend *QRhiGraphicsPipeline::cbeginTargetBlends() const

Renvoie un itérateur constant pointant vers le premier élément de la liste des paramètres de fusion de la cible de rendu.

const QRhiShaderStage *QRhiGraphicsPipeline::cendShaderStages() const

Renvoie un itérateur constant pointant juste après le dernier élément de la liste des étapes de shader.

const QRhiGraphicsPipeline::TargetBlend *QRhiGraphicsPipeline::cendTargetBlends() const

Renvoie un itérateur const pointant juste après le dernier élément de la liste des paramètres de fusion de la cible de rendu.

[pure virtual] bool QRhiGraphicsPipeline::create()

Crée les ressources graphiques natives correspondantes. Si des ressources existent déjà à la suite d’un appel antérieur à `create()` sans ` destroy()` correspondant, alors la fonction ` destroy()` est d’abord appelée implicitement.

Renvoie ` true ` en cas de réussite, et ` false ` lorsqu’une opération graphique a échoué. Quelle que soit la valeur renvoyée, l’appel à ` destroy()` est toujours sans risque.

QRhiGraphicsPipeline::CullMode QRhiGraphicsPipeline::cullMode() const

Renvoie le mode de culling des faces actuellement défini.

Voir aussi setCullMode().

int QRhiGraphicsPipeline::depthBias() const

Renvoie la correction de profondeur actuellement définie.

Voir également setDepthBias().

QRhiGraphicsPipeline::CompareOp QRhiGraphicsPipeline::depthOp() const

Renvoie la fonction de comparaison de profondeur.

Voir également setDepthOp().

QRhiGraphicsPipeline::Flags QRhiGraphicsPipeline::flags() const

Renvoie les indicateurs actuellement activés.

Voir aussi setFlags().

QRhiGraphicsPipeline::FrontFace QRhiGraphicsPipeline::frontFace() const

Renvoie le mode de face avant actuellement défini.

Voir aussi setFrontFace().

[since 6.11] bool QRhiGraphicsPipeline::hasDepthClamp() const

Renvoie « true » si le plafonnement de profondeur est activé.

Cette fonction a été introduite dans Qt 6.11.

bool QRhiGraphicsPipeline::hasDepthTest() const

Renvoie « true » si le test de profondeur est activé.

bool QRhiGraphicsPipeline::hasDepthWrite() const

Renvoie « true » si l'écriture en profondeur est activée.

bool QRhiGraphicsPipeline::hasStencilTest() const

Renvoie « true » si le test de stencil est activé.

float QRhiGraphicsPipeline::lineWidth() const

Renvoie la largeur de ligne actuellement définie. La valeur par défaut est 1,0f.

Voir également setLineWidth().

[since 6.7] int QRhiGraphicsPipeline::multiViewCount() const

Renvoie le nombre de vues. La valeur par défaut est 0, ce qui indique qu'il n'y a pas de rendu multivue.

Cette fonction a été introduite dans Qt 6.7.

Voir également ` setMultiViewCount()`.

int QRhiGraphicsPipeline::patchControlPointCount() const

Renvoie le nombre de points de contrôle de patch actuellement défini.

Voir également setPatchControlPointCount().

QRhiGraphicsPipeline::PolygonMode QRhiGraphicsPipeline::polygonMode() const

Renvoie le mode polygonal.

Voir aussi setPolygonMode().

QRhiRenderPassDescriptor *QRhiGraphicsPipeline::renderPassDescriptor() const

Renvoie l'QRhiRenderPassDescriptor actuellement définie.

Voir aussi setRenderPassDescriptor().

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

Réimplémente : ` QRhiResource::resourceType()` const.

Renvoie le type de ressource.

int QRhiGraphicsPipeline::sampleCount() const

Renvoie le nombre d'échantillons actuellement défini. La valeur 1 signifie qu'il n'y a pas d'anticrénelage par suréchantillonnage.

Voir également setSampleCount().

void QRhiGraphicsPipeline::setCullMode(QRhiGraphicsPipeline::CullMode mode)

Définit l'mode de culling des faces spécifiée.

Voir également cullMode().

void QRhiGraphicsPipeline::setDepthBias(int bias)

Définit la profondeur bias. La valeur par défaut est 0.

Voir aussi depthBias().

[since 6.11] void QRhiGraphicsPipeline::setDepthClamp(bool enable)

Active le « depth clamping » lorsque la valeur de enable est « true ». Lorsque le « depth clamping » est activé, les primitives qui seraient normalement rognées par le plan de rognage proche ou lointain sont rastérisées et leurs valeurs de profondeur sont limitées à la plage de profondeur définie. Lorsqu’il est désactivé (valeur par défaut), ces primitives sont rognées.

Cette fonction a été introduite dans Qt 6.11.

Voir aussi hasDepthClamp().

void QRhiGraphicsPipeline::setDepthOp(QRhiGraphicsPipeline::CompareOp op)

Définit la fonction de comparaison de profondeur op.

Voir également depthOp().

void QRhiGraphicsPipeline::setDepthTest(bool enable)

Active ou désactive la vérification de la profondeur en fonction de enable. Par défaut, la vérification de la profondeur et l'écriture des données de profondeur sont désactivées.

Voir également hasDepthTest() et setDepthWrite().

void QRhiGraphicsPipeline::setDepthWrite(bool enable)

Contrôle l'écriture des données de profondeur dans le tampon de profondeur en fonction de enable. Par défaut, cette option est désactivée. L'écriture de profondeur est généralement activée en même temps que le test de profondeur.

Voir également hasDepthWrite() et setDepthTest().

void QRhiGraphicsPipeline::setFlags(QRhiGraphicsPipeline::Flags f)

Définit les indicateurs « f ».

Voir également flags().

void QRhiGraphicsPipeline::setFrontFace(QRhiGraphicsPipeline::FrontFace f)

Définit le mode de la face avant f.

Voir également frontFace().

void QRhiGraphicsPipeline::setLineWidth(float width)

Définit l'width de ligne. Si la fonctionnalité « QRhi::WideLines » est signalée comme non prise en charge lors de l'exécution, les valeurs autres que 1.0f sont ignorées.

Voir également ` lineWidth()`.

[since 6.7] void QRhiGraphicsPipeline::setMultiViewCount(int count)

Définit l'count de la vue pour le rendu multivue. La valeur par défaut est 0, ce qui indique qu'il n'y a pas de rendu multivue. La valeur de « count » doit être égale ou supérieure à 2 pour activer le rendu multivue.

Le rendu multi-vue n'est disponible que lorsque l'MultiView feature est signalée comme prise en charge. La cible de rendu doit être un tableau de textures 2D, et l'attachement de couleur associé à cette cible doit avoir la même valeur définie pour ` count `.

Voir QRhiColorAttachment::setMultiViewCount() pour plus de détails sur le rendu multivue.

Cette fonction a été introduite dans Qt 6.7.

Voir également multiViewCount(), QRhi::MultiView et QRhiColorAttachment::setMultiViewCount().

void QRhiGraphicsPipeline::setPatchControlPointCount(int count)

Définit le nombre de points de contrôle du patch sur count. La valeur par défaut est 3. Ce paramètre n'est utilisé que lorsque la topologie est définie sur Patches.

Voir également patchControlPointCount().

void QRhiGraphicsPipeline::setPolygonMode(QRhiGraphicsPipeline::PolygonMode mode)

Définit l'mode du polygone. La valeur par défaut est « Fill ».

Voir également polygonMode() et QRhi::NonFillPolygonMode.

void QRhiGraphicsPipeline::setRenderPassDescriptor(QRhiRenderPassDescriptor *desc)

Renvoie l'QRhiRenderPassDescriptor spécifiée desc.

Voir également renderPassDescriptor().

void QRhiGraphicsPipeline::setSampleCount(int s)

Définit le nombre d'échantillons. Les valeurs courantes pour « s » sont 1, 4 ou 8. Le pipeline doit toujours être compatible avec la cible de rendu, c'est-à-dire que le nombre d'échantillons doit correspondre.

Voir également sampleCount() et QRhi::supportedSampleCounts().

void QRhiGraphicsPipeline::setShaderResourceBindings(QRhiShaderResourceBindings *srb)

Associé à ` srb `, qui décrit la disposition des liaisons de ressources et les ressources elles-mêmes (QRhiBuffer, QRhiTexture). Ce dernier élément est facultatif, car seule la disposition importe lors de la création du pipeline. Par conséquent, l’ srb transmis ici peut ne pas spécifier les objets de tampon ou de texture réels (nullptr), à condition qu’il existe un autre ` layout-compatible ` QRhiShaderResourceBindings lié via ` setShaderResources()` avant l’enregistrement des appels de dessin.

Voir également shaderResourceBindings().

void QRhiGraphicsPipeline::setShaderStages(std::initializer_list<QRhiShaderStage> list)

Définit l'list e des étapes de shader.

template <typename InputIterator> void QRhiGraphicsPipeline::setShaderStages(InputIterator first, InputIterator last)

Définit la liste des étapes de shader à partir des itérateurs first et last.

void QRhiGraphicsPipeline::setSlopeScaledDepthBias(float bias)

Définit la profondeur mise à l'échelle en fonction de la pente bias. La valeur par défaut est 0.

Voir également slopeScaledDepthBias().

void QRhiGraphicsPipeline::setStencilBack(const QRhiGraphicsPipeline::StencilOpState &state)

Définit l’ state de test de stencil pour les faces arrière.

Voir aussi stencilBack().

void QRhiGraphicsPipeline::setStencilFront(const QRhiGraphicsPipeline::StencilOpState &state)

Définit l'state de test de pochoir pour les faces avant.

Voir aussi stencilFront().

void QRhiGraphicsPipeline::setStencilReadMask(quint32 mask)

Définit l'mask de lecture du pochoir. La valeur par défaut est 0xFF.

Voir également stencilReadMask().

void QRhiGraphicsPipeline::setStencilTest(bool enable)

Active ou désactive les tests de stencil en fonction de enable. Par défaut, cette option est désactivée.

Voir également hasStencilTest().

void QRhiGraphicsPipeline::setStencilWriteMask(quint32 mask)

Définit l'mask d'écriture du pochoir. La valeur par défaut est 0xFF.

Voir également la fonction stencilWriteMask().

void QRhiGraphicsPipeline::setTargetBlends(std::initializer_list<QRhiGraphicsPipeline::TargetBlend> list)

Définit l'list des paramètres de fusion des cibles de rendu. Il s'agit d'une liste car, lorsque plusieurs cibles de rendu sont utilisées (c'est-à-dire une « QRhiTextureRenderTarget » comportant plusieurs « QRhiColorAttachment »), il doit y avoir une structure « TargetBlend » par cible de rendu (attachement de couleur).

Par défaut, il existe un ensemble TargetBlend construit par défaut.

Voir également QRhi::MaxColorAttachments.

template <typename InputIterator> void QRhiGraphicsPipeline::setTargetBlends(InputIterator first, InputIterator last)

Définit la liste des paramètres de fusion de la cible de rendu à partir des itérateurs first et last.

void QRhiGraphicsPipeline::setTopology(QRhiGraphicsPipeline::Topology t)

Définit la topologie de la primitive t.

Voir également topology().

void QRhiGraphicsPipeline::setVertexInputLayout(const QRhiVertexInputLayout &layout)

Spécifie l'layout d'entrée des sommets.

Voir également vertexInputLayout().

QRhiShaderResourceBindings *QRhiGraphicsPipeline::shaderResourceBindings() const

Renvoie l'objet ` QRhiShaderResourceBindings ` actuellement associé.

Voir aussi setShaderResourceBindings().

const QRhiShaderStage *QRhiGraphicsPipeline::shaderStageAt(qsizetype index) const

Renvoie l'étape de shader à l'index spécifiée.

qsizetype QRhiGraphicsPipeline::shaderStageCount() const

Renvoie le nombre d'étapes de shader dans ce pipeline.

float QRhiGraphicsPipeline::slopeScaledDepthBias() const

Renvoie le biais de profondeur mis à l'échelle de la pente actuellement défini.

Voir également setSlopeScaledDepthBias().

QRhiGraphicsPipeline::StencilOpState QRhiGraphicsPipeline::stencilBack() const

Renvoie l'état actuel du test de stencil pour les faces arrière.

Voir également setStencilBack().

QRhiGraphicsPipeline::StencilOpState QRhiGraphicsPipeline::stencilFront() const

Renvoie l'état actuel du test de stencil pour les faces avant.

Voir également setStencilFront().

quint32 QRhiGraphicsPipeline::stencilReadMask() const

Renvoie le masque de lecture de stencil actuel.

Voir aussi setStencilReadMask().

quint32 QRhiGraphicsPipeline::stencilWriteMask() const

Renvoie le masque d'écriture stencil actuel.

Voir également setStencilWriteMask().

const QRhiGraphicsPipeline::TargetBlend *QRhiGraphicsPipeline::targetBlendAt(qsizetype index) const

Renvoie le paramètre de fusion de la cible de rendu à l'index spécifiée.

qsizetype QRhiGraphicsPipeline::targetBlendCount() const

Renvoie le nombre de paramètres de fusion de la cible de rendu.

QRhiGraphicsPipeline::Topology QRhiGraphicsPipeline::topology() const

Renvoie la topologie primitive actuellement définie.

Voir également setTopology().

QRhiVertexInputLayout QRhiGraphicsPipeline::vertexInputLayout() const

Renvoie la spécification de disposition des entrées de sommets actuellement définie.

Voir également setVertexInputLayout().