Comment Macros are simple, short-hand, system level commands that can be executed when show is launched, a page is loaded, or a cue or scene is played. Please refer to tables below for a comprehensive list of comment macro commands.
| 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][timing]
| FM2/50t2 | Fades master 2 to 50% in 2 seconds. To fade in 0s omit the timing portion of the macro. |
| Fade Grand Master | FGM[level][timing]
| FGM10t3 | Fades the grand master to 10% in 3 seconds. To fade the grand master in 0s omit the timing portion of the macro. |
| 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, Playback Bars, 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
| |
| Dock Playback Bar |
DPB#
|
DPB2 | Docks the specified playback bar to its docking assignment. |
| 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][net num]/[index num] |
OTd1/1
| DP8000 node type: d
Console node type: |
| Enabling / Disabling Clock Triggers | |||
|---|---|---|---|
| Comment Macro | Syntax | Example | Notes |
| Enable Clock |
EC[cuelist] |
EC2 | Enables clock triggers for Cuelist 2 |
| Disable Clock |
DC[cuelist] |
DC2 | Disables clock triggers for Cuelist 2 |
| 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 opened 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. | ||
| Enable and Disable MIDI Note and Controller Message Input/Output | ||
|---|---|---|
| Comment Macro | Syntax | Example |
| Enable Notes In |
ENI[node type][net number]/[index]
|
ENIh1/1
|
| Disable Notes In |
DNI[node type][net number]/[index]
|
DNIh1/1
|
| Enable Notes Out |
ENO[node type][net number]/[index]
|
ENOh1/1
|
| Disable Notes Out |
DNO[node type][net number]/[index]
|
DNOh1/1
|
| Controlling Network Devices | |||
|---|---|---|---|
| Comment Macro | Syntax | Example | Notes |
| Reset Node |
[node type][net number]
|
RNH3
| Resets the selected network device. For the device type, use the following letter codes: H for Wholehog, D for 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]](../images/tip.png) | 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. |
To enter a comment macro command into a macro cell:
Select the macro cell, and press Set.
Select a command from the drop down menu.
Enter the specific information for the macro, such as the master number.
Press Enter to finish or select another macro and repeat. If you add a further macro command, the ‘:’ will be entered automatically.
Alternatively:
Select the macro cell, and press Set.
Enter the macro command manually using the keyboard.
Press Enter to finish.
Note that if you enter an invalid command, then the cell will revert to being empty when you press Enter.
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.