// 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