tsrc/musenginestub/inc/musengcamerahandler.h
branchRCL_3
changeset 22 73a1feb507fb
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/tsrc/musenginestub/inc/musengcamerahandler.h	Tue Aug 31 15:12:07 2010 +0300
@@ -0,0 +1,255 @@
+/*
+* Copyright (c) 2005 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 MUSHENGCAMERAHANDLER_H
+#define MUSHENGCAMERAHANDLER_H
+
+// USER
+#include "musunittesting.h"
+#include "mussettings.h"
+
+// SYSTEM
+#include <ecam.h>
+
+// FORWARD DECLARATIONS
+class CMceCameraSource;
+class CMceSession;
+
+// CLASS
+
+class TMusEngCameraHandler
+    {
+    MUS_UNITTEST( UT_CMusEngOutSession )
+    MUS_UNITTEST( UT_CMusEngLiveSession )
+    MUS_UNITTEST( UT_CMusEngTwoWaySession )
+    MUS_UNITTEST( UT_CMusEngTwoWayRecvSession )
+    MUS_UNITTEST( UT_TMusEngCameraHandler )
+        
+    public:
+    /*
+    * Defines current camera to be used  
+    */
+    enum TCurrentCamera
+        {
+        ENextCamera = -1,
+        EBackCamera = 0, 
+        EFrontCamera = 1
+        };
+    
+    public:
+    
+        /** 
+        * Determines the number of cameras on the device.
+        *
+        * @param aCurrentCamera returns current camera..
+        *
+        * @return Count of cameras present on the device.
+        */
+        IMPORT_C TInt CamerasAvailableL( TCurrentCamera& aCurrentCamera );
+       
+        /**
+        * Change current camera to front to back
+        * 
+        * @param aCurrentCamera Change camera to be used.
+        */
+        IMPORT_C void ChangeCameraL( TCurrentCamera aCurrentCamera );
+
+        /**
+        * Gets current zoom factor
+        * 
+        * @pre Session is established
+        * @leave KErrNotReady if precondition not fullfilled
+        */
+        IMPORT_C TInt CurrentZoomL() const;
+        
+        /**
+        * Sets new zoom factor
+        * 
+        * @pre Session is established
+        * @pre MinZoomL <= aNewZoomFactor <= MaxZoomL
+        * @leave KErrNotReady if session is not established
+        */
+        IMPORT_C void SetZoomL( TInt aNewZoomFactor );
+        
+        /**
+        * Gets minimum zoom factor
+        * 
+        * @pre Session is established
+        * @leave KErrNotReady if precondition not fullfilled
+        */
+        IMPORT_C TInt MinZoomL() const;
+
+        /**
+        * Gets maximum zoom factor
+        * 
+        * @pre Session is established
+        * @leave KErrNotReady if precondition not fullfilled
+        */
+        IMPORT_C TInt MaxZoomL() const;
+        
+        /**
+        * Increases zoom factor by one.
+        * 
+        * @pre Session is established
+        * @leave KErrNotReady if precondition not fullfilled
+        */
+        IMPORT_C void ZoomInL();
+
+        /**
+        * Decreases zoom factor by one.
+        * 
+        * @pre Session is established
+        * @leave KErrNotReady if precondition not fullfilled
+        */
+        IMPORT_C void ZoomOutL();
+
+        /**
+        * Sets zoom factor to default.
+        * 
+        * @pre Session is established
+        * @leave KErrNotReady if precondition not fullfilled
+        */
+        IMPORT_C void ZoomDefaultL();
+
+        /**
+        * Sets current brightness
+        * 
+        * @pre Session is established
+        * @leave KErrNotReady if precondition not fullfilled
+        */
+        IMPORT_C void SetBrightnessL( TInt aBrightness ) const;
+
+
+        /**
+        * Gets current brightness
+        * 
+        * @pre Session is established
+        * @leave KErrNotReady if precondition not fullfilled
+        */
+        IMPORT_C TInt CurrentBrightnessL() const;
+
+        /**
+        * Gets maximum brightness
+        * 
+        * @pre Session is established
+        * @leave KErrNotReady if precondition not fullfilled
+        */
+        IMPORT_C TInt MaxBrightnessL() const;
+
+        /**
+        * Gets minimum brightness
+        * 
+        * @pre Session is established
+        * @leave KErrNotReady if precondition not fullfilled
+        */
+        IMPORT_C TInt MinBrightnessL() const;
+
+        /**
+        * Increases brightness by one.
+        * 
+        * @pre Session is established
+        * @leave KErrNotReady if precondition not fullfilled
+        */
+        IMPORT_C void IncreaseBrightnessL();
+
+        /**
+        * Decreases brightness by one.
+        * 
+        * @pre Session is established
+        * @leave KErrNotReady if precondition not fullfilled
+        */
+        IMPORT_C void DecreaseBrightnessL();
+
+        /**
+        * Sets brightness factor to default.
+        * 
+        * @pre Session is established
+        * @leave KErrNotReady if precondition not fullfilled
+        */
+        IMPORT_C void BrightnessDefaultL();
+
+        /**
+        * Sets brightness to automatic.
+        * 
+        * @pre Session is established
+        * @leave KErrNotReady if precondition not fullfilled
+        */
+        IMPORT_C void BrightnessAutoL();
+        
+        /**
+        * Resumes previously paused session. 
+        * Continues using viewfinder and enables streaming video.
+        *
+        */
+        IMPORT_C void PlayL();
+        
+        /**
+        * Pauses session.
+        * Holds display and disables streaming video to network.
+        *
+        */
+        IMPORT_C void PauseL();
+        
+        /**
+        * Tells whether session is paused or not
+        */
+        IMPORT_C TBool IsPlayingL();
+                       
+
+    public:
+        
+        TMusEngCameraHandler();
+        
+        void SetSession( CMceSession* aSession );
+        
+        void InitializeL( CMceCameraSource& aCamera );
+        
+        void InitializeZoomStepSize();
+        
+        void ReadCameraUsageKeyL();
+        
+        TInt ZoomStepSize( TInt64& aTime );
+        
+        void ChangeActiveCameraL( TCurrentCamera aNewCamera );
+
+    private:
+        
+        CMceSession* iSession; // Not owned
+        
+        TCameraInfo iCameraInfo;
+
+        TInt iDefaultZoomFactor;
+        
+        TInt iDefaultBrightness;
+        
+        TInt64 iZoomInTime;
+        
+        TInt64 iZoomOutTime;        
+                      
+        TInt iSmallZoomStep;
+        
+        TInt iBigZoomStep;
+        
+        TCurrentCamera iCurrentCamera;
+        
+        MusSettingsKeys::TUseCamera iCameraUsage;
+        
+    };
+
+#endif
+