|index||The index of the sprite to duplicate.|
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".