Difference between revisions of "love.graphics.pop"

(Add an example)
(Examples)
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
Pops the current coordinate transformation from the transformation stack.
 
Pops the current coordinate transformation from the transformation stack.
  
This function is always used to reverse a previous [[love.graphics.push|push]] operation. It returns the current transformation state to what it was before the last preceding push. For an example, see the description of [[love.graphics.push]].
+
This function is always used to reverse a previous [[love.graphics.push|push]] operation. It returns the current transformation state to what it was before the last preceding push.
  
 
== Function ==
 
== Function ==
Line 18: Line 18:
 
function love.draw()
 
function love.draw()
 
   love.graphics.push()  -- stores the coordinate system
 
   love.graphics.push()  -- stores the coordinate system
 +
-- love.graphics.push("all") -- stores all: transform, colors etc.
 
   love.graphics.scale(0.5, 0.5)  -- reduce everything by 50% in both X and Y coordinates
 
   love.graphics.scale(0.5, 0.5)  -- reduce everything by 50% in both X and Y coordinates
 
   love.graphics.print("Scaled text", 50, 50)  -- print half-sized text at 25x25
 
   love.graphics.print("Scaled text", 50, 50)  -- print half-sized text at 25x25
Line 31: Line 32:
 
* [[love.graphics.rotate]]
 
* [[love.graphics.rotate]]
 
* [[love.graphics.scale]]
 
* [[love.graphics.scale]]
 +
* [[love.graphics.shear]]
 +
* [[love.graphics.origin]]
 
[[Category:Functions]]
 
[[Category:Functions]]
 
{{#set:Description=Pops the current coordinate transformation from the transformation stack.}}
 
{{#set:Description=Pops the current coordinate transformation from the transformation stack.}}
 
{{#set:Since=000}}
 
{{#set:Since=000}}
 +
{{#set:Sub-Category=Coordinate System}}
 
== Other Languages ==
 
== Other Languages ==
 
{{i18n|love.graphics.pop}}
 
{{i18n|love.graphics.pop}}

Latest revision as of 08:05, 13 March 2024

Pops the current coordinate transformation from the transformation stack.

This function is always used to reverse a previous push operation. It returns the current transformation state to what it was before the last preceding push.

Function

Synopsis

love.graphics.pop()

Arguments

None

Returns

Nothing.

Examples

Draw two lines of text, one scaled and one normal, using love.graphics.scale. We use love.graphics.pop to return to normal render scale, after having used love.graphics.push.

function love.draw()
   love.graphics.push()   -- stores the coordinate system
-- love.graphics.push("all") -- stores all: transform, colors etc.
   love.graphics.scale(0.5, 0.5)   -- reduce everything by 50% in both X and Y coordinates
   love.graphics.print("Scaled text", 50, 50)   -- print half-sized text at 25x25
   love.graphics.pop()   -- return to stored coordinated
   love.graphics.print("Normal text", 50, 50)
end

See Also


Other Languages