imageGetIPTCTag

Description

Retrieves the value of the IPTC tag for a ColdFusion image.

Categories

Related

History

ColdFusion 8: Added this function.

Syntax

ImageGetIPTCTag(name, tagName)

Attributes

AttributeDescriptionRequiredDefault
nameRequired. The ColdFusion image on which this operation is performed.
tagNameRequired. The IPTC tag name whose value is returned.

Returns

The value of the IPTC tag.

Usage

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

Example

<!--- This example shows how to retrieve the caption for a JPEG file. ---> 
<!--- Create a ColdFusion image from a JPEG file. ---> 
<cfimage source="../cfdocs/images/artgallery/paul05.jpg" name="myImage" action="read"> 
<!--- Retrieve the camera make used to take the original picture. ---> 
<cfset cameraMake=ImageGetIPTCTag(myImage,"make")> 
<cfdump var="#cameraMake#>"