Pinnacle Speakers DEKO500 User Manual

Page 120

Advertising
background image

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

A 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

A 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

A 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]

Advertising