QQuickFramebufferObject Class

Detaillierte Beschreibung

Auf den meisten Plattformen wird das Rendering auf einem dedizierten Thread stattfinden. Aus diesem Grund erzwingt die QQuickFramebufferObject-Klasse eine strikte Trennung zwischen der Item-Implementierung und dem FBO-Rendering. Die gesamte Elementlogik, wie Eigenschaften und UI-bezogene Hilfsfunktionen, die von QML benötigt werden, sollten in einer Unterklasse der Klasse QQuickFramebufferObject untergebracht werden. Alles, was sich auf das Rendering bezieht, muss sich in der Klasse QQuickFramebufferObject::Renderer befinden.

Um Race Conditions und Lese-/Schreibprobleme von zwei Threads zu vermeiden, ist es wichtig, dass der Renderer und das Item niemals gemeinsame Variablen lesen oder schreiben. Die Kommunikation zwischen dem Element und dem Renderer sollte hauptsächlich über die Funktion QQuickFramebufferObject::Renderer::synchronize() erfolgen. Diese Funktion wird im Render-Thread aufgerufen, während der GUI-Thread blockiert ist.

Die Verwendung von Warteschlangenverbindungen oder Ereignissen für die Kommunikation zwischen Element und Renderer ist ebenfalls möglich.

Sowohl der Renderer als auch das FBO werden intern im Speicher verwaltet.

Um in den FBO zu rendern, sollte der Benutzer die Klasse Renderer unterklassifizieren und ihre Funktion Renderer::render() neu implementieren. Die Renderer-Unterklasse wird von createRenderer() zurückgegeben.

Die Größe des FBO wird standardmäßig an die Größe des Elements angepasst. Wenn eine feste Größe bevorzugt wird, setzen Sie textureFollowsItemSize auf false und geben Sie eine Textur Ihrer Wahl von QQuickFramebufferObject::Renderer::createFramebufferObject() zurück.

Ab Qt 5.4 ist die Klasse QQuickFramebufferObject eine texture provider und kann direkt in ShaderEffects und anderen Klassen verwendet werden, die Texturanbieter nutzen.