/*

* Copyright (c) 2002-2004 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:  Camera Application Engine implementation class

*

*/

#ifndef CAEENGINEIMP_H

#define CAEENGINEIMP_H

//  INCLUDES

#include <ecam.h>

#include <videorecorder.h>

#include "CamCControllerCustomCommands.h"

#include "CaeEngine.h"

#include "CaeEngineExtInterface.h"

#include "CaeCommon.h"

#include "CaeStillEncoder.h"

#include "CaeStillDecoder.h"

#include "CaeCallbackActive.h"              // For making method calls from callbacks.

#include "CaeDbgUtilities.h"                // For debugging.

#include <e32std.h>

// CONSTANTS

const TInt KVideoTimesIntervalDefault = 1000000; // Default time interval for Video Recording times call-back.

const TInt KVideoTimesDelay = 100000; // Delay in starting to generate video times, in microseconds.

const TInt KCameraPriority = -1; // Relative priority (-100...100) of camera HW

const TUid KUidBurstModeVFOptimization = {0x4A758866}; // Custom command interface UID used by some products

// FORWARD DECLARATIONS

class CVideoRecorderUtility;

class RWsSession;

class CWsScreenDevice;

class RWindowBase;

class CFbsBitmap;

class CCaeStillQualityLevelsCont;

class CCaeVideoQualityLevelsCont;

class CCaeVideoTimes;

class CCaeStillBurst;

class CCaeStillStatesActive;

// CLASS DECLARATIONS

/**

* Camera application engine implementation class.

*/

NONSHARABLE_CLASS( CCaeEngineImp ): public CCaeEngine, 

                                    public MCameraObserver,

                                    public MExtensionCallbackInterface,

					                public MCaeExtEngineInfoCallbackInterface,

                                    public MVideoRecorderUtilityObserver,

                                    public MCameraObserver2

    {

    public: // Construction and destruction

        static CCaeEngineImp* NewL();

        virtual ~CCaeEngineImp();

    public: // General methods / CCaeEngine.h

        void SetCamAppEngineObserver( 

            MCamAppEngineObserver& aObserver );

        void GetInfo( 

            TCamAppEngineInfo& aInfo ) const;

        void InitL( 

            TBool aCreateSnapImage = ETrue );

        void InitL( 

            TUid  aSdUidStillQltyLevels, 

            TBool aCreateSnapImage = ETrue );

        void InitVideoRecorderL();

        void InitVideoRecorderL( 

            TUid aSdUidVideoQltyLevels );

        void Reserve();

        void Release();

        void PowerOn();

        void PowerOff();

    public: // Camera settings / CCaeEngine.h

        void SetZoomModeL( 

            TZoomMode aZoomMode = EZoomModeDigital );

        TZoomMode ZoomMode() const;

        void SetZoomValueL( 

            TInt aZoomValue = 0 );

        TInt ZoomValue() const;

        void SetBrightnessL( 

            TInt aBrightness = 0 );

        TInt Brightness() const;

        void SetContrastL( 

            TInt aContrast = 0 );

        TInt Contrast() const;

        void SetExposureModeL( 

            CCamera::TExposure aExposureMode = CCamera::EExposureAuto );

        CCamera::TExposure ExposureMode() const;

        void SetWhiteBalanceModeL( 

            CCamera::TWhiteBalance aWhiteBalanceMode = CCamera::EWBAuto );

        CCamera::TWhiteBalance WhiteBalanceMode() const;

        void SetFlashModeL( 

            CCamera::TFlash aFlashMode = CCamera::EFlashNone );

        CCamera::TFlash FlashMode() const;

        void ResetToDefaultsL();

    public: // View Finder / CCaeEngine.h

        void SetViewFinderMirrorL( 

            TBool aMirror );

        TBool ViewFinderMirror() const;

        void StartViewFinderBitmapsL( 

            TSize& aVfFrameSize );

        void StartViewFinderBitmapsL( 

            TSize& aVfFrameSize, 

            TRect& aCropRect );

        void StartViewFinderDirectL( 

            RWsSession&      aWs, 

            CWsScreenDevice& aScreenDevice, 

            RWindowBase&     aWindow, 

            TRect&           aScreenRect );

        void StartViewFinderDirectL( 

            RWsSession&      aWs, 

            CWsScreenDevice& aScreenDevice, 

            RWindowBase&     aWindow, 

            TRect&           aScreenRect, 

            TRect&           aCropRect );

        void StopViewFinder();

        TBool IsViewFinding() const;

        void GetViewFinderSize( 

            TSize& aVfFrameSize );

    public: // Still image capturing / CCaeEngine.h

        void PrepareStillCaptureL( 

            TInt aStillQualityIndex );

        void PrepareStillCaptureL( 

            TInt         aStillQualityIndex, 

            const TRect& aCropRect );

        void PrepareStillCaptureL( 

            const TSize&     aSize, 

            CCamera::TFormat aFormat,

            TInt             aCompressionQuality );

        void PrepareStillCaptureL( 

            const TSize&     aSize, 

            CCamera::TFormat aFormat, 

            TInt             aCompressionQuality, 

            const TRect&     aCropRect );

        TInt StillQualityIndex() const;

        void GetStillFrameSize( 

            TInt   aStillQualityIndex, 

            TSize& aSize ) const;

        TInt EstimatedStillSizeInBytes( 

            TInt aStillQualityIndex ) const;

        void CaptureStill(); 

        void CancelCaptureStill();

    public: // Video recording / CCaeEngine.h

        void SetVideoRecordingFileNameL( 

            const TDesC& aVideoClipFileName );

        void PrepareVideoRecordingL( 

            TInt aVideoQualityIndex );

        void PrepareVideoRecordingL( 

            const TSize&  aFrameSize, 

            TReal32       aFrameRate, 

            TInt          aBitRate, 

            TBool         aAudioEnabled,

            const TDesC8& aMimeType, 

            const TDesC&  aPreferredSupplier, 

            const TDesC8& aVideoType = KNullDesC8, 

            const TDesC8& aAudioType = KNullDesC8 );

        void CloseVideoRecording();

        TInt VideoQualityIndex() const;

        void GetVideoFrameSize( 

            TInt   aVideoQualityIndex, 

            TSize& aSize ) const;

        TReal32 VideoFrameRate( 

            TInt aVideoQualityIndex ) const;

        TInt EstimatedVideoRecordingBitRateL( 

            TInt aVideoQualityIndex ) const;

        void SetVideoClipMaxSizeL( 

            TInt aMaxClipSizeInBytes = 0 );

        TInt VideoClipMaxSize() const;

        void SetVideoAudioL( 

            TBool aAudioEnabled );

        TBool VideoAudio() const;

        void SetVideoTimesIntervalL( 

            TTimeIntervalMicroSeconds aInterval );

        TTimeIntervalMicroSeconds VideoTimesInterval() const;

        void StartVideoRecording();

        void StopVideoRecording();

        void PauseVideoRecording();

        void ResumeVideoRecording();

        TTimeIntervalMicroSeconds RemainingVideoRecordingTime() const;

        TBool IsVideoRecording() const;

    public: // New overloading method for preparing video recording / CCaeEngine.h

        void PrepareVideoRecordingL( 

            const TSize&  aFrameSize, 

            TReal32       aFrameRate, 

            TInt          aBitRate, 

            TBool         aAudioEnabled,

            TInt          aAudioBitRate, 

            const TDesC8& aMimeType, 

            const TDesC&  aPreferredSupplier, 

            const TDesC8& aVideoType, 

            const TDesC8& aAudioType );

    public: // Still image burst capturing interface methods / CCaeEngine.h

        void SetCaeStillBurstObserver( 

            MCaeStillBurstObserver& aObserver );

        TInt SetStillCaptureImageCountL( 

            TInt aImageCount );

        TInt StillCaptureImageCount() const;

        void SetStillBurstCaptureIntervalL( 

            TTimeIntervalMicroSeconds aInterval );

        TTimeIntervalMicroSeconds StillBurstCaptureInterval() const;

        void StopStillBurstCapture();

        void PrepareStillCaptureL( 

            TInt         aStillQualityIndex, 

            TSize&       aSnapSize );

        void PrepareStillCaptureL( 

            const TSize&     aSize, 

            CCamera::TFormat aFormat,  

            TInt             aCompressionQuality, 

            const TRect&     aCropRect,

            TSize&           aSnapSize );

        void SetEvCompensationL( 

            TInt aEvIndex = 0 );

        TInt EvCompensation() const;

    public: // Method for switching snap-image creation on/off. / CCaeEngine.h

        void SetSnapImageCreation( 

            TBool aCreateSnapImage = ETrue );

    public: // New methods since 2.6 and 2.8 / CCaeEngine.h

    	static CCaeEngineImp* NewL(

    	    TInt aCameraIndex, TInt aDisplayIndex );

    	void EnumerateStillCaptureSizes(

    	    TSize& aSize,

    	    TInt aSizeIndex,

    	    CCamera::TFormat aFormat ) const;

    	void SetJpegQuality(

    	    TInt aQuality );

    	TInt JpegQuality() const;

        TAny* CustomInterface(

			TUid aInterface );

        void SetSnapImageSizeL(

            TSize& aSize );

        void SetSnapImageColorMode(

            TDisplayMode aMode );

        void GetOrderL( 

			RCaeOrderedFeatureList& aOrderedFeatureList );

        void SetOrderL( 

			const RCaeOrderedFeatureList& aOrderedFeatureList );

        void SetSnapImageSourceL(

            TSnapImageSource aSnapImageSource );

        void SetImageCodecsL( 

        	TUid aDecoderUid, TUid aEncoderUid );

        TInt EnumerateVideoFrameSizeL(const TSize& aSize);

        TInt CCameraHandle() const;

        void SetCaeExtensionModeL( TBool aExtModeActive, TBool aCreateSnapImage );

        void ProcessExtViewFinderFrameReadyL( CFbsBitmap& aFrame );

        void ProcessExtSnapImageL( CFbsBitmap& aSnapImage );

        void ProcessExtCapturedImageL( CFbsBitmap& aBitmap, TBool aLastImage );

        void ProcessExtCapturedImageL( HBufC8* aImageData, TBool aLastImage );

        void ProcessExtCapturedImageL( TDesC8& aImageDataDes, TBool aLastImage );

        void ProcessExtCancel();

        void SkippedExtensionListL( RCaeOrderedFeatureList& aDisabledExtensions );

        void SetSkippedExtensionList( RCaeOrderedFeatureList& aDisabledExtensions );

        void EnableVideoRecording();

        void DisableVideoRecording();

        TInt SetAsyncVideoStopMode( TBool aAsyncVideoStopEnabled );

    public: // New public methods

        /**

        * Checks if still image burst capture should be completed.

        * @since 2.6

        * @return Boolean indicating if the burst should be completed.

        */

        TBool CheckForStillBurstCompletion();

    private: // From Camera Observer / ECam.h

        void ReserveComplete( 

            TInt aError );

        void PowerOnComplete( 

            TInt aError );

        void ViewFinderFrameReady( 

            CFbsBitmap& aFrame );

        void ImageReady( 

            CFbsBitmap* aBitmap, 

            HBufC8*     aData, 

            TInt        aError );

        void FrameBufferReady( 

            MFrameBuffer* /*aFrameBuffer*/, 

            TInt          /*aError*/ ) {}; // Empty default because not in use.

    private: // From Video Recorder Utility Observer / VideoRecorder.h

        void MvruoOpenComplete( 

            TInt aError );

        void MvruoPrepareComplete( 

            TInt aError );

        void MvruoRecordComplete( 

            TInt aError );

        void MvruoEvent( 

            const TMMFEvent& aEvent );

    private: // Private member methods

        /**

        * C++ constructor.

        */

        CCaeEngineImp();

        /**

        * Symbian OS 2nd phase constructor that can leave.

        * @param aCameraIndex Index from 0 to CamerasAvailable()-1 inclusive 

        * specifying the camera device to use.

        * @param aDisplayIndex Display index specifying the display to use.

        * @return void

        */

        void ConstructL( TInt aCameraIndex, TInt aDisplayIndex );

        /**

        * Finds all extension dlls and populates the extension arrays.

        * @since 2.8

        * @return void

        */

		void PopulateExtensionArrayL();

    //// General and settings related private methods. ////

        /**

        * Initializes the info class ("structure").

        * @since 2.1

        * @param aCamera Camera object.

        * @return void

        */

        void InitializeInfo( 

            const CCamera& aCamera );

        /**

        * Checks that power is on. If not, then leaves.

        * @since 2.1

        * @return void

        */

        void CheckPowerL();

        /**

        * Cancels view finder, still capturing, and video recording.

        * @since 2.1

        * @return void

        */

        void CancelAllActivities();

        /**

        * Re-sets settings to the previous values (before releasing camera).

        * @since 2.1

        * @return void

        */

        void ResetToPreviousSettingsL();

    //// Video recording related private methods. ////

        /**

        * Cancels video recording.

        * @since 2.1

        * @return void

        */

        void CancelVideoRecording();

        /**

        * Prepares video recording settings.

        * @since 2.1

        * @return void

        */

        void PrepareVideoSettingsL();

        /**

        * Changes video clip file name.

        * @since 2.1

        * @return void

        */

        void ChangeVideoFileNameL();

        /**

        * Finds video type and format UIDs using ECOM.

        * @since 2.1

        * @param aMimeType MIME type.

        * @param aPreferredSupplier Preferred supplier of video encoder.

        * @return void

        */

        void FindVideoUidsL(

            const TDesC8& aMimeType, 

            const TDesC&  aPreferredSupplier );

        /**

        * Convert audio type from TDesC8 to TFourCC.

        * @since 2.1