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

[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 可以不指定实际的缓冲区或纹理对象（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 。这是一个列表，因为当使用多个渲染目标时（即包含多个QRhiColorAttachment 的QRhiTextureRenderTarget ），每个渲染目标（颜色附件）都需要一个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()。