Difference between revisions of "SpriteBatch:set"
(Added geometry variant for 0.9.0) |
m |
||
| Line 22: | Line 22: | ||
== Function == | == Function == | ||
| − | {{newin|[[0.9.0]]|090|type=variant|text=This variant has replaced [[SpriteBatch:setq]] | + | {{newin|[[0.9.0]]|090|type=variant|text=This variant has replaced [[SpriteBatch:setq]]}} |
Changes a sprite with a [[Geometry]] in the batch. This requires the identifier returned by [[SpriteBatch:add]]. | Changes a sprite with a [[Geometry]] in the batch. This requires the identifier returned by [[SpriteBatch:add]]. | ||
{{notice|Geometry with more than 4 vertices cannot be used with SpriteBatches.}} | {{notice|Geometry with more than 4 vertices cannot be used with SpriteBatches.}} | ||
Revision as of 18:30, 11 August 2013
| Available since LÖVE 0.8.0 |
| This method is not supported in earlier versions. |
Changes a sprite in the batch. This requires the identifier returned by add and addq.
Contents
Function
Synopsis
SpriteBatch:set( id, x, y, r, sx, sy, ox, oy, kx, ky )
Arguments
number id- The identifier of the sprite that will be changed.
number x- The position to draw the object (x-axis).
number y- The position to draw the object (y-axis).
number r (0)- Orientation (radians).
number sx (1)- Scale factor (x-axis).
number sy (sx)- Scale factor (y-axis).
number ox (0)- Origin offset (x-axis).
number oy (0)- Origin offset (y-axis).
number kx (0)- Shear factor (x-axis).
number ky (0)- Shear factor (y-axis).
Returns
Nothing.
Function
| Available since LÖVE 0.9.0 |
| This variant has replaced SpriteBatch:setq. |
Changes a sprite with a Geometry in the batch. This requires the identifier returned by SpriteBatch:add.
|
Geometry with more than 4 vertices cannot be used with SpriteBatches. |
Synopsis
SpriteBatch:set( id, geometry, x, y, r, sx, sy, ox, oy, kx, ky )
Arguments
number id- The identifier of the sprite that will be changed.
Geometry geometry- The Geometry used on the image of the batch.
number x- The position to draw the object (x-axis).
number y- The position to draw the object (y-axis).
number r (0)- Orientation (radians).
number sx (1)- Scale factor (x-axis).
number sy (sx)- Scale factor (y-axis).
number ox (0)- Origin offset (x-axis).
number oy (0)- Origin offset (y-axis).
number kx (0)- Shear factor (x-axis).
number ky (0)- Shear factor (y-axis).
Returns
Nothing.
Notes
SpriteBatches do not support removing individual sprites. One can do a pseudo removal (instead of clearing and re-adding everything) by:
SpriteBatch:set(id, 0, 0, 0, 0, 0)
This makes all the sprite's vertices equal (because the x and y scales are 0), which prevents the GPU from fully processing the sprite when drawing the SpriteBatch.
See Also
Other Languages
Dansk –
Deutsch –
English –
Español –
Français –
Indonesia –
Italiano –
Lietuviškai –
Magyar –
Nederlands –
Polski –
Português –
Română –
Slovenský –
Suomi –
Svenska –
Türkçe –
Česky –
Ελληνικά –
Български –
Русский –
Српски –
Українська –
עברית –
ไทย –
日本語 –
正體中文 –
简体中文 –
Tiếng Việt –
한국어
More info
