QCanvasGradient Class

Description détaillée

QCanvasGradient est la classe de base pour toutes les brosses de gradient de QCanvasPainter. Il existe actuellement quatre types de dégradés : QCanvasLinearGradient, QCanvasRadialGradient, QCanvasConicalGradient et QCanvasBoxGradient.

Si aucun arrêt n'est fourni avec setStartColor, setEndColor, setColorAt ou setStops, le gradient est rendu avec une couleur de départ blanche (255,255,255) et une couleur de fin transparente (0,0,0,0). Si un seul point d'arrêt est fourni, le dégradé est rempli avec cette couleur.

QCanvasPainter utilise deux approches différentes pour peindre les dégradés.

• Avec un maximum de 2 arrêts, les couleurs sont transmises au shader sous la forme de 2 uniformes vec4. Cela rend l'animation de dégradés à 2 arrêts très performante, sans étapes supplémentaires entre les deux.
• Avec plus de 2 arrêts, les couleurs sont transmises au shader sous la forme d'une texture unidimensionnelle. Par défaut, la taille de la texture est de 1x256 pixels, optimisée pour la qualité et les performances. Les textures sont mises en cache, de sorte que lorsque le gradient s'arrête ou que les couleurs ne changent pas, la texture précédente peut être réutilisée même si d'autres propriétés du gradient (comme la position, l'angle, etc.) changent. Bien que l'animation de gradients à arrêts multiples soit rapide, elle entraînera des téléchargements de textures, il faut donc se demander si cela en vaut la peine.

Il existe quelques variables d'environnement pour contrôler l'utilisation des textures de dégradés :

• QCPAINTER_DISABLE_TEXTURE_USAGE_TRACKING - Par défaut, l'utilisation des textures de dégradés est suivie et maintenue en dessous de la quantité maximale. Définissez cette variable d'environnement pour désactiver le suivi et conserver toutes les textures de gradient en mémoire.
• QCPAINTER_MAX_TEXTURES - Par défaut, la quantité maximale de textures est 1024. Définissez cette variable d'environnement pour qu'elle contienne le nombre de textures maximum souhaité. Les textures de gradient temporaires actuellement inutilisées sont automatiquement supprimées lorsque la quantité maximale est atteinte.

  Remarque : cela n'a pas d'effet lorsque le suivi de l'utilisation des textures a été désactivé.