Difference between revisions of "love.graphics.translate"

m (Grammar and stuff.)
 
(9 intermediate revisions by 6 users not shown)
Line 5: Line 5:
 
Scale and translate are not commutative operations, therefore, calling them in different orders will change the outcome.
 
Scale and translate are not commutative operations, therefore, calling them in different orders will change the outcome.
  
This change lasts until love.draw() exits.
+
This change lasts until the next [[love.draw]] call, or a [[love.graphics.pop]] reverts to a previous [[love.graphics.push]], or [[love.graphics.origin]] is called - whichever comes first.
  
 
Translating using whole numbers will prevent tearing/blurring of images and fonts draw after translating.
 
Translating using whole numbers will prevent tearing/blurring of images and fonts draw after translating.
Line 20: Line 20:
 
=== Returns ===
 
=== Returns ===
 
Nothing.
 
Nothing.
 +
 +
== Examples ==
 +
Translate down and to the right by 10 pixels. Remember, the translation is reset at the end of each [[love.draw]].
 +
<source lang="lua">
 +
function love.draw()
 +
  love.graphics.translate(10, 10)
 +
  love.graphics.print("Text", 5, 5)  -- will effectively render at 15x15
 +
end
 +
</source>
 +
 +
 +
Move the coordinate system with the mouse:
 +
<source lang="lua">
 +
tx=0
 +
ty=0
 +
function love.draw()
 +
mx = love.mouse.getX()
 +
my = love.mouse.getY()
 +
if love.mouse.isDown(1) then
 +
if not mouse_pressed then
 +
mouse_pressed = true
 +
dx = tx-mx
 +
dy = ty-my
 +
else
 +
tx = mx+dx
 +
ty = my+dy
 +
end
 +
elseif mouse_pressed then
 +
mouse_pressed = false
 +
end
 +
love.graphics.translate(tx, ty)
 +
 +
-- example graphics:
 +
love.graphics.circle( "line", 0, 0, 400 )
 +
love.graphics.line(-440, 0, 440, 0)
 +
love.graphics.line(0, -440, 0, 440)
 +
end
 +
 +
-- restore position with the right mouse button:
 +
function love.mousepressed(x, y, button, istouch)
 +
  if button == 2 then
 +
      tx = 0
 +
      ty = 0
 +
  end
 +
end
 +
</source>
 +
 +
 +
 
== See Also ==
 
== See Also ==
 
* [[parent::love.graphics]]
 
* [[parent::love.graphics]]
Line 26: Line 75:
 
* [[love.graphics.rotate]]
 
* [[love.graphics.rotate]]
 
* [[love.graphics.scale]]
 
* [[love.graphics.scale]]
 +
* [[love.graphics.shear]]
 +
* [[love.graphics.origin]]
 
[[Category:Functions]]
 
[[Category:Functions]]
 
{{#set:Description=Translates the coordinate system in two dimensions.}}
 
{{#set:Description=Translates the coordinate system in two dimensions.}}
 
{{#set:Since=000}}
 
{{#set:Since=000}}
 +
{{#set:Sub-Category=Coordinate System}}
 
== Other Languages ==
 
== Other Languages ==
 
{{i18n|love.graphics.translate}}
 
{{i18n|love.graphics.translate}}

Latest revision as of 18:20, 3 June 2022

Translates the coordinate system in two dimensions.

When this function is called with two numbers, dx, and dy, all the following drawing operations take effect as if their x and y coordinates were x+dx and y+dy.

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

This change lasts until the next love.draw call, or a love.graphics.pop reverts to a previous love.graphics.push, or love.graphics.origin is called - whichever comes first.

Translating using whole numbers will prevent tearing/blurring of images and fonts draw after translating.

Function

Synopsis

love.graphics.translate( dx, dy )

Arguments

number dx
The translation relative to the x-axis.
number dy
The translation relative to the y-axis.

Returns

Nothing.

Examples

Translate down and to the right by 10 pixels. Remember, the translation is reset at the end of each love.draw.

function love.draw()
   love.graphics.translate(10, 10)
   love.graphics.print("Text", 5, 5)   -- will effectively render at 15x15
end


Move the coordinate system with the mouse:

tx=0
ty=0
function love.draw()
	mx = love.mouse.getX()
	my = love.mouse.getY()
	if love.mouse.isDown(1) then
		if not mouse_pressed then
			mouse_pressed = true
			dx = tx-mx
			dy = ty-my
		else
			tx = mx+dx
			ty = my+dy
		end
	elseif mouse_pressed then
		mouse_pressed = false
	end
	love.graphics.translate(tx, ty)
	
	-- example graphics:
	love.graphics.circle( "line", 0, 0, 400 )
	love.graphics.line(-440, 0, 440, 0)
	love.graphics.line(0, -440, 0, 440)
end

-- restore position with the right mouse button:
function love.mousepressed(x, y, button, istouch)
   if button == 2 then
      tx = 0
      ty = 0
   end
end


See Also


Other Languages