QRhiGraphicsPipeline 类

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迭代器。

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

返回一个指向渲染目标混合设置列表最后一个元素之后的const迭代器。

[纯虚函数] 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)

设置指定的面剔除模式。

另请参阅cullMode。

void QRhiGraphicsPipeline::setDepthBias(int 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().

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

设置多重视图渲染的视图 count。默认值为 0，表示不进行多重视图渲染。要引发多重视图渲染，count 必须为 2 或更大。

只有在报告 MultiView 特性 受到支持时，多重视图才可用。渲染目标必须是 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)

设置多边形 模式。默认值为填充。

另请参阅 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 可以省略实际缓冲区或纹理对象，只要还有一个，定义与布局兼容的 QRhiShaderResourceBindings 的 setShaderResources 被用于记录绘制调用之前。

另请参阅 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），需要为每个渲染目标（颜色附加）设置一个结构。

默认情况下，已设置一个默认构造的。

另请参阅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

返回指定 索引 处的目标混合设置。

qsizetype QRhiGraphicsPipeline::targetBlendCount() const

返回目标混合设置的数量。

QRhiGraphicsPipeline::Topology QRhiGraphicsPipeline::topology() const

返回当前设置的原始拓扑。

另请参阅 setTopology。

QRhiVertexInputLayout QRhiGraphicsPipeline::vertexInputLayout() const

返回当前设置的真相关入布局规范。

另请参阅 setVertexInputLayout。