»
Symbian OS v9.3 »
Symbian OS reference »
C++ component reference »
Multimedia ICL »
TExifReaderUtility
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;
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
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
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
![[Index]](../../../../a_stock/btn_index_wt.gif){kind=small}
![[Spacer]](../../../../a_stock/btn_spacer.gif){kind=small}
![[Previous]](../../../../a_stock/btn_prev_wt.gif){kind=small}
![[Next]](../../../../a_stock/btn_next_wt.gif){kind=small}
![[Top]](../../../../a_stock/arrow_up_2.gif){kind=icon}
![[Previous]](../../../../a_stock/btn_prev.gif){kind=small}
![[Top]](../../../../a_stock/btn_top.gif)
![[Next]](../../../../a_stock/btn_next.gif){kind=small}