love.graphics.push
Copies and pushes the current coordinate transformation to the transformation stack.
This function is always used to prepare for a corresponding pop operation later. It stores the current coordinate transformation state into the transformation stack and keeps it active. Later changes to the transformation can be undone by using the pop operation, which returns the coordinate transform to the state it was in before calling push.
Function
Pushes the current transformation to the transformation stack.
Synopsis
love.graphics.push( )
Arguments
None.
Returns
Nothing.
Function
Available since LÖVE 0.9.2
This variant is not supported in earlier versions.
Pushes a specific type of state to the stack.
Synopsis
love.graphics.push( stack )
Arguments
StackType stack
- The type of stack to push (e.g. just transformation state, or all love.graphics state).
Returns
Nothing.
Examples
Modify and restore the coordinate system.
function love.draw() love.graphics.push() -- stores the default coordinate system love.graphics.translate(...) -- move the camera position love.graphics.scale(...) -- zoom the camera -- use the new coordinate system to draw the viewed scene love.graphics.pop() -- return to the default coordinates -- draw the status display using the screen coordinates end
Available since LÖVE 0.9.2
This example is not supported in earlier versions.
Modify love.graphics state in a function, and restore it easily so other code isn't disturbed.
function DrawCoolThing() love.graphics.push("all") -- save all love.graphics state so any changes can be restored love.graphics.setColor(0, 0, 255) love.graphics.setBlendMode("subtractive") love.graphics.circle("fill", 400, 300, 80) love.graphics.pop() -- restore the saved love.graphics state end function love.draw() love.graphics.setColor(255, 128, 128) love.graphics.circle("fill", 400, 300, 100) DrawCoolThing() love.graphics.rectangle("fill", 600, 200, 200, 200) -- still uses the color set at the top of love.draw end
See Also
- love.graphics
- love.graphics.pop
- love.graphics.translate
- love.graphics.rotate
- love.graphics.scale
- love.graphics.shear
- love.graphics.origin
- StackType
Please login to continue.