cameracaptureengine.h

S60官方摄像头程序

/*
* ============================================================================
*  Name     : CameraCapureEngine.h
*  Part of  : CameraApp
*  Created  : 02/09/2004 by Forum Nokia
*  Description: Provides all still image releated methods. 
*               Interface to Symbian Onboard Camera API.
*
*  Version:
*  Copyright: Nokia Corporation, 2004
* ============================================================================
*/

#ifndef __CAMERA_CAPTURE_ENGINE_H__
#define __CAMERA_CAPTURE_ENGINE_H__

#include <f32file.h>
#include <e32std.h>
#include <gdi.h>
#include <ECam.h>

#include "CameraApp.hrh"
#include "CameraAppController.h"

const TInt  KLandscapeImageWidth = 160;
const TInt  KLandscapeImageHeight = 120;
const TInt  KPortraitImageWidth = 80;
const TInt  KPortraitImageHeight = 96;

//Color sampling used with the JPEG encoder
const TJpegImageData::TColorSampling KCameraColorSampling = TJpegImageData::EColor420;

class CWsBitmap;

/**
* Provides all still image releated methods.
*/
class CCameraCaptureEngine : public MCameraObserver, public CActive  
    {
    public: // Constructors and destructor
        /**
         * Two-phased constructor.
         * @return CCameraCapureEngine*
         */
        static CCameraCaptureEngine* NewL( CCameraAppController& aController );
        
        /**
         * Destructor
         */
        virtual ~CCameraCaptureEngine();

    private:
        /**
         * Symbian OS default constructor.
         */
        CCameraCaptureEngine( CCameraAppController& aController );

        /**
         * Symbian OS constructor.
         */
       void ConstructL();

    public: // New Functions
		/**
		 * Check whether the camera is being used by another app.
		 * @return, true if it used by another app. 
		 */
	    TBool IsCameraUsedByAnotherApp();

		/**
		 * Set the engine state	
		 */
	    void SetEngineState( TEngineState aState );

		/**
		 * Get the engine state	
		 * @return EEngineState
		 */
	    TEngineState GetEngineState();

		/**
		 * Returns whether the imageconversion is in progress or not	
		 */
	    TBool IsImageConversionInProgress();

		/**
		 * Start to save image
		 */
		void StartToSaveImage();

        /**
         * Starts view finding
         * @return void
         */
        void StartViewFinderL();

        /**
         * Stops view finding
         * @return void
         */
        void StopViewFinder();

        /**
         * Provides save and post-exposure images
         * @return void
         */
        void SnapL();

        /**
         * Sets zoom on/off
         * @param aEnable
         * @return TInt, Offset for the zoom indicator bitmap
         */
        TInt SetZoomFactorL( TBool aEnable );

        /**
         * Converts and saves bitmap to JPEG image
         * @param aQuality 
         * @param aNewFilePathAndName
         * @param aFs 
         * @return void
         */
        void SaveImageL(TJpegQualityFactor aQuality, const TFileName* 
					aNewFilePathAndName, RFs* aFs);

        /**
         * Destructs JPEG encoder
         * @return void
         */
        void DeleteEncoder();

        /**
         * Returns default display mode
         * @return TDisplayMode
         */
        TDisplayMode DisplayMode() const;

        /**
         * Sets Exposure time according to Camera mode
         * @param Camera State
         * @return void 
         */
        void SetMode( TCameraState aMode );
        
        /**
         * Reserves camera
         * @return void
         */
        void ReserveCameraL();

        /**
         * Releases camera
         * @return void
         */
        void ReleaseCamera();

        /**
         * Switches off camera power
         * @return void
         */
        void PowerOff();

        /**
         * Displays error message
         * @param An error
         * @return void
         */
        void HandleError( TInt aError );  

    private:
        /**
         * Returns camera image format to be used with current display mode
         * @return CCamera::TFormat
         */
        CCamera::TFormat ImageFormat() const;

        /**
         * Returns highest color mode supported by HW
         * @return CCamera::TFormat
         */
        CCamera::TFormat ImageFormatMax() const;

        /**
         * Clips the viewfinding images according to portrait mode size.
         * @param A bitmap to be clipped
         * @return void
         */
        void ClipL(const CFbsBitmap& aFrame);

        /**
         * Draws captured image on the screen, modifies if needed
         * @return void
         */
        void DrawL();

        /**
         * Starts view finding and prepares image capturing
         * @return void
         */
        void DoViewFinderL(); 

		/**
		 * From MCameraObserver, "CCamera::Reserve()" is completed
		 */
        virtual void ReserveComplete(TInt aError);

		/**
		 * From MCameraObserver, "CCamera::PowerOn()" is completed	
		 */
        virtual void PowerOnComplete(TInt aError);

		/**
		 * From MCameraObserver, "CCamera::StartViewFinderBitmapsL()" 
		 * is completed
		 */
        virtual void ViewFinderFrameReady(CFbsBitmap& aFrame);

		/**
		 * From MCameraObserver, "CCamera::CaptureImage()" is completed
		 */
        virtual void ImageReady(CFbsBitmap* aBitmap,HBufC8* aData,TInt aError);

		/**
		 * From MCameraObserver, CCamera::StartVideoCapture() is completed
		 */
        virtual void FrameBufferReady(MFrameBuffer* aFrameBuffer,TInt aError);

    private: // Functions from base CActive classes 
        /**
         * From CActive cancels the Active object, empty 
         * @return void
         */
        void DoCancel() ;

        /**
         * From CActive, called when an asynchronous request has completed
         * @return void
         */
        void RunL() ;

    private: //data 
        CCamera* iCamera;
        TDisplayMode iDisplayMode;
        CCamera::TFormat iColorDepth;
        CCamera::TFormat iColorDepthHW;
        CCameraAppController& iController;
        TCameraInfo iInfo;
        TInt iZoomFactor;
        TBool iCapturePrepared; 
		CWsBitmap* iBitmapPortraitVF; 
        CFbsBitmap* iBitmapSave;
        CImageEncoder* iEncoder;
        TBool iStart;
        TBool iCameraReserved;
        TBool iCameraReserveComplete;
        TSize iLandscapeSize;
        TSize iPortraitSize;
        TCameraState iMode;
        TBool iPowering;
		TEngineState iState;
    };

#endif // __CAMERA_CAPTURE_ENGINE_H__