QSSGFrameData Class
包含为一个帧收集的数据的存储类。更多...
| Header: | #include <qssgrenderextensions.h> |
| Since: | Qt 6.7 |
公共函数
| QSSGCameraId | activeCamera() const |
| QSSGNodeIdList | getLayerNodes(QSSGCameraId cameraId, QSSGFrameData::TypeMask typeMask = NodeMask) const |
| QSSGNodeIdList | getLayerNodes(quint32 layerMask, QSSGFrameData::TypeMask typeMask = NodeMask) const |
| QSSGRhiGraphicsPipelineState | getPipelineState() const |
| QSSGFrameData::Result | getRenderResult(QSSGFrameData::RenderResult id) const |
| QSSGFrameData::Result | getRenderResult(QSSGResourceId userPassId, QSSGFrameData::AttachmentSelector attachment) const |
| void | scheduleRenderResults(QSSGFrameData::RenderResults results) const |
成员函数文档
QSSGCameraId QSSGFrameData::activeCamera() const
返回该场景的当前活动摄像机；如果未找到，则返回 null。
QSSGNodeIdList QSSGFrameData::getLayerNodes(QSSGCameraId cameraId, QSSGFrameData::TypeMask typeMask = NodeMask) const
返回一个包含与typeMask 匹配的、属于给定cameraId 的图层节点的列表。如果摄像机没有图层蒙版，则返回一个空列表。
QSSGNodeIdList QSSGFrameData::getLayerNodes(quint32 layerMask, QSSGFrameData::TypeMask typeMask = NodeMask) const
返回一个包含符合layerMask 和typeMask 条件的图层节点的列表。
QSSGRhiGraphicsPipelineState QSSGFrameData::getPipelineState() const
返回该帧的基础管道状态
QSSGFrameData::Result QSSGFrameData::getRenderResult(QSSGFrameData::RenderResult id) const
返回由id 生成的可渲染纹理结果。如果未找到匹配的id ，则返回nullptr 。
注意：即使 该函数返回了非空结果，除非已执行向该纹理的渲染通道，否则返回的 QSSGRhiRenderableTexture 可能尚未就绪。
注意： 返回值 仅在当前帧内有效。在每个新帧中，可渲染对象都会被重置，因此应重新进行查询。
QSSGFrameData::Result QSSGFrameData::getRenderResult(QSSGResourceId userPassId, QSSGFrameData::AttachmentSelector attachment) const
返回来自用户定义渲染通道（使用给定的userPassId ）的可渲染纹理结果。如果找不到匹配的用户通道，或者用户通道未生成任何可渲染纹理，则返回一个无效的结果。
注意：即使 该函数返回了非空结果，除非渲染到该纹理的渲染通道已执行完毕，否则返回的 QSSGRhiRenderableTexture 可能尚未就绪。
注意： 返回值 仅在当前帧内有效。在每个新帧中，可渲染纹理都会被重置，因此应重新进行查询。
void QSSGFrameData::scheduleRenderResults(QSSGFrameData::RenderResults results) const
安排将给定的results 在该帧中启用。
该函数仅应在QSSGRenderExtension::prepareData() 的准备阶段被调用。
注意： 如果底层图层不支持所 请求的结果 ，或者该图层不包含任何需要生成所请求结果的数据，则可能无法提供所请求的结果 ；在这种情况下，getRenderResult() 将返回一个空结果。
另请参阅 getRenderResult()。
© 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.
