TExifReaderUtility Class Reference

#include <exifutility.h>

Link against: exifutility.lib

class TExifReaderUtility
Public Member Functions
TExifReaderUtility(MExifMetadataReader *)
IMPORT_C TIntGetColorSpace(TUint16 &)
IMPORT_C TIntGetComponentsConfiguration(HBufC8 *&)
IMPORT_C TIntGetCopyright(HBufC8 *&)
IMPORT_C TIntGetDateTime(HBufC8 *&)
IMPORT_C TIntGetDateTimeDigitized(HBufC8 *&)
IMPORT_C TIntGetDateTimeOriginal(HBufC8 *&)
IMPORT_C TIntGetExifVersion(HBufC8 *&)
IMPORT_C TIntGetFlash(TUint16 &)
IMPORT_C TIntGetFlashPixVersion(HBufC8 *&)
IMPORT_C TIntGetFocalLength(TInt &, TInt &)
IMPORT_C TIntGetGpsAltitude(TInt &, TInt &)
IMPORT_C TIntGetGpsAltitudeRef(TUint8 &)
IMPORT_C TIntGetGpsAreaInformation(HBufC8 *&)
IMPORT_C TIntGetGpsDateStamp(HBufC8 *&)
IMPORT_C TIntGetGpsDestBearing(TInt &, TInt &)
IMPORT_C TIntGetGpsDestBearingRef(HBufC8 *&)
IMPORT_C TIntGetGpsDestDistance(TInt &, TInt &)
IMPORT_C TIntGetGpsDestDistanceRef(HBufC8 *&)
IMPORT_C TIntGetGpsDestLatitude(TInt &, TInt &, TInt &, TInt &, TInt &, TInt &)
IMPORT_C TIntGetGpsDestLatitudeRef(HBufC8 *&)
IMPORT_C TIntGetGpsDestLongitude(TInt &, TInt &, TInt &, TInt &, TInt &, TInt &)
IMPORT_C TIntGetGpsDestLongitudeRef(HBufC8 *&)
IMPORT_C TIntGetGpsDifferential(TUint16 &)
IMPORT_C TIntGetGpsDop(TInt &, TInt &)
IMPORT_C TIntGetGpsImgDirection(TInt &, TInt &)
IMPORT_C TIntGetGpsImgDirectionRef(HBufC8 *&)
IMPORT_C TIntGetGpsLatitude(TInt &, TInt &, TInt &, TInt &, TInt &, TInt &)
IMPORT_C TIntGetGpsLatitudeRef(HBufC8 *&)
IMPORT_C TIntGetGpsLongitude(TInt &, TInt &, TInt &, TInt &, TInt &, TInt &)
IMPORT_C TIntGetGpsLongitudeRef(HBufC8 *&)
IMPORT_C TIntGetGpsMapDatum(HBufC8 *&)
IMPORT_C TIntGetGpsMeasureMode(HBufC8 *&)
IMPORT_C TIntGetGpsProcessingMethod(HBufC8 *&)
IMPORT_C TIntGetGpsSatellites(HBufC8 *&)
IMPORT_C TIntGetGpsSpeed(TInt &, TInt &)
IMPORT_C TIntGetGpsSpeedRef(HBufC8 *&)
IMPORT_C TIntGetGpsStatus(HBufC8 *&)
IMPORT_C TIntGetGpsTimeStamp(TInt &, TInt &, TInt &, TInt &, TInt &, TInt &)
IMPORT_C TIntGetGpsTrack(TInt &, TInt &)
IMPORT_C TIntGetGpsTrackRef(HBufC8 *&)
IMPORT_C TIntGetGpsVersionId(HBufC8 *&)
IMPORT_C TIntGetImageDescription(HBufC8 *&)
IMPORT_C TIntGetInteroperabilityIndex(HBufC8 *&)
IMPORT_C TIntGetInteroperabilityVersion(HBufC8 *&)
IMPORT_C TIntGetJpegInterchangeFormatLength(TInt &)
IMPORT_C TIntGetJpegInterchangeFormatLength(TUint &)
IMPORT_C TIntGetMake(HBufC8 *&)
IMPORT_C TIntGetMakerNote(HBufC8 *&)
IMPORT_C TIntGetModel(HBufC8 *&)
IMPORT_C TIntGetOrientation(TUint16 &)
IMPORT_C TIntGetPixelXDimension(TInt &)
IMPORT_C TIntGetPixelYDimension(TInt &)
IMPORT_C TIntGetResolutionUnit(TUint16 &)
IMPORT_C TIntGetShutterSpeedValue(TInt &, TInt &)
IMPORT_C TIntGetThumbCompression(TUint16 &)
IMPORT_C TIntGetThumbOrientation(TUint16 &)
IMPORT_C TIntGetThumbResolutionUnit(TUint16 &)
IMPORT_C TIntGetThumbXResolution(TInt &, TInt &)
IMPORT_C TIntGetThumbYResolution(TInt &, TInt &)
IMPORT_C TIntGetUserComment(HBufC8 *&)
IMPORT_C TIntGetXResolution(TInt &, TInt &)
IMPORT_C TIntGetYCbCrPositioning(TUint16 &)
IMPORT_C TIntGetYResolution(TInt &, TInt &)

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

Constructor & Destructor Documentation

TExifReaderUtility ( MExifMetadataReader * )

IMPORT_CTExifReaderUtility(MExifMetadataReader *aExifMetadataReader)

Constructor

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

Parameters
aExifMetadataReaderthe metadata class on which to read the tags

Member Function Documentation

GetColorSpace ( TUint16 & )

IMPORT_C TIntGetColorSpace(TUint16 &aParam)const

Gets the colorSpace tag value of the metadata.

Parameters
aParamon return, the 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.

GetComponentsConfiguration ( HBufC8 *& )

IMPORT_C TIntGetComponentsConfiguration(HBufC8 *&aParam)const

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

GetCopyright ( HBufC8 *& )

IMPORT_C TIntGetCopyright(HBufC8 *&aParam)const

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

GetDateTime ( HBufC8 *& )

IMPORT_C TIntGetDateTime(HBufC8 *&aParam)const

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

GetDateTimeDigitized ( HBufC8 *& )

IMPORT_C TIntGetDateTimeDigitized(HBufC8 *&aParam)const

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

GetDateTimeOriginal ( HBufC8 *& )

IMPORT_C TIntGetDateTimeOriginal(HBufC8 *&aParam)const

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

GetExifVersion ( HBufC8 *& )

IMPORT_C TIntGetExifVersion(HBufC8 *&aParam)const

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

GetFlash ( TUint16 & )

IMPORT_C TIntGetFlash(TUint16 &aParam)const

Gets the flash tag value of the metadata.

Parameters
aParamon return, the 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.

GetFlashPixVersion ( HBufC8 *& )

IMPORT_C TIntGetFlashPixVersion(HBufC8 *&aParam)const

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

GetFocalLength ( TInt &, TInt & )

IMPORT_C TIntGetFocalLength(TInt &aNumerator,
TInt &aDenominator
)const

Gets the focal length tag value of the metadata.

Parameters
aNumeratoron return, the focal length numerator value.
aDenominatoron return, the 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.

GetGpsAltitude ( TInt &, TInt & )

IMPORT_C TIntGetGpsAltitude(TInt &aNumerator,
TInt &aDenominator
)const

Gets the gps altitude tag value of the metadata.

Parameters
aNumeratoron return, the gps altitude numerator value.
aDenominatoron return, the gps 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.

GetGpsAltitudeRef ( TUint8 & )

IMPORT_C TIntGetGpsAltitudeRef(TUint8 &aParam)const

Gets the gps altitude reference tag value of the metadata.

Parameters
aParamon return, the gps altitude reference.
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.

GetGpsAreaInformation ( HBufC8 *& )

IMPORT_C TIntGetGpsAreaInformation(HBufC8 *&aParam)const

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

GetGpsDateStamp ( HBufC8 *& )

IMPORT_C TIntGetGpsDateStamp(HBufC8 *&aParam)const

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

GetGpsDestBearing ( TInt &, TInt & )

IMPORT_C TIntGetGpsDestBearing(TInt &aNumerator,
TInt &aDenominator
)const

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

Parameters
aNumeratoron return, the bearing of destination numerator value.
aDenominatoron return, the 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.

GetGpsDestBearingRef ( HBufC8 *& )

IMPORT_C TIntGetGpsDestBearingRef(HBufC8 *&aParam)const

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

GetGpsDestDistance ( TInt &, TInt & )

IMPORT_C TIntGetGpsDestDistance(TInt &aNumerator,
TInt &aDenominator
)const

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

Parameters
aNumeratoron return, the distance to destination numerator value.
aDenominatoron return, the 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.

GetGpsDestDistanceRef ( HBufC8 *& )

IMPORT_C TIntGetGpsDestDistanceRef(HBufC8 *&aParam)const

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

GetGpsDestLatitude ( TInt &, TInt &, TInt &, TInt &, TInt &, TInt & )

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

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

GetGpsDestLatitudeRef ( HBufC8 *& )

IMPORT_C TIntGetGpsDestLatitudeRef(HBufC8 *&aParam)const

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

GetGpsDestLongitude ( TInt &, TInt &, TInt &, TInt &, TInt &, TInt & )

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

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

GetGpsDestLongitudeRef ( HBufC8 *& )

IMPORT_C TIntGetGpsDestLongitudeRef(HBufC8 *&aParam)const

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

GetGpsDifferential ( TUint16 & )

IMPORT_C TIntGetGpsDifferential(TUint16 &aParam)const

Gets the gps differential correction tag value of the metadata.

Parameters
aParamon return, the 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.

GetGpsDop ( TInt &, TInt & )

IMPORT_C TIntGetGpsDop(TInt &aNumerator,
TInt &aDenominator
)const

Gets the gps measurement precision tag value of the metadata.

Parameters
aNumeratoron return, the gps measurement precision numerator value.
aDenominatoron return, the gps 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.

GetGpsImgDirection ( TInt &, TInt & )

IMPORT_C TIntGetGpsImgDirection(TInt &aNumerator,
TInt &aDenominator
)const

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

Parameters
aNumeratoron return, the gps direction of image numerator value.
aDenominatoron return, the gps 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.

GetGpsImgDirectionRef ( HBufC8 *& )

IMPORT_C TIntGetGpsImgDirectionRef(HBufC8 *&aParam)const

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

GetGpsLatitude ( TInt &, TInt &, TInt &, TInt &, TInt &, TInt & )

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

Gets the gps latitude tag value of the metadata.

Parameters
aDegNumeratoron return, the degrees latitude numerator value.
aDegDenominatoron return, the degrees latitude denominator value.
aMinNumeratoron return, the minutes latitude numerator value.
aMinDenominatoron return, the minutes latitude denominator value.
aSecNumeratoron return, the seconds latitude numerator value.
aSecDenominatoron return, the 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. KErrCorrupt if the gps latitude tag value of the metadata is corrupt.

GetGpsLatitudeRef ( HBufC8 *& )

IMPORT_C TIntGetGpsLatitudeRef(HBufC8 *&aParam)const

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
aParamon return, the gps north or south latitude.
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.

GetGpsLongitude ( TInt &, TInt &, TInt &, TInt &, TInt &, TInt & )

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

Gets the gps longitude tag value of the metadata.

Parameters
aDegNumeratoron return, the degrees longitude numerator value.
aDegDenominatoron return, the degrees longitude denominator value.
aMinNumeratoron return, the minutes longitude numerator value.
aMinDenominatoron return, the minutes longitude denominator value.
aSecNumeratoron return, the seconds longitude numerator value.
aSecDenominatoron return, the 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. KErrCorrupt if the gps longitude tag value of the metadata is corrupt.

GetGpsLongitudeRef ( HBufC8 *& )

IMPORT_C TIntGetGpsLongitudeRef(HBufC8 *&aParam)const

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
aParamon return, the gps east or west longitude.
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.

GetGpsMapDatum ( HBufC8 *& )

IMPORT_C TIntGetGpsMapDatum(HBufC8 *&aParam)const

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

GetGpsMeasureMode ( HBufC8 *& )

IMPORT_C TIntGetGpsMeasureMode(HBufC8 *&aParam)const

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

GetGpsProcessingMethod ( HBufC8 *& )

IMPORT_C TIntGetGpsProcessingMethod(HBufC8 *&aParam)const

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

GetGpsSatellites ( HBufC8 *& )

IMPORT_C TIntGetGpsSatellites(HBufC8 *&aParam)const

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

GetGpsSpeed ( TInt &, TInt & )

IMPORT_C TIntGetGpsSpeed(TInt &aNumerator,
TInt &aDenominator
)const

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

Parameters
aNumeratoron return, the speed of gps receiver numerator value.
aDenominatoron return, the 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.

GetGpsSpeedRef ( HBufC8 *& )

IMPORT_C TIntGetGpsSpeedRef(HBufC8 *&aParam)const

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

GetGpsStatus ( HBufC8 *& )

IMPORT_C TIntGetGpsStatus(HBufC8 *&aParam)const

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

GetGpsTimeStamp ( TInt &, TInt &, TInt &, TInt &, TInt &, TInt & )

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

Gets the gps time tag value of the metadata.

Parameters
aHourNumeratoron return, the gps hour numerator value.
aHourDenominatoron return, the gps hour denominator value.
aMinNumeratoron return, the gps minutes numerator value.
aMinDenominatoron return, the gps minutes denominator value.
aSecNumeratoron return, the gps seconds numerator value.
aSecDenominatoron return, the gps 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. KErrNoMemory if there was not enough memory available to complete the request. KErrCorrupt if the gps longitude tag value of the metadata is corrupt.

GetGpsTrack ( TInt &, TInt & )

IMPORT_C TIntGetGpsTrack(TInt &aNumerator,
TInt &aDenominator
)const

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

Parameters
aNumeratoron return, the gps direction of movement numerator value.
aDenominatoron return, the gps 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.

GetGpsTrackRef ( HBufC8 *& )

IMPORT_C TIntGetGpsTrackRef(HBufC8 *&aParam)const

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

GetGpsVersionId ( HBufC8 *& )

IMPORT_C TIntGetGpsVersionId(HBufC8 *&aParam)const

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
aParamon return, the gps version id.
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.

GetImageDescription ( HBufC8 *& )

IMPORT_C TIntGetImageDescription(HBufC8 *&aParam)const

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

GetInteroperabilityIndex ( HBufC8 *& )

IMPORT_C TIntGetInteroperabilityIndex(HBufC8 *&aParam)const

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

GetInteroperabilityVersion ( HBufC8 *& )

IMPORT_C TIntGetInteroperabilityVersion(HBufC8 *&aParam)const

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

GetJpegInterchangeFormatLength ( TInt & )

IMPORT_C TIntGetJpegInterchangeFormatLength(TInt &aParam)const

Gets the thumbnail jpeg interchange format length of the metadata.

Deprecated
  • Replaced by TExifReaderUtility::GetJpegInterchangeFormatLength(TUint& aParam).

Parameters
aParamon return, the thumbnail jpeg interchange format length.
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.

GetJpegInterchangeFormatLength ( TUint & )

IMPORT_C TIntGetJpegInterchangeFormatLength(TUint &aParam)const

Gets the thumbnail jpeg interchange format length of the metadata.

Parameters
aParamon return, the thumbnail jpeg interchange format length.
Return Value
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.

GetMake ( HBufC8 *& )

IMPORT_C TIntGetMake(HBufC8 *&aParam)const

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

GetMakerNote ( HBufC8 *& )

IMPORT_C TIntGetMakerNote(HBufC8 *&aParam)const

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

GetModel ( HBufC8 *& )

IMPORT_C TIntGetModel(HBufC8 *&aParam)const

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

GetOrientation ( TUint16 & )

IMPORT_C TIntGetOrientation(TUint16 &aParam)const

Gets the main image orientation tag value of the metadata.

Parameters
aParamon return, the 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.

GetPixelXDimension ( TInt & )

IMPORT_C TIntGetPixelXDimension(TInt &aParam)const

Gets the pixelXDimension tag value of the metadata.

Parameters
aParamon return, the 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.

GetPixelYDimension ( TInt & )

IMPORT_C TIntGetPixelYDimension(TInt &aParam)const

Gets the pixelYDimension tag value of the metadata.

Parameters
aParamon return, the 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.

GetResolutionUnit ( TUint16 & )

IMPORT_C TIntGetResolutionUnit(TUint16 &aParam)const

Gets the main image resolutionUnit tag value of the metadata.

Parameters
aParamon return, the 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.

GetShutterSpeedValue ( TInt &, TInt & )

IMPORT_C TIntGetShutterSpeedValue(TInt &aNumerator,
TInt &aDenominator
)const

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
aNumeratoron return, the shutter speed numerator value.
aDenominatoron return, the 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.

GetThumbCompression ( TUint16 & )

IMPORT_C TIntGetThumbCompression(TUint16 &aParam)const

Gets the thumbnail compression tag value of the metadata.

Parameters
aParamon return, the 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.

GetThumbOrientation ( TUint16 & )

IMPORT_C TIntGetThumbOrientation(TUint16 &aParam)const

Gets the thumbnail orientation tag value of the metadata.

Parameters
aParamon return, the 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.

GetThumbResolutionUnit ( TUint16 & )

IMPORT_C TIntGetThumbResolutionUnit(TUint16 &aParam)const

Gets the thumbnail resolutionUnit tag value of the metadata.

Parameters
aParamon return, the 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.

GetThumbXResolution ( TInt &, TInt & )

IMPORT_C TIntGetThumbXResolution(TInt &aNumerator,
TInt &aDenominator
)const

Gets the thumbnail xResolution tag value of the metadata.

Parameters
aNumeratoron return, the main thumbnail xResolution numerator value
aDenominatoron return, the main thumbnail xResolution 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.

GetThumbYResolution ( TInt &, TInt & )

IMPORT_C TIntGetThumbYResolution(TInt &aNumerator,
TInt &aDenominator
)const

Gets the thumbnail yResolution tag value of the metadata.

Parameters
aNumeratoron return, the main thumbnail yResolution numerator value
aDenominatoron return, the main thumbnail yResolution 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.

GetUserComment ( HBufC8 *& )

IMPORT_C TIntGetUserComment(HBufC8 *&aParam)const

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

GetXResolution ( TInt &, TInt & )

IMPORT_C TIntGetXResolution(TInt &aNumerator,
TInt &aDenominator
)const

Gets the main image xResolution tag value of the metadata.

Parameters
aNumeratoron return, the main image xResolution numerator value
aDenominatoron return, the main image xResolution 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.

GetYCbCrPositioning ( TUint16 & )

IMPORT_C TIntGetYCbCrPositioning(TUint16 &aParam)const

Gets the yCbCrPositioning tag value of the metadata.

Parameters
aParamon return, the 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.

GetYResolution ( TInt &, TInt & )

IMPORT_C TIntGetYResolution(TInt &aNumerator,
TInt &aDenominator
)const

Gets the main image yResolution tag value of the metadata.

Parameters
aNumeratoron return, the main image yResolution numerator value
aDenominatoron return, the main image yResolution 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.