Description

Retrieves the Exchangeable Image File Format (EXIF) headers in an image as a CFML structure.

Returns

A structure with the EXIF header values.

Category

Image functions

Function syntax

ImageGetEXIFMetadata(name)

See also

cfimage, ImageGetEXIFTag, ImageGetBlob, ImageGetBufferedImage, ImageGetHeight, ImageGetIPTCTag, ImageGetWidth, ImageInfo, IsImage, IsImageFile

History

ColdFusion 8: Added this function.

Parameters

Usage

The EXIF is a standard for storing interchange information in image files, especially those using JPEG compression. Most digital cameras use the EXIF format.

EXIF metadata includes information pertaining to the creation of the image, such as the creation date, the software used to create the image, the aperture, the make and model, and the resolution of the image.

The result of the ImageGetEXIFMetadata function is cached in the ColdFusion image to optimize performance.

The ImageGetEXIFMetadata function applies only to JPEG images. If you try to retrieve metadata for Base64, BLOB, or other types of images, ColdFusion generates errors.

Example

<!--- This example shows how to retrieve the EXIF header information from a
JPEG file. --->
<!--- Create a ColdFusion image from an existing JPEG file. --->
<cfimage source="images\paul05.jpg" name="myImage">
<!--- Retrieve the metadata associated with the image. --->
<cfset data =ImageGetEXIFMetadata(myImage)>
<!--- Display the ColdFusion image parameters. --->
<cfdump var="#myImage#">
<!--- Display the EXIF header information associated with the image
(creation date, software, and so on). --->
<cfdump var="#data#">