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 constant pointant vers le premier élément de la liste des étapes du 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 mélange 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 du shader.

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

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

[pure virtual] bool QRhiGraphicsPipeline::create()

Crée les ressources graphiques natives correspondantes. Si des ressources sont déjà présentes en raison d'un create() antérieur sans destroy() correspondant, alors destroy() est appelé implicitement en premier.

Retourne true en cas de succès, false en cas d'échec de l'opération graphique. Quelle que soit la valeur de retour, l'appel à destroy() est toujours sûr.

QRhiGraphicsPipeline::CullMode QRhiGraphicsPipeline::cullMode() const

Renvoie le mode d'abattage des visages actuellement défini.

Voir aussi setCullMode().

int QRhiGraphicsPipeline::depthBias() const

Renvoie le biais de profondeur actuellement défini.

Voir également setDepthBias().

QRhiGraphicsPipeline::CompareOp QRhiGraphicsPipeline::depthOp() const

Renvoie la fonction de comparaison de profondeur.

Voir aussi setDepthOp().

QRhiGraphicsPipeline::Flags QRhiGraphicsPipeline::flags() const

Renvoie les drapeaux actuellement définis.

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

Retourne vrai si la pince de profondeur est activée.

Cette fonction a été introduite dans Qt 6.11.

bool QRhiGraphicsPipeline::hasDepthTest() const

Retourne true si le test de profondeur est activé.

bool QRhiGraphicsPipeline::hasDepthWrite() const

Retourne vrai si l'écriture en profondeur est activée.

bool QRhiGraphicsPipeline::hasStencilTest() const

Retourne true si le test des pochoirs est activé.

float QRhiGraphicsPipeline::lineWidth() const

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

Voir aussi 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 multivues.

Cette fonction a été introduite dans Qt 6.7.

Voir aussi setMultiViewCount().

int QRhiGraphicsPipeline::patchControlPointCount() const

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

Voir aussi setPatchControlPointCount().

QRhiGraphicsPipeline::PolygonMode QRhiGraphicsPipeline::polygonMode() const

Renvoie le mode polygone.

Voir aussi setPolygonMode().

QRhiRenderPassDescriptor *QRhiGraphicsPipeline::renderPassDescriptor() const

Renvoie l'adresse 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. 1 signifie qu'il n'y a pas d'anti-crénelage multi-échantillon.

Voir aussi setSampleCount().

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

Définit l'élimination des visages spécifiée mode.

Voir également cullMode().

void QRhiGraphicsPipeline::setDepthBias(int bias)

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

Voir également depthBias().

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

Active la compression de la profondeur lorsque enable est vrai. Lorsque la compression de profondeur est activée, les primitives qui seraient autrement coupées par le plan de coupe proche ou lointain sont tramées et leurs valeurs de profondeur sont restreintes à la plage de profondeur. Lorsqu'il est désactivé (par défaut), ces primitives sont écrêté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 aussi depthOp().

void QRhiGraphicsPipeline::setDepthTest(bool enable)

Active ou désactive la vérification de la profondeur sur la base de enable. Le test de profondeur et l'écriture des données de profondeur sont désactivés par défaut.

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. Cette fonction est désactivée par défaut. 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 drapeaux f.

Voir aussi 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 la ligne width. Si la fonctionnalité QRhi::WideLines est signalée comme non prise en charge à l'exécution, les valeurs autres que 1.0f sont ignorées.

Voir aussi lineWidth().

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

Définit la vue count pour le rendu multi-vues. La valeur par défaut est 0, ce qui indique qu'il n'y a pas de rendu multivue. count doit être égal ou supérieur à 2 pour déclencher le rendu multivue.

Le rendu multi-vues n'est disponible que si l'adresse MultiView feature est signalée comme étant prise en charge. La cible de rendu doit être un tableau de textures 2D et l'attachement de couleur pour la cible de rendu doit avoir le même ensemble count.

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

Cette fonction a été introduite dans Qt 6.7.

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

void QRhiGraphicsPipeline::setPatchControlPointCount(int count)

Définit le nombre de points de contrôle de patch à 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 le polygone mode. La valeur par défaut est Fill.

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

void QRhiGraphicsPipeline::setRenderPassDescriptor(QRhiRenderPassDescriptor *desc)

S'associe au site spécifié QRhiRenderPassDescriptor desc .

Voir aussi renderPassDescriptor().

void QRhiGraphicsPipeline::setSampleCount(int s)

Définit le nombre d'échantillons. Les valeurs typiques 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)

Associe à srb la description de la structure de liaison des ressources et les ressources (QRhiBuffer, QRhiTexture) elles-mêmes. Ce dernier point est facultatif, car seule la disposition importe lors de la création du pipeline. Par conséquent, le srb passé ici peut laisser les objets de tampon ou de texture non spécifiés (nullptr) tant qu'il y a un autre layout-compatible QRhiShaderResourceBindings lié via setShaderResources() avant d'enregistrer les appels de dessin.

Voir aussi shaderResourceBindings().

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

Définit l'adresse list des étapes du shader.

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

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

void QRhiGraphicsPipeline::setSlopeScaledDepthBias(float bias)

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

Voir également slopeScaledDepthBias().

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

Définit le test du pochoir state pour les faces arrière.

Voir également stencilBack().

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

Définit le test du pochoir state pour les faces avant.

Voir également stencilFront().

void QRhiGraphicsPipeline::setStencilReadMask(quint32 mask)

Définit la lecture du stencil mask. La valeur par défaut est 0xFF.

Voir aussi stencilReadMask().

void QRhiGraphicsPipeline::setStencilTest(bool enable)

Active ou désactive les tests de pochoirs basés sur enable. Par défaut, cette option est désactivée.

Voir également hasStencilTest().

void QRhiGraphicsPipeline::setStencilWriteMask(quint32 mask)

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

Voir également stencilWriteMask().

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

Définit l'adresse 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 (par exemple, un site QRhiTextureRenderTarget avec plus d'un site QRhiColorAttachment), il doit y avoir une structure TargetBlend par cible de rendu (attachement de couleur).

Par défaut, il n'y a qu'un seul ensemble TargetBlend construit par défaut.

Voir aussi 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 primitive t.

Voir aussi topology().

void QRhiGraphicsPipeline::setVertexInputLayout(const QRhiVertexInputLayout &layout)

Spécifie l'entrée vertex layout.

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 du shader à l'adresse index spécifiée.

qsizetype QRhiGraphicsPipeline::shaderStageCount() const

Renvoie le nombre d'étages de shaders 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 du pochoir pour les faces arrière.

Voir aussi setStencilBack().

QRhiGraphicsPipeline::StencilOpState QRhiGraphicsPipeline::stencilFront() const

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

Voir aussi setStencilFront().

quint32 QRhiGraphicsPipeline::stencilReadMask() const

Renvoie le masque de lecture actuel du stencil.

Voir aussi setStencilReadMask().

quint32 QRhiGraphicsPipeline::stencilWriteMask() const

Renvoie le masque d'écriture actuel du stencil.

Voir aussi setStencilWriteMask().

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

Renvoie le paramètre de mélange de la cible de rendu à l'adresse index.

qsizetype QRhiGraphicsPipeline::targetBlendCount() const

Renvoie le nombre de paramètres de mélange de la cible de rendu.

QRhiGraphicsPipeline::Topology QRhiGraphicsPipeline::topology() const

Renvoie la topologie primitive actuellement définie.

Voir aussi setTopology().

QRhiVertexInputLayout QRhiGraphicsPipeline::vertexInputLayout() const

Renvoie la spécification de disposition d'entrée des vertex actuellement définie.

Voir aussi setVertexInputLayout().