# 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, size )

### Arguments

`Image image`
  The Image to use for the sprites.
`number size (1000)`
  The max number of sprites.

### 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, size, usagehint )

### Arguments

`Image image`
  The Image to use for the sprites.
`number size (1000)`
  The max number of sprites.
`SpriteBatchUsage usagehint ("dynamic")`
  The expected usage of the SpriteBatch.

### 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, size, usagehint )

### Arguments

`Texture texture`
  The Image or Canvas to use for the sprites.
`number size (1000)`
  The max number of sprites.
`SpriteBatchUsage usagehint ("dynamic")`
  The expected usage of the SpriteBatch.

### Returns

`SpriteBatch spriteBatch`
  The new SpriteBatch.

## See Also

- love.graphics
- SpriteBatch

##

Category:

- Functions