Vous pouvez utiliser cette fonction pour obtenir la valeur de profondeur associée à un 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 la fonction retournera la profondeur de ces couches comme un nombre réel. Notez que la profondeur est définie comme étant plus "éloignée" de la caméra et abaissée "plus proche" de la caméra, donc si vous avez trois couches avec des profondeurs -100, 0, 100, les couches dessineront dans l'ordre 100, 0, -100, de sorte que le calque "supérieur" (c'est-à-dire le plus proche de la vue de la caméra et ainsi dessiné sur tout le reste) sera le calque avec la profondeur -100.
L'image suivante montre un schéma de la façon dont la profondeur fonctionne pour les calques: 
Notez que si vous fournissez une valeur d'ID de couche invalide, vous obtiendrez une erreur.