QSSGRenderExtension Class

拡張バックエンドノード実装の基本クラスです。詳細...

Header: #include <QSSGRenderExtension>
Since: Qt 6.7

パブリック型

enum class RenderMode { Standalone, Main }
enum class RenderStage { PreColor, PostColor }

パブリック関数

virtual QSSGRenderExtension::RenderMode mode() const = 0
virtual bool prepareData(QSSGFrameData &data) = 0
virtual void prepareRender(QSSGFrameData &data) = 0
virtual void render(QSSGFrameData &data) = 0
virtual void resetForFrame() = 0
virtual QSSGRenderExtension::RenderStage stage() const = 0

詳細説明

QQuick3DRenderExtensionも参照

メンバ型の説明

enum class QSSGRenderExtension::RenderMode

レンダリング拡張モードを指定します。

定数説明
QSSGRenderExtension::RenderMode::Standalone0レンダリングコードは、レンダリング準備段階で完全に記録されます。これは通常、先行するレンダーエクステンション(複数可)のために作成されたいくつかの出力があることを意味します。このモードが使用される場合、prepareRender() とrender() 関数は、フレームの準備フェーズ中に呼び出されます。
QSSGRenderExtension::RenderMode::Main1レンダリングコードはメインのレンダーパスに記録されます。このモードでは、prepareRender ()はフレームの準備フェーズで呼び出され、render ()はフレームのレンダリングフェーズで呼び出されます。

enum class QSSGRenderExtension::RenderStage

拡張機能が呼び出される順序を指定します。

定数説明
QSSGRenderExtension::RenderStage::PreColor0レンダリングコードはメイン(カラー)パスの前に記録され、実行されます。
QSSGRenderExtension::RenderStage::PostColor1レンダリングコードは記録され、メイン(カラー)パスの後に実行されます。

メンバー関数ドキュメント

[pure virtual] QSSGRenderExtension::RenderMode QSSGRenderExtension::mode() const

Returns このエクステンションで使用されるレンダーモード。

[pure virtual] bool QSSGRenderExtension::prepareData(QSSGFrameData &data)

シーンdata が収集された後、現在のフレームのレンダーデータまたはレンダリングが実行される前に呼び出されます。

ダーティ状態を返す。レンダリングする必要があるダーティデータがある場合は、true を返します。

注意: 準備とレンダリングの段階でエンジンから作成/収集されたデータの多くはフレーム単位であり、次のフレームの開始時に解放されるか、解放されたと仮定されるべきです。

QSSGFrameDataも参照してください

[pure virtual] void QSSGRenderExtension::prepareRender(QSSGFrameData &data)

レンダリング用のデータを準備する。レンダリングに必要なdata を構築および収集します。これより前にスケジュールされたレンダリング拡張はすべて処理された。また、モードRenderMode::Standalone のレンダリング拡張は、成功した場合、すべて完了したことになる。

注: 準備フェーズとレンダー フェーズでエンジンから作成/収集されたデータの多くはフレーム単位であり、次のフレームの開始時に解放されるか、解放されたものと見なされます。

QSSGFrameDataも参照してください

[pure virtual] void QSSGRenderExtension::render(QSSGFrameData &data)

レンダー パスを記録します。この関数は、mode 拡張機能に応じて、フレームの準備フェーズまたはレンダーフェーズで呼び出されます。

アクティブなQRhi オブジェクトを照会できるレンダーコンテキストにアクセスするには、data を使用します。

QSSGRenderExtension::RenderModeも参照してください

[pure virtual] void QSSGRenderExtension::resetForFrame()

新しいフレームが始まるたびに呼び出されます。前のフレームのデータはすべて、この時点でクリアする必要があります。

[pure virtual] QSSGRenderExtension::RenderStage QSSGRenderExtension::stage() const

戻り値 このレンダーエクステンションが使用されるステージ。

©2024 The Qt Company Ltd. 本文書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。