TExifWriterUtility Class Reference

#include <exifutility.h>

Link against: exifutility.lib

class TExifWriterUtility
Public Member Functions
TExifWriterUtility(MExifMetadataWriter *)
IMPORT_C TIntSetColorSpace(TInt)
IMPORT_C TIntSetComponentsConfiguration(HBufC8 *)
IMPORT_C TIntSetCopyright(HBufC8 *)
IMPORT_C TIntSetDateTime(HBufC8 *)
IMPORT_C TIntSetDateTimeDigitized(HBufC8 *)
IMPORT_C TIntSetDateTimeOriginal(HBufC8 *)
IMPORT_C TIntSetExifVersion(HBufC8 *)
IMPORT_C TIntSetFlash(TUint16)
IMPORT_C TIntSetFlashPixVersion(HBufC8 *)
IMPORT_C TIntSetFocalLength(TInt, TInt)
IMPORT_C TIntSetGpsAltitude(TInt, TInt)
IMPORT_C TIntSetGpsAltitudeRef(TUint8)
IMPORT_C TIntSetGpsAreaInformation(HBufC8 *)
IMPORT_C TIntSetGpsDateStamp(HBufC8 *)
IMPORT_C TIntSetGpsDestBearing(TInt, TInt)
IMPORT_C TIntSetGpsDestBearingRef(HBufC8 *)
IMPORT_C TIntSetGpsDestDistance(TInt, TInt)
IMPORT_C TIntSetGpsDestDistanceRef(HBufC8 *)
IMPORT_C TIntSetGpsDestLatitude(TInt, TInt, TInt, TInt, TInt, TInt)
IMPORT_C TIntSetGpsDestLatitudeRef(HBufC8 *)
IMPORT_C TIntSetGpsDestLongitude(TInt, TInt, TInt, TInt, TInt, TInt)
IMPORT_C TIntSetGpsDestLongitudeRef(HBufC8 *)
IMPORT_C TIntSetGpsDifferential(TUint16)
IMPORT_C TIntSetGpsDop(TInt, TInt)
IMPORT_C TIntSetGpsImgDirection(TInt, TInt)
IMPORT_C TIntSetGpsImgDirectionRef(HBufC8 *)
IMPORT_C TIntSetGpsLatitude(TInt, TInt, TInt, TInt, TInt, TInt)
IMPORT_C TIntSetGpsLatitudeRef(HBufC8 *)
IMPORT_C TIntSetGpsLongitude(TInt, TInt, TInt, TInt, TInt, TInt)
IMPORT_C TIntSetGpsLongitudeRef(HBufC8 *)
IMPORT_C TIntSetGpsMapDatum(HBufC8 *)
IMPORT_C TIntSetGpsMeasureMode(HBufC8 *)
IMPORT_C TIntSetGpsProcessingMethod(HBufC8 *)
IMPORT_C TIntSetGpsSatellites(HBufC8 *)
IMPORT_C TIntSetGpsSpeed(TInt, TInt)
IMPORT_C TIntSetGpsSpeedRef(HBufC8 *)
IMPORT_C TIntSetGpsStatus(HBufC8 *)
IMPORT_C TIntSetGpsTimeStamp(TInt, TInt, TInt, TInt, TInt, TInt)
IMPORT_C TIntSetGpsTrack(TInt, TInt)
IMPORT_C TIntSetGpsTrackRef(HBufC8 *)
IMPORT_C TIntSetGpsVersionId(HBufC8 *)
IMPORT_C TIntSetImageDescription(HBufC8 *)
IMPORT_C TIntSetInteroperabilityIndex(HBufC8 *)
IMPORT_C TIntSetInteroperabilityVersion(HBufC8 *)
IMPORT_C TIntSetMake(HBufC8 *)
IMPORT_C TIntSetMakerNote(HBufC8 *)
IMPORT_C TIntSetModel(HBufC8 *)
IMPORT_C TIntSetOrientation(TInt)
IMPORT_C TIntSetPixelXDimension(TInt)
IMPORT_C TIntSetPixelYDimension(TInt)
IMPORT_C TIntSetResolutionUnit(TInt)
IMPORT_C TIntSetShutterSpeedValue(TInt, TInt)
IMPORT_C TIntSetThumbCompression(TInt)
IMPORT_C TIntSetThumbOrientation(TInt)
IMPORT_C TIntSetThumbResolutionUnit(TInt)
IMPORT_C TIntSetThumbXResolution(TInt, TInt)
IMPORT_C TIntSetThumbYResolution(TInt, TInt)
IMPORT_C TIntSetUserComment(HBufC8 *)
IMPORT_C TIntSetXResolution(TInt, TInt)
IMPORT_C TIntSetYCbCrPositioning(TInt)
IMPORT_C TIntSetYResolution(TInt, TInt)

Detailed Description

This class offers a friendly interface to write the metadata in exif encoded image files

Note: Unless otherwise stated in a method's documentation, it should be assumed that TInt arguments are representing unsigned quantities, even though TInt is a signed type. So unless otherwise stated, these parameters should be given unsigned values only.

Constructor & Destructor Documentation

TExifWriterUtility ( MExifMetadataWriter * )

IMPORT_CTExifWriterUtility(MExifMetadataWriter *aExifMetadata)

Constructor

instantiates the exif writer utility. Note: no method on this utility should be used after the metadate has been destroyed

Parameters
aExifMetadatathe metadata class on which to read the tags

Member Function Documentation

SetColorSpace ( TInt )

IMPORT_C TIntSetColorSpace(TIntaColorSpace)

Sets the colorSpace tag value of the metadata.

Note: aColorSpace may only take unsigned short (16-bit) values.

Parameters
aColorSpacethe colorSpace value
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found.

SetComponentsConfiguration ( HBufC8 * )

IMPORT_C TIntSetComponentsConfiguration(HBufC8 *aComponentsConfig)

Sets the componentsConfiguration tag value of the metadata.

Parameters
aComponentsConfigthe componentsConfiguration value
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found.

SetCopyright ( HBufC8 * )

IMPORT_C TIntSetCopyright(HBufC8 *aCopyright)

Sets the copyright tag value of the metadata.

Parameters
aCopyrightthe copyright value.
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata.

SetDateTime ( HBufC8 * )

IMPORT_C TIntSetDateTime(HBufC8 *aDateTime)

Sets the dateTime tag value of the metadata.

Parameters
aDateTimethe dateTime value
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found.

SetDateTimeDigitized ( HBufC8 * )

IMPORT_C TIntSetDateTimeDigitized(HBufC8 *aDateTime)

Sets the dateTimeDigitized tag value of the metadata.

Parameters
aDateTimethe dateTimeDigitized value
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found.

SetDateTimeOriginal ( HBufC8 * )

IMPORT_C TIntSetDateTimeOriginal(HBufC8 *aDateTime)

Sets the dateTimeOriginal tag value of the metadata.

Parameters
aDateTimethe dateTimeOriginal value
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found.

SetExifVersion ( HBufC8 * )

IMPORT_C TIntSetExifVersion(HBufC8 *aExifVersion)

Sets the exifVersion tag value of the metadata.

Parameters
aExifVersionthe exifVersion value
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found.

SetFlash ( TUint16 )

IMPORT_C TIntSetFlash(TUint16aFlash)

Sets the flash tag value of the metadata.

Parameters
aFlashthe flash value.
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata.

SetFlashPixVersion ( HBufC8 * )

IMPORT_C TIntSetFlashPixVersion(HBufC8 *aFlashPixVer)

Sets the flashpixVersion tag value of the metadata.

Parameters
aFlashPixVerthe flashpixVersion value
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found.

SetFocalLength ( TInt, TInt )

IMPORT_C TIntSetFocalLength(TIntaNumerator,
TIntaDenominator
)

Sets the focal length tag value of the metadata.

Parameters
aNumeratorthe focal length numerator value
aDenominatorthe focal length denominator value
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata.

SetGpsAltitude ( TInt, TInt )

IMPORT_C TIntSetGpsAltitude(TIntaNumerator,
TIntaDenominator
)

Sets the gps altitude tag value of the metadata.

Parameters
aNumeratorthe altitude numerator value.
aDenominatorthe altitude denominator value.
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata.

SetGpsAltitudeRef ( TUint8 )

IMPORT_C TIntSetGpsAltitudeRef(TUint8aGpsAltitudeRef)

Sets the gps altitude reference tag value of the metadata.

Parameters
aGpsAltitudeRefthe altitude reference value.
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata. KErrNoMemory if there was not enough memory available to complete the request.

SetGpsAreaInformation ( HBufC8 * )

IMPORT_C TIntSetGpsAreaInformation(HBufC8 *aGpsAreaInformation)

Sets the name of gps area tag value of the metadata.

Note: According to the Exif 2.2 specification, the first 8 bytes of aGpsAreaInformation must contain a Character Code to indicate the type of encoding used. See table 6 of the Exif 2.2 specification for a list of codes.

Parameters
aGpsAreaInformationthe name of gps area value.
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata.

SetGpsDateStamp ( HBufC8 * )

IMPORT_C TIntSetGpsDateStamp(HBufC8 *aDateStamp)

Sets the gps date tag value of the metadata.

Parameters
aDateStampthe gps date value.
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata.

SetGpsDestBearing ( TInt, TInt )

IMPORT_C TIntSetGpsDestBearing(TIntaNumerator,
TIntaDenominator
)

Sets the gps bearing of destination tag value of the metadata.

Parameters
aNumeratorthe bearing of destination numerator value
aDenominatorthe bearing of destination denominator value
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata.

SetGpsDestBearingRef ( HBufC8 * )

IMPORT_C TIntSetGpsDestBearingRef(HBufC8 *aGpsDestBearingRef)

Sets the gps reference for bearing of destination tag value of the metadata.

Parameters
aGpsDestBearingRefthe reference for bearing of destination value.
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata.

SetGpsDestDistance ( TInt, TInt )

IMPORT_C TIntSetGpsDestDistance(TIntaNumerator,
TIntaDenominator
)

Sets the gps distance to destination tag value of the metadata.

Parameters
aNumeratorthe distance to destination numerator value.
aDenominatorthe distance to destination denominator value.
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata.

SetGpsDestDistanceRef ( HBufC8 * )

IMPORT_C TIntSetGpsDestDistanceRef(HBufC8 *aGpsDestDistanceRef)

Sets the gps reference for distance to destination tag value of the metadata.

Parameters
aGpsDestDistanceRefthe reference for distance to destination value.
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata.

SetGpsDestLatitude ( TInt, TInt, TInt, TInt, TInt, TInt )

IMPORT_C TIntSetGpsDestLatitude(TIntaDegNumerator,
TIntaDegDenominator,
TIntaMinNumerator,
TIntaMinDenominator,
TIntaSecNumerator,
TIntaSecDenominator
)

Sets the gps latitude of destination tag value of the metadata.

Parameters
aDegNumeratoron return, the degrees latitude of destination numerator value
aDegDenominatoron return, the degrees latitude of destination denominator value
aMinNumeratoron return, the minutes latitude of destination numerator value
aMinDenominatoron return, the minutes latitude of destination denominator value
aSecNumeratoron return, the seconds latitude of destination numerator value
aSecDenominatoron return, the seconds latitude of destination denominator value
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata.

SetGpsDestLatitudeRef ( HBufC8 * )

IMPORT_C TIntSetGpsDestLatitudeRef(HBufC8 *aGpsDestLatitudeRef)

Sets the gps reference for latitude of destination tag value of the metadata.

Parameters
aGpsDestLatitudeRefthe reference for latitude of destination value.
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata.

SetGpsDestLongitude ( TInt, TInt, TInt, TInt, TInt, TInt )

IMPORT_C TIntSetGpsDestLongitude(TIntaDegNumerator,
TIntaDegDenominator,
TIntaMinNumerator,
TIntaMinDenominator,
TIntaSecNumerator,
TIntaSecDenominator
)

Sets the gps longitude of destination tag value of the metadata.

Parameters
aDegNumeratoron return, the degrees longitude of destination numerator value
aDegDenominatoron return, the degrees longitude of destination denominator value
aMinNumeratoron return, the minutes longitude of destination numerator value
aMinDenominatoron return, the minutes longitude of destination denominator value
aSecNumeratoron return, the seconds longitude of destination numerator value
aSecDenominatoron return, the seconds longitude of destination denominator value
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata.

SetGpsDestLongitudeRef ( HBufC8 * )

IMPORT_C TIntSetGpsDestLongitudeRef(HBufC8 *aGpsDestLongitudeRef)

Sets the gps reference for longitude of destination tag value of the metadata.

Parameters
aGpsDestLongitudeRefthe reference for longitude of destination value.
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata.

SetGpsDifferential ( TUint16 )

IMPORT_C TIntSetGpsDifferential(TUint16aGpsDifferential)

Sets the gps differential correction tag value of the metadata.

Parameters
aGpsDifferentialthe gps differential correction value.
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata.

SetGpsDop ( TInt, TInt )

IMPORT_C TIntSetGpsDop(TIntaNumerator,
TIntaDenominator
)

Sets the gps measurement precision tag value of the metadata.

Parameters
aNumeratorthe measurement precision numerator value.
aDenominatorthe measurement precision denominator value.
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata.

SetGpsImgDirection ( TInt, TInt )

IMPORT_C TIntSetGpsImgDirection(TIntaNumerator,
TIntaDenominator
)

Sets the direction of image tag value of the metadata.

Parameters
aNumeratorthe direction of image numerator value.
aDenominatorthe direction of image denominator value.
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata.

SetGpsImgDirectionRef ( HBufC8 * )

IMPORT_C TIntSetGpsImgDirectionRef(HBufC8 *aGpsImgDirectionRef)

Sets the gps reference for direction of image tag value of the metadata.

Parameters
aGpsImgDirectionRefthe gps reference for direction of image value.
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata.

SetGpsLatitude ( TInt, TInt, TInt, TInt, TInt, TInt )

IMPORT_C TIntSetGpsLatitude(TIntaDegNumerator,
TIntaDegDenominator,
TIntaMinNumerator,
TIntaMinDenominator,
TIntaSecNumerator,
TIntaSecDenominator
)

Sets the gps latitude tag value of the metadata.

Parameters
aDegNumeratorthe degrees latitude numerator value.
aDegDenominatorthe degrees latitude denominator value.
aMinNumeratorthe minutes latitude numerator value.
aMinDenominatorthe minutes latitude denominator value.
aSecNumeratorthe seconds latitude numerator value.
aSecDenominatorthe seconds latitude denominator value.
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata. KErrNoMemory if there was not enough memory available to complete the request.

SetGpsLatitudeRef ( HBufC8 * )

IMPORT_C TIntSetGpsLatitudeRef(HBufC8 *aGpsLatitudeRef)

Sets the gps north or south latitude tag value of the metadata.

Parameters
aGpsLatitudeRefthe gps north or south latitude value.
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata.

SetGpsLongitude ( TInt, TInt, TInt, TInt, TInt, TInt )

IMPORT_C TIntSetGpsLongitude(TIntaDegNumerator,
TIntaDegDenominator,
TIntaMinNumerator,
TIntaMinDenominator,
TIntaSecNumerator,
TIntaSecDenominator
)

Sets the gps longitude tag value of the metadata.

Parameters
aDegNumeratorthe degrees longitude numerator value.
aDegDenominatorthe degrees longitude denominator value.
aMinNumeratorthe minutes longitude numerator value.
aMinDenominatorthe minutes longitude denominator value.
aSecNumeratorthe seconds longitude numerator value.
aSecDenominatorthe seconds longitude denominator value.
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata. KErrNoMemory if there was not enough memory available to complete the request.

SetGpsLongitudeRef ( HBufC8 * )

IMPORT_C TIntSetGpsLongitudeRef(HBufC8 *aGpsLongitudeRef)

Sets the east or west longitude tag value of the metadata.

Parameters
aGpsLongitudeRefthe east or west longitude value.
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata.

SetGpsMapDatum ( HBufC8 * )

IMPORT_C TIntSetGpsMapDatum(HBufC8 *aGpsMapDatum)

Sets the gps geodetic survey data used tag value of the metadata.

Parameters
aGpsMapDatumthe geodetic survey data used value.
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata.

SetGpsMeasureMode ( HBufC8 * )

IMPORT_C TIntSetGpsMeasureMode(HBufC8 *aGpsMeasureMode)

Sets the gps measurement mode tag value of the metadata.

Parameters
aGpsMeasureModethe gps measurement mode value.
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata.

SetGpsProcessingMethod ( HBufC8 * )

IMPORT_C TIntSetGpsProcessingMethod(HBufC8 *aGpsProcessingMethod)

Sets the name of gps processing method tag value of the metadata.

Note: According to the Exif 2.2 specification, the first 8 bytes of aGpsProcessingMethod must contain a Character Code to indicate the type of encoding used. See table 6 of the Exif 2.2 specification for a list of codes.

Parameters
aGpsProcessingMethodthe name of gps processing method value.
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata.

SetGpsSatellites ( HBufC8 * )

IMPORT_C TIntSetGpsSatellites(HBufC8 *aGpsSatellites)

Sets the gps satellites used for measurement tag value of the metadata.

Parameters
aGpsSatellitesthe gps satellites used for measurement value.
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata.

SetGpsSpeed ( TInt, TInt )

IMPORT_C TIntSetGpsSpeed(TIntaNumerator,
TIntaDenominator
)

Sets the speed of gps receiver tag value of the metadata.

Parameters
aNumeratorthe speed of gps receiver numerator value.
aDenominatorthe speed of gps receiver denominator value.
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata.

SetGpsSpeedRef ( HBufC8 * )

IMPORT_C TIntSetGpsSpeedRef(HBufC8 *aGpsSpeedRef)

Sets the gps speed unit tag value of the metadata.

Parameters
aGpsSpeedRefthe speed unit value.
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata.

SetGpsStatus ( HBufC8 * )

IMPORT_C TIntSetGpsStatus(HBufC8 *aGpsStatus)

Sets the gps receiver status tag value of the metadata.

Parameters
aGpsStatusthe gps receiver status value.
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata.

SetGpsTimeStamp ( TInt, TInt, TInt, TInt, TInt, TInt )

IMPORT_C TIntSetGpsTimeStamp(TIntaHourNumerator,
TIntaHourDenominator,
TIntaMinNumerator,
TIntaMinDenominator,
TIntaSecNumerator,
TIntaSecDenominator
)

Sets the gps time tag value of the metadata.

Parameters
aHourNumeratorthe hour numerator value.
aHourDenominatorthe hour denominator value.
aMinNumeratorthe minutes numerator value.
aMinDenominatorthe minutes denominator value.
aSecNumeratorthe seconds numerator value.
aSecDenominatorthe seconds denominator value.
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata.

SetGpsTrack ( TInt, TInt )

IMPORT_C TIntSetGpsTrack(TIntaNumerator,
TIntaDenominator
)

Sets the direction of movement tag value of the metadata.

Parameters
aNumeratorthe direction of movement numerator value.
aDenominatorthe direction of movement denominator value.
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata.

SetGpsTrackRef ( HBufC8 * )

IMPORT_C TIntSetGpsTrackRef(HBufC8 *aGpsTrackRef)

Sets the gps reference for direction of movement tag value of the metadata.

Parameters
aGpsTrackRefthe gps reference for direction of movement value.
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata.

SetGpsVersionId ( HBufC8 * )

IMPORT_C TIntSetGpsVersionId(HBufC8 *aGpsVersionId)

Sets the gps version id tag value of the metadata.

Parameters
aGpsVersionIdthe gps version id value.
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata.

SetImageDescription ( HBufC8 * )

IMPORT_C TIntSetImageDescription(HBufC8 *aImageDescription)

Sets the image description tag value of the metadata.

Parameters
aImageDescriptionthe image description value.
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata.

SetInteroperabilityIndex ( HBufC8 * )

IMPORT_C TIntSetInteroperabilityIndex(HBufC8 *aIdx)

Sets the interoperabilityindex tag value of the metadata.

Parameters
aIdxthe interoperabilityIndex value
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found.

SetInteroperabilityVersion ( HBufC8 * )

IMPORT_C TIntSetInteroperabilityVersion(HBufC8 *aIdx)

Sets the interoperabilityVersion tag value of the metadata.

Parameters
aIdxthe interoperabilityVersion value
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found.

SetMake ( HBufC8 * )

IMPORT_C TIntSetMake(HBufC8 *aMake)

Sets the make tag value of the metadata.

Parameters
aMakethe make value
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found.

SetMakerNote ( HBufC8 * )

IMPORT_C TIntSetMakerNote(HBufC8 *aMakerNote)

Sets the maker note tag value of the metadata.

Parameters
aMakerNotethe maker note value.
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata.

SetModel ( HBufC8 * )

IMPORT_C TIntSetModel(HBufC8 *aModel)

Sets the model tag value of the metadata.

Parameters
aModelthe model value
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found.

SetOrientation ( TInt )

IMPORT_C TIntSetOrientation(TIntaOrientation)

Sets the main image orientation tag value of the metadata.

Note: aOrientation may only take unsigned short (16-bit) values.

Parameters
aOrientationthe main image orientation value
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found.

SetPixelXDimension ( TInt )

IMPORT_C TIntSetPixelXDimension(TIntaPixelXDim)

Sets the pixelXDimension tag value of the metadata.

Parameters
aPixelXDimthe pixelXDimension value
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found.

SetPixelYDimension ( TInt )

IMPORT_C TIntSetPixelYDimension(TIntaPixelYDim)

Sets the pixelYDimension tag value of the metadata.

Parameters
aPixelYDimthe pixelYDimension value
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found.

SetResolutionUnit ( TInt )

IMPORT_C TIntSetResolutionUnit(TIntaResUnit)

Sets the main image resolutionUnit tag value of the metadata.

Note: aResUnit may only take unsigned short (16-bit) values.

Parameters
aResUnitthe main image resolutionUnit value
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found.

SetShutterSpeedValue ( TInt, TInt )

IMPORT_C TIntSetShutterSpeedValue(TIntaNumerator,
TIntaDenominator
)

Sets the shutter speed tag value of the metadata.

Note that aNumerator may take signed values.

Note that aDenominator may take signed values.

Parameters
aNumeratorthe shutter speed numerator value.
aDenominatorthe shutter speed denominator value.
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata.

SetThumbCompression ( TInt )

IMPORT_C TIntSetThumbCompression(TIntaCompression)

Sets the thumbnail compression tag value of the metadata.

Note: aCompression may only take unsigned short (16-bit) values.

Parameters
aCompressionthe thumbnail compression value
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found.

SetThumbOrientation ( TInt )

IMPORT_C TIntSetThumbOrientation(TIntaOrientation)

Sets the thumbnail orientation tag value of the metadata.

Note: aOrientation may only take unsigned short (16-bit) values.

Parameters
aOrientationthe thumbnail orientation value
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found.

SetThumbResolutionUnit ( TInt )

IMPORT_C TIntSetThumbResolutionUnit(TIntaResUnit)

Sets the thumbnail resolutionUnit tag value of the metadata.

Note: aResUnit may only take unsigned short (16-bit) values.

Parameters
aResUnitthe thumbnail resolutionUnit value
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found.

SetThumbXResolution ( TInt, TInt )

IMPORT_C TIntSetThumbXResolution(TIntaNumerator,
TIntaDenominator
)

Sets the thumbnail xResolution tag value of the metadata.

Parameters
aNumeratorthe thumbnail xResolution value numerator
aDenominatorthe thumbnail xResolution value denominator
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found.

SetThumbYResolution ( TInt, TInt )

IMPORT_C TIntSetThumbYResolution(TIntaNumerator,
TIntaDenominator
)

Sets the thumbnail yResolution tag value of the metadata.

Parameters
aNumeratorthe thumbnail yResolution value numerator
aDenominatorthe thumbnail yResolution value denominator
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found.

SetUserComment ( HBufC8 * )

IMPORT_C TIntSetUserComment(HBufC8 *aUserComment)

Sets the user comment tag value of the metadata.

Note: According to the Exif 2.2 specification, the first 8 bytes of aUserComment must contain a Character Code to indicate the type of encoding used. See table 6 of the Exif 2.2 specification for a list of codes.

Parameters
aUserCommentthe user comment value.
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found. KErrOverflow if there is an internal error with the Exif metadata.

SetXResolution ( TInt, TInt )

IMPORT_C TIntSetXResolution(TIntaNumerator,
TIntaDenominator
)

Sets the main image xResolution tag value of the metadata.

Parameters
aNumeratorthe main image xResolution value numerator
aDenominatorthe main image xResolution value denominator
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found.

SetYCbCrPositioning ( TInt )

IMPORT_C TIntSetYCbCrPositioning(TIntaPositioning)

Sets the yCbCrPositioning tag value of the metadata.

Note: aPositioning may only take unsigned short (16-bit) values.

Parameters
aPositioningthe yCbCrPositioning value
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found.

SetYResolution ( TInt, TInt )

IMPORT_C TIntSetYResolution(TIntaNumerator,
TIntaDenominator
)

Sets the main image yResolution tag value of the metadata.

Parameters
aNumeratorthe main image yResolution value numerator
aDenominatorthe main image yResolution value denominator
Return Value
error code KErrArgument if the requested data type does not match with the tag. KErrNotSupported if called on an encoding module. KErrNotFound if the tag cannot be found.