Cette variable intégrée est créée pour chaque instance dans une pièce et contient la valeur d'ID de couche du calque auquel l'instance est affectée. Cette valeur peut ensuite être utilisée dans d'autres fonctions comme layer_get_depth ou il peut être changé pour déplacer l'instance vers un autre calque, mais notez que si le calque assigné n'existe pas dans la pièce courante, alors vous obtiendrez une erreur qui forcera votre jeu à se fermer. Lors de l'affectation d'une couche, vous devez fournir l' ID de couche unique renvoyé par la fonction layer_get_id() (lors de l'utilisation de couches de pièces nommées), ou telles que renvoyées par la fonction layer_create() (lorsque vous créez vos propres calques lors de l'exécution).
IMPORTANT! si vous avez créé l'instance en utilisant le instance_create_depth() fonction, ou ont changé manuellement la depth variable, la couche affectée à l'instance devient une couche "gérée", que GameMaker Studio 2 contrôle et gère automatiquement. Dans ces cas, le layer variable retournera -1.
layer;
Layer ID value (Real)
layer = layer_create(-1000);
Le code ci-dessus va créer un nouveau calque avec une profondeur de -1000 et ensuite définir l'instance layer variable à l'ID de couche retournée, en déplaçant l'instance de la couche sur laquelle elle est actuellement vers la nouvelle couche en cours de création.