sprite_duplicate(index);
| Argument | Description |
|---|---|
| index | The index of the sprite to duplicate. |
Returns: Real
This function will return the index of a newly created sprite that is a duplicate (copy) of the one input as the "index" argument. If the function fails, -1 is returned. This function must be used to copy any
sprites from the original assets before any transformations can be done on them. For example, if you wish to change the bounding box for a sprite, or set its alpha from another sprite, you must first duplicate it,
then perform the operation on the duplicated sprite and use that.
NOTE: When you duplicate a sprite in GameMaker: Studio you must remember to remove it again (with sprite_delete) when no longer needed, otherwise
there is risk of a memory leak which will slow down and eventually crash your game.
new_spr = sprite_duplicate(sprite_index)
The above code duplicates the sprite currently being used as the sprite index of the instance and stores the index for this new sprite in the variable "new_spr".