AiS EXIF Info examples and documentation

This ActiveX for Windows 95/98/ME/NT/2000/XP/2003/Vista/Windows 7 helps you to read, change and write EXIF, IPTC and GPS fields in your digital images and photos.

The component is useful for programmers, which need to read or change EXIF/IPTC/GPS information in programs on C++, C#, VB, Delphi, any .NET Projects or in web services by use script languages like PHP, ASP, Python or any other, that supports COM objects.

AiS EXIF Installation

To use this ASP component move the DLL into a subdirectory (like \winnt\system32 for NT or \windows\system for Win95). To register the component on the system change to the directory where you installed the DLL and type:

regsvr32 AiSEXIF.dll

AiSExif.Component ASP example

filename = "c:\Program Files\Watermarker\AiS EXIF ActiveX\images\clock.JPG"
    	
set obj = CreateObject("AiSExif.ExifControl")

ss = obj.Version 
Response.Write ( "Version:" & ss & "<br>" & filename  & "<hr>")
   
Call obj.ReadExifInfo(filename)
	
'read one EXIF fiels
ss = obj.GetParam("ImageType")
Response.Write("ImageType:" & ss)

'Set User Param
call obj.SetParam("User.url", "http://www.watermarker.com")

'ParseText
ss = obj.ParseText("I take the image by %Model% on %DateTime%. My site is <a href=""%url%"">%url%</a>." )
Response.Write("<br>Parsed text: " & ss)

'read all fields
ss = obj.GetAllExifData()
Response.Write("<hr><pre>" & ss & "</pre></hr>")
ss = obj.Error
Response.Write("Error: " & ss & "<br>")

obj = nothing

AiSExif.Component (aisexif.aspx) ASPX Example

Try	
	dim filename as string = "c:\Program Files\Watermarker\AiS EXIF ActiveX\images\clock.JPG"
	dim ss as string

	dim obj = Server.CreateObject("AiSExif.ExifControl")
	ss = obj.Version 
	Response.Write ( "Version:" & ss & "<br>" & filename  & "<hr>")
	Call obj.ReadExifInfo(filename)

	'read one EXIF fiels
	ss = obj.GetParam("ImageType")
	Response.Write("ImageType:" & ss)

	'Set User Param
	call obj.SetParam("User.url", "http://www.watermarker.com")

	'ParseText
	ss = obj.ParseText("I take the image by %Model% on %DateTime%. My site is <a href=""%url%"">%url%</a>." )
	Response.Write("<br>Parsed text: " & ss)

	'read all fields
	ss = obj.GetAllExifData()
	Response.Write("<hr><pre>" & ss & "</pre></hr>")
	ss = obj.Error
	Response.Write("Error: " & ss & "<br>")

	obj = nothing

Catch E As Exception
	Response.Write("Error: " & e.message)
End Try

AiSExif.Component (aisexif.php) PHP Example

$filename = 'c:\Program Files\Watermarker\AiS EXIF ActiveX\images\clock.JPG';

$obj = new COM("AiSExif.ExifControl");

echo 'Version: ' . $obj->Version.'<br>' . $filename . '<hr>';

if (file_exists($filename)) {
	$obj->ReadExifInfo($filename);
	
	//read one Exif field
	echo 'ImageType: ', $obj->GetParam('ImageType');

	//set user param
	$obj->SetParam("User.url", "http://www.watermarker.com");

	//parse text
	echo '<br>Parsed Text:', $obj->ParseText('I take the image by %Model% on %DateTime%. My site is <a href="%url%">%url%</a>.');

	//read all Exif info
	echo  '<hr><pre>', $obj->GetAllExifData(), '</pre><hr>';
	echo 'Error: ', $obj->Error, '<br>';
} else {
	echo $filename . ' not found.';
}

AiSExif.Component (aisexif.py) Python example

##
## Example of usage AiSExif.Component
## Copyright © Watermarker.com 2007
##
## need to ActivePython: http://www.activestate.com/products/activepython/
##

import string
import win32com.client

    
def callAiSExif(filename):
        exif=win32com.client.Dispatch('AiSExif.ExifControl')
        exif.ReadExifInfo(filename)
        print filename
        # read one Exif fields
        print 'Model:', exif.GetParam('Model')
        #set user param
        exif.SetParam("User.url", "http://www.watermarker.com")
        #ParseText
        print exif.ParseText("I take the image by %Model% on %DateTime%. My site is <a href=""%url%"">%url%</a>." )
        #read all Exif info
        print exif.GetAllExifData()
                
callAiSExif('c:\Program Files\Watermarker\AiS EXIF ActiveX\images\clock.JPG')

AiS EXIF Component Properties

Property	Type	Description
Error	string	description of error.
Version	string	return current version of the component.

AiS EXIF Component Methods

Method	Parameters	Result	Description
ReadExifInfo	FileName	boolean	Read EXIF, IPTC, GPC information from image file. This method must be called before call GetParam.
GetParam	Name	string	Get EXIF parameter with name NAME.
SetParam	Name, Value	string	Set Value of parameter with name NAME . You can add your custom useful macros or change value of existing EXIF parameters (use prefix 'User.' before name of user's parameters). The changed parameters will not be saved in the image file. Exampe SetParam('Make', 'Canon1')
ParseText	Text	string	return parsed string. Example: text= wm.ParseText("Copyright %c% 2000-%year% Watermarker.com") result of the text will be "Copyright © 2000-2003 Watermarker.com" see list of all macros
WriteExifInfo	filename	none	Write changed Exif tags to filename. Example: exif.WriteExifInfo("c:\my.jpg") see list of all macros

Macros for EXIF, IPTC and GPS parameters

You can use the following fields for adding parameters in the Metadata.
Note! Not all of the following fields must be present in your images.

EXIF fields

EXIF Field Name	Description
Image.ProcessingSoftware
Image.NewSubfileType
Image.ImageWidth
Image.ImageLength
Image.BitsPerSample
Image.Compression
Image.PhotometricInterpretation
Image.FillOrder
Image.DocumentName
Image.ImageDescription
Image.Make
Image.Model
Image.StripOffsets
Image.Orientation
Image.SamplesPerPixel
Image.RowsPerStrip
Image.StripByteCounts
Image.XResolution
Image.YResolution
Image.PlanarConfiguration
Image.ResolutionUnit
Image.TransferFunction
Image.Software
Image.DateTime
Image.Artist
Image.WhitePoint
Image.PrimaryChromaticities
Image.SubIFDs
Image.TransferRange
Image.JPEGProc
Image.JPEGInterchangeFormat
Image.JPEGInterchangeFormatLength
Image.YCbCrCoefficients
Image.YCbCrSubSampling
Image.YCbCrPositioning
Image.ReferenceBlackWhite
Image.XMLPacket
Image.Rating
Image.RatingPercent
Image.CFARepeatPatternDim
Image.CFAPattern
Image.BatteryLevel
Image.IPTCNAA
Image.Copyright
Image.ImageResources
Image.ExifTag
Image.InterColorProfile
Image.GPSTag
Image.TIFFEPStandardID
Image.XPTitle
Image.XPComment
Image.XPAuthor
Image.XPKeywords
Image.XPSubject
Photo.ExposureTime
Photo.FNumber
Photo.ExposureProgram
Photo.SpectralSensitivity
Photo.ISOSpeedRatings
Photo.OECF
Photo.ExifVersion
Photo.DateTimeOriginal
Photo.DateTimeDigitized
Photo.ComponentsConfiguration
Photo.CompressedBitsPerPixel
Photo.ShutterSpeedValue
Photo.ApertureValue
Photo.BrightnessValue
Photo.ExposureBiasValue
Photo.MaxApertureValue
Photo.SubjectDistance
Photo.MeteringMode
Photo.LightSource
Photo.Flash
Photo.FocalLength
Photo.SubjectArea
Photo.MakerNote
Photo.UserComment
Photo.SubSecTime
Photo.SubSecTimeOriginal
Photo.SubSecTimeDigitized
Photo.FlashpixVersion
Photo.ColorSpace
Photo.PixelXDimension
Photo.PixelYDimension
Photo.RelatedSoundFile
Photo.InteroperabilityTag
Photo.FlashEnergy
Photo.SpatialFrequencyResponse
Photo.FocalPlaneXResolution
Photo.FocalPlaneYResolution
Photo.FocalPlaneResolutionUnit
Photo.SubjectLocation
Photo.ExposureIndex
Photo.SensingMethod
Photo.FileSource
Photo.SceneType
Photo.CFAPattern
Photo.CustomRendered
Photo.ExposureMode
Photo.WhiteBalance
Photo.DigitalZoomRatio
Photo.FocalLengthIn35mmFilm
Photo.SceneCaptureType
Photo.GainControl
Photo.Contrast
Photo.Saturation
Photo.Sharpness
Photo.DeviceSettingDescription
Photo.SubjectDistanceRange
Photo.ImageUniqueID
Iop.InteroperabilityIndex
Iop.InteroperabilityVersion
Iop.RelatedImageFileFormat
Iop.RelatedImageWidth
Iop.RelatedImageLength

IPTC fields

Key	Description
Envelope.ModelVersion
Envelope.Destination
Envelope.FileFormat
Envelope.FileVersion
Envelope.ServiceId
Envelope.EnvelopeNumber
Envelope.ProductId
Envelope.EnvelopePriority
Envelope.DateSent
Envelope.TimeSent
Envelope.CharacterSet
Envelope.UNO
Envelope.ARMId
Envelope.ARMVersion
Application2.RecordVersion
Application2.ObjectType
Application2.ObjectAttribute
Application2.ObjectName
Application2.EditStatus
Application2.EditorialUpdate
Application2.Urgency
Application2.Subject
Application2.Category
Application2.SuppCategory
Application2.FixtureId
Application2.Keywords
Application2.LocationCode
Application2.LocationName
Application2.ReleaseDate
Application2.ReleaseTime
Application2.ExpirationDate
Application2.ExpirationTime
Application2.SpecialInstructions
Application2.ActionAdvised
Application2.ReferenceService
Application2.ReferenceDate
Application2.ReferenceNumber
Application2.DateCreated
Application2.TimeCreated
Application2.DigitizationDate
Application2.DigitizationTime
Application2.Program
Application2.ProgramVersion
Application2.ObjectCycle
Application2.Byline
Application2.BylineTitle
Application2.City
Application2.SubLocation
Application2.ProvinceState
Application2.CountryCode
Application2.CountryName
Application2.TransmissionReference
Application2.Headline
Application2.Credit
Application2.Source
Application2.Copyright
Application2.Contact
Application2.Caption
Application2.Writer
Application2.RasterizedCaption
Application2.ImageType
Application2.ImageOrientation
Application2.Language
Application2.AudioType
Application2.AudioRate
Application2.AudioResolution
Application2.AudioDuration
Application2.AudioOutcue
Application2.PreviewFormat
Application2.PreviewVersion
Application2.Preview

GPS fields

GPS Macros Name	Description
GPSInfo.GPSVersionID
GPSInfo.GPSLatitudeRef
GPSInfo.GPSLatitude
GPSInfo.GPSLongitudeRef
GPSInfo.GPSLongitude
GPSInfo.GPSAltitudeRef
GPSInfo.GPSAltitude
GPSInfo.GPSTimeStamp
GPSInfo.GPSSatellites
GPSInfo.GPSStatus
GPSInfo.GPSMeasureMode
GPSInfo.GPSDOP
GPSInfo.GPSSpeedRef
GPSInfo.GPSSpeed
GPSInfo.GPSTrackRef
GPSInfo.GPSTrack
GPSInfo.GPSImgDirectionRef
GPSInfo.GPSImgDirection
GPSInfo.GPSMapDatum
GPSInfo.GPSDestLatitudeRef
GPSInfo.GPSDestLatitude
GPSInfo.GPSDestLongitudeRef
GPSInfo.GPSDestLongitude
GPSInfo.GPSDestBearingRef
GPSInfo.GPSDestBearing
GPSInfo.GPSDestDistanceRef
GPSInfo.GPSDestDistance
GPSInfo.GPSProcessingMethod
GPSInfo.GPSAreaInformation
GPSInfo.GPSDateStamp
GPSInfo.GPSDifferential

Navigation