Macros

What are Macros

Macros are commands stored in a pool object.

The commands can be simple, very complex, and everything in between.

Macros can make programming faster and more convenient. Macros make it possible to do trivial or complex operations by a push of a button.

 

Macro Pool

Macros are stored in the Macro Pool but can be assigned to physical keys and view buttons. The macro pool is shared between all users in the show file. This means that if UserA stores a macro on pool object number 10, then it will also be available for UserB as macro number 10.

The Macro Pool could look like this:

Elements in a Macro

A macro consists of one or more rows.

Each row has information about a Command the row executes.

Each row has several fields that specify how the row is handled.

The Wait field can add a wait time before moving to the next row in the macro. This wait time is added after the command in the row is executed. It is relevant if there is more than one row in a macro. The first row will execute, it will wait the specified time and then execute the next row. There are two special wait commands. They are not a time value but a special value.

• Follow: This is the same as having a wait time of 0. The next row will be executed as soon as this row has executed the command.
• Go: This special value pauses the macro at this row. The macro is paused until it receives a new Go command.

The Enabled field indicates if the row is enabled. This is a Yes or No field. If it is Yes then it is executed when the macro row is triggered.

The AddToCmdline function makes it possible to append the command from the macro line to existing content in the command line. This is a Yes or No field. If it is Yes then it is appended to the command line.

Execute field defines if the macro row is automatically executed. Yes means that the row is executed (automatic please at the end of the row). No will put the command in the command line ready for user interaction.

Import Macro Library

There is a factory library of macros that can be imported using the import command.

Read more about importing in the Import Keyword topic.