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 TExifReaderUtility

class TExifReaderUtility;

Description

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

Note: Unless otherwise stated in a method's documentation, TInt& arguments represent unsigned quantities and will be updated with unsigned values, even though TInt is a signed type. In such cases, proper typecasting should be used to ensure that the values are correctly treated as unsigned.

Note: Get method arguments will only be updated if the method is returning KErrNone.

Members

Defined in TExifReaderUtility:
GetColorSpace(), GetComponentsConfiguration(), GetCopyright(), GetDateTime(), GetDateTimeDigitized(), GetDateTimeOriginal(), GetExifVersion(), GetFlash(), GetFlashPixVersion(), GetFocalLength(), GetGpsAltitude(), GetGpsAltitudeRef(), GetGpsAreaInformation(), GetGpsDateStamp(), GetGpsDestBearing(), GetGpsDestBearingRef(), GetGpsDestDistance(), GetGpsDestDistanceRef(), GetGpsDestLatitude(), GetGpsDestLatitudeRef(), GetGpsDestLongitude(), GetGpsDestLongitudeRef(), GetGpsDifferential(), GetGpsDop(), GetGpsImgDirection(), GetGpsImgDirectionRef(), GetGpsLatitude(), GetGpsLatitudeRef(), GetGpsLongitude(), GetGpsLongitudeRef(), GetGpsMapDatum(), GetGpsMeasureMode(), GetGpsProcessingMethod(), GetGpsSatellites(), GetGpsSpeed(), GetGpsSpeedRef(), GetGpsStatus(), GetGpsTimeStamp(), GetGpsTrack(), GetGpsTrackRef(), GetGpsVersionId(), GetImageDescription(), GetInteroperabilityIndex(), GetInteroperabilityVersion(), GetJpegInterchangeFormatLength(), GetJpegInterchangeFormatLength(), GetMake(), GetMakerNote(), GetModel(), GetOrientation(), GetPixelXDimension(), GetPixelYDimension(), GetResolutionUnit(), GetShutterSpeedValue(), GetThumbCompression(), GetThumbOrientation(), GetThumbResolutionUnit(), GetThumbXResolution(), GetThumbYResolution(), GetUserComment(), GetXResolution(), GetYCbCrPositioning(), GetYResolution(), TExifReaderUtility()


Construction and destruction


TExifReaderUtility()

IMPORT_C TExifReaderUtility(MExifMetadataReader *aExifMetadataReader);

Description

Constructor

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

Parameters

MExifMetadataReader *aExifMetadataReader

the metadata class on which to read the tags

[Top]


Member functions


GetMake()

IMPORT_C TInt GetMake(HBufC8 *&aParam) const;

Description

Gets the make tag value of the metadata.

Ownership of the buffer pointed to by aParam transfers to the client, which is therefore responsible for deleting the buffer when required. Note: The client should always initialise aParam to NULL, and the plugin should only assign to this parameter when ready to transfer ownership.

Parameters

HBufC8 *&aParam

on return, 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.


GetModel()

IMPORT_C TInt GetModel(HBufC8 *&aParam) const;

Description

Gets the model tag value of the metadata.

Ownership of the buffer pointed to by aParam transfers to the client, which is therefore responsible for deleting the buffer when required. Note: The client should always initialise aParam to NULL, and the plugin should only assign to this parameter when ready to transfer ownership.

Parameters

HBufC8 *&aParam

on return, 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.


GetDateTime()

IMPORT_C TInt GetDateTime(HBufC8 *&aParam) const;

Description

Gets the dateTime tag value of the metadata.

Ownership of the buffer pointed to by aParam transfers to the client, which is therefore responsible for deleting the buffer when required. Note: The client should always initialise aParam to NULL, and the plugin should only assign to this parameter when ready to transfer ownership.

Parameters

HBufC8 *&aParam

on return, 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.


GetDateTimeOriginal()

IMPORT_C TInt GetDateTimeOriginal(HBufC8 *&aParam) const;

Description

Gets the dateTimeOriginal tag value of the metadata.

Ownership of the buffer pointed to by aParam transfers to the client, which is therefore responsible for deleting the buffer when required. Note: The client should always initialise aParam to NULL, and the plugin should only assign to this parameter when ready to transfer ownership.

Parameters

HBufC8 *&aParam

on return, 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.


GetDateTimeDigitized()

IMPORT_C TInt GetDateTimeDigitized(HBufC8 *&aParam) const;

Description

Gets the dateTimeDigitized tag value of the metadata.

Ownership of the buffer pointed to by aParam transfers to the client, which is therefore responsible for deleting the buffer when required. Note: The client should always initialise aParam to NULL, and the plugin should only assign to this parameter when ready to transfer ownership.

Parameters

HBufC8 *&aParam

on return, 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.


GetInteroperabilityIndex()

IMPORT_C TInt GetInteroperabilityIndex(HBufC8 *&aParam) const;

Description

Gets the interoperabilityIndex tag value of the metadata.

Ownership of the buffer pointed to by aParam transfers to the client, which is therefore responsible for deleting the buffer when required. Note: The client should always initialise aParam to NULL, and the plugin should only assign to this parameter when ready to transfer ownership.

Parameters

HBufC8 *&aParam

on return, 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.


GetInteroperabilityVersion()

IMPORT_C TInt GetInteroperabilityVersion(HBufC8 *&aParam) const;

Description

Gets the interoperabilityVersion tag value of the metadata.

Ownership of the buffer pointed to by aParam transfers to the client, which is therefore responsible for deleting the buffer when required. Note: The client should always initialise aParam to NULL, and the plugin should only assign to this parameter when ready to transfer ownership.

Parameters

HBufC8 *&aParam

on return, 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.


GetExifVersion()

IMPORT_C TInt GetExifVersion(HBufC8 *&aParam) const;

Description

Gets the exifVersion tag value of the metadata.

Ownership of the buffer pointed to by aParam transfers to the client, which is therefore responsible for deleting the buffer when required. Note: The client should always initialise aParam to NULL, and the plugin should only assign to this parameter when ready to transfer ownership.

Parameters

HBufC8 *&aParam

on return, 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.


GetComponentsConfiguration()

IMPORT_C TInt GetComponentsConfiguration(HBufC8 *&aParam) const;

Description

Gets the componentsConfiguration tag value of the metadata.

Ownership of the buffer pointed to by aParam transfers to the client, which is therefore responsible for deleting the buffer when required. Note: The client should always initialise aParam to NULL, and the plugin should only assign to this parameter when ready to transfer ownership.

Parameters

HBufC8 *&aParam

on return, the ComponentConfiguration 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.


GetFlashPixVersion()

IMPORT_C TInt GetFlashPixVersion(HBufC8 *&aParam) const;

Description

Gets the flashpixVersion tag value of the metadata.

Ownership of the buffer pointed to by aParam transfers to the client, which is therefore responsible for deleting the buffer when required. Note: The client should always initialise aParam to NULL, and the plugin should only assign to this parameter when ready to transfer ownership.

Parameters

HBufC8 *&aParam

on return, 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.


GetXResolution()

IMPORT_C TInt GetXResolution(TInt &aNumerator, TInt &aDenominator) const;

Description

Gets the main image xResolution tag value of the metadata.

Parameters

TInt &aNumerator

on return, the main image xResolution numerator value

TInt &aDenominator

on return, the main image xResolution 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.


GetYResolution()

IMPORT_C TInt GetYResolution(TInt &aNumerator, TInt &aDenominator) const;

Description

Gets the main image yResolution tag value of the metadata.

Parameters

TInt &aNumerator

on return, the main image yResolution numerator value

TInt &aDenominator

on return, the main image yResolution 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.


GetThumbXResolution()

IMPORT_C TInt GetThumbXResolution(TInt &aNumerator, TInt &aDenominator) const;

Description

Gets the thumbnail xResolution tag value of the metadata.

Parameters

TInt &aNumerator

on return, the main thumbnail xResolution numerator value

TInt &aDenominator

on return, the main thumbnail xResolution 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.


GetThumbYResolution()

IMPORT_C TInt GetThumbYResolution(TInt &aNumerator, TInt &aDenominator) const;

Description

Gets the thumbnail yResolution tag value of the metadata.

Parameters

TInt &aNumerator

on return, the main thumbnail yResolution numerator value

TInt &aDenominator

on return, the main thumbnail yResolution 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.


GetResolutionUnit()

IMPORT_C TInt GetResolutionUnit(TUint16 &aParam) const;

Description

Gets the main image resolutionUnit tag value of the metadata.

Parameters

TUint16 &aParam

on return, 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.


GetYCbCrPositioning()

IMPORT_C TInt GetYCbCrPositioning(TUint16 &aParam) const;

Description

Gets the yCbCrPositioning tag value of the metadata.

Parameters

TUint16 &aParam

on return, 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.


GetOrientation()

IMPORT_C TInt GetOrientation(TUint16 &aParam) const;

Description

Gets the main image orientation tag value of the metadata.

Parameters

TUint16 &aParam

on return, 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.


GetColorSpace()

IMPORT_C TInt GetColorSpace(TUint16 &aParam) const;

Description

Gets the colorSpace tag value of the metadata.

Parameters

TUint16 &aParam

on return, 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.


GetPixelXDimension()

IMPORT_C TInt GetPixelXDimension(TInt &aParam) const;

Description

Gets the pixelXDimension tag value of the metadata.

Parameters

TInt &aParam

on return, 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.


GetPixelYDimension()

IMPORT_C TInt GetPixelYDimension(TInt &aParam) const;

Description

Gets the pixelYDimension tag value of the metadata.

Parameters

TInt &aParam

on return, 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.


GetThumbCompression()

IMPORT_C TInt GetThumbCompression(TUint16 &aParam) const;

Description

Gets the thumbnail compression tag value of the metadata.

Parameters

TUint16 &aParam

on return, 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.


GetThumbResolutionUnit()

IMPORT_C TInt GetThumbResolutionUnit(TUint16 &aParam) const;

Description

Gets the thumbnail resolutionUnit tag value of the metadata.

Parameters

TUint16 &aParam

on return, 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.


GetThumbOrientation()

IMPORT_C TInt GetThumbOrientation(TUint16 &aParam) const;

Description

Gets the thumbnail orientation tag value of the metadata.

Parameters

TUint16 &aParam

on return, 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.


GetImageDescription()

IMPORT_C TInt GetImageDescription(HBufC8 *&aParam) const;

Description

Gets the image description tag value of the metadata.

Ownership of the buffer pointed to by aParam transfers to the client, which is therefore responsible for deleting the buffer when required. Note: The client should always initialise aParam to NULL, and the plugin should only assign to this parameter when ready to transfer ownership.

Parameters

HBufC8 *&aParam

on return, 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.


GetCopyright()

IMPORT_C TInt GetCopyright(HBufC8 *&aParam) const;

Description

Gets the copyright tag value of the metadata.

Ownership of the buffer pointed to by aParam transfers to the client, which is therefore responsible for deleting the buffer when required. Note: The client should always initialise aParam to NULL, and the plugin should only assign to this parameter when ready to transfer ownership.

Parameters

HBufC8 *&aParam

on return, 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.


GetMakerNote()

IMPORT_C TInt GetMakerNote(HBufC8 *&aParam) const;

Description

Gets the maker note tag value of the metadata.

Ownership of the buffer pointed to by aParam transfers to the client, which is therefore responsible for deleting the buffer when required. Note: The client should always initialise aParam to NULL, and the plugin should only assign to this parameter when ready to transfer ownership.

Parameters

HBufC8 *&aParam

on return, 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.


GetUserComment()

IMPORT_C TInt GetUserComment(HBufC8 *&aParam) const;

Description

Gets the user comment tag value of the metadata.

Ownership of the buffer pointed to by aParam transfers to the client, which is therefore responsible for deleting the buffer when required. Note: The client should always initialise aParam to NULL, and the plugin should only assign to this parameter when ready to transfer ownership.

Note: The first 8 bytes of aParam may 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 *&aParam

on return, 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.


GetFlash()

IMPORT_C TInt GetFlash(TUint16 &aParam) const;

Description

Gets the flash tag value of the metadata.

Parameters

TUint16 &aParam

on return, 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.


GetFocalLength()

IMPORT_C TInt GetFocalLength(TInt &aNumerator, TInt &aDenominator) const;

Description

Gets the focal length tag value of the metadata.

Parameters

TInt &aNumerator

on return, the focal length numerator value.

TInt &aDenominator

on return, 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.


GetShutterSpeedValue()

IMPORT_C TInt GetShutterSpeedValue(TInt &aNumerator, TInt &aDenominator) const;

Description

Gets the shutter speed tag value of the metadata.

Note that aNumerator is a true signed quantity, so no typecasting to an unsigned type is required.

Note that aDenominator is a true signed quantity, so no typecasting to an unsigned type is required.

Parameters

TInt &aNumerator

on return, the shutter speed numerator value.

TInt &aDenominator

on return, 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.


GetJpegInterchangeFormatLength()

IMPORT_C TInt GetJpegInterchangeFormatLength(TInt &aParam) const;

Description

Gets the thumbnail jpeg interchange format length of the metadata.

Parameters

TInt &aParam

on return, the thumbnail jpeg interchange format length.

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.


GetJpegInterchangeFormatLength()

IMPORT_C TInt GetJpegInterchangeFormatLength(TUint &aParam) const;

Description

Gets the thumbnail jpeg interchange format length of the metadata.

Parameters

TUint &aParam

on return, the thumbnail jpeg interchange format length.

Return value

TInt

error code 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.


GetGpsVersionId()

IMPORT_C TInt GetGpsVersionId(HBufC8 *&aParam) const;

Description

Gets the gps version id tag value of the metadata.

Ownership of the buffer pointed to by aParam transfers to the client, which is therefore responsible for deleting the buffer when required. Note: The client should always initialise aParam to NULL, and the plugin should only assign to this parameter when ready to transfer ownership.

Parameters

HBufC8 *&aParam

on return, the gps version id.

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.


GetGpsLatitudeRef()

IMPORT_C TInt GetGpsLatitudeRef(HBufC8 *&aParam) const;

Description

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

Ownership of the buffer pointed to by aParam transfers to the client, which is therefore responsible for deleting the buffer when required. Note: The client should always initialise aParam to NULL, and the plugin should only assign to this parameter when ready to transfer ownership.

Parameters

HBufC8 *&aParam

on return, the gps north or south latitude.

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.


GetGpsLatitude()

IMPORT_C TInt GetGpsLatitude(TInt &aDegNumerator, TInt &aDegDenominator, TInt &aMinNumerator, TInt &aMinDenominator, TInt &aSecNumerator, TInt &aSecDenominator) const;

Description

Gets the gps latitude tag value of the metadata.

Parameters

TInt &aDegNumerator

on return, the degrees latitude numerator value.

TInt &aDegDenominator

on return, the degrees latitude denominator value.

TInt &aMinNumerator

on return, the minutes latitude numerator value.

TInt &aMinDenominator

on return, the minutes latitude denominator value.

TInt &aSecNumerator

on return, the seconds latitude numerator value.

TInt &aSecDenominator

on return, 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. KErrCorrupt if the gps latitude tag value of the metadata is corrupt.


GetGpsLongitudeRef()

IMPORT_C TInt GetGpsLongitudeRef(HBufC8 *&aParam) const;

Description

Gets the gps east or west longitude tag value of the metadata.

Ownership of the buffer pointed to by aParam transfers to the client, which is therefore responsible for deleting the buffer when required. Note: The client should always initialise aParam to NULL, and the plugin should only assign to this parameter when ready to transfer ownership.

Parameters

HBufC8 *&aParam

on return, the gps east or west longitude.

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.


GetGpsLongitude()

IMPORT_C TInt GetGpsLongitude(TInt &aDegNumerator, TInt &aDegDenominator, TInt &aMinNumerator, TInt &aMinDenominator, TInt &aSecNumerator, TInt &aSecDenominator) const;

Description

Gets the gps longitude tag value of the metadata.

Parameters

TInt &aDegNumerator

on return, the degrees longitude numerator value.

TInt &aDegDenominator

on return, the degrees longitude denominator value.

TInt &aMinNumerator

on return, the minutes longitude numerator value.

TInt &aMinDenominator

on return, the minutes longitude denominator value.

TInt &aSecNumerator

on return, the seconds longitude numerator value.

TInt &aSecDenominator

on return, 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. KErrCorrupt if the gps longitude tag value of the metadata is corrupt.


GetGpsAltitudeRef()

IMPORT_C TInt GetGpsAltitudeRef(TUint8 &aParam) const;

Description

Gets the gps altitude reference tag value of the metadata.

Parameters

TUint8 &aParam

on return, the gps altitude reference.

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.


GetGpsAltitude()

IMPORT_C TInt GetGpsAltitude(TInt &aNumerator, TInt &aDenominator) const;

Description

Gets the gps altitude tag value of the metadata.

Parameters

TInt &aNumerator

on return, the gps altitude numerator value.

TInt &aDenominator

on return, the gps 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.


GetGpsTimeStamp()

IMPORT_C TInt GetGpsTimeStamp(TInt &aHourNumerator, TInt &aHourDenominator, TInt &aMinNumerator, TInt &aMinDenominator, TInt &aSecNumerator, TInt &aSecDenominator) const;

Description

Gets the gps time tag value of the metadata.

Parameters

TInt &aHourNumerator

on return, the gps hour numerator value.

TInt &aHourDenominator

on return, the gps hour denominator value.

TInt &aMinNumerator

on return, the gps minutes numerator value.

TInt &aMinDenominator

on return, the gps minutes denominator value.

TInt &aSecNumerator

on return, the gps seconds numerator value.

TInt &aSecDenominator

on return, the gps 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. KErrNoMemory if there was not enough memory available to complete the request. KErrCorrupt if the gps longitude tag value of the metadata is corrupt.


GetGpsSatellites()

IMPORT_C TInt GetGpsSatellites(HBufC8 *&aParam) const;

Description

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

Ownership of the buffer pointed to by aParam transfers to the client, which is therefore responsible for deleting the buffer when required. Note: The client should always initialise aParam to NULL, and the plugin should only assign to this parameter when ready to transfer ownership.

Parameters

HBufC8 *&aParam

on return, 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.


GetGpsStatus()

IMPORT_C TInt GetGpsStatus(HBufC8 *&aParam) const;

Description

Gets the gps receiver status tag value of the metadata.

Ownership of the buffer pointed to by aParam transfers to the client, which is therefore responsible for deleting the buffer when required. Note: The client should always initialise aParam to NULL, and the plugin should only assign to this parameter when ready to transfer ownership.

Parameters

HBufC8 *&aParam

on return, 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.


GetGpsMeasureMode()

IMPORT_C TInt GetGpsMeasureMode(HBufC8 *&aParam) const;

Description

Gets the gps measurement mode tag value of the metadata.

Ownership of the buffer pointed to by aParam transfers to the client, which is therefore responsible for deleting the buffer when required. Note: The client should always initialise aParam to NULL, and the plugin should only assign to this parameter when ready to transfer ownership.

Parameters

HBufC8 *&aParam

on return, 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.


GetGpsDop()

IMPORT_C TInt GetGpsDop(TInt &aNumerator, TInt &aDenominator) const;

Description

Gets the gps measurement precision tag value of the metadata.

Parameters

TInt &aNumerator

on return, the gps measurement precision numerator value.

TInt &aDenominator

on return, the gps 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.


GetGpsSpeedRef()

IMPORT_C TInt GetGpsSpeedRef(HBufC8 *&aParam) const;

Description

Gets the gps speed unit tag value of the metadata.

Ownership of the buffer pointed to by aParam transfers to the client, which is therefore responsible for deleting the buffer when required. Note: The client should always initialise aParam to NULL, and the plugin should only assign to this parameter when ready to transfer ownership.

Parameters

HBufC8 *&aParam

on return, the gps 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.


GetGpsSpeed()

IMPORT_C TInt GetGpsSpeed(TInt &aNumerator, TInt &aDenominator) const;

Description

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

Parameters

TInt &aNumerator

on return, the speed of gps receiver numerator value.

TInt &aDenominator

on return, 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.


GetGpsTrackRef()

IMPORT_C TInt GetGpsTrackRef(HBufC8 *&aParam) const;

Description

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

Ownership of the buffer pointed to by aParam transfers to the client, which is therefore responsible for deleting the buffer when required. Note: The client should always initialise aParam to NULL, and the plugin should only assign to this parameter when ready to transfer ownership.

Parameters

HBufC8 *&aParam

on return, 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.


GetGpsTrack()

IMPORT_C TInt GetGpsTrack(TInt &aNumerator, TInt &aDenominator) const;

Description

Gets the gps direction of movement tag value of the metadata.

Parameters

TInt &aNumerator

on return, the gps direction of movement numerator value.

TInt &aDenominator

on return, the gps 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.


GetGpsImgDirectionRef()

IMPORT_C TInt GetGpsImgDirectionRef(HBufC8 *&aParam) const;

Description

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

Ownership of the buffer pointed to by aParam transfers to the client, which is therefore responsible for deleting the buffer when required. Note: The client should always initialise aParam to NULL, and the plugin should only assign to this parameter when ready to transfer ownership.

Parameters

HBufC8 *&aParam

on return, 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.


GetGpsImgDirection()

IMPORT_C TInt GetGpsImgDirection(TInt &aNumerator, TInt &aDenominator) const;

Description

Gets the gps direction of image tag value of the metadata.

Parameters

TInt &aNumerator

on return, the gps direction of image numerator value.

TInt &aDenominator

on return, the gps 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.


GetGpsMapDatum()

IMPORT_C TInt GetGpsMapDatum(HBufC8 *&aParam) const;

Description

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

Ownership of the buffer pointed to by aParam transfers to the client, which is therefore responsible for deleting the buffer when required. Note: The client should always initialise aParam to NULL, and the plugin should only assign to this parameter when ready to transfer ownership.

Parameters

HBufC8 *&aParam

on return, 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.


GetGpsDestLatitudeRef()

IMPORT_C TInt GetGpsDestLatitudeRef(HBufC8 *&aParam) const;

Description

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

Ownership of the buffer pointed to by aParam transfers to the client, which is therefore responsible for deleting the buffer when required. Note: The client should always initialise aParam to NULL, and the plugin should only assign to this parameter when ready to transfer ownership.

Parameters

HBufC8 *&aParam

on return, 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.


GetGpsDestLatitude()

IMPORT_C TInt GetGpsDestLatitude(TInt &aDegNumerator, TInt &aDegDenominator, TInt &aMinNumerator, TInt &aMinDenominator, TInt &aSecNumerator, TInt &aSecDenominator) const;

Description

Gets 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.


GetGpsDestLongitudeRef()

IMPORT_C TInt GetGpsDestLongitudeRef(HBufC8 *&aParam) const;

Description

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

Ownership of the buffer pointed to by aParam transfers to the client, which is therefore responsible for deleting the buffer when required. Note: The client should always initialise aParam to NULL, and the plugin should only assign to this parameter when ready to transfer ownership.

Parameters

HBufC8 *&aParam

on return, the gps 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.


GetGpsDestLongitude()

IMPORT_C TInt GetGpsDestLongitude(TInt &aDegNumerator, TInt &aDegDenominator, TInt &aMinNumerator, TInt &aMinDenominator, TInt &aSecNumerator, TInt &aSecDenominator) const;

Description

Gets 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.


GetGpsDestBearingRef()

IMPORT_C TInt GetGpsDestBearingRef(HBufC8 *&aParam) const;

Description

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

Ownership of the buffer pointed to by aParam transfers to the client, which is therefore responsible for deleting the buffer when required. Note: The client should always initialise aParam to NULL, and the plugin should only assign to this parameter when ready to transfer ownership.

Parameters

HBufC8 *&aParam

on return, 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.


GetGpsDestBearing()

IMPORT_C TInt GetGpsDestBearing(TInt &aNumerator, TInt &aDenominator) const;

Description

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

Parameters

TInt &aNumerator

on return, the bearing of destination numerator value.

TInt &aDenominator

on return, 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.


GetGpsDestDistanceRef()

IMPORT_C TInt GetGpsDestDistanceRef(HBufC8 *&aParam) const;

Description

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

Ownership of the buffer pointed to by aParam transfers to the client, which is therefore responsible for deleting the buffer when required. Note: The client should always initialise aParam to NULL, and the plugin should only assign to this parameter when ready to transfer ownership.

Parameters

HBufC8 *&aParam

on return, 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.


GetGpsDestDistance()

IMPORT_C TInt GetGpsDestDistance(TInt &aNumerator, TInt &aDenominator) const;

Description

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

Parameters

TInt &aNumerator

on return, the distance to destination numerator value.

TInt &aDenominator

on return, 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.


GetGpsProcessingMethod()

IMPORT_C TInt GetGpsProcessingMethod(HBufC8 *&aParam) const;

Description

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

Ownership of the buffer pointed to by aParam transfers to the client, which is therefore responsible for deleting the buffer when required. Note: The client should always initialise aParam to NULL, and the plugin should only assign to this parameter when ready to transfer ownership.

Note: According to the Exif 2.2 specification, the first 8 bytes of aParam should 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 *&aParam

on return, 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.


GetGpsAreaInformation()

IMPORT_C TInt GetGpsAreaInformation(HBufC8 *&aParam) const;

Description

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

Ownership of the buffer pointed to by aParam transfers to the client, which is therefore responsible for deleting the buffer when required. Note: The client should always initialise aParam to NULL, and the plugin should only assign to this parameter when ready to transfer ownership.

Note: According to the Exif 2.2 specification, the first 8 bytes of aParam should 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 *&aParam

on return, 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.


GetGpsDateStamp()

IMPORT_C TInt GetGpsDateStamp(HBufC8 *&aParam) const;

Description

Gets the gps date tag value of the metadata.

Ownership of the buffer pointed to by aParam transfers to the client, which is therefore responsible for deleting the buffer when required. Note: The client should always initialise aParam to NULL, and the plugin should only assign to this parameter when ready to transfer ownership.

Parameters

HBufC8 *&aParam

on return, 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.


GetGpsDifferential()

IMPORT_C TInt GetGpsDifferential(TUint16 &aParam) const;

Description

Gets the gps differential correction tag value of the metadata.

Parameters

TUint16 &aParam

on return, 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.