QSSGRenderExtension 类

扩展后端节点实现的基础类。 更多信息...

头文件 #include <QSSGRenderExtension>
自Qt 6.7

公共类型

枚举类RenderMode { 独立, 主要 }
枚举类RenderStage { 预颜色, 颜色后 }

公共函数

虚函数mode() const = 0
虚函数prepareData(QSSGFrameData &data) = 0
虚函数prepareRender(QSSGFrameData &data) = 0
虚函数render(QSSGFrameData &data) = 0
虚函数resetForFrame() = 0
虚函数stage() const = 0

详细描述

另请参阅QQuick3DRenderExtension.

成员类型文档

枚举类 QSSGRenderExtension::RenderMode

指定渲染扩展模式。

常量值描述
QSSGRenderExtension::RenderMode::Standalone0渲染代码在渲染准备阶段被完整记录。这通常意味着会有一些输出创建在前面渲染扩展（s）。使用此模式时，在帧的准备阶段将调用 prepareRender() 和 render() 函数。
QSSGRenderExtension::RenderMode::Main1渲染代码在主要渲染通道中记录。在此模式中，在帧的准备阶段调用 prepareRender()，在帧的渲染阶段调用 render()。

枚举类 QSSGRenderExtension::RenderStage

指定扩展将被调用的顺序。

常量值描述
QSSGRenderExtension::RenderStage::PreColor0渲染代码在主（颜色）通道之前记录和执行。
QSSGRenderExtension::RenderStage::PostColor1渲染代码在主（颜色）通道之后记录和执行。

成员函数文档

[纯虚] QSSGRenderExtension::RenderMode QSSGRenderExtension::mode() const

返回用于此扩展的渲染模式。

[纯虚] bool QSSGRenderExtension::prepareData(QSSGFrameData &data)

在收集场景数据之后，但在当前帧的任何渲染数据或渲染操作之前被调用。

返回脏状态。如果有需要渲染的脏数据，则返回true。

注意：在准备和渲染阶段，从引擎中创建/收集的大部分数据是按帧的，应该在下一帧的开始处释放或假定释放。

另请参阅：QSSGFrameData。

[纯虚函数] void QSSGRenderExtension::prepareRender(QSSGFrameData &data)

为渲染准备数据。构建和收集渲染所需的数据。在此之前的任何计划好的渲染扩展已经处理。另外；任何模式的RenderMode::Standalone渲染扩展，如果成功，将会完成全部。

注意：在准备和渲染阶段，从引擎中创建/收集的大部分数据是按帧的，应该在下一帧的开始处释放或假定释放。

另请参阅：QSSGFrameData。

[纯虚函数] void QSSGRenderExtension::render(QSSGFrameData &data)

记录渲染通道。根据扩展的模式，此函数将在此帧的准备或渲染阶段被调用。

使用数据来访问渲染上下文，从而可以查询激活的QRhi对象。

另请参阅：QSSGRenderExtension::RenderMode。

[纯虚函数] void QSSGRenderExtension::resetForFrame()

每次新帧开始时都会调用。在这一点上应清除前一帧的任何数据。

[纯虚函数] QSSGRenderExtension::RenderStage QSSGRenderExtension::stage() const

返回此渲染扩展将要使用的阶段。

© 2024 Qt公司有限公司。包含在本处的文档贡献是各自所有者的著作权。提供的文档根据自由软件基金会发布的GNU自由文档许可版本1.3的条款进行许可。Qt及其相应的标志是芬兰和/或其他国家/地区的Qt公司有限公司的商标。所有其他商标均为其各自所有者的财产。