love.graphics.clear

Очищает экран или активный холст до указанного цвета.

Эта функция вызывается автоматически перед love.draw в функции по умолчанию love.run. Пример использования этой функции см. в love.run.

Обратите внимание, что границы области обрезки ограничивают область, которая будет очищена.

В версиях до 11.0 значения компонентов цвета находились в диапазоне от 0 до 255 вместо 0 до 1.

В версиях до 0.10.0 эта функция очищала экран до текущего установленного фонового цвета.

Функция

Очищает экран до фонового цвета в 0.9.2 и ранее, или до прозрачного черного (0, 0, 0, 0) в LÖVE 0.10.0 и новее.

Синтаксис

love.graphics.clear( )

Аргументы

Нет.

Возвращаемые значения

Ничего.

Функция

Доступна начиная с LÖVE 0.10.0
Этот вариант недоступен в более ранних версиях.

Очищает экран или активный холст до указанного цвета.

Синтаксис

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

Аргументы

number r

Красная составляющая цвета, которым будет очищен экран.

number g

Зелёная составляющая цвета, которым будет очищен экран.

number b

Синяя составляющая цвета, которым будет очищен экран.

number a (1)

Альфа-составляющая цвета, которым будет очищен экран.

boolean clearstencil (true) Доступна начиная с 11.0

Нужно ли очистить активный буфер трафарета, если он присутствует. Также может быть целым числом от 0 до 255 для очистки буфера трафарета до определенного значения.

boolean cleardepth (true) Доступна начиная с 11.0

Нужно ли очистить активный буфер глубины, если он присутствует. Также может быть числом от 0 до 1 для очистки буфера глубины до определенного значения.

Возвращаемые значения

Ничего.

Функция

Доступна начиная с LÖVE 0.10.0
Этот вариант недоступен в более ранних версиях.

Очищает несколько активных холстов до разных цветов, если несколько холстов активны одновременно через love.graphics.setCanvas.

Синтаксис

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

Аргументы

table color

Таблица в формате {r, g, b, a} содержащая цвет для очистки первого активного холста.

table ...

Дополнительные таблицы для каждого активного холста.

boolean clearstencil (true) Доступна начиная с 11.0

Нужно ли очистить активный буфер трафарета, если он присутствует. Также может быть целым числом от 0 до 255 для очистки буфера трафарета до определенного значения.

boolean cleardepth (true) Доступна начиная с 11.0

Нужно ли очистить активный буфер глубины, если он присутствует. Также может быть числом от 0 до 1 для очистки буфера глубины до определенного значения.

Возвращаемые значения

Ничего.

Примечания

Для каждого активного холста должен быть указан цвет, когда используется этот вариант функции.

Функция

Доступна начиная с LÖVE 11.0
Этот вариант недоступен в более ранних версиях.

Очищает буферы трафарета или глубины без необходимости очистки цветового холста.

Синтаксис

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

Аргументы

boolean clearcolor

Нужно ли очистить активный цветовой холст до прозрачного черного (0, 0, 0, 0). Обычно это должно быть установлено в false с этим вариантом функции.

boolean clearstencil

Нужно ли очистить активный буфер трафарета, если он присутствует. Также может быть целым числом от 0 до 255 для очистки буфера трафарета до определенного значения.

boolean cleardepth

Нужно ли очистить активный буфер глубины, если он присутствует. Также может быть числом от 0 до 1 для очистки буфера глубины до определенного значения.

Возвращаемые значения

Ничего.

Примеры

Очистка холста перед отрисовкой

Если нажата клавиша 'c', холст будет очищен перед отрисовкой новой линии на экране.

local canvas = love.graphics.newCanvas()
local clear
 
function love.update()
    -- Use an anonymous function to draw lines on our canvas.
    canvas:renderTo( function()
        if clear then
            love.graphics.clear() -- Clear the canvas before drawing lines.
        end
 
        -- Draw lines from the screen's origin to a random x and y coordinate.
        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

См. также

• love.graphics.present
• love.graphics.setBackgroundColor
• love.graphics.setScissor
• love.graphics.setCanvas
• love.graphics