Reads the on-disk or in-memory source pathname or URL and creates a ColdFusion image.

Image Functions

cfimage imageNew imageReadBase64 imageWrite isImageFile

ColdFusion 8: Added this function.

ImageRead(path)

A ColdFusion image.

The ImageRead function performs the same operation as the cfimageread action. However, you cannot use the cfimage tag to read and create a ColdFusion image variable in the cfscript tag. Use the ImageRead function within the cfscript tag to read ColdFusion images.
The following example reads the image file aiden01.jpg into a variable called myImage and displays the image in the browser:
<cfset myImage=ImageRead("../cfdocs/images/artgallery/aiden01.jpg")> <cfimage action="writeToBrowser" source="#myImage#"> For a list of valid image formats, see the supported image file formats listed in cfimage. To retrieve a list of readable formats on the server where the ColdFusion application is deployed, use the GetReadableImageFormats function.

<!--- This example shows how to create a script that reads an image from a URL. ---> 
<cfscript> 
    myImage=ImageRead("http://www.google.com/images/logo.gif"); 
    ImageWrite(myImage,"google-logo.gif"); 
</cfscript> 
This image has been downloaded by ColdFusion:</p> 
<img src="google-logo.gif"> 
This is the original image:</p> 
<img src="http://www.google.com/images/logo.gif"/>