Cette fonction est utilisée pour créer un nouveau calque dans la pièce actuelle. Vous fournissez la profondeur que la nouvelle couche doit occuper et la fonction renvoie la valeur unique de l'ID de couche qui peut ensuite être utilisée pour accéder à la couche dans d'autres fonctions. Vous pouvez également fournir un argument "nom" facultatif, qui vous permettra de donner un nom spécifique au calque (en tant que chaîne), et au lieu d'utiliser l'ID de calque pour accéder au calque, vous pouvez utiliser cette chaîne de nom Il convient de noter que l'utilisation de chaînes de noms aura un impact plus important sur les performances que l'utilisation de la valeur ID uniquement.
Lorsque vous donnez une valeur de profondeur, ce sera plus "éloigné" de la caméra et plus "proche" de la caméra est la couche, donc si vous avez trois couches avec des profondeurs -100, 0, 100, le Les calques dessinent 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: 
Il convient de noter que si vous pouvez assigner plus d'un calque à une seule profondeur, vous ne pouvez en aucun cas garantir que les calques de même profondeur seront dessinés dans un ordre donné et il est donc préférable d'affecter une seule couche à une profondeur donnée. Notez également que les profondeurs minimale et maximale de la couche sont de -16000 à 16000, et que tout ce qui ne fait pas partie de ces profondeurs ne sera pas rendu. Si vous avez besoin d'une profondeur en dehors de cette plage, vous devrez utiliser la fonction layer_force_draw_depth.