background_replace(ind, fname);
| Argument | Description |
|---|---|
| ind | The index of the background to permanently replace. |
| fname | The filename of the image to make the new background. |
| removeback | Indicates whether to make all pixels with the same colour (left-bottom pixel) transparent. |
| smooth | Indicates whether to smooth the edges. |
Returns: N/A
This function works in almost the exact same manner as background_add, only instead of
returning the index of the background you are importing, it
overwrites a previously created background index. The background
index to be replaces is one that has been created and stored in a
variable using other functions like background_add or background_create_from_surface.
You can not use one from the resource tree as you cannot
replace built-in assets.
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.
background_replace(bck_Sky, "Sky_5.png");
The above code will replace the image asset indexed in "spr_Sky" with another one loaded from an external source.