24.2 Comment Macros

You can use comment macros to automate tasks on the console such as:

Comment macros can be configured to run at these times:

Comment Macros are text commands that you type or place into a macro cell; the syntax used is the same in each case:

Controlling Masters

Comment Macro

Syntax

Example

Notes

Go Master

GM[master]/[cue]

GM1/3

Use ‘*’ for the current chosen master. If you omit the cue number, the next cue will Go.

Go Master

GM[range]

GM2>7

Go next cue on a range of masters.

Halt Master

HM[master or range]

HM1,3:HM2>7

 

Assert Master

AM[master or range]

AM1:AM2>7

 

Release Master

RM[master or range]

RM1:RM2>7

 

Release All

RA

RA

Equivalent to Pig + Release.

Release Others

RO

RO

Releases all masters except the one with the macro.

Fade Master

FM[master]/[level]

FM2/50

Fades Master 2 to 50%

Fade Grand Master

FGM[level]

FGM10

Fades the Grand Master to 10%

Choose Master

CM[master]

CM1

 

Controlling Cuelists

Comment Macro

Syntax

Example

Notes

Go Cuelist

GL[list]/[cue]

GL1.5, GL2/5

If you omit the cue number, the next cue will Go.

Halt Cuelist

HL[list]

HL1,6

 

Assert Cuelist

AL[list]

AL10

 

Release Cuelist

RL[list]

RL4,7,9

 

Controlling Batches

Comment Macro

Syntax

Example

Notes

Go Batch

GB[batch]

GB12

 

Halt Batch

HB[batch]

HB1

 

Assert Batch

AB[batch]

AB10

 

Release Batch

RB[batch]

RB4

 

Controlling Scenes

Comment Macro

Syntax

Example

Notes

Go Scene

GS[scene]

GS12

 

Halt Scene

HS[scene]

HS4

 

Assert Scene

AS[scene]

AS1

 

Release Scene

RS[scene]

RS6,20

 

Controlling Pages and Views

Comment Macro

Syntax

Example

Notes

Change Page

CP[page]

CP3

 

Next Page

CP+

CP+

Goes to the next page in the Page Directory, skipping the template page and blank pages.

Previous Page

CP-

CP-

Goes to the previous page in the Page Directory, skipping the template page and blank pages.

Recall View

RV[view]

RV2

 

Controlling Timecode

Comment Macro

Syntax

Example

Notes

Enable Timecode

ET[cuelist]

ET2

Enables timecode for the selected cuelist.

Disable Timecode

DT[cuelist]

DT2

 

Open Timecode Toolbar

OT[node type][node number]

OTh1

When DP8000 is specified as the node type then an index number is also required; example: OTd1/1

Sending MIDI strings

Comment Macro

Syntax

Example

MIDI String

MS[node type][node number]/[MIDI message]

MSh1/90 47 3F

Midi strings can be used to send System Exclusive Midi Messages or Midi Note Messages but must be written using hex values (see Decimal to Hex Conversion Chart).

Listed below is a break down of how a midi string comment macro would be formatted for sending a midi note:

MSh1 - indicates midi string will be sent from Hog Console with net number 1

[ forward slash ]

9 - indicates note on (8 indicates note off)

0 - midi channel number (0 in hex = 0 in decimal)

[ SPACE ]

47 - midi note number (47 in hex = 71 in decimal)

[ SPACE ]

3F - velocity (3F in hex = 63 in decimal)

A simpler method for sending midi notes via comment macros is explained in the "sending midi notes" section below.

Sending MIDI Notes

Comment Macro

Syntax

Example

MIDI Note

MN[reference to entry]

MNGoLaser

In order to utilize midi note comment macros the user must first create entries in the "Midi Notes" window which can be openned by holding the Open key on the front panel and selecting the "Midi Notes" button on the open toolbar. Once a midi note message entry has been created in the Midi Note Window it will appear in the comment macro drop down menu for cues, scenes, and pages. If the details of a midi note entry are changed in the midi note window then any cues and scenes, or pages referencing that entry will also be updated.

Controlling Network Devices

Comment Macro

Syntax

Example

Notes

Reset Node

[node type][net number]

RNH3

Resets the selected network device, such as a DMX Processor. For the device type, use the following letter codes: H for WholeHog, D for DMX Processor .

Controlling Keystroke Macros

Macro

Syntax

Example

Notes

GK

GK [macro number]

GK2

Runs Macro 2

HK

HK [macro number]

HK2

Pauses Macro 2

RK

RK [macro number]

RK2

Stops Macro 2

[Tip]Tip

You can display and select from a list of available macro commands on the console by selecting the Macro cell and pressing the Set key.

24.2.1 Entering Comment Macro Commands

To enter a comment macro command into a macro cell:

  1. Select the macro cell, and press Set.

  2. Select a command from the drop down menu.

  3. Enter the specific information for the macro, such as the master number.

  4. Press Enter to finish or select another macro and repeat. If you add a further macro command, the ‘:’ will be entered automatically.

Alternatively:

  1. Select the macro cell, and press Set.

  2. Enter the macro command manually using the keyboard.

  3. Press Enter to finish.

Note that if you enter an invalid command, then the cell will revert to being empty when you press Enter.

24.2.2 Additional Comment Macro Syntax

For some comment macro commands such as fading masters you can specify the execution timing of the macro by adding a "t" followed by a numerical value in seconds:

  • FM10/1t10

Also within a comment macro command, you can specify multiple targets separated with commas:

  • RS6,20

or a range with a right angle-bracket:

  • HM2>7

You can have multiple comment macros executed by one cue by separating them with colons:

  • HM1,3:HM2>7

You can also send commands to a specified network device, using H (Hog) to refer to a console, D to refer to a DMX Processor, and IOP to refer to an MIDI/Timecode Processor. For example:

  • GM1H2 : will Go master 1 on console number 2.

  • RND3 : will reset DMX Processor number 3.