在本页

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

返回 与layerMasktypeMask 匹配的层节点列表。

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.