Symbian
Symbian OS Library

SYMBIAN OS V9.3

[Index] [Spacer] [Previous] [Next]



Location: ExifUtility.h
Link against: exifutility.lib

This item is not part of the S60 3rd Edition SDK for Symbian OS, Feature Pack 2.

Class TExifWriterUtility

class TExifWriterUtility;

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.

Members

Defined in TExifWriterUtility:
SetColorSpace(), SetComponentsConfiguration(), SetCopyright(), SetDateTime(), SetDateTimeDigitized(), SetDateTimeOriginal(), SetExifVersion(), SetFlash(), SetFlashPixVersion(), SetFocalLength(), SetGpsAltitude(), SetGpsAltitudeRef(), SetGpsAreaInformation(), SetGpsDateStamp(), SetGpsDestBearing(), SetGpsDestBearingRef(), SetGpsDestDistance(), SetGpsDestDistanceRef(), SetGpsDestLatitude(), SetGpsDestLatitudeRef(), SetGpsDestLongitude(), SetGpsDestLongitudeRef(), SetGpsDifferential(), SetGpsDop(), SetGpsImgDirection(), SetGpsImgDirectionRef(), SetGpsLatitude(), SetGpsLatitudeRef(), SetGpsLongitude(), SetGpsLongitudeRef(), SetGpsMapDatum(), SetGpsMeasureMode(), SetGpsProcessingMethod(), SetGpsSatellites(), SetGpsSpeed(), SetGpsSpeedRef(), SetGpsStatus(), SetGpsTimeStamp(), SetGpsTrack(), SetGpsTrackRef(), SetGpsVersionId(), SetImageDescription(), SetInteroperabilityIndex(), SetInteroperabilityVersion(), SetMake(), SetMakerNote(), SetModel(), SetOrientation(), SetPixelXDimension(), SetPixelYDimension(), SetResolutionUnit(), SetShutterSpeedValue(), SetThumbCompression(), SetThumbOrientation(), SetThumbResolutionUnit(), SetThumbXResolution(), SetThumbYResolution(), SetUserComment(), SetXResolution(), SetYCbCrPositioning(), SetYResolution(), TExifWriterUtility()


Construction and destruction


TExifWriterUtility()

IMPORT_C TExifWriterUtility(MExifMetadataWriter *aExifMetadata);

Description

Constructor

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

Parameters

MExifMetadataWriter *aExifMetadata

the metadata class on which to read the tags

[Top]


Member functions


SetMake()

IMPORT_C TInt SetMake(HBufC8 *aMake);

Description

Sets the make tag value of the metadata.

Parameters

HBufC8 *aMake

the make value

Return value

TInt

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.


SetModel()

IMPORT_C TInt SetModel(HBufC8 *aModel);

Description

Sets the model tag value of the metadata.

Parameters

HBufC8 *aModel

the model value

Return value

TInt

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.


SetDateTime()

IMPORT_C TInt SetDateTime(HBufC8 *aDateTime);

Description

Sets the dateTime tag value of the metadata.

Parameters

HBufC8 *aDateTime

the dateTime value

Return value

TInt

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()

IMPORT_C TInt SetDateTimeOriginal(HBufC8 *aDateTime);

Description

Sets the dateTimeOriginal tag value of the metadata.

Parameters

HBufC8 *aDateTime

the dateTimeOriginal value

Return value

TInt

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()

IMPORT_C TInt SetDateTimeDigitized(HBufC8 *aDateTime);

Description

Sets the dateTimeDigitized tag value of the metadata.

Parameters

HBufC8 *aDateTime

the dateTimeDigitized value

Return value

TInt

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.


SetInteroperabilityIndex()

IMPORT_C TInt SetInteroperabilityIndex(HBufC8 *aIdx);

Description

Sets the interoperabilityindex tag value of the metadata.

Parameters

HBufC8 *aIdx

the interoperabilityIndex value

Return value

TInt

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()

IMPORT_C TInt SetInteroperabilityVersion(HBufC8 *aIdx);

Description

Sets the interoperabilityVersion tag value of the metadata.

Parameters

HBufC8 *aIdx

the interoperabilityVersion value

Return value

TInt

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()

IMPORT_C TInt SetExifVersion(HBufC8 *aExifVersion);

Description

Sets the exifVersion tag value of the metadata.

Parameters

HBufC8 *aExifVersion

the exifVersion value

Return value

TInt

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()

IMPORT_C TInt SetComponentsConfiguration(HBufC8 *aComponentsConfig);

Description

Sets the componentsConfiguration tag value of the metadata.

Parameters

HBufC8 *aComponentsConfig

the componentsConfiguration value

Return value

TInt

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.


SetFlashPixVersion()

IMPORT_C TInt SetFlashPixVersion(HBufC8 *aFlashPixVer);

Description

Sets the flashpixVersion tag value of the metadata.

Parameters

HBufC8 *aFlashPixVer

the flashpixVersion value

Return value

TInt

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.


SetXResolution()

IMPORT_C TInt SetXResolution(TInt aNumerator, TInt aDenominator);

Description

Sets the main image xResolution tag value of the metadata.

Parameters

TInt aNumerator

the main image xResolution value numerator

TInt aDenominator

the main image xResolution value denominator

Return value

TInt

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()

IMPORT_C TInt SetYResolution(TInt aNumerator, TInt aDenominator);

Description

Sets the main image yResolution tag value of the metadata.

Parameters

TInt aNumerator

the main image yResolution value numerator

TInt aDenominator

the main image yResolution value denominator

Return value

TInt

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()

IMPORT_C TInt SetThumbXResolution(TInt aNumerator, TInt aDenominator);

Description

Sets the thumbnail xResolution tag value of the metadata.

Parameters

TInt aNumerator

the thumbnail xResolution value numerator

TInt aDenominator

the thumbnail xResolution value denominator

Return value

TInt

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()

IMPORT_C TInt SetThumbYResolution(TInt aNumerator, TInt aDenominator);

Description

Sets the thumbnail yResolution tag value of the metadata.

Parameters

TInt aNumerator

the thumbnail yResolution value numerator

TInt aDenominator

the thumbnail yResolution value denominator

Return value

TInt

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()

IMPORT_C TInt SetResolutionUnit(TInt aResUnit);

Description

Sets the main image resolutionUnit tag value of the metadata.

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

Parameters

TInt aResUnit

the main image resolutionUnit value

Return value

TInt

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()

IMPORT_C TInt SetYCbCrPositioning(TInt aPositioning);

Description

Sets the yCbCrPositioning tag value of the metadata.

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

Parameters

TInt aPositioning

the yCbCrPositioning value

Return value

TInt

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()

IMPORT_C TInt SetOrientation(TInt aOrientation);

Description

Sets the main image orientation tag value of the metadata.

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

Parameters

TInt aOrientation

the main image orientation value

Return value

TInt

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.


SetColorSpace()

IMPORT_C TInt SetColorSpace(TInt aColorSpace);

Description

Sets the colorSpace tag value of the metadata.

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

Parameters

TInt aColorSpace

the colorSpace value

Return value

TInt

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()

IMPORT_C TInt SetPixelXDimension(TInt aPixelXDim);

Description

Sets the pixelXDimension tag value of the metadata.

Parameters

TInt aPixelXDim

the pixelXDimension value

Return value

TInt

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()

IMPORT_C TInt SetPixelYDimension(TInt aPixelYDim);

Description

Sets the pixelYDimension tag value of the metadata.

Parameters

TInt aPixelYDim

the pixelYDimension value

Return value

TInt

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.


SetThumbCompression()

IMPORT_C TInt SetThumbCompression(TInt aCompression);

Description

Sets the thumbnail compression tag value of the metadata.

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

Parameters

TInt aCompression

the thumbnail compression value

Return value

TInt

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()

IMPORT_C TInt SetThumbResolutionUnit(TInt aResUnit);

Description

Sets the thumbnail resolutionUnit tag value of the metadata.

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

Parameters

TInt aResUnit

the thumbnail resolutionUnit value

Return value

TInt

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()

IMPORT_C TInt SetThumbOrientation(TInt aOrientation);

Description

Sets the thumbnail orientation tag value of the metadata.

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

Parameters

TInt aOrientation

the thumbnail orientation value

Return value

TInt

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.


SetImageDescription()

IMPORT_C TInt SetImageDescription(HBufC8 *aImageDescription);

Description

Sets the image description tag value of the metadata.

Parameters

HBufC8 *aImageDescription

the image description value.

Return value

TInt

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.


SetCopyright()

IMPORT_C TInt SetCopyright(HBufC8 *aCopyright);

Description

Sets the copyright tag value of the metadata.

Parameters

HBufC8 *aCopyright

the copyright value.

Return value

TInt

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.


SetMakerNote()

IMPORT_C TInt SetMakerNote(HBufC8 *aMakerNote);

Description

Sets the maker note tag value of the metadata.

Parameters

HBufC8 *aMakerNote

the maker note value.

Return value

TInt

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.


SetUserComment()

IMPORT_C TInt SetUserComment(HBufC8 *aUserComment);

Description

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

HBufC8 *aUserComment

the user comment value.

Return value

TInt

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.


SetFlash()

IMPORT_C TInt SetFlash(TUint16 aFlash);

Description

Sets the flash tag value of the metadata.

Parameters

TUint16 aFlash

the flash value.

Return value

TInt

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.


SetFocalLength()

IMPORT_C TInt SetFocalLength(TInt aNumerator, TInt aDenominator);

Description

Sets the focal length tag value of the metadata.

Parameters

TInt aNumerator

the focal length numerator value

TInt aDenominator

the focal length denominator value

Return value

TInt

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.


SetShutterSpeedValue()

IMPORT_C TInt SetShutterSpeedValue(TInt aNumerator, TInt aDenominator);

Description

Sets the shutter speed tag value of the metadata.

Note that aNumerator may take signed values.

Note that aDenominator may take signed values.

Parameters

TInt aNumerator

the shutter speed numerator value.

TInt aDenominator

the shutter speed denominator value.

Return value

TInt

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()

IMPORT_C TInt SetGpsVersionId(HBufC8 *aGpsVersionId);

Description

Sets the gps version id tag value of the metadata.

Parameters

HBufC8 *aGpsVersionId

the gps version id value.

Return value

TInt

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.


SetGpsLatitudeRef()

IMPORT_C TInt SetGpsLatitudeRef(HBufC8 *aGpsLatitudeRef);

Description

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

Parameters

HBufC8 *aGpsLatitudeRef

the gps north or south latitude value.

Return value

TInt

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()

IMPORT_C TInt SetGpsLatitude(TInt aDegNumerator, TInt aDegDenominator, TInt aMinNumerator, TInt aMinDenominator, TInt aSecNumerator, TInt aSecDenominator);

Description

Sets the gps latitude tag value of the metadata.

Parameters

TInt aDegNumerator

the degrees latitude numerator value.

TInt aDegDenominator

the degrees latitude denominator value.

TInt aMinNumerator

the minutes latitude numerator value.

TInt aMinDenominator

the minutes latitude denominator value.

TInt aSecNumerator

the seconds latitude numerator value.

TInt aSecDenominator

the seconds latitude denominator value.

Return value

TInt

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()

IMPORT_C TInt SetGpsLongitudeRef(HBufC8 *aGpsLongitudeRef);

Description

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

Parameters

HBufC8 *aGpsLongitudeRef

the east or west longitude value.

Return value

TInt

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()

IMPORT_C TInt SetGpsLongitude(TInt aDegNumerator, TInt aDegDenominator, TInt aMinNumerator, TInt aMinDenominator, TInt aSecNumerator, TInt aSecDenominator);

Description

Sets the gps longitude tag value of the metadata.

Parameters

TInt aDegNumerator

the degrees longitude numerator value.

TInt aDegDenominator

the degrees longitude denominator value.

TInt aMinNumerator

the minutes longitude numerator value.

TInt aMinDenominator

the minutes longitude denominator value.

TInt aSecNumerator

the seconds longitude numerator value.

TInt aSecDenominator

the seconds longitude denominator value.

Return value

TInt

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.


SetGpsAltitudeRef()

IMPORT_C TInt SetGpsAltitudeRef(TUint8 aGpsAltitudeRef);

Description

Sets the gps altitude reference tag value of the metadata.

Parameters

TUint8 aGpsAltitudeRef

the altitude reference value.

Return value

TInt

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.


SetGpsAltitude()

IMPORT_C TInt SetGpsAltitude(TInt aNumerator, TInt aDenominator);

Description

Sets the gps altitude tag value of the metadata.

Parameters

TInt aNumerator

the altitude numerator value.

TInt aDenominator

the altitude denominator value.

Return value

TInt

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()

IMPORT_C TInt SetGpsTimeStamp(TInt aHourNumerator, TInt aHourDenominator, TInt aMinNumerator, TInt aMinDenominator, TInt aSecNumerator, TInt aSecDenominator);

Description

Sets the gps time tag value of the metadata.

Parameters

TInt aHourNumerator

the hour numerator value.

TInt aHourDenominator

the hour denominator value.

TInt aMinNumerator

the minutes numerator value.

TInt aMinDenominator

the minutes denominator value.

TInt aSecNumerator

the seconds numerator value.

TInt aSecDenominator

the seconds denominator value.

Return value

TInt

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()

IMPORT_C TInt SetGpsSatellites(HBufC8 *aGpsSatellites);

Description

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

Parameters

HBufC8 *aGpsSatellites

the gps satellites used for measurement value.

Return value

TInt

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()

IMPORT_C TInt SetGpsStatus(HBufC8 *aGpsStatus);

Description

Sets the gps receiver status tag value of the metadata.

Parameters

HBufC8 *aGpsStatus

the gps receiver status value.

Return value

TInt

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()

IMPORT_C TInt SetGpsMeasureMode(HBufC8 *aGpsMeasureMode);

Description

Sets the gps measurement mode tag value of the metadata.

Parameters

HBufC8 *aGpsMeasureMode

the gps measurement mode value.

Return value

TInt

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()

IMPORT_C TInt SetGpsDop(TInt aNumerator, TInt aDenominator);

Description

Sets the gps measurement precision tag value of the metadata.

Parameters

TInt aNumerator

the measurement precision numerator value.

TInt aDenominator

the measurement precision denominator value.

Return value

TInt

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()

IMPORT_C TInt SetGpsSpeedRef(HBufC8 *aGpsSpeedRef);

Description

Sets the gps speed unit tag value of the metadata.

Parameters

HBufC8 *aGpsSpeedRef

the speed unit value.

Return value

TInt

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()

IMPORT_C TInt SetGpsSpeed(TInt aNumerator, TInt aDenominator);

Description

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

Parameters

TInt aNumerator

the speed of gps receiver numerator value.

TInt aDenominator

the speed of gps receiver denominator value.

Return value

TInt

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()

IMPORT_C TInt SetGpsTrackRef(HBufC8 *aGpsTrackRef);

Description

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

Parameters

HBufC8 *aGpsTrackRef

the gps reference for direction of movement value.

Return value

TInt

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()

IMPORT_C TInt SetGpsTrack(TInt aNumerator, TInt aDenominator);

Description

Sets the direction of movement tag value of the metadata.

Parameters

TInt aNumerator

the direction of movement numerator value.

TInt aDenominator

the direction of movement denominator value.

Return value

TInt

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()

IMPORT_C TInt SetGpsImgDirectionRef(HBufC8 *aGpsImgDirectionRef);

Description

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

Parameters

HBufC8 *aGpsImgDirectionRef

the gps reference for direction of image value.

Return value

TInt

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()

IMPORT_C TInt SetGpsImgDirection(TInt aNumerator, TInt aDenominator);

Description

Sets the direction of image tag value of the metadata.

Parameters

TInt aNumerator

the direction of image numerator value.

TInt aDenominator

the direction of image denominator value.

Return value

TInt

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()

IMPORT_C TInt SetGpsMapDatum(HBufC8 *aGpsMapDatum);

Description

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

Parameters

HBufC8 *aGpsMapDatum

the geodetic survey data used value.

Return value

TInt

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()

IMPORT_C TInt SetGpsDestLatitudeRef(HBufC8 *aGpsDestLatitudeRef);

Description

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

Parameters

HBufC8 *aGpsDestLatitudeRef

the reference for latitude of destination value.

Return value

TInt

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()

IMPORT_C TInt SetGpsDestLatitude(TInt aDegNumerator, TInt aDegDenominator, TInt aMinNumerator, TInt aMinDenominator, TInt aSecNumerator, TInt aSecDenominator);

Description

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

Parameters

TInt aDegNumerator

on return, the degrees latitude of destination numerator value

TInt aDegDenominator

on return, the degrees latitude of destination denominator value

TInt aMinNumerator

on return, the minutes latitude of destination numerator value

TInt aMinDenominator

on return, the minutes latitude of destination denominator value

TInt aSecNumerator

on return, the seconds latitude of destination numerator value

TInt aSecDenominator

on return, the seconds latitude of destination denominator value

Return value

TInt

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()

IMPORT_C TInt SetGpsDestLongitudeRef(HBufC8 *aGpsDestLongitudeRef);

Description

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

Parameters

HBufC8 *aGpsDestLongitudeRef

the reference for longitude of destination value.

Return value

TInt

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()

IMPORT_C TInt SetGpsDestLongitude(TInt aDegNumerator, TInt aDegDenominator, TInt aMinNumerator, TInt aMinDenominator, TInt aSecNumerator, TInt aSecDenominator);

Description

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

Parameters

TInt aDegNumerator

on return, the degrees longitude of destination numerator value

TInt aDegDenominator

on return, the degrees longitude of destination denominator value

TInt aMinNumerator

on return, the minutes longitude of destination numerator value

TInt aMinDenominator

on return, the minutes longitude of destination denominator value

TInt aSecNumerator

on return, the seconds longitude of destination numerator value

TInt aSecDenominator

on return, the seconds longitude of destination denominator value

Return value

TInt

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()

IMPORT_C TInt SetGpsDestBearingRef(HBufC8 *aGpsDestBearingRef);

Description

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

Parameters

HBufC8 *aGpsDestBearingRef

the reference for bearing of destination value.

Return value

TInt

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()

IMPORT_C TInt SetGpsDestBearing(TInt aNumerator, TInt aDenominator);

Description

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

Parameters

TInt aNumerator

the bearing of destination numerator value

TInt aDenominator

the bearing of destination denominator value

Return value

TInt

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()

IMPORT_C TInt SetGpsDestDistanceRef(HBufC8 *aGpsDestDistanceRef);

Description

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

Parameters

HBufC8 *aGpsDestDistanceRef

the reference for distance to destination value.

Return value

TInt

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()

IMPORT_C TInt SetGpsDestDistance(TInt aNumerator, TInt aDenominator);

Description

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

Parameters

TInt aNumerator

the distance to destination numerator value.

TInt aDenominator

the distance to destination denominator value.

Return value

TInt

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()

IMPORT_C TInt SetGpsProcessingMethod(HBufC8 *aGpsProcessingMethod);

Description

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

HBufC8 *aGpsProcessingMethod

the name of gps processing method value.

Return value

TInt

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.


SetGpsAreaInformation()

IMPORT_C TInt SetGpsAreaInformation(HBufC8 *aGpsAreaInformation);

Description

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

HBufC8 *aGpsAreaInformation

the name of gps area value.

Return value

TInt

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()

IMPORT_C TInt SetGpsDateStamp(HBufC8 *aDateStamp);

Description

Sets the gps date tag value of the metadata.

Parameters

HBufC8 *aDateStamp

the gps date value.

Return value

TInt

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()

IMPORT_C TInt SetGpsDifferential(TUint16 aGpsDifferential);

Description

Sets the gps differential correction tag value of the metadata.

Parameters

TUint16 aGpsDifferential

the gps differential correction value.

Return value

TInt

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.