// Copyright (c) 2008-2009 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:

 //

 /**

  @file

  @internalTechnology

 */

 #ifndef MMCAMERACLIENTINTERFACE_H

 #define MMCAMERACLIENTINTERFACE_H

 #include <e32base.h>

 #include <e32std.h>

 #include <ecamuids.hrh>

 #ifdef SYMBIAN_ENABLE_SPLIT_HEADERS

 #include <ecamuidsdef.hrh>

 #endif

 #include <ecamviewfinder.h>

 #include <graphics/surface.h>

 static const TInt KECamMaxMessage = 100;

 static const TUid KECamServerUid3 = {KUidMMCameraServer};

 static const TInt KECamNoPriority = -101;

 static const TInt KECamHandleNotKnown = -1;

 static const TInt KECamNumAsynchMsg = 8;

 _LIT(KMMCameraServerName, "!MMCameraServer");

 _LIT(KMMCameraServerExe, "MMCameraServer");  // Exe name

 enum TECamMsgId // Enums for use in ServiceL()

 	{    

 	ECamQueryCamerasAvailable = 0,	// Query MM server to retrieve number of physical cameras available

 	ECamCameraAccessControl,    	// Enums to reserve/release the camera for exclusive use. TBool ETrue/EFalse decides Reserve/Release . 

 	ECamPowerCamera,      			// To Power On the camera if TBool passed =ETrue, else power down 

   	ECamOpenCamera,        			// Called from ConnectSession to open a particular camera specified by the index 

 	ECamHandleCamera,     			// Get the handle of the camera 

 	ECamGetCameraInfo,    			// Retrieve the info about camera device

 	ECamPrepareDirectViewFinder,	// Sets up the direct view finder

 	ECamStartDirectViewFinder,		// Starts view finder operation

 	ECamStopDirectViewFinder,  		// Stops view finder playback

 	ECamPauseDirectViewFinder,		// Pauses view finder playback

 	ECamResumeDirectViewFinder,		// If paused, resumes view finder playback

 	ECamDirectViewFinderState,		// Retrieves state of direct view finder

 	ECamSetDirectViewFinderMirror,	// Enables/Disables mirror mode on direct viewfinder

 	ECamGetDirectViewFinderMirror,	// Retrieves mirror mode status of direct viewfinder

 	ECamDirectViewFinderProperties, // Retrieves properties related to the direct viewfinder

 	ECamSetParameter,				// Maps Set camera parameters

 	ECamGetParameter,				// Retrives camera parameters

 	ECamCameraHandle  		   		// Retrieves unique camera handle

 	};

 enum TCameraParameterId   // Camera parameters to set/get 

     {

     EZoomFactor,

     EDigitalZoomFactor,

     EContrast,

     EBrightness,

     EFlash,

     EExposure,

     EWhiteBalance,

     EJpegQuality

     };

 /*    

 enum TCameraMode   // Camera modes in which the parameter setting is valid 

     {

     ECameraVF = 0x0001,

     ECameraIC = 0x0002,

     ECameraVC = 0x0004

     };

 */

 enum TCameraAccessControl

 	{

 	ECameraRelease,

 	ECameraReservedNotification,

 	ECameraCancelReservedNotification,

 	ECameraOverthrowNotification,

 	ECameraCancelOverthrowNotification		

 	};

 enum TCameraPower

 	{

 	ECameraPowerOnNotification,

 	ECameraPowerOff,

 	ECameraCancelPowerOnNotification		

 	};

 enum TServerPanic

 	{

 	EPanicBadDescriptor,

 	EPanicNotSupported

 	};

 typedef TPckg <TCameraInfo> TCameraInfoBuf;

 struct TCamerasAvailable

 	{

 	TInt iCameraCount;

 	};

 typedef TPckg <TCamerasAvailable> TCamerasAvailablePckg;

 struct TOpenCamera    // Used for passing the infos to the server side session while creating camera channel 

     {

     TInt iCameraIndex; // between 0-2 assuming 3 cameras 

     TInt iPriority; //  If NewDuplicateL called, set KRefCamNoPriority 

     TInt iHandle;   //  If NewL called, set -1 

     TBool iMMCapability; // set ETrue 

     TBool iCollaborativeClient; //  If NewDuplicateL used 

     };

 typedef TPckg <TOpenCamera> TOpenCameraPckg;

 struct TCameraHandle    

     {

     TInt iHandle;   

     };

 typedef TPckg <TCameraHandle> TCameraHandlePckg;

 struct TDirectViewFinderInfo    

     {

 	TInt iScreenNum;

 	TRect iScreenRect;

 	TRect iClipRect;

 	TSurfaceId iSurfaceId;

     };

 typedef TPckg <TDirectViewFinderInfo> TDirectViewFinderInfoPckg;

 struct TDirectViewFinderState

 	{

 	CCamera::CCameraV2DirectViewFinder::TViewFinderState iState;

 	};

 typedef TPckg <TDirectViewFinderState> TDirectViewFinderStatePckg;

 struct TCameraZoom

 	{

 	TInt iZoom;

 	};

 typedef TPckg <TCameraZoom> TCameraZoomPckg;

 struct TCameraDigitalZoom

 	{

 	TInt iDigitalZoom;

 	};

 typedef TPckg <TCameraDigitalZoom> TCameraDigitalZoomPckg;

 struct TCameraContrast

 	{

 	TInt iContrast;

 	};

 typedef TPckg <TCameraContrast> TCameraContrastPckg;

 struct TCameraBrightness

 	{

 	TInt iBrightness;

 	};

 typedef TPckg <TCameraBrightness> TCameraBrightnessPckg;

 struct TViewFinderMirror  

     {

 	TBool iMirror;

     };

 typedef TPckg <TViewFinderMirror> TViewFinderMirrorPckg;

 struct TCameraFlash

 	{

 	CCamera::TFlash iFlash;

 	};

 typedef TPckg <TCameraFlash> TCameraFlashPckg;

 struct TCameraExposure

 	{

 	CCamera::TExposure iExposure;

 	};

 typedef TPckg <TCameraExposure> TCameraExposurePckg;

 struct TCameraWhiteBalance

 	{

 	CCamera::TWhiteBalance iWhiteBalance;

 	};

 typedef TPckg <TCameraWhiteBalance> TCameraWhiteBalancePckg;

 /**

  * Interface class to allow communication between clients and server.

  * 

  * Provides API's for both synchronous and asynchronous methods of communication. 

  */

 class RMMCameraSession : public RSessionBase

 	{

 public:

 	TInt Connect();

 	TInt SendMessage(TECamMsgId aMsgId, TCameraParameterId aParameterId, TDes8& aMessage);

 	TInt SendMessage(TECamMsgId aMsgId, TCameraParameterId aParameterId, TInt aMessage);

 	TInt SendMessage(TECamMsgId aMsgId, TDes8& aMessage);

 	TInt SendMessage(TECamMsgId aMsgId, TInt aMessage);

 	TInt SendMessage(TECamMsgId aMsgId);

 	TInt SendRxMessage(TECamMsgId aMsgId, TCameraParameterId aParameterId, TDes8& aMessage) const;

 	TInt SendRxMessage(TECamMsgId aMsgId, TCameraParameterId aParameterId, TInt aMessage) const;

 	TInt SendRxMessage(TECamMsgId aMsgId, TDes8& aMessage) const;

 	TInt ReceiveMessage(TECamMsgId aMsgId, TDes8& aMessage, TRequestStatus& aStatus);

 	void ReceiveMessage(TECamMsgId aMsgId, TInt aMessage, TRequestStatus& aStatus);

 	}; 

 #endif // MMCAMERACLIENTINTERFACE_H