love.graphics.setCanvas

Available since LÖVE 0.8.0
It has been renamed from love.graphics.setRenderTarget.

Function

Synopsis

love.graphics.setCanvas( canvas )

Arguments

Canvas canvas
The new target.

Returns

Nothing.

Notes

Sets the render target to a specified Canvas. All drawing operations until the next love.graphics.setCanvas call will be redirected to the Canvas and not shown on the screen.

Function

Synopsis

love.graphics.setCanvas( )

Arguments

None.

Returns

Nothing.

Notes

Resets the render target to the screen, i.e. re-enables drawing to the screen.

Examples

Drawing to a framebuffer

-- create canvas
canvas = love.graphics.newCanvas()

-- draw colored square to canvas
love.graphics.setCanvas(canvas)
love.graphics.setColor(230,240,120)
love.graphics.rectangle('fill',0,0,100,100)
love.graphics.setCanvas()

-- draw scaled canvas to screen
love.graphics.setColor(255,255,255)
love.graphics.clear()
love.graphics.draw(canvas, 200,100, 0, .5,.5)

See Also


Other Languages