williamr@2: // Copyright (c) 2004-2009 Nokia Corporation and/or its subsidiary(-ies).
williamr@2: // All rights reserved.
williamr@2: // This component and the accompanying materials are made available
williamr@2: // under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
williamr@2: // which accompanies this distribution, and is available
williamr@2: // at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
williamr@2: //
williamr@2: // Initial Contributors:
williamr@2: // Nokia Corporation - initial contribution.
williamr@2: //
williamr@2: // Contributors:
williamr@2: //
williamr@2: // Description:
williamr@2: // ExifUtilty.h
williamr@2: // 
williamr@2: //
williamr@2: 
williamr@2: #ifndef __EXIFUTILITY_H__
williamr@2: #define __EXIFUTILITY_H__
williamr@2: 
williamr@2: class MExifMetadataReader;
williamr@2: class MExifMetadataWriter;
williamr@2: 
williamr@2: 
williamr@2: /**
williamr@2: @publishedAll
williamr@2: @released
williamr@2: 
williamr@2: This class offers a friendly interface to read the metadata in exif encoded image files
williamr@2: 
williamr@2: 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.
williamr@2: In such cases, proper typecasting should be used to ensure that the values are correctly treated as unsigned.
williamr@2: 
williamr@2: Note: Get method arguments will only be updated if the method is returning KErrNone.
williamr@2: 
williamr@2: */
williamr@2: class TExifReaderUtility 
williamr@2: 	{
williamr@2: public:
williamr@2: 	// Construction and destruction
williamr@2: 	IMPORT_C TExifReaderUtility(MExifMetadataReader* aExifMetadataReader);
williamr@2: 	
williamr@2: public:
williamr@2: 	// Getters
williamr@2: 	IMPORT_C TInt GetMake(HBufC8*& aParam) const;
williamr@2: 	IMPORT_C TInt GetModel(HBufC8*& aParam) const;
williamr@2: 	IMPORT_C TInt GetDateTime(HBufC8*& aParam) const;
williamr@2: 	IMPORT_C TInt GetDateTimeOriginal(HBufC8*& aParam) const;
williamr@2: 	IMPORT_C TInt GetDateTimeDigitized(HBufC8*& aParam) const;
williamr@2: 	IMPORT_C TInt GetInteroperabilityIndex(HBufC8*& aParam) const;
williamr@2: 	IMPORT_C TInt GetInteroperabilityVersion(HBufC8*& aParam) const;
williamr@2: 
williamr@2: 	IMPORT_C TInt GetExifVersion(HBufC8*& aParam) const;
williamr@2: 	IMPORT_C TInt GetComponentsConfiguration(HBufC8*& aParam) const;
williamr@2: 	IMPORT_C TInt GetFlashPixVersion(HBufC8*& aParam) const;
williamr@2: 
williamr@2: 	IMPORT_C TInt GetXResolution(TInt& aNumerator, TInt& aDenominator) const;
williamr@2: 	IMPORT_C TInt GetYResolution(TInt& aNumerator, TInt& aDenominator) const;
williamr@2: 	IMPORT_C TInt GetThumbXResolution(TInt& aNumerator, TInt& aDenominator) const;
williamr@2: 	IMPORT_C TInt GetThumbYResolution(TInt& aNumerator, TInt& aDenominator) const;
williamr@2: 
williamr@2: 	IMPORT_C TInt GetResolutionUnit(TUint16& aParam) const;
williamr@2: 	IMPORT_C TInt GetYCbCrPositioning(TUint16& aParam) const;
williamr@2: 	IMPORT_C TInt GetOrientation(TUint16& aParam) const;
williamr@2: 	IMPORT_C TInt GetColorSpace(TUint16& aParam) const;
williamr@2: 	IMPORT_C TInt GetPixelXDimension(TInt& aParam) const;
williamr@2: 	IMPORT_C TInt GetPixelYDimension(TInt& aParam) const;
williamr@2: 
williamr@2: 	IMPORT_C TInt GetThumbCompression(TUint16& aParam) const;
williamr@2: 	IMPORT_C TInt GetThumbResolutionUnit(TUint16& aParam) const;
williamr@2: 	IMPORT_C TInt GetThumbOrientation(TUint16& aParam) const;
williamr@2: 	
williamr@2: 	IMPORT_C TInt GetImageDescription(HBufC8*& aParam) const;
williamr@2: 	IMPORT_C TInt GetCopyright(HBufC8*& aParam) const;
williamr@2: 	IMPORT_C TInt GetMakerNote(HBufC8*& aParam) const;
williamr@2: 	IMPORT_C TInt GetUserComment(HBufC8*& aParam) const;
williamr@2: 	IMPORT_C TInt GetFlash(TUint16& aParam) const;
williamr@2: 	IMPORT_C TInt GetFocalLength(TInt& aNumerator, TInt& aDenominator) const;
williamr@2: 	IMPORT_C TInt GetShutterSpeedValue(TInt& aNumerator, TInt& aDenominator) const;
williamr@2: 	IMPORT_C TInt GetJpegInterchangeFormatLength(TInt& aParam) const;
williamr@2: 	IMPORT_C TInt GetJpegInterchangeFormatLength(TUint& aParam) const;
williamr@2: 
williamr@2: 	IMPORT_C TInt GetGpsVersionId(HBufC8*& aParam) const;
williamr@2: 	IMPORT_C TInt GetGpsLatitudeRef(HBufC8*& aParam) const;
williamr@2: 	IMPORT_C TInt GetGpsLatitude(TInt& aDegNumerator, TInt& aDegDenominator, TInt& aMinNumerator, TInt& aMinDenominator, TInt& aSecNumerator, TInt& aSecDenominator) const;
williamr@2: 	IMPORT_C TInt GetGpsLongitudeRef(HBufC8*& aParam) const;
williamr@2: 	IMPORT_C TInt GetGpsLongitude(TInt& aDegNumerator, TInt& aDegDenominator, TInt& aMinNumerator, TInt& aMinDenominator, TInt& aSecNumerator, TInt& aSecDenominator) const;
williamr@2: 	IMPORT_C TInt GetGpsAltitudeRef(TUint8& aParam) const;
williamr@2: 	IMPORT_C TInt GetGpsAltitude(TInt& aNumerator, TInt& aDenominator) const;
williamr@2: 	IMPORT_C TInt GetGpsTimeStamp(TInt& aHourNumerator, TInt& aHourDenominator, TInt& aMinNumerator, TInt& aMinDenominator, TInt& aSecNumerator, TInt& aSecDenominator) const;
williamr@2: 	IMPORT_C TInt GetGpsSatellites(HBufC8*& aParam) const;
williamr@2: 	IMPORT_C TInt GetGpsStatus(HBufC8*& aParam) const;
williamr@2: 	IMPORT_C TInt GetGpsMeasureMode(HBufC8*& aParam) const;
williamr@2: 	IMPORT_C TInt GetGpsDop(TInt& aNumerator, TInt& aDenominator) const;
williamr@2: 	IMPORT_C TInt GetGpsSpeedRef(HBufC8*& aParam) const;
williamr@2: 	IMPORT_C TInt GetGpsSpeed(TInt& aNumerator, TInt& aDenominator) const;
williamr@2: 	IMPORT_C TInt GetGpsTrackRef(HBufC8*& aParam) const;
williamr@2: 	IMPORT_C TInt GetGpsTrack(TInt& aNumerator, TInt& aDenominator) const;
williamr@2: 	IMPORT_C TInt GetGpsImgDirectionRef(HBufC8*& aParam) const;
williamr@2: 	IMPORT_C TInt GetGpsImgDirection(TInt& aNumerator, TInt& aDenominator) const;
williamr@2: 	IMPORT_C TInt GetGpsMapDatum(HBufC8*& aParam) const;
williamr@2: 	IMPORT_C TInt GetGpsDestLatitudeRef(HBufC8*& aParam) const;
williamr@2: 	IMPORT_C TInt GetGpsDestLatitude(TInt& aDegNumerator, TInt& aDegDenominator, TInt& aMinNumerator, TInt& aMinDenominator, TInt& aSecNumerator, TInt& aSecDenominator) const;
williamr@2: 	IMPORT_C TInt GetGpsDestLongitudeRef(HBufC8*& aParam) const;
williamr@2: 	IMPORT_C TInt GetGpsDestLongitude(TInt& aDegNumerator, TInt& aDegDenominator, TInt& aMinNumerator, TInt& aMinDenominator, TInt& aSecNumerator, TInt& aSecDenominator) const;
williamr@2: 	IMPORT_C TInt GetGpsDestBearingRef(HBufC8*& aParam) const;
williamr@2: 	IMPORT_C TInt GetGpsDestBearing(TInt& aNumerator, TInt& aDenominator) const;
williamr@2: 	IMPORT_C TInt GetGpsDestDistanceRef(HBufC8*& aParam) const;
williamr@2: 	IMPORT_C TInt GetGpsDestDistance(TInt& aNumerator, TInt& aDenominator) const;
williamr@2: 	IMPORT_C TInt GetGpsProcessingMethod(HBufC8*& aParam) const;
williamr@2: 	IMPORT_C TInt GetGpsAreaInformation(HBufC8*& aParam) const;
williamr@2: 	IMPORT_C TInt GetGpsDateStamp(HBufC8*& aParam) const;
williamr@2: 	IMPORT_C TInt GetGpsDifferential(TUint16& aParam) const;
williamr@2: private:
williamr@2: 	MExifMetadataReader* iExifRead;
williamr@2: 	};
williamr@2: 
williamr@2: 
williamr@2: /**
williamr@2: @publishedAll
williamr@2: @released
williamr@2: 
williamr@2: This class offers a friendly interface to write the metadata in exif encoded image files
williamr@2: 
williamr@2: Note: Unless otherwise stated in a method's documentation, it should be assumed that TInt arguments are representing unsigned quantities, even though TInt is a signed type.
williamr@2: So unless otherwise stated, these parameters should be given unsigned values only.
williamr@2: */
williamr@2: class TExifWriterUtility
williamr@2: 	{	
williamr@2: public:
williamr@2: 	// Construction and destruction
williamr@2: 	IMPORT_C TExifWriterUtility(MExifMetadataWriter* aExifMetadata);
williamr@2: 	
williamr@2: public:
williamr@2: 	// Setters
williamr@2: 	IMPORT_C TInt SetMake(HBufC8* aMake);
williamr@2: 	IMPORT_C TInt SetModel(HBufC8* aModel);
williamr@2: 	IMPORT_C TInt SetDateTime(HBufC8* aDateTime);
williamr@2: 	IMPORT_C TInt SetDateTimeOriginal(HBufC8* aDateTime);
williamr@2: 	IMPORT_C TInt SetDateTimeDigitized(HBufC8* aDateTime);
williamr@2: 	IMPORT_C TInt SetInteroperabilityIndex(HBufC8* aIdx);
williamr@2: 	IMPORT_C TInt SetInteroperabilityVersion(HBufC8* aIdx);
williamr@2: 
williamr@2: 	IMPORT_C TInt SetExifVersion(HBufC8* aExifVersion);
williamr@2: 	IMPORT_C TInt SetComponentsConfiguration(HBufC8* aComponentsConfig);
williamr@2: 	IMPORT_C TInt SetFlashPixVersion(HBufC8* aFlashPixVer);
williamr@2: 
williamr@2: 	IMPORT_C TInt SetXResolution(TInt aNumerator, TInt aDenominator);
williamr@2: 	IMPORT_C TInt SetYResolution(TInt aNumerator, TInt aDenominator);
williamr@2: 	IMPORT_C TInt SetThumbXResolution(TInt aNumerator, TInt aDenominator);
williamr@2: 	IMPORT_C TInt SetThumbYResolution(TInt aNumerator, TInt aDenominator);
williamr@2: 
williamr@2: 	IMPORT_C TInt SetResolutionUnit(TInt aResUnit);
williamr@2: 	IMPORT_C TInt SetYCbCrPositioning(TInt aPositioning);
williamr@2: 	IMPORT_C TInt SetOrientation(TInt aOrientation);
williamr@2: 	IMPORT_C TInt SetColorSpace(TInt aColorSpace);
williamr@2: 	IMPORT_C TInt SetPixelXDimension(TInt aPixelXDim);
williamr@2: 	IMPORT_C TInt SetPixelYDimension(TInt aPixelYDim); 
williamr@2: 
williamr@2: 	IMPORT_C TInt SetThumbCompression(TInt aCompression);
williamr@2: 	IMPORT_C TInt SetThumbResolutionUnit(TInt aResUnit);
williamr@2: 	IMPORT_C TInt SetThumbOrientation(TInt aOrientation);
williamr@2: 	
williamr@2: 	IMPORT_C TInt SetImageDescription(HBufC8* aImageDescription);
williamr@2: 	IMPORT_C TInt SetCopyright(HBufC8* aCopyright);
williamr@2: 	IMPORT_C TInt SetMakerNote(HBufC8* aMakerNote);
williamr@2: 	IMPORT_C TInt SetUserComment(HBufC8* aUserComment);
williamr@2: 	IMPORT_C TInt SetFlash(TUint16 aFlash);
williamr@2: 	IMPORT_C TInt SetFocalLength(TInt aNumerator, TInt aDenominator);
williamr@2: 	IMPORT_C TInt SetShutterSpeedValue(TInt aNumerator, TInt aDenominator);
williamr@2: 	
williamr@2: 	IMPORT_C TInt SetGpsVersionId(HBufC8* aGpsVersionId);
williamr@2: 	IMPORT_C TInt SetGpsLatitudeRef(HBufC8* aGpsLatitudeRef);
williamr@2: 	IMPORT_C TInt SetGpsLatitude(TInt aDegNumerator, TInt aDegDenominator, TInt aMinNumerator, TInt aMinDenominator, TInt aSecNumerator, TInt aSecDenominator);
williamr@2: 	IMPORT_C TInt SetGpsLongitudeRef(HBufC8* aGpsLongitudeRef);
williamr@2: 	IMPORT_C TInt SetGpsLongitude(TInt aDegNumerator, TInt aDegDenominator, TInt aMinNumerator, TInt aMinDenominator, TInt aSecNumerator, TInt aSecDenominator);
williamr@2: 	IMPORT_C TInt SetGpsAltitudeRef(TUint8 aGpsAltitudeRef);
williamr@2: 	IMPORT_C TInt SetGpsAltitude(TInt aNumerator, TInt aDenominator);
williamr@2: 	IMPORT_C TInt SetGpsTimeStamp(TInt aHourNumerator, TInt aHourDenominator, TInt aMinNumerator, TInt aMinDenominator, TInt aSecNumerator, TInt aSecDenominator);
williamr@2: 	IMPORT_C TInt SetGpsSatellites(HBufC8* aGpsSatellites);
williamr@2: 	IMPORT_C TInt SetGpsStatus(HBufC8* aGpsStatus);
williamr@2: 	IMPORT_C TInt SetGpsMeasureMode(HBufC8* aGpsMeasureMode);
williamr@2: 	IMPORT_C TInt SetGpsDop(TInt aNumerator, TInt aDenominator);
williamr@2: 	IMPORT_C TInt SetGpsSpeedRef(HBufC8* aGpsSpeedRef);
williamr@2: 	IMPORT_C TInt SetGpsSpeed(TInt aNumerator, TInt aDenominator);
williamr@2: 	IMPORT_C TInt SetGpsTrackRef(HBufC8* aGpsTrackRef);
williamr@2: 	IMPORT_C TInt SetGpsTrack(TInt aNumerator, TInt aDenominator);
williamr@2: 	IMPORT_C TInt SetGpsImgDirectionRef(HBufC8* aGpsImgDirectionRef);
williamr@2: 	IMPORT_C TInt SetGpsImgDirection(TInt aNumerator, TInt aDenominator);
williamr@2: 	IMPORT_C TInt SetGpsMapDatum(HBufC8* aGpsMapDatum);
williamr@2: 	IMPORT_C TInt SetGpsDestLatitudeRef(HBufC8* aGpsDestLatitudeRef);
williamr@2: 	IMPORT_C TInt SetGpsDestLatitude(TInt aDegNumerator, TInt aDegDenominator, TInt aMinNumerator, TInt aMinDenominator, TInt aSecNumerator, TInt aSecDenominator);
williamr@2: 	IMPORT_C TInt SetGpsDestLongitudeRef(HBufC8* aGpsDestLongitudeRef);
williamr@2: 	IMPORT_C TInt SetGpsDestLongitude(TInt aDegNumerator, TInt aDegDenominator, TInt aMinNumerator, TInt aMinDenominator, TInt aSecNumerator, TInt aSecDenominator);
williamr@2: 	IMPORT_C TInt SetGpsDestBearingRef(HBufC8* aGpsDestBearingRef);
williamr@2: 	IMPORT_C TInt SetGpsDestBearing(TInt aNumerator, TInt aDenominator);
williamr@2: 	IMPORT_C TInt SetGpsDestDistanceRef(HBufC8* aGpsDestDistanceRef);
williamr@2: 	IMPORT_C TInt SetGpsDestDistance(TInt aNumerator, TInt aDenominator);
williamr@2: 	IMPORT_C TInt SetGpsProcessingMethod(HBufC8* aGpsProcessingMethod);
williamr@2: 	IMPORT_C TInt SetGpsAreaInformation(HBufC8* aGpsAreaInformation);
williamr@2: 	IMPORT_C TInt SetGpsDateStamp(HBufC8* aDateStamp);
williamr@2: 	IMPORT_C TInt SetGpsDifferential(TUint16 aGpsDifferential);
williamr@2: 
williamr@2: private: // Member
williamr@2: 	
williamr@2: 	MExifMetadataWriter* iExifWrite;
williamr@2: 	
williamr@2: 	};
williamr@2: 
williamr@2: 
williamr@2: #endif	// __EXIFUTILITY_H__