MACROMEDIA DREAMWEAVER MX 2004, Reference

Page: 73 / 486

The Flash Objects API 73
SWFFile.createFile()
Description
This function generates a new Flash Object file with the specified template and array of
parameters. It also creates a GIF, PNG, JPEG, and MOV version of the title if filenames for those
formats are specified.
If you want to specify an optional parameter that follows optional parameters that you do not
want to include, you need to specify empty strings for the unused parameters. For example, if you
want to specify a PNG file, but not a GIF file, you need to specify an empty string before
specifying the PNG filename.
Arguments
templateFile
,
templateParams
,
swfFileName
,
{gifFileName}
,
{pngFileName}
,
{jpgFileName}
,
{movFileName}
,
{generatorParams}
•
The
templateFile
argument is a path to a template file, which is expressed as a file:// URL.
This file can be a SWT file.
•
The
templateParams
argument is an array of name/value pairs where the names are the
parameters in the SWT file, and the values are what you want to specify for those parameters.
For Dreamweaver to recognize a SWF file as a Flash object, the first parameter must be
"dwType"
. Its value should be a string that represents the name of the object type, such as
"Flash Text"
.
•
The
swfFileName
argument, which is expressed as a file:// URL, is the output filename of an
SWF file or an empty string to ignore.
•
The
gifFileName
argument, which is expressed as a file:// URL, is the output filename of a
GIF file. This argument is optional.
•
The
pngFileName
argument, which is expressed as a file:// URL, is the output filename of a
PNG file. This argument is optional.
•
The
jpgFileName
argument, which is expressed as a file:// URL, is the output filename of a
JPEG file. This argument is optional.
•
The
movFileName
argument, which is expressed as a file:// URL, is the output filename of a
QuickTime file. This argument is optional.
•
The
generatorParams
argument is an array of strings that represents optional Generator
command line flags. This argument is optional. Each flag’s data items must follow it in the
array. Some commonly used flags are listed in the following table:
Option Flag Data Description Example
-defaultsize
Width, height Sets the output image size to the
specified width and height
"-defaultsize",
"640", "480"
-exactFit
None Stretches the contents in the output
image to fit exactly into the specified
output size
"-exactFit"
000_DW_API_Print.book Page 73 Wednesday, August 20, 2003 9:14 AM