Canvas:clear (Deutsch)

Available since LÖVE 0.8.0
It has been renamed from Framebuffer:clear.

Entfernt den gesamten bisherigen Inhalt eines Canvas.

Wenn die Funktion ohne Argumente aufgerufen wird, dann wird das Canvas mit voller Transparenz (rgba = {0, 0, 0, 0}) überschrieben. Die Alpha Komponente kann optional gesetzt werden. Wird kein Wert für sie gesetzt, so fällt sie auf einen Standardwert von 255 zurück.

Bestimmte Teile einer Leinwand können mit love.graphics.setScissor entfernt werden.

Funktion

Übersicht

Canvas:clear( )

Argumente

Keine.

Rückgabewerte

Keine.

Funktion

Übersicht

Canvas:clear( red, green, blue, alpha )

Argumente

number (Deutsch) red
Die Rot-Komponente der Farbe mit der die Leinwand überschrieben werden soll (0-255).
number (Deutsch) green
Die Grün-Komponente der Farbe mit der die Leinwand überschrieben werden soll (0-255).
number (Deutsch) blue
Die Blau-Komponente der Farbe mit der die Leinwand überschrieben werden soll (0-255).
number (Deutsch) alpha (255)
Die Alpha-Komponente der Farbe mit der die Leinwand überschrieben werden soll (0-255).

Rückgabewerte

Keine.

Funktion

Übersicht

Canvas:clear( rgba )

Argumente

table (Deutsch) rgba
Eine Sequenz mit Rot, Grün, Blau und Alpha Werten.

Rückgabewerte

Keine.

Beispiele

Leeren eines Canvas

Entfernt den bisherigen Inhalt des Canvas wenn die c-Taste gedrückt wird.

local canvas = love.graphics.newCanvas();
local clear;
function love.update()
    -- Nutzt eine anonyme Funktion um auf ein Canvas zu zeichnen.
    canvas:renderTo(function()
        if clear then canvas:clear(); end   -- Leert das Canvas bevor neue Linien gezeichnet werden.
        love.graphics.setColor(love.math.random(255), 0, 0);
        love.graphics.line(0, 0, love.math.random(0, love.graphics.getWidth()), love.math.random(0, love.graphics.getHeight()));
    end);
end

function love.draw()
    love.graphics.setColor(255, 255, 255);
    love.graphics.draw(canvas);
end

function love.keypressed(key)
    if key == 'c' then clear = not clear; end
end

Siehe auch

Andere Sprachen