imageWrite

Writes a ColdFusion image to the specified filename or destination.

imageWrite(name [, destination] [, quality] [, overwrite]) → returns void

Member Function Syntax

someImage.write([destination] [, quality] [, overwrite])

Argument Reference for the imageWrite function

name

Required: Yes
The image on which this operation is performed.

destination

Required: No
The path to write the file.

If you create the image with the ImageNew function or another operation where you do not specify the filename, specify the destination parameter. The file format is derived from the extension of the filename. The default value for this parameter is the filename of the original image source.

quality

Required: No
Defines the JPEG quality used to encode the image. This parameter applies only to destination files with an extension of JPG or JPEG. Valid values are fractions that range from 0 through 1 (the lower the number, the lower the quality). The default value is 0.75.

overwrite

Required: No
Default: YES
If set to true, overwrites the destination file Values:
  • NO
  • YES

Examples sample code invoking the imageWrite function


Using write member function

CF 11+ save an image with a new name

imgObj = imageRead("http://cfdocs.org/apple-touch-icon.png");
imgObj.write('newName.png');

Fork me on GitHub