#include <exifutility.h>
Link against: exifutility.lib
| class TExifReaderUtility |
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.
| IMPORT_C | TExifReaderUtility | ( | MExifMetadataReader * | aExifMetadataReader | ) |
Constructor
Instantiates the exif reader utility. Note: no method on this utility should be used after the metadate has been destroyed
| Parameters | |
|---|---|
| aExifMetadataReader | the metadata class on which to read the tags |
Gets the colorSpace tag value of the metadata.
| Parameters | |
|---|---|
| aParam | on return, the colorSpace value |
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 | |
|---|---|
| aParam | on return, the ComponentConfiguration value |
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 | |
|---|---|
| aParam | on return, the copyright value. |
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 | |
|---|---|
| aParam | on return, the dateTime value |
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 | |
|---|---|
| aParam | on return, the dateTimeDigitized value |
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 | |
|---|---|
| aParam | on return, the dateTimeOriginal value |
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 | |
|---|---|
| aParam | on return, the exifVersion value |
Gets the flash tag value of the metadata.
| Parameters | |
|---|---|
| aParam | on return, the flash value. |
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 | |
|---|---|
| aParam | on return, the flashpixVersion value |
Gets the focal length tag value of the metadata.
| Parameters | |
|---|---|
| aNumerator | on return, the focal length numerator value. |
| aDenominator | on return, the focal length denominator value. |
Gets the gps altitude tag value of the metadata.
| Parameters | |
|---|---|
| aNumerator | on return, the gps altitude numerator value. |
| aDenominator | on return, the gps altitude denominator value. |
Gets the gps altitude reference tag value of the metadata.
| Parameters | |
|---|---|
| aParam | on return, the gps altitude reference. |
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 | |
|---|---|
| aParam | on return, the name of gps area value. |
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 | |
|---|---|
| aParam | on return, the gps date value. |
Gets the gps bearing of destination tag value of the metadata.
| Parameters | |
|---|---|
| aNumerator | on return, the bearing of destination numerator value. |
| aDenominator | on return, the bearing of destination denominator value. |
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 | |
|---|---|
| aParam | on return, the reference for bearing of destination value. |
Gets the gps distance to destination tag value of the metadata.
| Parameters | |
|---|---|
| aNumerator | on return, the distance to destination numerator value. |
| aDenominator | on return, the distance to destination denominator value. |
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 | |
|---|---|
| aParam | on return, the reference for distance to destination value. |
| IMPORT_C TInt | GetGpsDestLatitude | ( | 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 | |
|---|---|
| aDegNumerator | on return, the degrees latitude of destination numerator value. |
| aDegDenominator | on return, the degrees latitude of destination denominator value. |
| aMinNumerator | on return, the minutes latitude of destination numerator value. |
| aMinDenominator | on return, the minutes latitude of destination denominator value. |
| aSecNumerator | on return, the seconds latitude of destination numerator value. |
| aSecDenominator | on return, the seconds latitude of destination denominator value. |
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 | |
|---|---|
| aParam | on return, the reference for latitude of destination value. |
| IMPORT_C TInt | GetGpsDestLongitude | ( | 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 | |
|---|---|
| aDegNumerator | on return, the degrees longitude of destination numerator value. |
| aDegDenominator | on return, the degrees longitude of destination denominator value. |
| aMinNumerator | on return, the minutes longitude of destination numerator value. |
| aMinDenominator | on return, the minutes longitude of destination denominator value. |
| aSecNumerator | on return, the seconds longitude of destination numerator value. |
| aSecDenominator | on return, the seconds longitude of destination denominator value. |
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 | |
|---|---|
| aParam | on return, the gps reference for longitude of destination value. |
Gets the gps differential correction tag value of the metadata.
| Parameters | |
|---|---|
| aParam | on return, the gps differential correction value. |
Gets the gps measurement precision tag value of the metadata.
| Parameters | |
|---|---|
| aNumerator | on return, the gps measurement precision numerator value. |
| aDenominator | on return, the gps measurement precision denominator value. |
Gets the gps direction of image tag value of the metadata.
| Parameters | |
|---|---|
| aNumerator | on return, the gps direction of image numerator value. |
| aDenominator | on return, the gps direction of image denominator value. |
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 | |
|---|---|
| aParam | on return, the gps reference for direction of image value. |
| IMPORT_C TInt | GetGpsLatitude | ( | TInt & | aDegNumerator, |
| TInt & | aDegDenominator, | |||
| TInt & | aMinNumerator, | |||
| TInt & | aMinDenominator, | |||
| TInt & | aSecNumerator, | |||
| TInt & | aSecDenominator | |||
| ) | const | |||
Gets the gps latitude tag value of the metadata.
| Parameters | |
|---|---|
| aDegNumerator | on return, the degrees latitude numerator value. |
| aDegDenominator | on return, the degrees latitude denominator value. |
| aMinNumerator | on return, the minutes latitude numerator value. |
| aMinDenominator | on return, the minutes latitude denominator value. |
| aSecNumerator | on return, the seconds latitude numerator value. |
| aSecDenominator | on return, the seconds latitude denominator value. |
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 | |
|---|---|
| aParam | on return, the gps north or south latitude. |
| IMPORT_C TInt | GetGpsLongitude | ( | TInt & | aDegNumerator, |
| TInt & | aDegDenominator, | |||
| TInt & | aMinNumerator, | |||
| TInt & | aMinDenominator, | |||
| TInt & | aSecNumerator, | |||
| TInt & | aSecDenominator | |||
| ) | const | |||
Gets the gps longitude tag value of the metadata.
| Parameters | |
|---|---|
| aDegNumerator | on return, the degrees longitude numerator value. |
| aDegDenominator | on return, the degrees longitude denominator value. |
| aMinNumerator | on return, the minutes longitude numerator value. |
| aMinDenominator | on return, the minutes longitude denominator value. |
| aSecNumerator | on return, the seconds longitude numerator value. |
| aSecDenominator | on return, the seconds longitude denominator value. |
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 | |
|---|---|
| aParam | on return, the gps east or west longitude. |
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 | |
|---|---|
| aParam | on return, the geodetic survey data used value. |
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 | |
|---|---|
| aParam | on return, the gps measurement mode value. |
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 | |
|---|---|
| aParam | on return, the name of gps processing method value. |
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 | |
|---|---|
| aParam | on return, the gps satellites used for measurement value. |
Gets the speed of gps receiver tag value of the metadata.
| Parameters | |
|---|---|
| aNumerator | on return, the speed of gps receiver numerator value. |
| aDenominator | on return, the speed of gps receiver denominator value. |
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 | |
|---|---|
| aParam | on return, the gps speed unit value. |
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 | |
|---|---|
| aParam | on return, the gps receiver status value. |
| IMPORT_C TInt | GetGpsTimeStamp | ( | TInt & | aHourNumerator, |
| TInt & | aHourDenominator, | |||
| TInt & | aMinNumerator, | |||
| TInt & | aMinDenominator, | |||
| TInt & | aSecNumerator, | |||
| TInt & | aSecDenominator | |||
| ) | const | |||
Gets the gps time tag value of the metadata.
| Parameters | |
|---|---|
| aHourNumerator | on return, the gps hour numerator value. |
| aHourDenominator | on return, the gps hour denominator value. |
| aMinNumerator | on return, the gps minutes numerator value. |
| aMinDenominator | on return, the gps minutes denominator value. |
| aSecNumerator | on return, the gps seconds numerator value. |
| aSecDenominator | on return, the gps seconds denominator value. |
Gets the gps direction of movement tag value of the metadata.
| Parameters | |
|---|---|
| aNumerator | on return, the gps direction of movement numerator value. |
| aDenominator | on return, the gps direction of movement denominator value. |
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 | |
|---|---|
| aParam | on return, the gps reference for direction of movement value. |
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 | |
|---|---|
| aParam | on return, the gps version id. |
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 | |
|---|---|
| aParam | on return, the image description value. |
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 | |
|---|---|
| aParam | on return, the interoperabilityIndex value |
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 | |
|---|---|
| aParam | on return, the interoperabilityVersion value |
Gets the thumbnail jpeg interchange format length of the metadata.
Replaced by TExifReaderUtility::GetJpegInterchangeFormatLength(TUint& aParam).
| Parameters | |
|---|---|
| aParam | on return, the thumbnail jpeg interchange format length. |
Gets the thumbnail jpeg interchange format length of the metadata.
| Parameters | |
|---|---|
| aParam | on return, the thumbnail jpeg interchange format length. |
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 | |
|---|---|
| aParam | on return, the make value |
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 | |
|---|---|
| aParam | on return, the maker note value. |
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 | |
|---|---|
| aParam | on return, the model value |
Gets the main image orientation tag value of the metadata.
| Parameters | |
|---|---|
| aParam | on return, the main image orientation value |
Gets the pixelXDimension tag value of the metadata.
| Parameters | |
|---|---|
| aParam | on return, the pixelXDimension value |
Gets the pixelYDimension tag value of the metadata.
| Parameters | |
|---|---|
| aParam | on return, the pixelYDimension value |
Gets the main image resolutionUnit tag value of the metadata.
| Parameters | |
|---|---|
| aParam | on return, the main image resolutionUnit value |
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 | |
|---|---|
| aNumerator | on return, the shutter speed numerator value. |
| aDenominator | on return, the shutter speed denominator value. |
Gets the thumbnail compression tag value of the metadata.
| Parameters | |
|---|---|
| aParam | on return, the thumbnail compression value |
Gets the thumbnail orientation tag value of the metadata.
| Parameters | |
|---|---|
| aParam | on return, the thumbnail orientation value |
Gets the thumbnail resolutionUnit tag value of the metadata.
| Parameters | |
|---|---|
| aParam | on return, the thumbnail resolutionUnit value |
Gets the thumbnail xResolution tag value of the metadata.
| Parameters | |
|---|---|
| aNumerator | on return, the main thumbnail xResolution numerator value |
| aDenominator | on return, the main thumbnail xResolution denominator value |
Gets the thumbnail yResolution tag value of the metadata.
| Parameters | |
|---|---|
| aNumerator | on return, the main thumbnail yResolution numerator value |
| aDenominator | on return, the main thumbnail yResolution denominator value |
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 | |
|---|---|
| aParam | on return, the user comment value. |
Gets the main image xResolution tag value of the metadata.
| Parameters | |
|---|---|
| aNumerator | on return, the main image xResolution numerator value |
| aDenominator | on return, the main image xResolution denominator value |
Gets the yCbCrPositioning tag value of the metadata.
| Parameters | |
|---|---|
| aParam | on return, the yCbCrPositioning value |
Gets the main image yResolution tag value of the metadata.
| Parameters | |
|---|---|
| aNumerator | on return, the main image yResolution numerator value |
| aDenominator | on return, the main image yResolution denominator value |