Canvas:renderTo

Available since LÖVE 0.8.0

It has been renamed from Framebuffer:renderTo.

Render to the Canvas using a function.

This is a shortcut to love.graphics.setCanvas:

canvas:renderTo( func )

is the same as

local prevcanvas = love.graphics.getCanvas()
love.graphics.setCanvas( canvas )
func()
love.graphics.setCanvas( prevcanvas )

Function

Synopsis

Canvas:renderTo( func, ... )

Arguments

function func

A function performing drawing operations.

Available since LÖVE 11.5

any ...

Additional arguments to call the function with.

Returns

Nothing.

Function

Available since LÖVE 11.0

This variant is not supported in earlier versions.

Synopsis

Canvas:renderTo( index, func, ... )

Arguments

number index

An index to a layer (for array textures and volume textures) or an index to a cubemap face (for cubemap textures).

function func

A function performing drawing operations.

Available since LÖVE 11.5

any ...

Additional arguments to call the function with.

Returns

Nothing.

Examples

Using an anonymous function for drawing to a Canvas

This example randomly draws a bunch of red lines from the top left corner of the screen to the bottom.

local canvas = love.graphics.newCanvas()
function love.update()
    canvas:renderTo(function()
        love.graphics.setColor(love.math.random(), 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(1, 1, 1);
    love.graphics.draw(canvas);
end

See Also

• Canvas
• love.graphics.setCanvas

Other Languages

Dansk – Deutsch – English – Español – Français – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Polski – Português – Română – Slovenský – Suomi – Svenska – Türkçe – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – ไทย – 日本語 – 正體中文 – 简体中文 – Tiếng Việt – 한국어
More info