Adds a sprite to the batch. Sprites are drawn in the order they are added.

== Function ==
{{newin|[[0.8.0]]|080|type=variant}}
=== Synopsis ===
<source lang="lua">
id = SpriteBatch:add( x, y, r, sx, sy, ox, oy, kx, ky )
</source>
=== Arguments ===
{{param|number|x|The position to draw the object (x-axis).}}
{{param|number|y|The position to draw the object (y-axis).}}
{{param|number|r (0)|Orientation (radians).}}
{{param|number|sx (1)|Scale factor (x-axis).}}
{{param|number|sy (sx)|Scale factor (y-axis).}}
{{param|number|ox (0)|Origin offset (x-axis).}}
{{param|number|oy (0)|Origin offset (y-axis).}}
{{param|number|kx (0)|Shear factor (x-axis).}}
{{param|number|ky (0)|Shear factor (y-axis).}}
=== Returns ===
{{param|number|id|An identifier for the added sprite.}}

== Function ==
{{newin|[[0.9.0]]|090|type=variant|text=This variant has replaced [[SpriteBatch:addq]]}}
Adds a [[Quad]] to the batch.
=== Synopsis ===
<source lang="lua">
id = SpriteBatch:add( quad, x, y, r, sx, sy, ox, oy, kx, ky )
</source>
=== Arguments ===
{{param|Quad|quad|The Quad to add.}}
{{param|number|x|The position to draw the object (x-axis).}}
{{param|number|y|The position to draw the object (y-axis).}}
{{param|number|r (0)|Orientation (radians).}}
{{param|number|sx (1)|Scale factor (x-axis).}}
{{param|number|sy (sx)|Scale factor (y-axis).}}
{{param|number|ox (0)|Origin offset (x-axis).}}
{{param|number|oy (0)|Origin offset (y-axis).}}
{{param|number|kx (0)|Shear factor (x-axis).}}
{{param|number|ky (0)|Shear factor (y-axis).}}
=== Returns ===
{{param|number|id|An identifier for the added sprite.}}

== Function ==
{{oldin|[[0.8.0]]|080|type=variant}}
=== Synopsis ===
<source lang="lua">
SpriteBatch:add( x, y, r, sx, sy, ox, oy )
</source>
=== Arguments ===
{{param|number|x|The position to draw the object (x-axis).}}
{{param|number|y|The position to draw the object (y-axis).}}
{{param|number|r (0)|Orientation (radians).}}
{{param|number|sx (1)|Scale factor (x-axis).}}
{{param|number|sy (sx)|Scale factor (y-axis).}}
{{param|number|ox (0)|Origin offset (x-axis).}}
{{param|number|oy (0)|Origin offset (y-axis).}}
=== Returns ===
Nothing.

== Notes ==
The returned <code>id</code>s range from 1 to the set [[SpriteBatch:setBufferSize|buffer size]]. If the buffer size is exceeded the returned <code>id</code> will default to 0 and the sprite won't be drawn.

== See Also ==
* [[parent::SpriteBatch]]
* [[SpriteBatch:set]]
[[Category:Functions]]
{{#set:Description=Adds a sprite to the batch.}}
{{#set:Since=000}}
== Other Languages ==
{{i18n|SpriteBatch:add}}