QQuickFramebufferObject Class

詳細な説明

ほとんどのプラットフォームでは、レンダリングは専用のスレッドで行われます。このため、QQuickFramebufferObject クラスは、アイテムの実装と FBO レンダリングの間で厳格な分離を強制します。 プロパティやQMLで必要なUI関連のヘルパー関数など、すべてのアイテムロジックはQQuickFramebufferObjectクラスのサブクラスに配置する必要があります。レンダリングに関連するすべての処理は、QQuickFramebufferObject::Renderer クラス内に配置しなければなりません。

2つのスレッド間でのレースコンディションや読み書きの問題を回避するため、レンダラーとアイテムが共有変数を読み書きしないことが重要です。アイテムとレンダラー間の通信は、主にQQuickFramebufferObject::Renderer::synchronize()関数を介して行われるべきです。この関数は、GUIスレッドがブロックされている間に、レンダリングスレッド上で呼び出されます。

アイテムとレンダラー間の通信に、キュー化された接続やイベントを使用することも可能です。

Renderer と FBO は、どちらも内部でメモリ管理が行われます。

FBO へレンダリングするには、ユーザーは Renderer クラスをサブクラス化し、そのRenderer::render() 関数を再実装する必要があります。Renderer サブクラスは、createRenderer() から返されます。

FBO のサイズは、デフォルトではアイテムのサイズに合わせて調整されます。固定サイズを希望する場合は、textureFollowsItemSize をfalse に設定し、QQuickFramebufferObject::Renderer::createFramebufferObject() から任意のテクスチャを返してください。

Qt 5.4 以降、QQuickFramebufferObject クラスはtexture provider であり、ShaderEffects や、テクスチャプロバイダを利用するその他のクラスで直接使用できます。