/*

* 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;

    friend class UT_CMusEngTwoWaySession;

    friend class UT_TMusEngCameraHandler;

	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 );

        /// Not in the real implementation 

        IMPORT_C static CMceCameraSource* NewL();		

		/// Not in the real implementation 

		IMPORT_C static CMceCameraSource* NewLC();

	    /**

	    * 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();

    private: // Owned data

        TCameraInfo iCameraInfo;

	private: // Not owned data

        //CMceManager* iManager;

    private: // Reserved for future use

        TAny* iReserved;       	

    public: // stub data

	    TInt iCameraIndex;

	    TInt iCameraCount;

        TInt iZoomFactor;

        TInt iDigitalZoomFactor;

        TInt iContrast;

        TInt iBrightness;

        TInt iExposure;

        TInt iWhiteBalance;

	};

#endif