DAT Execute DAT

Summary

The DAT Execute DAT monitors another DAT's contents and runs a script when those contents change. The other DAT is usually a table.

Put the command echo $args in the script to show what values are passed to the script from the changing DAT.

You can specify how the script is triggered using the Monitor parameter:

• Table - If the table changes in any way since the last cook - this was the original "classic" behavior. Arguments passed to script are: script_fullpath fullpath_of_table
• Row - The script is called once for every row that changed (since its last cook). Arguments passed to script are: script_fullpath table_fullpath change_index total_changes row_number
• Column - The script is called once for every column that changed (since its last cook). Arguments passed to script are: script_fullpath table_fullpath change_index total_changes column_number
• Cell - The script is called for every cell that changed since the last cook. Arguments passed to script are: script_fullpath table_fullpath change_index total_changes row_number column_number new_value old_value

where script_fullpath is $arg0

Parameters

Execute From /executeloc - Determines the location the script is run from.

• Current Node /current - The script is executed from the current node location (for example, where the 'pc' command points to).
• This Node /here - The script is executed from the parent of the DAT. The DAT executes from the parent to make siblings of the DAT easy to access: DAT scripts used to execute from inside the DAT.
• Specified Component /comp - The script is executed from the component specified in the Component parameter below.

From Component /component - The component who's state change will trigger the DAT to execute its script when Execute is set to On Panel Change. This component is also the path that the script will be executed from if the Execute From parameter is set to Specified Component.

DAT /dat - The DAT which is monitored and will trigger the script to execute when its contents change.

Edit... button /edit - Clicking this opens a text editor to add/edit/delete text from the DAT.

Monitor /monitor - Specify what part of the DAT to monitor

• Cell - If the table changes in any way since the last cook.
• Row - The script is called once for every row that changed (since its last cook).
• Column - The script is called once for every column that changed (since its last cook).
• Table - The script is called for every cell that changed since the last cook.

Execute on End Frame /execute - When this flag is set, the DAT script will execute at most one time per frame, at the end of the frame, even if it triggered several times in one frame. If, for example, Monitor is set to Row, a row may change several times in a frame, but it will be called only once for each row. By default, with Monitor set to Row, the script will be called 4 times if a row has changed 4 times during a frame (like for Multi Touch In DAT events).