QQuickFramebufferObject Class

Description détaillée

Sur la plupart des plateformes, le rendu s'effectue sur un thread dédié. C'est pourquoi la classe QQuickFramebufferObject impose une séparation stricte entre l'implémentation des éléments et le rendu FBO. Toute la logique de l’élément, telle que les propriétés et les fonctions d’aide liées à l’interface utilisateur requises par QML, doit être placée dans une sous-classe de la classe `QQuickFramebufferObject`. Tout ce qui concerne le rendu doit être placé dans la classe ` QQuickFramebufferObject::Renderer `.

Pour éviter les conditions de concurrence et les problèmes de lecture/écriture entre deux threads, il est important que le moteur de rendu et l’élément ne lisent ni n’écrivent jamais de variables partagées. La communication entre l’élément et le moteur de rendu doit principalement s’effectuer via la fonction ` QQuickFramebufferObject::Renderer::synchronize()`. Cette fonction sera appelée sur le thread de rendu tandis que le thread de l’interface graphique est bloqué.

Il est également possible d’utiliser des connexions en file d’attente ou des événements pour la communication entre l’élément et le moteur de rendu.

Le Renderer et le FBO sont tous deux gérés en mémoire en interne.

Pour effectuer le rendu dans le FBO, l’utilisateur doit créer une sous-classe de la classe Renderer et réimplémenter sa fonction Renderer::render(). La sous-classe du Renderer est renvoyée par la fonction createRenderer().

Par défaut, la taille du FBO s’adapte à celle de l’élément. Si vous préférez une taille fixe, définissez ` textureFollowsItemSize ` sur ` false ` et renvoyez une texture de votre choix à partir de ` QQuickFramebufferObject::Renderer::createFramebufferObject()`.

À partir de Qt 5.4, la classe QQuickFramebufferObject est un « texture provider » et peut être utilisée directement dans ShaderEffects et d’autres classes qui utilisent des fournisseurs de textures.