Qt3DRender::QRenderSettings Class
class Qt3DRender::QRenderSettingsQRenderSettings 类保存了与渲染过程相关的设置，并托管着当前活动的FrameGraph。更多内容...
| 头文件： | #include <qrendersettings.h> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS 3drender) target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake： | QT += 3drender |
| 在 QML 中： | RenderSettings |
| 继承自： | Qt3DCore::QComponent |
| 状态： | 已弃用 |
该类已弃用。我们强烈建议不要在新代码中使用它。
公共类型
| enum | RenderPolicy { OnDemand, Always } |
属性
- activeFrameGraph : Qt3DRender::QFrameGraphNode*
- pickingSettings : Qt3DRender::QPickingSettings* const
- renderCapabilities : Qt3DRender::QRenderCapabilities* const
- renderPolicy : RenderPolicy
公共函数
| Qt3DRender::QFrameGraphNode * | activeFrameGraph() const |
| Qt3DRender::QPickingSettings * | pickingSettings() |
| Qt3DRender::QRenderCapabilities * | renderCapabilities() |
| Qt3DRender::QRenderSettings::RenderPolicy | renderPolicy() const |
公共插槽
| void | setActiveFrameGraph(Qt3DRender::QFrameGraphNode *activeFrameGraph) |
| void | setRenderPolicy(Qt3DRender::QRenderSettings::RenderPolicy renderPolicy) |
信号
| void | activeFrameGraphChanged(Qt3DRender::QFrameGraphNode *activeFrameGraph) |
| void | renderPolicyChanged(Qt3DRender::QRenderSettings::RenderPolicy renderPolicy) |
详细说明
QRenderSettings 组件必须设置为场景根实体的组件。它指定渲染策略和拾取设置，并托管活动的FrameGraph。
成员类型文档
enum QRenderSettings::RenderPolicy
渲染策略。
| 常量 | 值 | 描述 |
|---|---|---|
Qt3DRender::QRenderSettings::OnDemand | 0 | 只有当发生变化时，才会渲染FrameGraph。 |
Qt3DRender::QRenderSettings::Always | 1 | 即使没有任何变化，FrameGraph也会持续进行渲染。 |
属性文档
activeFrameGraph : Qt3DRender::QFrameGraphNode*
保存当前活动的FrameGraph。
访问函数：
| Qt3DRender::QFrameGraphNode * | activeFrameGraph() const |
| void | setActiveFrameGraph(Qt3DRender::QFrameGraphNode *activeFrameGraph) |
通知器信号：
| void | activeFrameGraphChanged(Qt3DRender::QFrameGraphNode *activeFrameGraph) |
[read-only] pickingSettings : Qt3DRender::QPickingSettings* const
保存FrameGraph 的当前选择设置。
访问函数：
| Qt3DRender::QPickingSettings * | pickingSettings() |
[read-only] renderCapabilities : Qt3DRender::QRenderCapabilities* const
包含所支持的渲染引擎的详细信息
访问函数：
| Qt3DRender::QRenderCapabilities * | renderCapabilities() |
renderPolicy : RenderPolicy
保存当前的渲染策略。
访问函数：
| Qt3DRender::QRenderSettings::RenderPolicy | renderPolicy() const |
| void | setRenderPolicy(Qt3DRender::QRenderSettings::RenderPolicy renderPolicy) |
通知器信号：
| void | renderPolicyChanged(Qt3DRender::QRenderSettings::RenderPolicy renderPolicy) |
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
