diff -r 9ebf3284bc56 -r e5ca06a707ac imagingext_plat/ecam_use_case_hint_custom_api/inc/ecamusecasehintcustomapi.h
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/imagingext_plat/ecam_use_case_hint_custom_api/inc/ecamusecasehintcustomapi.h	Wed Apr 14 17:19:50 2010 +0300
@@ -0,0 +1,204 @@
+/*
+* Copyright (c) 2010 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:  This Custom API provides use case hints to camera.
+*               Application can use this custom interface to notify camera
+*               which use case it's going to use before reserving camera. 
+*               Based on this information camera adaptation can optimize 
+*               resource allocation so that camera is able to start up faster
+*               for the particular use case.
+*
+*/
+
+
+#ifndef ECAMUSECASEHINTCUSTOMAPI_H
+#define ECAMUSECASEHINTCUSTOMAPI_H
+
+#include <e32base.h>
+#include <ecam.h>
+
+// CONSTANTS
+
+const TUid KCameraUseCaseHintUid = { 0x2002EA1A };
+
+// CLASS DECLARATION
+
+/**
+* Custom interface for providing use case hints to camera.
+*/
+class MCameraUseCaseHint
+    {
+public: // Enumerations
+    
+    /**
+    * List of codecs for encoded video
+    * @see HintDirectVideoCaptureL()
+    */
+    enum TVideoCodec
+        {
+        ECodecUnknown = 0,
+        ECodecMpeg4,
+        ECodecH263,
+        ECodecH264,
+        ECodecVC1,
+        ECodecSorenson,
+        ECodecOn2Vp6,
+        ECodecOn2Vp7,
+        };
+    
+    /**
+    * List of profiles for encoded video
+    * @see HintDirectVideoCaptureL()
+    */
+    enum TVideoProfile
+        {
+        EProfileUnknown = 0,
+        
+        EProfileMPEG4SpL0 = 0x1000,
+        EProfileMPEG4SpL0b,
+        EProfileMPEG4SpL1,
+        EProfileMPEG4SpL2,
+        EProfileMPEG4SpL3,
+        EProfileMPEG4SpL4a,
+        EProfileMPEG4SpL5,
+        EProfileMPEG4SpL6,
+        
+        EProfileMPEG4AspL0,
+        EProfileMPEG4AspL0b,
+        EProfileMPEG4AspL1,
+        EProfileMPEG4AspL2,
+        EProfileMPEG4AspL3,
+        EProfileMPEG4AspL3b,
+        EProfileMPEG4AspL4,
+        EProfileMPEG4AspL4a,
+        EProfileMPEG4AspL5,
+        EProfileMPEG4AspL6, 
+
+        EProfileH263P0L10 = 0x2000,
+        EProfileH263P0L20,
+        EProfileH263P0L30,
+        EProfileH263P0L40,
+        EProfileH263P0L45,
+        
+        EProfileH264BpL1 = 0x3000,
+        EProfileH264BpL1b,
+        EProfileH264BpL1_1,
+        EProfileH264BpL1_2,
+        EProfileH264BpL1_3,
+        EProfileH264BpL2,
+        EProfileH264BpL2_1,
+        EProfileH264BpL2_2,
+        EProfileH264BpL3,
+        EProfileH264BpL3_1,
+        EProfileH264BpL3_2,
+        EProfileH264BpL4,
+        
+        EProfileH264MpL1,
+        EProfileH264MpL1b,
+        EProfileH264MpL1_1,
+        EProfileH264MpL1_2,
+        EProfileH264MpL1_3,
+        EProfileH264MpL2,
+        EProfileH264MpL2_1,
+        EProfileH264MpL2_2,
+        EProfileH264MpL3,
+        EProfileH264MpL3_1,
+        EProfileH264MpL3_2,
+        EProfileH264MpL4,
+        
+        EProfileH264HpL1,
+        EProfileH264HpL1b,
+        EProfileH264HpL1_1,
+        EProfileH264HpL1_2,
+        EProfileH264HpL1_3,
+        EProfileH264HpL2,
+        EProfileH264HpL2_1,
+        EProfileH264HpL2_2,
+        EProfileH264HpL3,
+        EProfileH264HpL3_1,
+        EProfileH264HpL3_2,
+        EProfileH264HpL4,
+        
+        EProfileVC1SpLL = 0x4000,
+        EProfileVC1SpLM,
+        EProfileVC1MpLL,
+        EProfileVC1MpLM,
+        EProfileVC1MpLH,
+        EProfileVC1ApL0,
+        EProfileVC1ApL1,
+        EProfileVC1ApL2,
+        
+        EProfileSSGeneric = 0x5000,
+        
+        EProfileVP6Generic = 0x6000,
+        };
+    
+public: // Methods
+
+    /**
+    * Gives a hint to camera that client wants to capture encoded video.
+    * 
+    * This method should be called after calling CCamera::New2L() and
+    * before CCamera::Reserve().
+    * 
+    * @param aCodec Codec of the encoded video.
+    * @param aProfile Profile of the encoded video.
+    * @param aResolution Resolution of the encoded video.
+    * @leave KErrInUse if this method is not called at the right time.
+    * @leave KErrNotSupported if given codec/profile/resolution is not
+    *                         supported.
+    */
+    virtual void HintDirectVideoCaptureL(
+        TVideoCodec aCodec,
+        TVideoProfile aProfile,
+        const TSize& aResolution ) = 0;
+    
+    /**
+    * Gives a hint to camera that client wants to capture non-encoded video.
+    * 
+    * This method should be called after calling CCamera::New2L() and
+    * before CCamera::Reserve().
+    * 
+    * @param aFormat Format. Must be one of the supported video frame formats 
+                     (see TCameraInfo::iVideoFrameFormatsSupported).
+    * @param aSizeIndex Size index. Must be in the range 0 to 
+                        TCameraInfo::iNumVideoFrameSizesSupported-1 inclusive.
+    * @param aRateIndex Rate index. Must be in the range 0 to 
+                        TCameraInfo::iNumVideoFrameRatesSupported-1 inclusive.
+    * @leave KErrInUse if this method is not called at the right time.
+    * @leave KErrNotSupported if given format/size/rate is not supported.
+    */
+    virtual void HintVideoCaptureL(
+        CCamera::TFormat aFormat,
+        TInt aSizeIndex,
+        TInt aRateIndex ) = 0;
+    
+    /**
+    * Gives a hint to camera that client wants to capture still images.
+    * 
+    * This method should be called after calling CCamera::New2L() and
+    * before CCamera::Reserve().
+    * 
+    * @param aFormat Format. Must be one of the supported still formats
+    *                (see TCameraInfo::iImageFormatsSupported).
+    * @param aSizeIndex Size index. Must be in the range of 0 to 
+    *                   TCameraInfo::iNumImageSizesSupported-1 inclusive.
+    * @leave KErrInUse if this method is not called at the right time.
+    * @leave KErrNotSupported if given format/size/rate is not supported.
+    */
+    virtual void HintStillCaptureL(
+        CCamera::TFormat aFormat,
+        TInt aSizeIndex ) = 0;
+    };
+
+#endif //ECAMUSECASEHINTCUSTOMAPI_H