instance_create_layer


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 sur la couche spécifiée. La couche peut être identifiée à l'aide de la valeur d'ID de couche (retournée par la fonction layer_create() ) ou par le nom de la couche (sous forme de chaîne, par exemple "instance_layer") tel que défini dans l'éditeur de pièce. 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.

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.


Syntaxe:

instance_create_layer(x, y, layer_id, obj);


Arguments:

Argument La description
x La position x de l'objet sera créée à
y La position y l'objet sera créé à
layer_id L'ID de couche (ou nom) à attribuer à 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_layer(x, y, "instance_layer", 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.