/*
* Copyright (c) 2006 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:  
*
*/


#ifndef MCECAMERASOURCE_H
#define MCECAMERASOURCE_H

// INCLUDES
#include <e32std.h>
#include <ecam.h>
#include "mcemediasource.h"

// CONSTANTS
const TMceSourceType KMceCameraSource = 3;

//FORWARD DECLARATIONS
class CMceManager;
class CMceItcSender;

// CLASS DECLARATION

/**
* Class representing camera in MCE.
*
* CMceCameraSource can be used to record video from camera.
*
* Enable (continue) and Disable (pause) operations to it are considered
* to be local, so they are not signalled to remote terminal.
*
* In common situation camera source is combined with display sink which acts
* as a viewfinder for the camera.
* 
* @lib mceclient.lib
*/
class CMceCameraSource : public CMceMediaSource
	{
    friend class UT_CMusEngLiveSession;

	public: // Constructors and destructor

	    /**
	    * Two-phased constructor.
	    * @param aManager reference to the manager
	    */
		IMPORT_C static CMceCameraSource* NewL( CMceManager& aManager );

	    /**
	    * Two-phased constructor.
	    * @param aManager reference to the manager
	    */
		IMPORT_C static CMceCameraSource* NewLC( CMceManager& aManager );
		
	    /**
	    * Destructor.
	    */
		IMPORT_C ~CMceCameraSource();

	public: // From CMceMediaSource

	    /**
	    * Enables the source explicitly.
	    */
		IMPORT_C void EnableL(); 

	    /**
	    * Disables the source explicitly.
	    */
		IMPORT_C void DisableL(); 

	public: // New functions
	
	    /**
	    * Gets the number of cameras on the device.
	    * @return number of available cameras 
	    */
	    IMPORT_C TInt CamerasAvailable() const;

        /**
        * Sets index of physical camera to be used.
        * @param aCameraIndex, index of the camera to be used; First camera has
        *        index 0 and number of available cameras can be retrieved by 
        *        calling CMceCameraSource::CamerasAvailable                                  
        */
        IMPORT_C void SetCameraIndexL( TInt aCameraIndex );
        
        /** 
    	* Gets information about the camera device.
    	* @param aInfo on return information about the camera device
    	*/
        IMPORT_C void GetCameraInfo( TCameraInfo& aInfo ) const;
        
        /** 
    	* Sets the zoom factor.
    	* This must be in the range of TCameraInfo::iMinZoom to 
    	* TCameraInfo::iMaxZoom inclusive.
    	* @param aZoomFactor required zoom factor
    	* @leave KErrArgument if the specified zoom factor is out of range
    	*/
    	IMPORT_C void SetZoomFactorL( TInt aZoomFactor );
    	
    	/** 
	    * Gets the currently set zoom factor.
        * @return current zoom factor
	    */
	    IMPORT_C TInt ZoomFactorL();
    	
        /** 
        * Sets the digital zoom factor.
        * This must be in the range of 0 to TCameraInfo::iMaxDigitalZoom 
        * inclusive.
        * @param aDigitalZoomFactor The required digital zoom factor
        * @leave KErrArgument if the zoom factor is out of range
        */
        IMPORT_C void SetDigitalZoomFactorL( TInt aDigitalZoomFactor );

        /** 
        * Gets the currently set digital zoom factor.
        * @return current digital zoom factor 
        */
        IMPORT_C TInt DigitalZoomFactorL();

        /**
        * Sets the contrast adjustment of the device.
        * @param aContrast required contrast value; This must be in the 
        *        range of -100 to +100 or CCamera::EContrastAuto.
        * @leave KErrNotSupported if contrast adjustment is not supported, 
        *        see TCameraInfo::TOptions
        * @leave KErrArgument if the specified contrast value is out of 
        *        range
        */
        IMPORT_C void SetContrastL( TInt aContrast );

        /** 
        * Gets the current contrast value.
        * @return current contrast value
        */
        IMPORT_C TInt ContrastL();

        /** 
        * Sets the brightness adjustment of the device.
        * No effect if this is not supported, see TCameraInfo::TOptions.
        * 
        * @param aBrightness required brightness adjustment; This must be 
        *        in the range of -100 to +100 or CCamera::EBrightnessAuto
        * @leave KErrNotSupported if brightness adjustment is not supported, 
        *        see TCameraInfo::TOptions
        * @leave KErrArgument if the brightness adjustment is out of range
        */
        IMPORT_C void SetBrightnessL( TInt aBrightness );

        /** 
        * Gets the currently set brightness adjustment value.
        * @return current brightness adjustment value
        */
        IMPORT_C TInt BrightnessL();

        /** 
        * Sets the exposure adjustment of the device.
        * @param aExposure required exposure adjustment
        * @leave KErrNotSupported if the specified exposure adjustment is
        *        not supported, see CameraInfo::iExposureModesSupported
        */
        IMPORT_C void SetExposureL( CCamera::TExposure aExposure );

        /** 
        * Gets the currently set exposure setting value.
        * @return current exposure setting value
        */
        IMPORT_C CCamera::TExposure ExposureL();

        /** 
        * Sets the white balance adjustment of the device.
        * @param aWhiteBalance required white balance adjustment
        * @leave KErrNotSupported if the specified white balance adjustment is 
        *        not supported, see TCameraInfo::iWhiteBalanceModesSupported
        */
        IMPORT_C void SetWhiteBalanceL( CCamera::TWhiteBalance aWhiteBalance );

        /** 
        * Gets the currently set white balance adjustment value.
        * @return current white balance adjustment value
        */
        IMPORT_C CCamera::TWhiteBalance WhiteBalanceL();

	public: // internal
	
	    /**
	    * Initializes 
	    * @param aManager the manager. Ownership is NOT transferred
	    */
	    void InitializeL( CMceManager* aManager );

	private:

	    /**
	    * C++ constructor.
	    */
		CMceCameraSource();

	    /**
	    * Second-phase constructor.
	    */
		void ConstructL( CMceManager* aManager );
    
    private: // Owned data
   
        TCameraInfo iCameraInfo;
        
	private: // Not owned data

        //CMceManager* iManager;

    private: // Reserved for future use
    
        TAny* iReserved;       	
        

    public: // stub data
	
	    TInt iCameraIndex;
        TInt iZoomFactor;
        TInt iDigitalZoomFactor;
        TInt iContrast;
        TInt iBrightness;
        TInt iExposure;
        TInt iWhiteBalance;
	    	    
	};

#endif