QSSGFrameData Class
存储类,包含为帧收集的数据。更多
| Header: | #include <QSSGFrameData> |
| 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 |
| void | scheduleRenderResults(QSSGFrameData::RenderResults results) const |
成员函数文档
QSSGCameraId QSSGFrameData::activeCamera() const
返回场景中的活动摄像机,如果找不到则为空。
QSSGNodeIdList QSSGFrameData::getLayerNodes(QSSGCameraId cameraId, QSSGFrameData::TypeMask typeMask = NodeMask) const
返回cameraId 中与typeMask 匹配的图层节点列表。如果摄像机没有图层掩码,则返回空列表。
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 也可能尚未准备就绪,除非已经执行了纹理的传递渲染。
注意: 返回值仅在当前帧内有效。在每个新帧中,可呈现纹理都将被重置,因此应重新查询。
void QSSGFrameData::scheduleRenderResults(QSSGFrameData::RenderResults results) const
安排给定的results 在此帧中可用。
该函数只能在QSSGRenderExtension::prepareData() 中的准备阶段调用。
注意: 如果底层不支持所请求的结果,或者如果该层不包含任何数据,因而没有必要生成所请求的结果,那么所请求的结果可能不可用,在这种情况下,getRenderResult() 将返回空结果。
另请参阅 QSSGRenderExtension::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.