Scales the coordinate system in two dimensions.

By default the coordinate system in LÖVE corresponds to the display pixels in horizontal and vertical directions one-to-one, and the x-axis increases towards the right while the y-axis increases downwards. Scaling the coordinate system changes this relation.

After scaling by sx and sy, all coordinates are treated as if they were multiplied by sx and sy. Every result of a drawing operation is also correspondingly scaled, so scaling by (2, 2) for example would mean making everything twice as large in both x- and y-directions. Scaling by a negative value flips the coordinate system in the corresponding direction, which also means everything will be drawn flipped or upside down, or both. Scaling by zero is not a useful operation.

Scale and translate are not commutative operations, therefore, calling them in different orders will change the outcome.

Scaling lasts until [[love.draw]]() exits.

== Function ==
=== Synopsis ===
<source lang="lua">
love.graphics.scale( sx, sy )
</source>
=== Arguments ===
{{param|number|sx|The scaling in the direction of the x-axis.}}
{{param|number|sy (sx)|The scaling in the direction of the y-axis. If omitted, it defaults to same as parameter sx.}}

=== Returns ===
Nothing.

== Examples ==
Draw two lines of text, one scaled and one normal. Uses [[love.graphics.push]] and [[love.graphics.pop]] to return to normal render scale.
<source lang="lua">
function love.draw()
   love.graphics.push()
   love.graphics.scale(0.5, 0.5)   -- reduce everything by 50% in both X and Y coordinates
   love.graphics.print("Scaled text", 50, 50)
   love.graphics.pop()
   love.graphics.print("Normal text", 50, 50)
end
</source>

== See Also ==
* [[parent::love.graphics]]
* [[love.graphics.pop]]
* [[love.graphics.push]]
* [[love.graphics.rotate]]
* [[love.graphics.shear]]
* [[love.graphics.translate]]
* [[love.graphics.origin]]
[[Category:Functions]]
{{#set:Description=Scales the coordinate system in two dimensions.}}
{{#set:Since=000}}
{{#set:Sub-Category=Coordinate System}}
== Other Languages ==
{{i18n|love.graphics.scale}}