The Link command is similar to the Call command except that Lightwing branches to a page in another script, instead of a page within the current script. Also, only a single branch target can be defined, instead of a list of pages. The Link command requires a script name (which may also include a path) followed by an optional page name. If the page name is omitted, the first page in the script will be the branch target. The referenced scripts should be in a scripts folder which can be the current scripts folder or a different folder specified by either an absolute or relative file path. Most of the same command options available for the Call command can also be used with the Link command, except for the index option.
Examples of Absolute and Relative Script File Paths
Script File Paths Path Types scripts/Default.lws Current Folder /home/root/lightwing/scripts/Default.lws Absolute demos/lightwing/scripts/Default.lws Relative
The Jump, Call, Chain and Link commands feature options to make branching conditional. Lightwing branches only if all of the defined conditions are true, otherwise execution continues with the next consecutive page in the current script.
Example of a Page that Links only on Mondays
page: FirstPage
link: MondayPage day: Monday
Day Option
Defines a specific day and/or time condition on which a branch will be taken. This can be a time which reoccurs every day, or a day that reoccurs every week, or a month that reoccurs every year, or a specific calendar date and/or time event that only occurs once. The maximum number of conditions is 8 per page.
Time Condition Examples
Examples Occurrences 12:00PM Every day at Noon. Monday Every Monday at Midnight. Tuesday 12:00PM Every Tuesday at Noon. Wednesday January 12:00PM Every Wednesday in January at Noon. 1/1/2015 First day of 2015 at Midnight.
Before Option
Defines a specific day and/or time condition before which a branch will be taken. This can be a time which reoccurs every day, or a day that reoccurs every week, or a month that reoccurs every year, or a specific calendar date and/or time event that only occurs once. The date and time syntax is the same as shown for the day option above.
After Option
Defines a specific day and/or time condition after which a branch will be taken. This can be a time which reoccurs every day, or a day that reoccurs every week, or a month that reoccurs every year, or a specific calendar date and/or time event that only occurs once. The date and time syntax is the same as shown for the day option above.
Portrait Option
Defines a display orientation condition that must be met for the branch to be taken. This parameter must be either on or off. The default is off, which means the display must have a landscape orientation for the branch to be taken. Otherwise, on means the display must have a portrait orientation for the branch to be taken.