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() 常量。

返回资源类型。

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 报告支持多视图时，多视图才可用。渲染目标必须是二维纹理数组，而且渲染目标的颜色附件必须具有相同的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 。默认为填充。

另请参阅 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 可以不指定实际的缓冲区或纹理对象 (nullptr) ，只要在记录绘制调用之前通过setShaderResources() 绑定了另一个layout-compatible QRhiShaderResourceBindings 即可。

另请参阅 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 渲染目标混合设置。这是一个列表，因为当使用多个渲染目标时（即一个QRhiTextureRenderTarget 有多个QRhiColorAttachment ），每个渲染目标（颜色附件）都需要有一个TargetBlend 结构。

默认情况下，有一个默认构建的TargetBlend 集合。

另请参见 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().