253
EXTENDING FIREWORKS
Objects within Fireworks documents
Las
t
up
d
a
ted
12/8/2009
ExportFrameInfo object
The following table lists the properties of the ExportFrameInfo object, along with their data type and, where
appropriate, acceptable values and notes.
ExportOptions object
Note:
When this object is used to set properties, the only required property is exportFormat. If other properties are not
specified, their default values are used.
Use the following information to understand the rules for determining scaling in this object:
•
If
useScale
is set to
true
(the default),
percentScale
is used to uniformly scale the object on export, and
applyScale
is ignored.
•
If
useScale
is set to
false
and
applyScale
is set to
false
(the default), no scaling is performed on the object
when it is exported.
•
If
useScale
is set to
false
and
applyScale
is set to
true
, then
xSize
and
ySize
determine scaling as follows:
– If the value is positive, specifies the exact size for the axis.
– If the value is zero, specifies that the axis varies without limit.
– If the value is negative, specifies that the axis varies but can be no larger than “
abs(value)
“
•
If one value is positive and one is negative, the positive value is always used. This gives the following possibilities:
–
xSize < 0, ySize < 0
– use
min(xSize, ySize)
scaling
mode
string
Acceptable values are
"mask to image"
and
"mask to
path"
.
owner
object
The element (image, path, text, and so on) that owns the mask.
showAttrs
Boolean
If set to
true
, and
mode
is
"mask to path"
, the mask
element’s fill and stroke (if any) are drawn. If set to
false
, the
mask element’s fill and stroke are ignored.
Property
Data type
Notes
delayTime
integer
For GIF animations, the delay time between frames, in 1/100ths
of a second. For example, if you set
delayTime
to
200
, two
seconds elapse before the next frame in the animation
appears. Default value is
7
.
frameHidden
Boolean
If set to
false
(the default), the frame is exported. If set to
true
, the frame is hidden and not exported.
frameName
string
The name of the frame displayed in the Frames panel. Default
is
null
.
gifDisposalMethod
string
GIF89a frame disposal method. See the GIF89a specification for
details. Acceptable values are
"unspecified"
(the default),
"none"
,
"background",
and
"previous"
.
Property
Data type
Notes