Mercurial Mercurial > oss > API_REF > Public_API / diff
summary | shortlog | changelog | graph | tags | bookmarks | branches | files | changeset | file | latest | revisions | annotate | diff | comparison | raw | help
Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
epoc32/include/exifutility.h
branchSymbian2
changeset 2 2fe1408b6811
child 4 837f303aceeb 
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/epoc32/include/exifutility.h	Tue Mar 16 16:12:26 2010 +0000
@@ -0,0 +1,211 @@
+// Copyright (c) 2004-2009 Nokia Corporation and/or its subsidiary(-ies).
+// All rights reserved.
+// This component and the accompanying materials are made available
+// 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
+// which accompanies this distribution, and is available
+// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
+//
+// Initial Contributors:
+// Nokia Corporation - initial contribution.
+//
+// Contributors:
+//
+// Description:
+// ExifUtilty.h
+// 
+//
+
+#ifndef __EXIFUTILITY_H__
+#define __EXIFUTILITY_H__
+
+class MExifMetadataReader;
+class MExifMetadataWriter;
+
+
+/**
+@publishedAll
+@released
+
+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.
+
+*/
+class TExifReaderUtility 
+	{
+public:
+	// Construction and destruction
+	IMPORT_C TExifReaderUtility(MExifMetadataReader* aExifMetadataReader);
+	
+public:
+	// Getters
+	IMPORT_C TInt GetMake(HBufC8*& aParam) const;
+	IMPORT_C TInt GetModel(HBufC8*& aParam) const;
+	IMPORT_C TInt GetDateTime(HBufC8*& aParam) const;
+	IMPORT_C TInt GetDateTimeOriginal(HBufC8*& aParam) const;
+	IMPORT_C TInt GetDateTimeDigitized(HBufC8*& aParam) const;
+	IMPORT_C TInt GetInteroperabilityIndex(HBufC8*& aParam) const;
+	IMPORT_C TInt GetInteroperabilityVersion(HBufC8*& aParam) const;
+
+	IMPORT_C TInt GetExifVersion(HBufC8*& aParam) const;
+	IMPORT_C TInt GetComponentsConfiguration(HBufC8*& aParam) const;
+	IMPORT_C TInt GetFlashPixVersion(HBufC8*& aParam) const;
+
+	IMPORT_C TInt GetXResolution(TInt& aNumerator, TInt& aDenominator) const;
+	IMPORT_C TInt GetYResolution(TInt& aNumerator, TInt& aDenominator) const;
+	IMPORT_C TInt GetThumbXResolution(TInt& aNumerator, TInt& aDenominator) const;
+	IMPORT_C TInt GetThumbYResolution(TInt& aNumerator, TInt& aDenominator) const;
+
+	IMPORT_C TInt GetResolutionUnit(TUint16& aParam) const;
+	IMPORT_C TInt GetYCbCrPositioning(TUint16& aParam) const;
+	IMPORT_C TInt GetOrientation(TUint16& aParam) const;
+	IMPORT_C TInt GetColorSpace(TUint16& aParam) const;
+	IMPORT_C TInt GetPixelXDimension(TInt& aParam) const;
+	IMPORT_C TInt GetPixelYDimension(TInt& aParam) const;
+
+	IMPORT_C TInt GetThumbCompression(TUint16& aParam) const;
+	IMPORT_C TInt GetThumbResolutionUnit(TUint16& aParam) const;
+	IMPORT_C TInt GetThumbOrientation(TUint16& aParam) const;
+	
+	IMPORT_C TInt GetImageDescription(HBufC8*& aParam) const;
+	IMPORT_C TInt GetCopyright(HBufC8*& aParam) const;
+	IMPORT_C TInt GetMakerNote(HBufC8*& aParam) const;
+	IMPORT_C TInt GetUserComment(HBufC8*& aParam) const;
+	IMPORT_C TInt GetFlash(TUint16& aParam) const;
+	IMPORT_C TInt GetFocalLength(TInt& aNumerator, TInt& aDenominator) const;
+	IMPORT_C TInt GetShutterSpeedValue(TInt& aNumerator, TInt& aDenominator) const;
+	IMPORT_C TInt GetJpegInterchangeFormatLength(TInt& aParam) const;
+	IMPORT_C TInt GetJpegInterchangeFormatLength(TUint& aParam) const;
+
+	IMPORT_C TInt GetGpsVersionId(HBufC8*& aParam) const;
+	IMPORT_C TInt GetGpsLatitudeRef(HBufC8*& aParam) const;
+	IMPORT_C TInt GetGpsLatitude(TInt& aDegNumerator, TInt& aDegDenominator, TInt& aMinNumerator, TInt& aMinDenominator, TInt& aSecNumerator, TInt& aSecDenominator) const;
+	IMPORT_C TInt GetGpsLongitudeRef(HBufC8*& aParam) const;
+	IMPORT_C TInt GetGpsLongitude(TInt& aDegNumerator, TInt& aDegDenominator, TInt& aMinNumerator, TInt& aMinDenominator, TInt& aSecNumerator, TInt& aSecDenominator) const;
+	IMPORT_C TInt GetGpsAltitudeRef(TUint8& aParam) const;
+	IMPORT_C TInt GetGpsAltitude(TInt& aNumerator, TInt& aDenominator) const;
+	IMPORT_C TInt GetGpsTimeStamp(TInt& aHourNumerator, TInt& aHourDenominator, TInt& aMinNumerator, TInt& aMinDenominator, TInt& aSecNumerator, TInt& aSecDenominator) const;
+	IMPORT_C TInt GetGpsSatellites(HBufC8*& aParam) const;
+	IMPORT_C TInt GetGpsStatus(HBufC8*& aParam) const;
+	IMPORT_C TInt GetGpsMeasureMode(HBufC8*& aParam) const;
+	IMPORT_C TInt GetGpsDop(TInt& aNumerator, TInt& aDenominator) const;
+	IMPORT_C TInt GetGpsSpeedRef(HBufC8*& aParam) const;
+	IMPORT_C TInt GetGpsSpeed(TInt& aNumerator, TInt& aDenominator) const;
+	IMPORT_C TInt GetGpsTrackRef(HBufC8*& aParam) const;
+	IMPORT_C TInt GetGpsTrack(TInt& aNumerator, TInt& aDenominator) const;
+	IMPORT_C TInt GetGpsImgDirectionRef(HBufC8*& aParam) const;
+	IMPORT_C TInt GetGpsImgDirection(TInt& aNumerator, TInt& aDenominator) const;
+	IMPORT_C TInt GetGpsMapDatum(HBufC8*& aParam) const;
+	IMPORT_C TInt GetGpsDestLatitudeRef(HBufC8*& aParam) const;
+	IMPORT_C TInt GetGpsDestLatitude(TInt& aDegNumerator, TInt& aDegDenominator, TInt& aMinNumerator, TInt& aMinDenominator, TInt& aSecNumerator, TInt& aSecDenominator) const;
+	IMPORT_C TInt GetGpsDestLongitudeRef(HBufC8*& aParam) const;
+	IMPORT_C TInt GetGpsDestLongitude(TInt& aDegNumerator, TInt& aDegDenominator, TInt& aMinNumerator, TInt& aMinDenominator, TInt& aSecNumerator, TInt& aSecDenominator) const;
+	IMPORT_C TInt GetGpsDestBearingRef(HBufC8*& aParam) const;
+	IMPORT_C TInt GetGpsDestBearing(TInt& aNumerator, TInt& aDenominator) const;
+	IMPORT_C TInt GetGpsDestDistanceRef(HBufC8*& aParam) const;
+	IMPORT_C TInt GetGpsDestDistance(TInt& aNumerator, TInt& aDenominator) const;
+	IMPORT_C TInt GetGpsProcessingMethod(HBufC8*& aParam) const;
+	IMPORT_C TInt GetGpsAreaInformation(HBufC8*& aParam) const;
+	IMPORT_C TInt GetGpsDateStamp(HBufC8*& aParam) const;
+	IMPORT_C TInt GetGpsDifferential(TUint16& aParam) const;
+private:
+	MExifMetadataReader* iExifRead;
+	};
+
+
+/**
+@publishedAll
+@released
+
+This class offers a friendly interface to write the metadata in exif encoded image files
+
+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.
+So unless otherwise stated, these parameters should be given unsigned values only.
+*/
+class TExifWriterUtility
+	{	
+public:
+	// Construction and destruction
+	IMPORT_C TExifWriterUtility(MExifMetadataWriter* aExifMetadata);
+	
+public:
+	// Setters
+	IMPORT_C TInt SetMake(HBufC8* aMake);
+	IMPORT_C TInt SetModel(HBufC8* aModel);
+	IMPORT_C TInt SetDateTime(HBufC8* aDateTime);
+	IMPORT_C TInt SetDateTimeOriginal(HBufC8* aDateTime);
+	IMPORT_C TInt SetDateTimeDigitized(HBufC8* aDateTime);
+	IMPORT_C TInt SetInteroperabilityIndex(HBufC8* aIdx);
+	IMPORT_C TInt SetInteroperabilityVersion(HBufC8* aIdx);
+
+	IMPORT_C TInt SetExifVersion(HBufC8* aExifVersion);
+	IMPORT_C TInt SetComponentsConfiguration(HBufC8* aComponentsConfig);
+	IMPORT_C TInt SetFlashPixVersion(HBufC8* aFlashPixVer);
+
+	IMPORT_C TInt SetXResolution(TInt aNumerator, TInt aDenominator);
+	IMPORT_C TInt SetYResolution(TInt aNumerator, TInt aDenominator);
+	IMPORT_C TInt SetThumbXResolution(TInt aNumerator, TInt aDenominator);
+	IMPORT_C TInt SetThumbYResolution(TInt aNumerator, TInt aDenominator);
+
+	IMPORT_C TInt SetResolutionUnit(TInt aResUnit);
+	IMPORT_C TInt SetYCbCrPositioning(TInt aPositioning);
+	IMPORT_C TInt SetOrientation(TInt aOrientation);
+	IMPORT_C TInt SetColorSpace(TInt aColorSpace);
+	IMPORT_C TInt SetPixelXDimension(TInt aPixelXDim);
+	IMPORT_C TInt SetPixelYDimension(TInt aPixelYDim); 
+
+	IMPORT_C TInt SetThumbCompression(TInt aCompression);
+	IMPORT_C TInt SetThumbResolutionUnit(TInt aResUnit);
+	IMPORT_C TInt SetThumbOrientation(TInt aOrientation);
+	
+	IMPORT_C TInt SetImageDescription(HBufC8* aImageDescription);
+	IMPORT_C TInt SetCopyright(HBufC8* aCopyright);
+	IMPORT_C TInt SetMakerNote(HBufC8* aMakerNote);
+	IMPORT_C TInt SetUserComment(HBufC8* aUserComment);
+	IMPORT_C TInt SetFlash(TUint16 aFlash);
+	IMPORT_C TInt SetFocalLength(TInt aNumerator, TInt aDenominator);
+	IMPORT_C TInt SetShutterSpeedValue(TInt aNumerator, TInt aDenominator);
+	
+	IMPORT_C TInt SetGpsVersionId(HBufC8* aGpsVersionId);
+	IMPORT_C TInt SetGpsLatitudeRef(HBufC8* aGpsLatitudeRef);
+	IMPORT_C TInt SetGpsLatitude(TInt aDegNumerator, TInt aDegDenominator, TInt aMinNumerator, TInt aMinDenominator, TInt aSecNumerator, TInt aSecDenominator);
+	IMPORT_C TInt SetGpsLongitudeRef(HBufC8* aGpsLongitudeRef);
+	IMPORT_C TInt SetGpsLongitude(TInt aDegNumerator, TInt aDegDenominator, TInt aMinNumerator, TInt aMinDenominator, TInt aSecNumerator, TInt aSecDenominator);
+	IMPORT_C TInt SetGpsAltitudeRef(TUint8 aGpsAltitudeRef);
+	IMPORT_C TInt SetGpsAltitude(TInt aNumerator, TInt aDenominator);
+	IMPORT_C TInt SetGpsTimeStamp(TInt aHourNumerator, TInt aHourDenominator, TInt aMinNumerator, TInt aMinDenominator, TInt aSecNumerator, TInt aSecDenominator);
+	IMPORT_C TInt SetGpsSatellites(HBufC8* aGpsSatellites);
+	IMPORT_C TInt SetGpsStatus(HBufC8* aGpsStatus);
+	IMPORT_C TInt SetGpsMeasureMode(HBufC8* aGpsMeasureMode);
+	IMPORT_C TInt SetGpsDop(TInt aNumerator, TInt aDenominator);
+	IMPORT_C TInt SetGpsSpeedRef(HBufC8* aGpsSpeedRef);
+	IMPORT_C TInt SetGpsSpeed(TInt aNumerator, TInt aDenominator);
+	IMPORT_C TInt SetGpsTrackRef(HBufC8* aGpsTrackRef);
+	IMPORT_C TInt SetGpsTrack(TInt aNumerator, TInt aDenominator);
+	IMPORT_C TInt SetGpsImgDirectionRef(HBufC8* aGpsImgDirectionRef);
+	IMPORT_C TInt SetGpsImgDirection(TInt aNumerator, TInt aDenominator);
+	IMPORT_C TInt SetGpsMapDatum(HBufC8* aGpsMapDatum);
+	IMPORT_C TInt SetGpsDestLatitudeRef(HBufC8* aGpsDestLatitudeRef);
+	IMPORT_C TInt SetGpsDestLatitude(TInt aDegNumerator, TInt aDegDenominator, TInt aMinNumerator, TInt aMinDenominator, TInt aSecNumerator, TInt aSecDenominator);
+	IMPORT_C TInt SetGpsDestLongitudeRef(HBufC8* aGpsDestLongitudeRef);
+	IMPORT_C TInt SetGpsDestLongitude(TInt aDegNumerator, TInt aDegDenominator, TInt aMinNumerator, TInt aMinDenominator, TInt aSecNumerator, TInt aSecDenominator);
+	IMPORT_C TInt SetGpsDestBearingRef(HBufC8* aGpsDestBearingRef);
+	IMPORT_C TInt SetGpsDestBearing(TInt aNumerator, TInt aDenominator);
+	IMPORT_C TInt SetGpsDestDistanceRef(HBufC8* aGpsDestDistanceRef);
+	IMPORT_C TInt SetGpsDestDistance(TInt aNumerator, TInt aDenominator);
+	IMPORT_C TInt SetGpsProcessingMethod(HBufC8* aGpsProcessingMethod);
+	IMPORT_C TInt SetGpsAreaInformation(HBufC8* aGpsAreaInformation);
+	IMPORT_C TInt SetGpsDateStamp(HBufC8* aDateStamp);
+	IMPORT_C TInt SetGpsDifferential(TUint16 aGpsDifferential);
+
+private: // Member
+	
+	MExifMetadataWriter* iExifWrite;
+	
+	};
+
+
+#endif	// __EXIFUTILITY_H__
API_REF/Public_API