Pinnacle Systems FXDEKO, User Manual

Page: 154 / 239

154 Working with Macros
FXDeko User’s Guide
An object parameter specifies an object, a collection of values that is treated as
a single item. Typical objects in FXDeko 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]
The
font
parameter specifies an object created by the
font
command, and the
look
parameter specifies an object created by the
look
command.
You create an object with a command. For example, the
rgb
command creates a
color object:
rgb red= green= blue=
The elements of an object correspond exactly with the of the command that
created it. The parameters of the
rgb
command represent the amounts of red,
blue and green that make up the color.
You can assign an object to a variable:
$gold = rgb 100 100 0
You can specify an object parameter with an embedded command, using
parentheses:
ramp top_left=(rgb 60 60 0)
Accessing Object Elements
To access an element to edit its value or to assign it to a variable for use
elsewhere, use the element operator.
To edit
$gold
to re-specify the amount of green:
$gold:green = 80
To assign the green element of
$gold
to the variable
$grn
:
$grn = $gold:green
List
A list parameter , also known as a repeating parameter , specifies a list of one or
more values. Depending on the command, the values on the list may or may not
be of the same type. A command can have no more than one list parameter,
which is usually the last parameter.
The message command has a list parameter that specifies a list of
strings to output on the Status Bar:
message list=
message " Enter " " file " " name " " of " $song