Adds an image from a file to the set of sprite resources.


background_add(fname, removeback, smooth);

Argument Description
fname The name (string) of the file to added.
removeback Indicates whether to make all pixels with the selected colour (left-bottom pixel) transparent.
smooth Indicates whether to smooth the edges if transparent.

Returns: Real


With this function you can add an image as a background, loading it from an external source where the image file to be loaded should always be *.png format. The function returns the new background index which must then be used in all further codes that relate to this background. If you use this function with HTML5 or are getting an image from an URL, this function will also generate an asynchronous event. See Advanced Use - More About Async Events for more information.

Setting the "removeback" argument to true will remove a colour from the background, by checking the bottom left pixel of the defined area for the colour there and then using that as the colour to be removed.

If you choose the "removeback" option, you may also want GameMaker: Studio to smooth the edges of the background by setting the "smooth" argument to true. All this does is create a semi-transparent border around the edges of the background after it has had its background removed.

It is worth noting that when you load a background into GameMaker: Studio in this way you must remember to remove it again (with background_delete) when no longer needed, otherwise there is risk of a memory leak which will slow down and eventually crash your game.

NOTE: Depending on the target platform that is chosen you are limited as to where you can save and load files from. See Reference - Files for more information.

NOTE: You should be aware that if you are using this function in your HTML5 target game to load resources from an external server, then, due to XSS protection in browsers, attempts to load resources from across domains can be blocked and may appear to return blank results.


bck = background_add("Sky_5.png");

The above code loads a background into the game and stores its index in the variable "bck".

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