epoc32/include/icl/exifimagedisplayext.h
branchSymbian2
changeset 2 2fe1408b6811
child 4 837f303aceeb
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/epoc32/include/icl/exifimagedisplayext.h	Tue Mar 16 16:12:26 2010 +0000
@@ -0,0 +1,82 @@
+// Copyright (c) 2005-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:
+// This is the extension to the plugin API for the Image Display framework
+// 
+//
+
+#ifndef EXIFIMAGEDISPLAYEXT_H
+#define EXIFIMAGEDISPLAYEXT_H
+
+#include <e32base.h>
+#include <icl/imagedisplaypluginext.h>
+#include <icl/exifimagedisplay.hrh>
+
+const TUid KExifImageDisplayExtensionUid={KUidExifImageDisplayExtension};
+
+class MExifMetadataReader;
+
+/**
+This class extends the functionality of the Image Display Library client API defined 
+in the class CImageDisplay. This extension is supported only by the EXIF-specific framework
+plug-ins. In order to invoke the extended functionality, the user needs to call the 
+CImageDisplay::ExtensionInterface( ) with the KExifImageDisplayExtensionUid interface UID
+and an interface pointer to the object of this class.
+
+@publishedAll
+@released
+*/
+class MExifImageDisplayExtension :public MImageDisplayPluginExtension
+	{
+public:
+	/**
+	Obtains an MExifMetadataReader that can be used to access the EXIF metadata of the image.
+	@param aPtr A reference to a pointer to the MExifMetadataReader that can be used to access the EXIF
+				metadata of the image.
+	@return A system-wide error code.
+	*/
+	virtual TInt GetExifMetadataReader(MExifMetadataReader*& aPtr)=0;
+	
+	/**
+	Sets the level of quality for the scaling algorithm.
+	If quality level is not set by calling this function then 
+	the fastest/lowest quality algorithm is used.
+	Note: This function must be called before calling CImageDisplay::Play()
+	
+	@param aQualityLevel Quality level value for the scaling algorithm.
+				See CBitmapScaler::TQualityAlgorithm for a set of possible values.
+	@return A system-wide error code.
+	*/	
+	virtual TInt SetScaleQuality(TInt aQualityLevel)=0;
+	
+	/**
+	Sets the maximum quality reduction factor for image decoding.
+	By default, the plug-in calculates an optimal maximum reduction factor 
+	and uses it to produce a series of roughly-decoded images, passing each of 
+	them to the observer interface with the CImageDisplayPlugin::EStatusPartialFrame flag set.
+	Note: This function must be called before calling CImageDisplay::Play().
+	
+	@param aMaxReductionFactor
+				The maximum quality reduction factor.
+				Usually the maximum reduction can be specfied in range of 0-3.
+				A value of 0 means no quality reduction is allowed, so a full-quality image will be decoded as the first frame.
+				A value of 1 means (1/2)^1=1/2 of the original image quality. 
+				A value of 3 means (1/2)^3=1/8 of the original image quality. 
+				If the reduction factor is not set by calling this function then
+				the reduction factor value of 3 is used for jpeg images.
+	@return KErrArgument if the aMaxReductionFactor parameter is not in the supported range, or a system-wide error code.
+	*/	
+	virtual TInt SetMaximumReductionFactor(TInt aMaxReductionFactor)=0;
+	};
+
+#endif // EXIFIMAGEDISPLAYEXT_H