love.graphics.setScissor

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

Sets or disables scissor.

The scissor limits the drawing area to a specified rectangle. This affects all graphics calls, including love.graphics.clear.

The dimensions of the scissor are unaffected by graphical transformations (translate, scale, ...), and it operates on whole pixels rather than having sub-pixel precision.

Function

Limits the drawing area to a specified rectangle.

Synopsis

love.graphics.setScissor( x, y, width, height )

Arguments

number x
The x-coordinate of the upper left corner of the clipping rectangle.
number y
The y-coordinate of the upper left corner of the clipping rectangle.
number width
The width of the clipping rectangle.
number height
The height of the clipping rectangle.

Returns

Nothing.

Function

Disables scissor.

Synopsis

love.graphics.setScissor( )

Arguments

None.

Returns

Nothing.

Examples

Only draw on the left side of the screen

function love.draw()
	local windowWidth, windowHeight = love.graphics.getDimensions()

	love.graphics.setScissor(0,0, windowWidth/2,windowHeight)
	love.graphics.clear(0, 0, .5)
	love.graphics.circle("fill", windowWidth/2,windowHeight/2, 100)
end

See Also

Other Languages