Misc

setnode command

setnode command will set GPRM11 with the node of the object. This is to satisfy Abstraction Layer if you are cutting out the execution of AL by having a Break command or simply make sure the GPRM11 is set to the current node (for example prior using a link to other objects)

PRE "Menu 1"

 if (GPRM2==GPRM4) then

 linkto "VMG Menu 1"

 endif

 setnode        

 Break

END

A Break command will exit the current VM command section on that object. Any object has Abstraction Layer commands inserted after the "A" Custom Commands section. The Abstraction Layer section set the GPRM11 for each object with unique number we call Node to keep track of few functions, most notably the redirection from Movie to a VTS Menu. By cutting the script using Break command the GPRM11 will not be modified with the actual Node and as a consequence some functions (minor) may not work properly.

You may also use the GPRM11 in your own code - since it is unique for each object PRE and POST commands, you can always tell where the link comes from and so  modify the behaviour.

For example by comparing the GPRM11 on a menu you can tell which movie viewer just watched and if he interrupted it (the GPRM11 will be even number) or watched it till the end (GPRM11 will be odd number).

BUTTON command

The BUTTON command is a supplemental command to change the VM command of a button. The command can be only one line.

Syntax:

BUTTON "Button label" vm_command

This will replace VM command of the button with specified label on cell 1 of the menu. If more than one buttons have that same label, only the first one will be replaced.

Note: This is a supplemental command. Setting buttons in script is prone to user errors as there is no feedback. It is better to set buttons from within interface. to make sure we are setting the correct object.