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

Dokumentation der Member-Funktionen

const QRhiShaderStage *QRhiGraphicsPipeline::cbeginShaderStages() const

Gibt einen const-Iterator zurück, der auf das erste Element in der Shader-Stage-Liste verweist.

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

Gibt einen konstanten Iterator zurück, der auf das erste Element in der Liste der Blend-Einstellungen des Renderziels verweist.

const QRhiShaderStage *QRhiGraphicsPipeline::cendShaderStages() const

Gibt einen konstanten Iterator zurück, der direkt auf das Element nach dem letzten Element in der Shader-Stufenliste zeigt.

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

Gibt einen konstanten Iterator zurück, der direkt auf das Element nach dem letzten Element in der Liste der Blend-Einstellungen für das Renderziel zeigt.

[pure virtual] bool QRhiGraphicsPipeline::create()

Erstellt die entsprechenden nativen Grafikressourcen. Falls aufgrund eines früheren Aufrufs von `create()` bereits Ressourcen vorhanden sind, für die noch kein entsprechender Aufruf von ` destroy()` erfolgt ist, wird zunächst implizit ` destroy()` aufgerufen.

Gibt bei Erfolg ` true ` zurück, bei einem fehlgeschlagenen Grafikvorgang ` false `. Unabhängig vom Rückgabewert ist der Aufruf von ` destroy()` stets sicher.

QRhiGraphicsPipeline::CullMode QRhiGraphicsPipeline::cullMode() const

Gibt den aktuell eingestellten Face-Culling-Modus zurück.

Siehe auch „ setCullMode()“.

int QRhiGraphicsPipeline::depthBias() const

Gibt den aktuell eingestellten Tiefen-Bias zurück.

Siehe auch „ setDepthBias()“.

QRhiGraphicsPipeline::CompareOp QRhiGraphicsPipeline::depthOp() const

Gibt die Tiefenvergleichsfunktion zurück.

Siehe auch ` setDepthOp()`.

QRhiGraphicsPipeline::Flags QRhiGraphicsPipeline::flags() const

Gibt die aktuell gesetzten Flags zurück.

Siehe auch ` setFlags()`.

QRhiGraphicsPipeline::FrontFace QRhiGraphicsPipeline::frontFace() const

Gibt den aktuell eingestellten Front-Face-Modus zurück.

Siehe auch „ setFrontFace()“.

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

Gibt „true“ zurück, wenn die Tiefenbegrenzung aktiviert ist.

Diese Funktion wurde in Qt 6.11 eingeführt.

bool QRhiGraphicsPipeline::hasDepthTest() const

Gibt „true“ zurück, wenn die Tiefenprüfung aktiviert ist.

bool QRhiGraphicsPipeline::hasDepthWrite() const

Gibt „true“ zurück, wenn das Schreiben in die Tiefe aktiviert ist.

bool QRhiGraphicsPipeline::hasStencilTest() const

Gibt „true“ zurück, wenn die Stencil-Prüfung aktiviert ist.

float QRhiGraphicsPipeline::lineWidth() const

Gibt die aktuell eingestellte Linienbreite zurück. Der Standardwert ist 1,0f.

Siehe auch „ setLineWidth()“.

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

Gibt die Anzahl der Ansichten zurück. Der Standardwert ist 0, was bedeutet, dass keine Mehrfachansicht gerendert wird.

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch ` setMultiViewCount()`.

int QRhiGraphicsPipeline::patchControlPointCount() const

Gibt die Anzahl der aktuell festgelegten Patch-Kontrollpunkte zurück.

Siehe auch „ setPatchControlPointCount()“.

QRhiGraphicsPipeline::PolygonMode QRhiGraphicsPipeline::polygonMode() const

Gibt den Polygonmodus zurück.

Siehe auch „ setPolygonMode()“.

QRhiRenderPassDescriptor *QRhiGraphicsPipeline::renderPassDescriptor() const

Gibt die aktuell eingestellte „ QRhiRenderPassDescriptor “ zurück.

Siehe auch ` setRenderPassDescriptor()`.

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

Implementiert neu: ` QRhiResource::resourceType()` const.

Gibt den Ressourcentyp zurück.

int QRhiGraphicsPipeline::sampleCount() const

Gibt die aktuell eingestellte Sample-Anzahl zurück. 1 bedeutet, dass kein Multisample-Antialiasing verwendet wird.

Siehe auch setSampleCount().

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

Legt die angegebene Face-Culling- mode fest.

Siehe auch cullMode().

void QRhiGraphicsPipeline::setDepthBias(int bias)

Legt die Tiefe „ bias “ fest. Der Standardwert ist 0.

Siehe auch ` depthBias()`.

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

Aktiviert die Tiefenbegrenzung, wenn „ enable “ auf „true“ gesetzt ist. Wenn die Tiefenbegrenzung aktiviert ist, werden Primitive, die andernfalls von der nahen oder fernen Clip-Ebene abgeschnitten würden, gerastert und ihre Tiefenwerte auf den Tiefenbereich begrenzt. Ist diese Option deaktiviert (Standardeinstellung), werden solche Primitive abgeschnitten.

Diese Funktion wurde in Qt 6.11 eingeführt.

Siehe auch „ hasDepthClamp()“.

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

Legt die Funktion für den Tiefenvergleich fest: op.

Siehe auch depthOp().

void QRhiGraphicsPipeline::setDepthTest(bool enable)

Aktiviert oder deaktiviert die Tiefenprüfung basierend auf enable. Sowohl die Tiefenprüfung als auch das Schreiben von Tiefendaten sind standardmäßig deaktiviert.

Siehe auch hasDepthTest() und setDepthWrite().

void QRhiGraphicsPipeline::setDepthWrite(bool enable)

Steuert das Schreiben von Tiefendaten in den Tiefenpuffer auf der Grundlage von enable. Standardmäßig ist diese Option deaktiviert. Das Schreiben von Tiefendaten wird in der Regel zusammen mit dem Tiefentest aktiviert.

Siehe auch „ hasDepthWrite “ () und „ setDepthTest “ ().

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

Setzt die Flags „ f “.

Siehe auch flags().

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

Legt den Modus für die Vorderseite fest: f.

Siehe auch frontFace().

void QRhiGraphicsPipeline::setLineWidth(float width)

Legt die Zeilen width fest. Wenn die Funktion „ QRhi::WideLines “ zur Laufzeit als nicht unterstützt gemeldet wird, werden Werte ungleich 1.0f ignoriert.

Siehe auch ` lineWidth()`.

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

Legt den View- count -Wert für das Multiview-Rendering fest. Der Standardwert ist 0, was bedeutet, dass kein Multiview-Rendering stattfindet. „ count “ muss mindestens 2 betragen, um das Multiview-Rendering auszulösen.

Multiview ist nur verfügbar, wenn die „ MultiView feature “ als unterstützt gemeldet wird. Das Renderziel muss ein 2D-Textur-Array sein, und für den Farb-Attachment des Renderziels muss derselbe Wert für „ count “ festgelegt sein.

Weitere Details zum Multiview-Rendering finden Sie unter „ QRhiColorAttachment::setMultiViewCount()“.

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch multiViewCount(), QRhi::MultiView sowie QRhiColorAttachment::setMultiViewCount().

void QRhiGraphicsPipeline::setPatchControlPointCount(int count)

Legt die Anzahl der Patch-Kontrollpunkte auf „ count “ fest. Der Standardwert ist 3. Diese Einstellung wird nur verwendet, wenn die Topologie auf „ Patches “ gesetzt ist.

Siehe auch ` patchControlPointCount()`.

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

Legt die Polygon mode fest. Die Standardeinstellung ist „Fill“.

Siehe auch „ polygonMode()“ und „ QRhi::NonFillPolygonMode “.

void QRhiGraphicsPipeline::setRenderPassDescriptor(QRhiRenderPassDescriptor *desc)

Verweist auf die angegebene QRhiRenderPassDescriptor desc .

Siehe auch renderPassDescriptor().

void QRhiGraphicsPipeline::setSampleCount(int s)

Legt die Anzahl der Samples fest. Typische Werte für „ s “ sind 1, 4 oder 8. Die Pipeline muss stets mit dem Renderziel kompatibel sein, d. h., die Anzahl der Samples muss übereinstimmen.

Siehe auch „ sampleCount()“ und „ QRhi::supportedSampleCounts()“.

void QRhiGraphicsPipeline::setShaderResourceBindings(QRhiShaderResourceBindings *srb)

Wird mit ` srb ` verknüpft, das das Layout der Ressourcenbindung sowie die Ressourcen (QRhiBuffer, QRhiTexture) selbst beschreibt. Letzteres ist optional, da bei der Erstellung der Pipeline nur das Layout von Bedeutung ist. Daher kann das hier übergebene ` srb ` die tatsächlichen Puffer- oder Texturobjekte unbestimmt lassen (nullptr), solange ein anderes, ` layout-compatible ` QRhiShaderResourceBindings, vor der Aufzeichnung der Draw-Calls über ` setShaderResources()` gebunden wurde.

Siehe auch shaderResourceBindings().

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

Legt die „ list “ der Shader-Stufen fest.

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

Legt die Liste der Shader-Stufen anhand der Iteratoren „ first “ und „ last “ fest.

void QRhiGraphicsPipeline::setSlopeScaledDepthBias(float bias)

Legt die skalierte Tiefen bias, der Steigung fest. Der Standardwert ist 0.

Siehe auch slopeScaledDepthBias().

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

Legt die Stencil-Test- state en für Rückseiten fest.

Siehe auch ` stencilBack()`.

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

Legt die Stencil-Test- state en für die Vorderseiten fest.

Siehe auch ` stencilFront()`.

void QRhiGraphicsPipeline::setStencilReadMask(quint32 mask)

Legt das Lese- mask s der Schablone fest. Der Standardwert ist 0xFF.

Siehe auch ` stencilReadMask()`.

void QRhiGraphicsPipeline::setStencilTest(bool enable)

Aktiviert oder deaktiviert Stencil-Tests basierend auf enable. Standardmäßig ist diese Option deaktiviert.

Siehe auch hasStencilTest().

void QRhiGraphicsPipeline::setStencilWriteMask(quint32 mask)

Legt den Stencil-Schreib mask fest. Der Standardwert ist 0xFF.

Siehe auch ` stencilWriteMask()`.

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

Legt die „ list “ der Einstellungen für die Überblendung von Renderzielen fest. Hierbei handelt es sich um eine Liste, da bei Verwendung mehrerer Renderziele (d. h. eines „ QRhiTextureRenderTarget “ mit mehr als einer „ QRhiColorAttachment “) pro Renderziel (Farb-Attachment) eine „ TargetBlend “-Struktur vorhanden sein muss.

Standardmäßig ist ein standardmäßig erstelltes „ TargetBlend “-Set vorhanden.

Siehe auch „ QRhi::MaxColorAttachments “.

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

Legt die Liste der Blend-Einstellungen für das Renderziel anhand der Iteratoren first und last fest.

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

Legt die Topologie der Primitive fest: t.

Siehe auch topology().

void QRhiGraphicsPipeline::setVertexInputLayout(const QRhiVertexInputLayout &layout)

Legt die Scheitelpunkt-Eingabe layout fest.

Siehe auch ` vertexInputLayout()`.

QRhiShaderResourceBindings *QRhiGraphicsPipeline::shaderResourceBindings() const

Gibt das aktuell zugeordnete „ QRhiShaderResourceBindings “-Objekt zurück.

Siehe auch setShaderResourceBindings().

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

Gibt die Shader-Stufe an der angegebenen Adresse „ index “ zurück.

qsizetype QRhiGraphicsPipeline::shaderStageCount() const

Gibt die Anzahl der Shader-Stufen in dieser Pipeline zurück.

float QRhiGraphicsPipeline::slopeScaledDepthBias() const

Gibt den aktuell eingestellten, steigungsskalierten Tiefen-Bias zurück.

Siehe auch ` setSlopeScaledDepthBias()`.

QRhiGraphicsPipeline::StencilOpState QRhiGraphicsPipeline::stencilBack() const

Gibt den aktuellen Stencil-Test-Status für Rückseiten zurück.

Siehe auch „ setStencilBack()“.

QRhiGraphicsPipeline::StencilOpState QRhiGraphicsPipeline::stencilFront() const

Gibt den aktuellen Stencil-Test-Status für Vorderseiten zurück.

Siehe auch „ setStencilFront()“.

quint32 QRhiGraphicsPipeline::stencilReadMask() const

Gibt die aktuelle Lese-Maske für die Schablone zurück.

Siehe auch „ setStencilReadMask()“.

quint32 QRhiGraphicsPipeline::stencilWriteMask() const

Gibt die aktuelle Stencil-Schreibmaske zurück.

Siehe auch „ setStencilWriteMask()“.

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

Gibt die Blend-Einstellung des Renderziels an der angegebenen Koordinate ` index` zurück.

qsizetype QRhiGraphicsPipeline::targetBlendCount() const

Gibt die Anzahl der Blend-Einstellungen für das Renderziel zurück.

QRhiGraphicsPipeline::Topology QRhiGraphicsPipeline::topology() const

Gibt die aktuell festgelegte primitive Topologie zurück.

Siehe auch „ setTopology()“.

QRhiVertexInputLayout QRhiGraphicsPipeline::vertexInputLayout() const

Gibt die aktuell festgelegte Spezifikation für das Vertex-Eingabelayout zurück.

Siehe auch „ setVertexInputLayout()“.