Difference between revisions of "Sprite:getBounds"

From GiderosMobile
(remove language stuff)
 
(2 intermediate revisions by one other user not shown)
Line 5: Line 5:
 
=== Description ===
 
=== Description ===
 
Returns a rectangle (as x, y, width and height) that encloses the sprite as it appears in another sprite coordinate system.
 
Returns a rectangle (as x, y, width and height) that encloses the sprite as it appears in another sprite coordinate system.
−
<source lang="lua">
+
<syntaxhighlight lang="lua">
−
(number), (number), (number), (number) = Sprite:getBounds(targetSprite)
+
(number), (number), (number), (number) = Sprite:getBounds(targetSprite,constrain)
−
</source>
+
</syntaxhighlight>
  
 
=== Parameters ===
 
=== Parameters ===
 
'''targetSprite''': (Sprite) the sprite that defines the other coordinate system to transform<br/>
 
'''targetSprite''': (Sprite) the sprite that defines the other coordinate system to transform<br/>
 +
'''constrain''': (bool) constrains the bounds to the base sprite layout '''default = false'''<br/>
  
 
=== Return values ===
 
=== Return values ===
Line 19: Line 20:
  
 
=== Examples ===
 
=== Examples ===
−
<source lang="lua">
+
<syntaxhighlight lang="lua">
 
local x, y, width, height = sprite:getBounds(sprite) -- returns local (untransformed) bounds
 
local x, y, width, height = sprite:getBounds(sprite) -- returns local (untransformed) bounds
 
local x, y, width, height = sprite:getBounds(stage) -- returns bounds as transformed to the stage coordinate system
 
local x, y, width, height = sprite:getBounds(stage) -- returns bounds as transformed to the stage coordinate system
−
</source>
+
</syntaxhighlight>
  
 
{{Sprite}}
 
{{Sprite}}

Latest revision as of 04:01, 18 November 2023

Available since: Gideros 2011.6
Class: Sprite

Description

Returns a rectangle (as x, y, width and height) that encloses the sprite as it appears in another sprite coordinate system. 

(number), (number), (number), (number) = Sprite:getBounds(targetSprite,constrain)

Parameters

targetSprite: (Sprite) the sprite that defines the other coordinate system to transform
constrain: (bool) constrains the bounds to the base sprite layout default = false

Return values

Returns (number) x coordinate
Returns (number) y coordinate
Returns (number) width of Sprite
Returns (number) height of Sprite

Examples

local x, y, width, height = sprite:getBounds(sprite) -- returns local (untransformed) bounds
local x, y, width, height = sprite:getBounds(stage) -- returns bounds as transformed to the stage coordinate system





Retrieved from ‘https://wiki.gideros.rocks/index.php?title=Sprite:getBounds&oldid=23040’