love.graphics.newSpriteBatch
Creates a new SpriteBatch object.
This function can be slow if it is called repeatedly, such as from love.update or love.draw. If you need to use a specific resource often, create it once and store it somewhere it can be reused!
Function
Synopsis
spriteBatch = love.graphics.newSpriteBatch( image, maxsprites )
Arguments
Image image
- The Image to use for the sprites.
number maxsprites (1000)
- The maximum number of sprites that the SpriteBatch can contain at any given time.
Returns
SpriteBatch spriteBatch
- The new SpriteBatch.
Function
Available since LÖVE 0.8.0
This variant is not supported in earlier versions.
Synopsis
spriteBatch = love.graphics.newSpriteBatch( image, maxsprites, usage )
Arguments
Image image
- The Image to use for the sprites.
number maxsprites (1000)
- The maximum number of sprites that the SpriteBatch can contain at any given time.
SpriteBatchUsage usage ("dynamic")
- The expected usage of the SpriteBatch. The specified usage mode affects the SpriteBatch's memory usage and performance.
Returns
SpriteBatch spriteBatch
- The new SpriteBatch.
Function
Available since LÖVE 0.9.1
This variant is not supported in earlier versions.
Synopsis
spriteBatch = love.graphics.newSpriteBatch( texture, maxsprites, usage )
Arguments
Texture texture
- The Image or Canvas to use for the sprites.
number maxsprites (1000)
- The maximum number of sprites that the SpriteBatch can contain at any given time.
SpriteBatchUsage usage ("dynamic")
- The expected usage of the SpriteBatch. The specified usage mode affects the SpriteBatch's memory usage and performance.
Returns
SpriteBatch spriteBatch
- The new SpriteBatch.
Please login to continue.