Adobe 38040334 API Reference - Page 48

DREAMWEAVER CS3 43 API Reference 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 -defaultsize Data Width, height -exactFit None Description Example Sets the output image size to the specified "-defaultsize", width and height "640", "480" Stretches the contents in the output image "-exactFit" to fit exactly into the specified output size Returns A string that contains one of the following values: • "noError" means the call completed successfully. • "invalidTemplateFile" means the specified template file is invalid or not found. • "invalidOutputFile" means at least one of the specified output filenames is invalid. • "invalidData" means that one or more of the templateParams name/value pairs is invalid.