sprite_duplicate


Syntaxe:

sprite_duplicate(index);

Argument La description
index L'index de l'image-objet à dupliquer.


Résultats

Real (unique sprite ID value)


La description

Cette fonction renvoie l'index d'une image-objet nouvellement créée qui est une copie (copie) d'une entrée en tant qu'argument "index". Si la fonction échoue, -1 est renvoyé. Cette fonction doit être utilisée pour copier les images-objets des fichiers d'origine avant toute transformation. Par exemple, si vous souhaitez modifier la zone de délimitation d'une image-objet ou définir son alpha à partir d'une autre image-objet, vous devez d'abord la dupliquer, puis effectuer l'opération sur l'image-objet dupliquée et l'utiliser. Une image-objet dupliquée sera placée sur sa propre page de texture une fois créée, ce qui signifie que la duplication de plusieurs images-objets créera plusieurs pages de texture et aura un impact sur les performances. Utilisez cette fonction uniquement si nécessaire.

REMARQUE: lorsque vous dupliquez une image-objet dans GameMaker Studio 2 n'oubliez pas de la supprimer sprite_delete ) lorsqu'il n'est plus nécessaire, sinon il y a un risque de fuite de mémoire qui ralentira et finira par planter votre jeu.
IMPORTANT! Cette fonction n'est pas disponible avec la licence d'évaluation du produit.


Exemple:

new_spr = sprite_duplicate(sprite_index)

Le code ci-dessus duplique l'image-objet actuellement utilisée comme index d'image-objet de l'instance et stocke l'index pour cette nouvelle image-objet dans la variable "new_spr".