SpriteBatch:bind

SpriteBatch:bind

Available since LÖVE 0.8.0
It has been renamed from SpriteBatch:lock.

Removed in LÖVE 0.10.0
It happens automatically since version 0.9.2. Use SpriteBatch:flush if absolutely necessary.


Binds the SpriteBatch to memory for more efficient updating.

Binding a SpriteBatch before updating its content can improve the performance as it doesn't push each update to the graphics card separately. Don't forget to unbind the SpriteBatch or the updates won't show up.

Function

Synopsis

1
SpriteBatch:bind( )

Arguments

None.

Returns

Nothing.

Examples

Updating a SpriteBatch with binding

1
2
3
4
5
6
7
8
9
function update_spritebatch(spritebatch)
    spritebatch:bind()
  
    for i = 1, 100 do
        add_tile(spritebatch)
    end
  
    spritebatch:unbind()
end

See Also

doc_love
2025-01-10 15:47:30
Comments
Leave a Comment

Please login to continue.