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 Mitgliedsfunktionen

const QRhiShaderStage *QRhiGraphicsPipeline::cbeginShaderStages() const

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

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

Gibt einen konstanten Iterator zurück, der auf das erste Element in der Liste der Rendering-Ziel-Mischeinstellungen zeigt.

const QRhiShaderStage *QRhiGraphicsPipeline::cendShaderStages() const

Gibt einen konstanten Iterator zurück, der direkt auf das letzte Element in der Shader-Stage-Liste zeigt.

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

Gibt einen konstanten Iterator zurück, der direkt auf das letzte Element in der Liste der Rendering-Ziel-Mischeinstellungen zeigt.

[pure virtual] bool QRhiGraphicsPipeline::create()

Erzeugt die entsprechenden nativen Grafikressourcen. Wenn aufgrund eines früheren create() ohne entsprechende destroy() bereits Ressourcen vorhanden sind, wird destroy() implizit zuerst aufgerufen.

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

QRhiGraphicsPipeline::CullMode QRhiGraphicsPipeline::cullMode() const

Gibt den aktuell eingestellten Modus für die Gesichtsauslese zurück.

Siehe auch setCullMode().

int QRhiGraphicsPipeline::depthBias() const

Gibt die aktuell eingestellte Tiefenverzerrung 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 Frontalmodus zurück.

Siehe auch setFrontFace().

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 Schablonenprüfung aktiviert ist.

float QRhiGraphicsPipeline::lineWidth() const

Gibt die aktuell eingestellte Linienbreite zurück. Die Vorgabe 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 kein Multiview-Rendering stattfindet.

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch setMultiViewCount().

int QRhiGraphicsPipeline::patchControlPointCount() const

Gibt die Anzahl der aktuell eingestellten 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

Reimplements: QRhiResource::resourceType() const.

Gibt den Ressourcentyp zurück.

int QRhiGraphicsPipeline::sampleCount() const

Gibt die aktuell eingestellte Sampleanzahl zurück. 1 bedeutet kein Multisample-Antialiasing.

Siehe auch setSampleCount().

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

Setzt das angegebene Face Culling mode.

Siehe auch cullMode().

void QRhiGraphicsPipeline::setDepthBias(int bias)

Legt die Tiefe bias fest. Der Standardwert ist 0.

Siehe auch depthBias().

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

Legt die Tiefenvergleichsfunktion op fest.

Siehe auch depthOp().

void QRhiGraphicsPipeline::setDepthTest(bool enable)

Aktiviert oder deaktiviert die Tiefenprüfung auf der Grundlage von enable. Sowohl die Tiefenprüfung als auch das Schreiben der 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 dies deaktiviert. Das Schreiben in die Tiefe wird normalerweise zusammen mit der Tiefenprüfung 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)

Stellt den Frontalmodus f ein.

Siehe auch frontFace().

void QRhiGraphicsPipeline::setLineWidth(float width)

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

Siehe auch lineWidth().

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

Legt die Ansicht count für Multiview-Rendering fest. Der Standardwert ist 0, was bedeutet, dass kein Multiview-Rendering stattfindet. count muss 2 oder größer sein, um Multiview-Rendering auszulösen.

Multiview ist nur verfügbar, wenn die MultiView feature als unterstützt gemeldet wird. Das Rendering-Ziel muss ein 2D-Textur-Array sein, und das Farbattachment für das Rendering-Ziel muss denselben count -Satz haben.

Siehe QRhiColorAttachment::setMultiViewCount() für weitere Details zum Multiview-Rendering.

Diese Funktion wurde in Qt 6.7 eingeführt.

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

void QRhiGraphicsPipeline::setPatchControlPointCount(int count)

Legt die Anzahl der Patch-Kontrollpunkte auf count fest. Der Standardwert ist 3. Dies wird nur verwendet, wenn die Topologie auf Patches eingestellt ist.

Siehe auch patchControlPointCount().

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

Legt das Polygon mode fest. Die Standardeinstellung ist Füllen.

Siehe auch polygonMode() und QRhi::NonFillPolygonMode.

void QRhiGraphicsPipeline::setRenderPassDescriptor(QRhiRenderPassDescriptor *desc)

Assoziiert mit dem angegebenen QRhiRenderPassDescriptor desc .

Siehe auch renderPassDescriptor().

void QRhiGraphicsPipeline::setSampleCount(int s)

Legt die Anzahl der Proben fest. Typische Werte für s sind 1, 4 oder 8. Die Pipeline muss immer mit dem Rendering-Ziel kompatibel sein, d. h. die Sample-Zahlen müssen übereinstimmen.

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

void QRhiGraphicsPipeline::setShaderResourceBindings(QRhiShaderResourceBindings *srb)

Assoziiert mit srb und beschreibt das Layout der Ressourcenbindung und die Ressourcen (QRhiBuffer, QRhiTexture) selbst. Letzteres ist optional, da nur das Layout bei der Erstellung der Pipeline von Bedeutung ist. Daher kann das hier übergebene srb die eigentlichen Puffer- oder Texturobjekte unspezifiziert lassen (nullptr), solange ein weiteres, layout-compatible QRhiShaderResourceBindings über setShaderResources() vor der Aufzeichnung der Zeichenaufrufe gebunden wird.

Siehe auch shaderResourceBindings().

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

Legt die list von Shaderstufen fest.

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

Setzt die Liste der Shaderstufen aus den Iteratoren first und last.

void QRhiGraphicsPipeline::setSlopeScaledDepthBias(float bias)

Legt die neigungsskalierte Tiefe bias fest. Der Standardwert ist 0.

Siehe auch slopeScaledDepthBias().

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

Legt den Schablonentest state für Rückseiten fest.

Siehe auch stencilBack().

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

Legt den Schablonentest state für Stirnseiten fest.

Siehe auch stencilFront().

void QRhiGraphicsPipeline::setStencilReadMask(quint32 mask)

Legt die Schablonenlesung mask fest. Der Standardwert ist 0xFF.

Siehe auch stencilReadMask().

void QRhiGraphicsPipeline::setStencilTest(bool enable)

Aktiviert oder deaktiviert die Schablonentests auf der Grundlage von enable. Standardmäßig ist dies deaktiviert.

Siehe auch hasStencilTest().

void QRhiGraphicsPipeline::setStencilWriteMask(quint32 mask)

Legt die Schablonenschreibweise mask fest. Der Standardwert ist 0xFF.

Siehe auch stencilWriteMask().

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

Legt die list der Rendering-Ziel-Überblendungseinstellungen fest. Dies ist eine Liste, denn wenn mehrere Rendering-Ziele verwendet werden (d.h. ein QRhiTextureRenderTarget mit mehr als einem QRhiColorAttachment), muss es eine TargetBlend Struktur pro Rendering-Ziel geben (Farbanhang).

Standardmäßig gibt es einen standardmäßig erstellten TargetBlend Satz.

Siehe auch QRhi::MaxColorAttachments.

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

Legt die Liste der Renderzielüberblendungseinstellungen aus den Iteratoren first und last fest.

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

Legt die primitive Topologie t fest.

Siehe auch topology().

void QRhiGraphicsPipeline::setVertexInputLayout(const QRhiVertexInputLayout &layout)

Gibt die Scheitelpunkteingabe layout an.

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 auf der angegebenen index zurück.

qsizetype QRhiGraphicsPipeline::shaderStageCount() const

Gibt die Anzahl der Shaderstufen in dieser Pipeline zurück.

float QRhiGraphicsPipeline::slopeScaledDepthBias() const

Gibt die aktuell eingestellte neigungsskalierte Tiefenverzerrung zurück.

Siehe auch setSlopeScaledDepthBias().

QRhiGraphicsPipeline::StencilOpState QRhiGraphicsPipeline::stencilBack() const

Gibt den aktuellen Schablonenteststatus für Rückseiten zurück.

Siehe auch setStencilBack().

QRhiGraphicsPipeline::StencilOpState QRhiGraphicsPipeline::stencilFront() const

Gibt den aktuellen Schablonenteststatus für Vorderseiten zurück.

Siehe auch setStencilFront().

quint32 QRhiGraphicsPipeline::stencilReadMask() const

Gibt die aktuelle Schablonenlesemaske zurück.

Siehe auch setStencilReadMask().

quint32 QRhiGraphicsPipeline::stencilWriteMask() const

Gibt die aktuelle Schablonen-Schreibmaske zurück.

Siehe auch setStencilWriteMask().

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

Gibt die Einstellung für die Rendering-Zielmischung unter der angegebenen index zurück.

qsizetype QRhiGraphicsPipeline::targetBlendCount() const

Gibt die Anzahl der Rendering-Zielüberblendungseinstellungen zurück.

QRhiGraphicsPipeline::Topology QRhiGraphicsPipeline::topology() const

Gibt die aktuell eingestellte primitive Topologie zurück.

Siehe auch setTopology().

QRhiVertexInputLayout QRhiGraphicsPipeline::vertexInputLayout() const

Gibt die aktuell eingestellte Spezifikation des Vertex-Eingabelayouts zurück.

Siehe auch setVertexInputLayout().