Skip to content
Sparfell edited this page Mar 7, 2018 · 9 revisions

gdc_lib est un addon crée par les membres de la communauté "Grèce de Canards" qui a pour objectif de fournir divers outils pour les créateurs de missions.


Pour l'instant gdc_lib contient quelques fonctions qui sont documentées dans les autres rubriques du wiki.
Pour chaque fonction vous trouverez :

  • Une présentation générale
  • Le header de la fonction (texte explicatif qui se trouve dans le fichier de script)
  • Une notice d'utilisation avec des exemples

Utiliser une fonction

Les fonctions peuvent être exécutées grâce aux commandes call ou spawn.
Exemple : [] call GDC_fnc_exemple;
Les fonctions peuvent être exécutées à différents endroit et de différentes façons ,consultez la documentation de chaque fonction pour savoir de quelle manière il est préférable de les utiliser.

L'effet de certaines fonctions peut être modifié au moyen de paramètres définis entre crochets [] avant l'appel de la fonction. Chaque paramètre est séparé par une virgule.
Exemple : [paramètre1,paramètre2,paramètre3] call GDC_fnc_exemple;

Le nombre et le type des paramètres dépendent de la fonction utilisée, consultez la documentation de chaque fonction pour connaître ses paramètres.

Paramètres optionnels

Certains paramètres peuvent être optionnels, dans ce cas, il n'est utile de les renseigner que si vous souhaitez les modifier. En effet, si un paramètre optionnel n'est pas renseigné, la valeur par défaut est utilisée.
Les paramètres obligatoires sont toujours définis en premiers et les paramètres optionnels sont toujours définis en derniers.

Attention, si les paramètres 2 et 3 sont optionnels et que vous souhaitez modifier uniquement le paramètre 3, vous devez tout de même renseigner le paramètre 2 afin que l'ordre des paramètres entre les crochets soit conservé.

Exemple :
Si tous les paramètres sont optionnels et que je ne veux modifier que le paramètre 3, j'écris :
[paramètre1,paramètre2,paramètre3] call GDC_fnc_exemple;
Idem mais cette fois je ne veux modifier que le paramètre 2 :
[paramètre1,paramètre2] call GDC_fnc_exemple;
Idem mais cette fois je souhaite utiliser les valeurs par défaut pour tous les paramètres :
[] call GDC_fnc_exemple;

(A ce sujet voyez aussi les exemples dans les rubriques dédiées à chaque fonction)

Types de paramètres

Dans arma, les paramètres peuvent être de différents types :
https://community.bistudio.com/wiki/Data_Types
https://community.bistudio.com/wiki/typeName

Voici les types de paramètres que vous rencontrerez le plus souvent dans les fonctions de gdc_lib :

  • un BOOL (booléen) est une variable qui ne peut avoir que deux états, true ou false (ex: ma_variable = false;)
  • un OBJECT est le nom assigné à un objet dans une mission.
  • un STRING est une séquence de caractères contenue dans des guillemets (ex: "ceci est un string" ou "this_is_not_a_slip"). En général, les classname et les noms de marqueurs sont contenus dans des STRING.
  • un ARRAY est un tableau contenant plusieurs éléments contenus dans des crochets [] et séparés entre eux par des virgules (ex: [element1,element2,element3]). Les paramètres d'une fonction sont donc contenus dans un ARRAY. les différents éléments d'un ARRAY peuvent être de tous types (ex: [bidule,"truc",4,["chouette","machin",[0,0,0]],false]). En général, les positions sont des ARRAY en [x,y,z].
You can’t perform that action at this time.