Renderer Class

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

[protected] Renderer::Renderer()

新しいレンダラーを構築する。

この関数は、GUI スレッドがブロックされているときに、シーン グラフの同期フェーズで呼び出されます。

[virtual noexcept protected] Renderer::~Renderer()

レンダラーは、QQuickFramebufferObject アイテムのシーン グラフ リソースがクリーンアップされると自動的に削除されます。

この関数は、レンダリング スレッドで呼び出されます。

[virtual protected] QOpenGLFramebufferObject *Renderer::createFramebufferObject(const QSize &size)

この関数は、新しい FBO が必要になったときに呼び出されます。これは初期フレームで発生します。QQuickFramebufferObject::textureFollowsItemSize を true に設定すると、アイテムの寸法が変わるたびに再度呼び出されます。

返される FBO は、任意のアタッチメントを持つことができます。QOpenGLFramebufferObjectFormat が FBO をマルチサンプリングする必要があることを示している場合、Renderer の内部実装は 2 番目の FBO を割り当て、マルチサンプリングされた FBO をテクスチャの表示に使用する FBO にブリットします。

[protected] QOpenGLFramebufferObject *Renderer::framebufferObject() const

現在レンダリングされているフレームバッファオブジェクトを返します。

[protected] void Renderer::invalidateFramebufferObject()

現在のFBOを無効にするには、synchronize （）の間にこの関数を呼び出します。これにより、createFramebufferObject （）で新しいFBOが作成されます。

[pure virtual protected] void Renderer::render()

この関数は、FBOがレンダリングされるときに呼び出されます。この時点でフレームバッファはバインドされており、glViewport は FBO のサイズに合わせて設定されています。

FBOは、この関数がリターンした後、自動的にバインド解除されます。

[virtual protected] void Renderer::synchronize(QQuickFramebufferObject *item)

この関数はQQuickFramebufferObject::update() の結果として呼び出されます。

アイテムで発生した変更でレンダラーを更新するには、この関数を使用します。item は、このレンダラーをインスタンス化したアイテムです。この関数は、FBO が作成される前に 1 回呼び出されます。

たとえば、アイテムに QML で制御されるカラー プロパティがある場合、QQuickFramebufferObject::update （）を呼び出し、synchronize() を使用して新しいカラーをレンダラーにコピーし、次のフレームのレンダリングに使用できるようにします。

この関数は、レンダラーとアイテムがお互いのメンバを安全に読み書きできる唯一の場所です。

[protected] void Renderer::update()

FBO を再度レンダリングする場合は、この関数を呼び出します。

この関数をrender() から呼び出すと、次のフレームの前に FBO を再度レンダリングさせることができます。