love.lowmemory

Available since LÖVE 0.10.0
This callback is not supported in earlier versions.

Callback function triggered when the system is running out of memory on mobile devices.

Mobile operating systems may forcefully kill the game if it uses too much memory, so any non-critical resource should be removed if possible (by setting all variables referencing the resources to nil), when this event is triggered. Sounds and images in particular tend to use the most memory.

Function

Synopsis

love.lowmemory( )

Arguments

None.

Returns

Nothing.

Examples

Clear unused data and collect the garbage when memory is low.

local cachetable = {}
for i = 0, math.pi * 2, math.pi / 1000 do
    cachetable[i] = math.sin(i)
end
 
function love.lowmemory()
    cachetable = {}
    collectgarbage()
end