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 QRhiGraphicsPipeline::TargetBlend *QRhiGraphicsPipeline::cbeginTargetBlends() const

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

const QRhiShaderStage *QRhiGraphicsPipeline::cendShaderStages() const

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

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

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

[pure virtual] bool QRhiGraphicsPipeline::create()

対応するネイティブ・グラフィックス・リソースを作成する。以前の create() で対応するdestroy() がなかったためにすでにリソースが存在する場合は、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()も参照 。

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()も参照 。

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)

リソースバインディングのレイアウトを記述するsrb と、リソース (QRhiBuffer,QRhiTexture) 自身を関連付けます。パイプラインの作成時に重要なのはレイアウトだけなので、後者はオプションです。したがって、ここで渡される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 ）、レンダーターゲット（カラーアタッチメント）ごとに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()も参照してください 。