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() も参照して ください。

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() も参照して ください。