QQuickFramebufferObject::Renderer Class

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

[protected] Renderer::Renderer()

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

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

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

QQuickFramebufferObject 項目のシーングラフリソースがクリーンアップされると、Rendererは自動的に削除されます。

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

[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()

synchronize() の実行中にこの関数を呼び出すと、現在の FBO が無効化されます。これにより、createFramebufferObject() によって新しい FBO が作成されます。

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

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

関数が返った後、FBOは自動的にバインド解除されます。

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

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

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

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

この関数内のみ、レンダラーとアイテムが互いのメンバを読み書きしても安全です。

[protected] void Renderer::update()

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

この関数は、render() から呼び出すことで、次のフレームの前に FBO の再レンダリングを強制的に実行できます。