Deletes the background from memory, freeing the memory used.



Argument Description
index The index of the background to be deleted.

Returns: N/A


This function will delete a background from the game, freeing any memory that was reserved for it. This is a permanent removal, and if the asset that you delete was included as part of the game's resources, not even restarting the game (unless you close the application first) will recover it. This is a very important function for those moments when you need to create and change backgrounds from external resources and should always be used to remove those assets that are no longer needed by a game, or to clear an indexed asset from a variable before re-assigning another asset to that same variable.


var bck;
bck = background_create_from_screen(0, 0, 320, 320, false, false);
background_assign(bck_Custom, bck) background_delete(bck);

The above code creates a local variable and then stores the index of the background created from the screen. This background is then assigned to the asset indexed in the variable "bck_Custom" before being removed from memory again.

Back: Backgrounds
Next: background_flush
© Copyright YoYo Games Ltd. 2018 All Rights Reserved