Pinnacle Speakers DEKO500 User Manual

Page of 199
Macro Programming Language
118
Deko500 User’s Guide
Integer
An integer parameter specifies a whole number value, either positive or negative,
e.g., 3, 12967, -14, 0, etc.
If you specify a real value for an integer parameter, Deko500 ignores the fractional
component.
An example of an integer parameter is the 
number
 parameter of the
select_style_preset
 command, which sets the current style from the list of
preset styles:
select_style_preset [number=]
Switch
switch parameter specifies a parameter that is either true or false. A true parameter
is either preceded by a hyphen (
-
) or followed by 
=1
, while a false parameter is either
preceded by 
-no
 or followed by 
=0
.
The following illustrates examples of the 
all
 switch parameter of the 
tab_clear
command:
tab_clear -all
or
tab_clear all=1
tab_clear -noall
or
tab_clear all=0
String
string parameter specifies one or more alphanumeric characters (e.g., a letter, word
or sentence).
A string that contains spaces or non-alphanumeric characters must be enclosed in
quotation marks.
A typical string parameter is the 
name
 parameter of the 
file_open
 command,
which opens the file specified by 
name
:
file_open name=
For example, to open the file named “my file”, the value of the parameter would be
the string, “my file”:
file_open “my file”
Choice
choice parameter specifies one item from a list of possible choices.
Both parameters of the 
justify
 command are choice parameters:
justify [horizontal=] [vertical=]
Possible choices for 
horizontal
 are: 
left
right
center
full
spread
,
off
 and 
unchanged;
 and for 
vertical
top
bottom
center
full
,
baseline
off
 and 
unchanged
.
Object
An object parameter specifies an object, a collection of values that is treated as a
single item. Typical objects in Deko500 include colors, shaders, ellipses, rectangles,
boxes, fonts and looks.
The 
letter
 command, which adds a letter to a text field, includes two object
parameters, 
font
 and 
look
:
letter [character=] [font=] [look=] [tx=]\
[ty=] [code=] [insert=] [-show] [-attach]