layer_destroy


La description

Cette fonction va détruire le calque donné. Vous fournissez l'ID de couche (que vous obtenez lorsque vous créez la couche en utilisant layer_create() ) ou le nom de la couche (en tant que chaîne - cela aura un impact sur les performances) et cela l'enlèvera de la pièce actuelle. Si le calque est celui qui a été conçu dans l'éditeur de pièce, la couche suivante sera recréée avec le contenu d'origine la prochaine fois que vous quitterez la pièce, mais si la pièce est persistante, la couche sera supprimée à moins que la persistance de la pièce est à nouveau désactivée. Lorsque vous détruisez un calque de cette manière, tout son contenu sera également supprimé, donc tout ID de référence pour les arrière-plans ou les tilemaps, etc... ne sera plus valide et toutes les occurrences assignées au calque seront détruites (en effectuant leur Destroy Event en même temps, s'ils en ont un, ainsi que le Clean Up Event).


Syntaxe:

layer_destroy(layer_id)


Arguments:

Argument La description
layer_id La valeur d'ID unique du calque à détruire (ou le nom du calque sous forme de chaîne)


Résultats:

N/A


Exemple:

if !instance_exists(obj_Bullet_Parent)
   {
   layer_destroy(global.Bullet_Layer);
   }

Le code ci-dessus vérifiera si des instances de l'objet "obj_Bullet_Parent" existent, et si ce n'est pas le cas, il détruira la couche avec l'ID stocké dans la variable globale.


Précédent: Fonctions de couche générales
suivant: layer_x
© Copyright YoYo Games Ltd. 2017 Tous droits réservés