Back to the "PlugITs" functions edition content page

Link parameters

Some PlugIts allow to edit values, like an object coordinates.
To do this, it is necessary to edit the created link between the events and the actions.

Double-click on the link.

Select the concerned link in the displayed list.

Enter a value (like x y z coordinate values).

The link can also dynamically be edited with an other PlugIT; For example, use a PlugIT which will have a value as an event (like coordinates). Thereby values will be dynamics.

Get and use a dynamic variable in a link.

The "$" character allows to get and to use a dynamic variable directly in the links.
For example : Here we get the x y coordinates of the mouse with a left click to its position in the scene (see image below).

"$1" is the first parameter sent by the mouse (so the X value) and "$2" for the Y coordinates.

Use a global variable in a link

Global variables (declared with the "global var" plugIT) can also be called in any link by inserting its name between two % (example : %MyVar%).

Several predefined global variables exist, providing several useful informations :
- Time : the local time with the format "hh:mm:ss"
- TimeGmt : the time at GMT+0 with the format "hh:mm:ss"
- Date : the date with the format "yyyy-mm-dd"
- DateTime : the date and local time with the format "yyyy-mm-dd hh:mm:ss"
- DateTimeGmt : the date and time at GMT+0 with the format "yyyy-mm-dd hh:mm:ss"
- TimeStamps : the number of seconds elapdes since the 1st January 1970 at 00:00:00 UTC
- DateString : the local time and date fully formatted. Example : Wed Jul 25 15:31:01 2018
- Language : language used by the application
- Random : a randomly generated number changing each time it is called

Advanced : the [code][/code] tag

The [code][/code] tag allows to insert snippets of Scol code in the link parameters.
All of the Scol fonctions are available, and it is of course possible to use the dynamic and global variables mentionned above in the code.
Warning : the link parameters being of type String, it is obligatory that your code returns a String. For the same reason, the parameters of type Int or Float must be reconverted into this type before use, with the function atoi or atof. If your code does not work, check for any potential error message in the editor console.