Canvas

Доступно начиная с LÖVE 0.8.0
Было переименовано из Framebuffer.

Canvas используется для рендеринга вне экрана. Представьте его как невидимый экран, на который можно рисовать, но который не будет виден, пока вы не нарисуете его на реальном видимом экране. Также он известен как "рендеринг в текстуру".

Рисуя элементы, положение которых часто не меняется (например, фоновые объекты), на Canvas и затем рисуя весь Canvas вместо каждого элемента, вы можете уменьшить количество операций рисования, выполняемых в каждом кадре.

В версиях до 0.10.0 не все графические карты, поддерживаемые LÖVE, могли использовать Canvas. love.graphics.isSupported("canvas") можно использовать для проверки поддержки во время выполнения.

При рисовании содержимого на Canvas с обычным альфа-смешиванием значения альфа содержимого умножаются на его значения RGB.

Поэтому цвета пикселей Canvas будут иметь предварительно умноженную альфу после отрисовки, поэтому при рисовании Canvas на экран или на другой Canvas необходимо использовать предварительно умноженное альфа-смешивание – love.graphics.setBlendMode("alpha", "premultiplied").

Конструкторы

Функции

Перечисления

Надтипы

• Текстура
• Рисуемый объект
• Объект

Примеры

Рисование чего-либо на Canvas и последующее рисование Canvas на экран.

function love.load()
    canvas = love.graphics.newCanvas(800, 600)
 
    -- Rectangle is drawn to the canvas with the regular alpha blend mode.
    love.graphics.setCanvas(canvas)
        love.graphics.clear()
        love.graphics.setBlendMode("alpha")
        love.graphics.setColor(1, 0, 0, 0.5)
        love.graphics.rectangle('fill', 0, 0, 100, 100)
    love.graphics.setCanvas()
end
 
function love.draw()
    -- very important!: reset color before drawing to canvas to have colors properly displayed
    -- see discussion here: https://love2d.org/forums/viewtopic.php?f=4&p=211418#p211418
    love.graphics.setColor(1, 1, 1, 1)
 
    -- The rectangle from the Canvas was already alpha blended.
    -- Use the premultiplied alpha blend mode when drawing the Canvas itself to prevent improper blending.
    love.graphics.setBlendMode("alpha", "premultiplied")
    love.graphics.draw(canvas)
    -- Observe the difference if the Canvas is drawn with the regular alpha blend mode instead.
    love.graphics.setBlendMode("alpha")
    love.graphics.draw(canvas, 100, 0)
 
    -- Rectangle is drawn directly to the screen with the regular alpha blend mode.
    love.graphics.setBlendMode("alpha")
    love.graphics.setColor(1, 0, 0, 0.5)
    love.graphics.rectangle('fill', 200, 0, 100, 100)
end

См. также

• love.graphics
• love.graphics.setCanvas
• love.graphics.setBlendMode
• love.graphics.isSupported