love.graphics.clear (Français)

Nettoie l'écran ou le Canvas actif avec la couleur spécifiée.

Cette fonction est appelée automatiquement avant love.draw dans la fonction love.run par défaut. Voir l'exemple dans love.run pour une utilisation typique de cette fonction.

Note que le scissor area délimite la région nettoyée.

Dans les versions antérieures à 11.0, les valeurs de composantes couleurs étaient dans la plage allant de 0 à 255 au lieu de 0 à 1.

Dans les version antérieure à la 0.10.0, cette fonction nettoie l'écran dans la couleur de fond actuellement définie à la place.

Fonction

Nettoie l'écran avec la couleur de fond en 0.9.2 et antérieur, ou dans le noir transparent (0, 0, 0, 0) dans LÖVE 0.10.0 et plus récent.

Synopsis

love.graphics.clear( )

Arguments

Aucun.

Retourne

Rien.

Fonction

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

Nettoie l'écran ou le Canvas actif avec la couleur spécifiée.

Synopsis

love.graphics.clear( r, g, b, a, clearstencil, cleardepth )

Arguments

number (Français) r
Canal rouge de la couleur de nettoyage.
number (Français) g
Canal vert de la couleur de nettoyage.
number (Français) b
Canal bleu de la couleur de nettoyage.
number (Français) a (1)
Canal alpha de la couleur de nettoyage.
Disponible depuis LÖVE 11.0
boolean (Français) clearstencil (true)
Est-ce qu'il faut nettoyer le tampon de stencil actif, si présent. Cela peut également être un entier compris entre 0 et 255 pour nettoyer le tampon de stencil avec une valeur spécifique.
boolean (Français) cleardepth (true)
Est-ce qu'il faut nettoyer le tampon de profondeur actif, si présent. Cela peut également être un nombre compris entre 0 et 1 pour nettoyer le tampon de profondeur avec une valeur spécifique.


Retourne

Rien.

Fonction

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

Nettoie plusieurs Canvas actifs dans différentes couleurs, Si plusieurs Canvas sont actifs ensemble via love.graphics.setCanvas.

Synopsis

love.graphics.clear( color, ..., clearstencil, cleardepth )

Arguments

table (Français) color
Une table de la forme de {r, g, v, a} contenant la couleur dans laquelle nettoyer le premier canvas actif.
table (Français) ...
Tables additionnelles pour chaque Canvas actifs.
Available since LÖVE 11.0
boolean (Français) clearstencil (true)
Est-ce qu'il faut nettoyer le tampon de stencil actif, si présent. Ce peut aussi être un entier compris entre 0 et 255 pour nettoyer le tampon de stencil dans une valeur spécifique.
boolean (Français) cleardepth (true)
Est-ce qu'il faut nettoyer le tampon de profondeur actif, si présent. Ce peut aussi être un nombre compris entre 0 et 1 pour nettoyer le tampon de profondeur dans une valeur spécifique.

Retourne

Rien.

Notes

Une couleur doit être spécifiée pour chaque Canvas actif, lorsque cette variante de la fonction est utilisée.

Fonction

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

Nettoie les tampons de stencil ou de profondeur sans nécessité de nettoyer également le canvas de couleur.

Synopsis

love.graphics.clear( clearcolor, clearstencil, cleardepth )

Arguments

boolean (Français) clearcolor
Est-ce qu'il faut nettoyer le canvas de couleur actif en noir transparent (0, 0, 0, 0). Typiquement, cela devrait être régler à false (faux) avec cette variante de la fonction.
boolean (Français) clearstencil
Est-ce qu'il faut nettoyer le tampon de stencil active, si présent. Ce peut aussi être un entier compris entre 0 et 255 pour nettoyer le tampon de stencil dans une valeur spécifique.
boolean (Français) cleardepth
Est-ce qu'il faut nettoyer le tampon de profondeur actif, si présent. Ce peut aussi être un nombre compris entre 0 et 1 pour nettoyer le tampon de profondeur dans une valeur spécirique..

Retourne

Rien.

Exemples

Nettoie le canvas avant de tracer

Si la touche c est préssée, le canvas sera nettoyé avant de tracer une nouvelle ligne à l'écran.

local canvas = love.graphics.newCanvas()
local clear
 
function love.update()
    -- Utilise une fonction anonyme pour tracer des lignes sur notre canvas.
    canvas:renderTo( function()
        if clear then
            love.graphics.clear() -- Nettoie le canvas avant de tracer des lignes.
        end
 
        -- Trace des lignes depuis l'origine de l'écran jusqu'à des coordonnées x et y au hasard.
        local rx, ry = love.math.random( 0, love.graphics.getWidth() ), love.math.random( 0, love.graphics.getHeight() )
        love.graphics.setColor( love.math.random( ), 0, 0 )
        love.graphics.line( 0, 0, rx, ry )
        love.graphics.setColor( 1, 1, 1 )
    end)
end
 
function love.draw()
    love.graphics.draw( canvas )
end
 
function love.keypressed( key )
    if key == "c" then
        clear = not clear
    end
end

Voir également


Autres langues