Macro file editing rules, Macro file syntax syntax of event and continue, Statements – Sony GP-X1EM Grip Extension User Manual
Page 543: File name, Macro file syntax, Syntax of event and continue statements
543
Macro File Editing Rules
When editing a macro file, observe the following rules.
Macro File Syntax
The macro file syntax is as follows.
File format
The file is in CSV (comma-separated value) format.
Newline code
CR (ASCII code 0D), LF (ASCII code 0A), or CRLF may
be used.
Statement syntax
There are four types of statement, each terminated by a
newline code.
File header:
This must always appear as the first line of
the file. It comprises 28 characters, as follows.
Example: PNL (space) 0001PNL_rrrr.PMRnnnnnnnn
rrrr: Macro register number (0001 to 0999)
nnnnnnnn: In a file created on the switcher, this is a
register name automatically set by the switcher.
When creating a new file, it is recommended to set this
to be the same as the file name
.
The name is limited to eight characters.
The following characters may not be used.
space, \, /, :, ;, , (comma), . (period), <, >, *, ?, ", |
Comment:
Begins with “#”. The content of the line
following the “#” up to the next newline has no effect
on macro execution, and can be used as a comment.
Comments can be used on the local drive or a
removable drive only. When you load a macro file into
a register, the comments are discarded.
Event statement:
Begins with “Event?”, and defines the
macro event content
Continue statement:
Begins with “Continue?”, and
defines the macro event content
Some events cannot be used
Syntax of Event and Continue
Statements
An event can be written with an Event statement only, or
with an Event statement followed by any number of
Continue statements. Event statements and Continue
statements have the following syntax.
Word separator character
Use “,” (comma).
Ignored
Spaces and tabs are ignored. There is no distinction
between lowercase and uppercase. If two or more
separator characters appear consecutively, later ones are
ignored. Separator characters at the beginning of a line are
also ignored.
Content of line
Must begin with “Event?” or “Continue?”, followed by
symbols and parameters.
Event?,[symbol],[parameter],[parameter],…
Continue?,[symbol],[parameter],[parameter],…
symbol:
Type of event (ASCII character string)
parameter:
Shows details of an event. Consists of
parameter names and arguments, and these must
appear in pairs. The number and type of parameters
depends on the event
If the same parameter appears two or more times, the
rightmost occurrence is valid.
How to use Continue statements
When a single parameter has more than one argument, use
a Continue statement.
This section describes a snapshot event as an example.
An event to recall a snapshot in region M/E-1 is written as:
Event?,Snapshot,Region?,ME1,Register?,1,
Attribute?,Off,Time?,Current
In the Event statement, only one region can be specified.
To specify both regions M/E-1 and DME1, use a Continue
statement, thus:
Event?,Snapshot,Region?,ME1,Register?,1,
Attribute?,Off,Time?,Current
Continue?,Snapshot,Region?,DME1,Register?,1,
Attribute?,Off,Time?,Current
To specify more than one argument for a region parameter,
follow the Event statement by a Continue statement on the
next line.
File Name
Set the file name as follows.
Example: nnnnnnnn.PNL_rrrr.PMR
nnnnnnnn: In a file created on the switcher, this is a
register name automatically set by the switcher.
The name for a new file is limited to eight characters.
The following characters may not be used.
space, \, /, :, ;, , (comma), . (period), <, >, *, ?, ", |
rrrr: macro register number (0001 to 0999)
Note