instance_create_depth


La description

Avec cette fonction, vous pouvez créer une nouvelle instance de l'objet spécifié à n'importe quel point de la pièce et à la profondeur spécifiée. La profondeur peut être n'importe quelle valeur, où plus la profondeur est proche de la caméra, plus la profondeur est élevée et plus la profondeur est éloignée, donc une instance à profondeur -200 sera dessinée sur une instance à profondeur +300 ( par exemple). Notez que cette fonction créera réellement un calque de pièce pour l'instance, puisque toutes les instances doivent être sur un calque dans la pièce, mais puisqu'il s'agit d'un calque géré (pas un que vous avez créé par le code ou dans la pièce, mais celui que GameMaker Studio 2 a créé automatiquement) vous ne pouvez pas y accéder, et le layer La variable d'instance renverra -1.

IMPORTANT! Il existe une profondeur de couche minimum et maximum de -16000 à 16000. Tout ce qui est placé sur un calque en dehors de cette plage ne sera pas dessiné bien que tous les événements continueront à fonctionner normalement.

Cette fonction renvoie le id de la nouvelle instance qui peut ensuite être stockée dans une variable ou utilisée pour accéder à cette instance. Notez que cette fonction appelle également l'événement de création de l'instance en cours de création avant de poursuivre le ou les actions de l'événement qui a appelé la fonction.


Syntaxe:

instance_create_depth(x, y, depth, obj);


Arguments:

Argument La description
x La position x de l'objet sera créée à
y La position y l'objet sera créé à
depth La profondeur à affecter à l'instance créée
obj L'index d'objet de l'objet pour créer une instance de


Résultats:

Real (instance ID value)


Exemple:

var inst;
inst = instance_create_depth(x, y, -10000, obj_Bullet);
with (inst)
   {
   speed = other.shoot_speed;
   direction = other.image_angle;
   }

Le code ci-dessus crée une nouvelle instance de l'objet "obj_Bullet" et stocke l'identifiant de l'instance dans une variable. Cette variable est ensuite utilisée pour affecter speed et direction à la nouvelle instance.