Variables et Fonctions Diverses

Vous trouverez ici les variables et fonctions ayant traits aux erreurs.

error_occurred Indique qu'une erreur est apparue
error_last Chaîne de caractères contenant le message de la dernière erreur survenue
show_debug_message(str) Affiche la chaîne en mode déboguage (debug mode)

Les fonctions suivantes existent et vous permettent de vérifier si certaines variables existent; variables dont vous pourrez initialiser et lire le contenu. Dans toutes ces fonctions, le nom de la variable est passé en paramètre à l'aide d'une chaîne de caractères !

variable_global_exists(name) Retourne si une variable globale de nom name (une chaîne) existe.
variable_local_exists(name) Retourne si une variable locale de nom name (une chaîne) existe pour l'instance courante.
variable_global_get(name) Retourne la valeur de la variable globale de nom name (une chaîne).
variable_global_array_get(name, ind) Retourne la valeur de l'index ind de la variable globale tableau de nom name (une chaîne).
variable_global_array2_get(name, ind1, ind2) Retourne la valeur des index ind1,ind2 de la variable globale du tableau à 2 dimensions de nom name (une chaîne).
variable_local_get(name) Retourne la valeur de la variable locale de nom name (une chaîne).
variable_local_array_get(name, ind) Retourne la valeur de l'index ind de la variable locale du tableau de nom name (une chaîne).
variable_local_array2_get(name, ind1, ind2) Retourne la valeur des index ind1,ind2 de la variable locale du tableau à 2 dimensions de nom name (une chaîne).
variable_global_set(name, value) Affecte la valeur value à la variable globale de nom name (une chaîne).
variable_global_array_set(name, ind, value) Affecte la valeur value à l'index ind de la variable globale tableau de nom name (une chaîne).
variable_global_array2_set(name, ind1, ind2, value) Affecte la valeur value aux index ind1,ind2 de la variable globale tableau à 2 dimensions de nom name (une chaîne).
variable_local_set(name, value) Affecte la valeur value à la variable locale de nom name (une chaîne).
variable_local_array_set(name, ind, value) Affecte la valeur value à l'index ind de la variable locale du tableau de nom name (une chaîne).
variable_local_array2_set(name, ind1, ind2, value) Affecte la valeur value aux index ind1,ind2 de la variable locale du tableau à 2 dimensions de nom name (une chaîne).

Par exemple, vous pourrez écrire :

{
  if variable_global_exists('munition')
    global.munition += 1
  else
    global.munition = 0
}

Vous pouvez aussi utiliser ces fonctions pour passer des variables à un script par référence, en donnant le nom des variables sous forme de chaînes et en utilisant les fonctions pour modifier le contenu de ces variables.

Vous pouvez modifier la priorité d'exécution du programme à l'aide des fonctions suivantes :

set_program_priority(priority) Fixe la priorité du programme. Vous pouvez indiquer une valeur allant de -3 à +3. Une valeur de -3 signifie que le programme s'exécutera si aucun autre processus sur l'ordinateur ne demande du temps processeur, soit autrement dit, lorsque tous les autres processus sont à l'état prêt. Des valeurs de -2 et -1 sont en dessous de la normale, ainsi les autres processus auront la priorité. 0 est la valeur normale. +1 et +2 accordent une plus haute priorité au programme de jeu, permettant d'obtenir une plus grande vitesse d'exécution du jeu ainsi qu'un affichage plus coulé. Mais les autres processus bénéficieront de moins de temps processeur. +3 indique un mode en temps réel. Dans ce dernier mode, tout le temps processeur sera théoriquement attribué au jeu. Cela peut conduire à de sérieux problèmes en ce qui concerne les autres applications tournant actuellement sur l'ordinateur. Même les événements clavier ou souris (comme par exemple le clic sur le bouton de fermeture de la fenêtre), pourront ne plus être gérés correctement par Windows. Aussi, cette fonction sera à utiliser uniquement si vous souhaitez véritablement réserver tout le temps processeur pour le jeu. Il est conseillé d'utiliser cette fonction avec précaution et de sauvegarder le jeu avant de l'employer.

<< Traduction française par Philippe Ragni - (2005) >>