ColdFusion makes it easy to convert images from one file format to another. Also, you can convert an image file to a binary object, BLOB data, or a Base64 string.
Converting an image file
The extension of the destination file determines the file format of the image. Therefore, to convert an image, simply change the filename extension in the destination file. The following example shows how to convert a JPEG file to a GIF file:
<cfimage source="../cfdocs/images/artgallery/jeff01.jpg" action="write" destination="jeff01.gif">
Similarly, you can use the ImageWrite function with the ImageNew function:
<cfset myImage=ImageNew("../cfdocs/images/artgallery/jeff01.jpg")> |
In both examples, the convert action is implied.
The write action does not create a ColdFusion image; it simply writes an image to a file. To convert an image and generate a ColdFusion image variable, use the convert action:
<cfimage source="../cfdocs/images/artgallery/jeff01.jpg" action="convert" |
ColdFusion reads and writes most standard image formats. For more information, see Supported image file formats in cfimage in the CFML Reference.
Converting an image to a Base64 string
To convert a ColdFusion image to a Base64 string, use the ImageWriteBase64 function. In the following example, the yes value determines that the output includes the headers required for display in HTML:
<!--- This example shows how convert a BMP file to a Base64 string. ---> |
Note: Microsoft Internet Explorer does not support Base64 strings. |
Inserting an image as a BLOB in a database
Many databases store images as BLOB data. To insert a ColdFusion image into a BLOB column of a database, use the ImageGetBlob function within a cfquery statement, as the following example shows:
<!--- This example shows how to add a ColdFusion image to a BLOB column of a database. ---> |
