instance_nearest


La description

Cette fonction va vérifier toutes les instances de l'objet donné pour voir lequel est le plus proche du point d'origine donné. Si aucune instance de l'objet n'existe, la fonction renverra le mot clé noone, mais s'il existe des instances, elle renverra le id de l'instance trouvée. Veuillez noter que si l'instance exécutant le code a été créée en tant qu'instance de l'objet en cours de vérification, elle sera incluse dans la vérification.


Syntaxe:

instance_nearest(x, y, obj);


Arguments:

Argument La description
x La position x à vérifier.
y La position y à vérifier.
obj L'objet à vérifier pour les instances de.


Résultats:

Real (either an instance ID value or the keyword noone)


Exemple:

var inst, xx;
xx = x;
x -= 10000;
inst = instance_nearest(xx, y, object_index);
if inst != id
   {
   draw_line(x, y, inst.x, inst.y);
   }
x += 10000;

Le code ci-dessus déplace l'instance actuelle de 10000 pixels puis vérifie sa position précédente pour trouver l'instance la plus proche du même type d'objet. Si cette instance est elle-même, elle ne fera rien d'autre que de revenir à sa position d'origine, mais si l'instance trouvée est différente, elle tracera une ligne entre les deux.