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

メンバ関数のドキュメント

const QRhiShaderStage *QRhiGraphicsPipeline::cbeginShaderStages() const

シェーダステージリストの最初の項目を指す const イテレータを返します。

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

レンダリングターゲットのブレンド設定リストの最初の項目を指す const イテレータを返します。

const QRhiShaderStage *QRhiGraphicsPipeline::cendShaderStages() const

シェーダステージリストの最後の項目の直後を指す const イテレータを返します。

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

レンダリングターゲットのブレンド設定リストの最後の項目の直後を指す const イテレータを返します。

[pure virtual] bool QRhiGraphicsPipeline::create()

対応するネイティブグラフィックスリソースを作成します。以前にdestroy() を伴わない create() が実行された結果、すでにリソースが存在する場合、まず暗黙的にdestroy() が呼び出されます。

成功した場合はtrue を返し、グラフィックス操作が失敗した場合はfalse を返します。戻り値にかかわらず、destroy()を呼び出すことは常に安全です。

QRhiGraphicsPipeline::CullMode QRhiGraphicsPipeline::cullMode() const

現在設定されているフェイスカリングモードを返します。

setCullMode()も参照してください 。

int QRhiGraphicsPipeline::depthBias() const

現在設定されている深度バイアスを返します。

setDepthBias()も参照してください 。

QRhiGraphicsPipeline::CompareOp QRhiGraphicsPipeline::depthOp() const

深度比較関数を返します。

setDepthOp()も参照してください 。

QRhiGraphicsPipeline::Flags QRhiGraphicsPipeline::flags() const

現在設定されているフラグを返します。

setFlags()も参照してください 。

QRhiGraphicsPipeline::FrontFace QRhiGraphicsPipeline::frontFace() const

現在設定されているフロントフェイスモードを返します。

setFrontFace()も参照してください 。

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

深度クランプが有効な場合、true を返します。

この関数は Qt 6.11 で導入されました。

bool QRhiGraphicsPipeline::hasDepthTest() const

深度テストが有効になっている場合、true を返します。

bool QRhiGraphicsPipeline::hasDepthWrite() const

深度書き込みが有効な場合、true を返します。

bool QRhiGraphicsPipeline::hasStencilTest() const

ステンシルテストが有効になっている場合、trueを返します。

float QRhiGraphicsPipeline::lineWidth() const

現在設定されている線の幅を返します。デフォルトは 1.0f です。

setLineWidth()も参照してください 。

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

ビュー数を返します。デフォルトは 0 で、マルチビューレンダリングが行われないことを示します。

この関数は Qt 6.7 で導入されました。

setMultiViewCount()も参照してください 。

int QRhiGraphicsPipeline::patchControlPointCount() const

現在設定されているパッチ制御点数を返します。

setPatchControlPointCount()も参照してください 。

QRhiGraphicsPipeline::PolygonMode QRhiGraphicsPipeline::polygonMode() const

ポリゴンモードを返します。

setPolygonMode()も参照してください 。

QRhiRenderPassDescriptor *QRhiGraphicsPipeline::renderPassDescriptor() const

現在設定されているQRhiRenderPassDescriptor を返します。

setRenderPassDescriptor()も参照してください 。

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

QRhiResource::resourceType() const を再実装します。

リソースの型を返します。

int QRhiGraphicsPipeline::sampleCount() const

現在設定されているサンプル数を返します。1 は、マルチサンプルアンチエイリアシングが有効でないことを意味します。

setSampleCount()も参照してください 。

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

指定された面カリングmode を設定します。

cullMode()も参照してください 。

void QRhiGraphicsPipeline::setDepthBias(int bias)

bias の深度を設定します。デフォルト値は0です。

depthBias()も参照してください 。

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

enable が true の場合、深度クリッピングを有効にします。深度クリッピングが有効になっている場合、通常であればニアクリップ面またはファークリップ面によってクリップされるはずのプリミティブはラスタライズされ、その深度値は深度範囲内にクリップされます。無効の場合（デフォルト）、そのようなプリミティブはクリップされます。

この関数は Qt 6.11 で導入されました。

関連項目: hasDepthClamp()。

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

深度比較関数 `op` を設定します。

depthOp()も参照してください 。

void QRhiGraphicsPipeline::setDepthTest(bool enable)

enable に基づいて、深度テストを有効または無効にします。デフォルトでは、深度テストと深度データの書き出しの両方が無効になっています。

hasDepthTest() およびsetDepthWrite()も参照してください 。

void QRhiGraphicsPipeline::setDepthWrite(bool enable)

enable に基づいて、深度バッファへの深度データの書き込みを制御します。デフォルトでは、これは無効になっています。通常、深度書き込みは深度テストと併せて有効にされます。

hasDepthWrite() およびsetDepthTest()も参照してください 。

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

フラグ「f 」を設定します。

flags()も参照してください 。

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

フロントフェイスモードをf に設定します。

frontFace()も参照してください 。

void QRhiGraphicsPipeline::setLineWidth(float width)

width 行を設定します。実行時に「QRhi::WideLines 」機能がサポートされていないと報告された場合、1.0f 以外の値は無視されます。

lineWidth()も参照してください 。

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

マルチビューレンダリング用のビューcount を設定します。デフォルトは0で、マルチビューレンダリングを行わないことを示します。マルチビューレンダリングを有効にするには、count を2以上に設定する必要があります。

マルチビューは、MultiView feature がサポートされていると報告されている場合にのみ利用可能です。レンダリングターゲットは 2D テクスチャ配列である必要があり、そのレンダリングターゲットのカラーアタッチメントには、同じcount が設定されている必要があります。

マルチビューレンダリングの詳細については、QRhiColorAttachment::setMultiViewCount() を参照してください。

この関数は Qt 6.7 で導入されました。

multiViewCount()、QRhi::MultiView 、およびQRhiColorAttachment::setMultiViewCount()も参照してください 。

void QRhiGraphicsPipeline::setPatchControlPointCount(int count)

パッチ制御点の数をcount に設定します。デフォルト値は3です。これは、トポロジーがPatches に設定されている場合にのみ使用されます。

patchControlPointCount()も参照してください 。

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

ポリゴンを「mode 」に設定します。デフォルトは「Fill」です。

polygonMode() およびQRhi::NonFillPolygonModeも参照してください 。

void QRhiGraphicsPipeline::setRenderPassDescriptor(QRhiRenderPassDescriptor *desc)

指定されたQRhiRenderPassDescriptor desc に関連付けられます。

renderPassDescriptor()も参照してください 。

void QRhiGraphicsPipeline::setSampleCount(int s)

サンプル数を設定します。s の一般的な値は 1、4、または 8 です。パイプラインは常にレンダリングターゲットと互換性がある必要があります。つまり、サンプル数が一致している必要があります。

sampleCount() およびQRhi::supportedSampleCounts()も参照してください 。

void QRhiGraphicsPipeline::setShaderResourceBindings(QRhiShaderResourceBindings *srb)

リソースバインディングのレイアウトおよびリソース（QRhiBuffer 、QRhiTexture ）自体を記述する `srb ` と関連付けられます。後者はオプションです。これは、パイプラインの作成時にはレイアウトのみが重要となるためです。したがって、ここで渡される `srb ` は、ドローコールの記録前に `setShaderResources()` を通じて別の `layout-compatible ` `QRhiShaderResourceBindings ` がバインドされていれば、実際のバッファやテクスチャオブジェクトを未指定（nullptr ）のままにしておくことができます。

shaderResourceBindings()も参照してください 。

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

シェーダーステージのlist を設定します。

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

イテレータ `first ` および `last` からシェーダステージのリストを設定します。

void QRhiGraphicsPipeline::setSlopeScaledDepthBias(float bias)

勾配のスケーリングされた深度bias を設定します。デフォルト値は 0 です。

slopeScaledDepthBias()も参照してください 。

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

背面に対して、ステンシルテスト「state 」を設定します。

stencilBack()も参照してください 。

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

前面に対して、ステンシルテスト「state 」を設定します。

stencilFront()も参照してください 。

void QRhiGraphicsPipeline::setStencilReadMask(quint32 mask)

ステンシル読み取り値 `mask` を設定します。デフォルト値は 0xFF です。

stencilReadMask()も参照してください 。

void QRhiGraphicsPipeline::setStencilTest(bool enable)

enable に基づいて、ステンシルテストを有効または無効にします。デフォルトでは無効になっています。

hasStencilTest()も参照してください 。

void QRhiGraphicsPipeline::setStencilWriteMask(quint32 mask)

ステンシル書き込みをmask に設定します。デフォルト値は0xFFです。

stencilWriteMask()も参照してください 。

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

レンダリングターゲットのブレンド設定のlist を設定します。これはリスト形式となっています。これは、複数のレンダリングターゲットが使用される場合（つまり、複数のQRhiColorAttachment を持つQRhiTextureRenderTarget の場合）、レンダリングターゲット（カラーアタッチメント）ごとに1つのTargetBlend 構造体が必要となるためです。

デフォルトでは、デフォルトの構造を持つTargetBlend セットが1つ存在します。

QRhi::MaxColorAttachmentsも参照してください 。

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

イテレータ `first ` および `last` から、レンダリングターゲットのブレンド設定のリストを設定します。

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

プリミティブのトポロジーをt に設定します。

topology()も参照してください 。

void QRhiGraphicsPipeline::setVertexInputLayout(const QRhiVertexInputLayout &layout)

頂点入力layout を指定します。

vertexInputLayout()も参照してください 。

QRhiShaderResourceBindings *QRhiGraphicsPipeline::shaderResourceBindings() const

現在関連付けられているQRhiShaderResourceBindings オブジェクトを返します。

setShaderResourceBindings()も参照してください 。

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

指定されたindex にあるシェーダステージを返します。

qsizetype QRhiGraphicsPipeline::shaderStageCount() const

このパイプラインに含まれるシェーダステージの数を返します。

float QRhiGraphicsPipeline::slopeScaledDepthBias() const

現在設定されているスロープ・スケーリングされた深度バイアスを返します。

setSlopeScaledDepthBias()も参照してください 。

QRhiGraphicsPipeline::StencilOpState QRhiGraphicsPipeline::stencilBack() const

背面に対する現在のステンシルテストの状態を返します。

setStencilBack()も参照してください 。

QRhiGraphicsPipeline::StencilOpState QRhiGraphicsPipeline::stencilFront() const

前面の現在のステンシルテスト状態を返します。

setStencilFront()も参照してください 。

quint32 QRhiGraphicsPipeline::stencilReadMask() const

現在のステンシル読み取りマスクを返します。

setStencilReadMask()も参照してください 。

quint32 QRhiGraphicsPipeline::stencilWriteMask() const

現在のステンシル書き込みマスクを返します。

setStencilWriteMask()も参照してください 。

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

指定されたindex におけるレンダリングターゲットのブレンド設定を返します。

qsizetype QRhiGraphicsPipeline::targetBlendCount() const

レンダリングターゲットのブレンド設定の数を返します。

QRhiGraphicsPipeline::Topology QRhiGraphicsPipeline::topology() const

現在設定されているプリミティブのトポロジーを返します。

setTopology()も参照してください 。

QRhiVertexInputLayout QRhiGraphicsPipeline::vertexInputLayout() const

現在設定されている頂点入力レイアウトの仕様を返します。

setVertexInputLayout()も参照してください 。