Retour au sommaire Edition des fonctions "PlugITs"

Les paramètres de liens

Certains PlugITs vous permettrons d'éditer des valeurs, comme les coordonnées d'un objet.
Pour cela, il vous faudra éditer les liens crées entre vos évènements et vos actions.

Comme vous avez pu le voir dans la rubrique précédente, double-cliquez sur le cercle présent sur le lien. Un panneau s'affiche, énumérant les différents liens présents.

Il vous faut à présent sélectionner dans la liste le lien adapté à votre action.

La zone de texte du bas, grisée à l'origine, est maintenant accessible.
Il vous suffit d'y entrer la valeur de votre choix, sous la forme adaptée.
Un texte s'écrira tout simplement, il n'est pas nécessaire de lui mettre des guillemets (Voir visuel ci-dessus).

Des coordonnées s'écriront sous la forme X Y Z , soit les valeurs de chaque axe, séparées par un espace.

Le lien peut également être édité de manière dynamique via un autre PlugIT; il suffit pour cela d'utiliser un PlugIT qui aura comme évènement une valeur (par exemple une coordonnée) et de faire directement le lien vers l'action du PlugIT. Ainsi les valeurs seront dynamiques.

Récupérer et utiliser une variable dynamique dans un lien

Le caractère "$" vous permet de récupérer et d'utiliser un variable dynamique directement dans les liens.
Par exemple : Ici nous récupérons les coordonées x, y et z de la souris sur un clic gauche par rapport à sa position sur un plan dans la scène (voir image ci-dessous).

"$1" correspond au premier paramètre que me renvoi la souris, ici respectivement à la coordonnée en x de la souris. "$2" et "$3" pour les coordonnées y et Z.

Utiliser une variable globale dans un lien

Les variables globales (déclarées avec le plugIT "global var") peuvent aussi être appelée dans n'importe quel lien en insérant leur nom entre deux % (exemple : %MyVar%).

Il existe plusieurs variable globales prédéfinie fournissant plusieurs informations utiles :
- Time : l'heure locale au format "hh:mm:ss"
- TimeGmt : l'heure à GMT+0 au format "hh:mm:ss"
- Date : la date au format "aaaa-mm-jj"
- DateTime : la date et l'heure locale au format "aaaa-mm-jj hh:mm:ss"
- DateTimeGmt : la date et l'heure à GMT+0 au format "aaaa-mm-jj hh:mm:ss"
- TimeStamps : le nombre de secondes écoulée depuis le 1er Janvier 1970 à 00:00:00 UTC
- DateString : l'heure et date locale complète formattée. Exemple : Wed Jul 25 15:31:01 2018
- Language : langage utilisé par l'application
- Random : un nombre généré aléatoirement différent à chaque appel

Avancé : La balise [code][/code]

La balise [code][/code] permet d'insérer des fragments de code Scol dans les paramètres de lien.
Toutes les fonctions Scol sont disponibles, et il est bien sûr possible d'utiliser les variables dynamiques et globales citées ci-dessus dans le code.
Attention : les paramètres de lien étant de type String, il est obligatoire que votre code retourne également une String. Pour la même raison, afin de pouvoir utiliser des paramètres de type Int ou Float, il est nécessaire de d'abord les reconvertir en ce type avec la fonction atoi ou atof. Si votre code ne fonctionne pas, pensez à vérifier la présence de potentiels messages d'erreur dans la console de l'éditeur