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 を再度レンダリングさせることができます。