The csImageFile component can be used to read and write EXIF data that is stored in JPEG and TIFF images. This data is usually written at the time that the image is created, usually by the camera or scanner. Most of the EXIF attributes should not be edited because they are related to the camera settings or conditions at the time of creating the image, but some attributes, such as the description and copyright information, can be edited separately. The code fragments on this page form an extension to the csImageFile instructions.
csImageFile does not store a separate property for each EXIF attribute. Instead it uses a single method for setting all the attributes, which must be called with the attribute name as one parameter and the new value in string form as the other parameter. The following code fragment shows how to set four EXIF attributes. It assumes that the csImageFile object has been created with a name Image and a JPG or TIFF image has been loaded.
Image.ExifSetAttribute("ImageDescription", "The description of the image.");
Image.ExifSetAttribute("Artist", "The author of the image.");
Image.ExifSetAttribute("Copyright", "A copyright notice");
The first parameter of ExifSetAttribute is the name of the EXIF tag which must be a recognised tag name, although it is not case sensitive. The second parameter is the new value, and this must be a string even if the attribute that is stored is not a string. To set the DateTime attribute the current date/time is passed to the ExifDateToString method where it is converted from a date/time used by Cold Fusion to the correct format of string for an EXIF attribute.
The ExifSetAttribute method has a Boolean return value which is true when the value was set correctly but false if it was not set. The method does not return an error. If the tag name is not recognised or if the data is in an incorrect format, the return value will be false.
<cfoutput>#Image.ExifSetAttribute("ImageDescription", "A new description")#</cfoutput>
Note that the ExifSetAttribute parameters are enclosed in brackets when the return value is used.
We do not provide a list of the available EXIF attributes, as there are over 100 different attributes. The following tags are the ones that are most likely to be edited. The first are all strings.
ImageDescription - Image title
Software - Software used
Artist - Person who created the image
Copyright - Copyright holder
The next are date/time values.
DateTime - File change date and time
DateTimeOriginal - Date and time of the original data generation
DateTimeDigitized - Date and time of digital data generation
© Chestysoft, 2015.