# love.graphics.setRenderTarget

Available since LÖVE 0.7.0
This function is not supported in earlier versions.

Removed in LÖVE 0.8.0
It has been renamed to love.graphics.setCanvas.

Sets or resets a Framebuffer as render target. All drawing operations until the next love.graphics.setRenderTarget will be directed to the Framebuffer object specified.

## Function

### Synopsis

    love.graphics.setRenderTarget( framebuffer )

### Arguments

`Framebuffer framebuffer`
  The new render target.

### Returns

Nothing.

### Notes

Sets the render target to a specified Framebuffer. The specified Framebuffer will be cleared. All drawing operations until the next love.graphics.setRenderTarget will be redirected to the Framebuffer and not shown on the screen.

## Function

### Synopsis

    love.graphics.setRenderTarget( )

### 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

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

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

## See Also

- love.graphics
- Framebuffer
- Framebuffer:renderTo

##

Category:

- Functions