love.graphics.discard (Français)

Disponible depuis LÖVE 0.10.0
Ce-tte function n'est pas supporté-e par des versions plus anciennes.

Annule (jette) le contenu de l'écran ou du Canvas actif. C'est une fonction d'optimisation des performances pour des cas d'utilisation de niche.

Si le Canvas actif vient juste d'être changé et que le BlendMode « Replace » (remplace) va être utilisé pour tracer quelque chose qui couvre tout l'écran, l'appel de love.graphics.discard (Français) plutôt que l'appel de love.graphics.clear (Français) ou ne rien faire pourrait améliorer les performances sur les périphériques mobiles.

Sur certains systèmes de bureau, cette fonction ne pourrait avoir aucun effet.

O.png Cette fonction remplace effectivement le contenu de l'écran ou du Canvas actif avec des détritus. La plupart des BlendModes, dont celui par défaut, « alpha », mixent ce qui est tracé avec le contenu de l'écran - ce qui devrait provoquer des défaut inattendus is la fonction est utilisée de façon inappropriée.  


Fonction

Synopsis

love.graphics.discard( discardcolor, discardstencil )

Arguments

boolean (Français) discardcolor (true)
Est-ce qu'il faut annuler la/les texture(s) du ou des Canvas actifs (le contenu de l'écran si aucun Canvas n'est actif.)
boolean (Français) discardstencil (true)
Est-ce qu'il faut annuler le contenu du Tampon de stencil de l'écran / Canvas actif.

Retourne

Rien.

Fonction

Synopsis

love.graphics.discard( discardcolors, discardstencil )

Arguments

table (Français) discardcolors
Un tableau contenant des valeurs booléennes indiquant si il faut ou non annuler les textures de chaque Canvas actif, lorsque plusieurs sont actif simultanément.
boolean (Français) discardstencil (true)
Est-ce qu'il faut annule le contenu du tampon de stencil de l'écran / Canvas actif.

Retourne

Rien.

Voir également


Autres langues