このページでは

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

指定された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 を返します。

注: この関数が null 以外の結果を返した場合でも 、テクスチャへのレンダリングパスが実行されない限り、返された QSSGRhiRenderableTexture は使用可能になっていない可能性があります。

注: 返される値は 、現在のフレーム内でのみ有効です。新しいフレームごとにレンダラブルはリセットされるため、再度クエリを実行する必要があります。

QSSGFrameData::Result QSSGFrameData::getRenderResult(QSSGResourceId userPassId, QSSGFrameData::AttachmentSelector attachment) const

指定されたuserPassId を持つユーザー定義のレンダリングパスからの、レンダリング可能なテクスチャの結果を返します。一致するユーザーパスが見つからない場合、またはユーザーパスがレンダリング可能なテクスチャを生成しなかった場合は、無効なResultが返されます。

注: この関数が null 以外の結果を返した場合でも 、そのテクスチャへのレンダリングを行うパスが実行されない限り、返された 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.