1 /*

     2 * Copyright (c) 2007-2009 Nokia Corporation and/or its subsidiary(-ies). 

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:  Class for managing intercommunication between Camcera UI*

    15 */

    16 

    17 

    18 #ifndef CAMAPPCONTROLLER_H

    19 #define CAMAPPCONTROLLER_H

    20 

    21 

    22 // ===========================================================================

    23 //  INCLUDES

    24 #include <e32base.h>

    25 

    26 #include <cflistener.h> // publish zoom state related

    27 #include <cfclient.h>

    28 

    29 #include <sensrvdatalistener.h>

    30 #include <sensrvchannel.h>

    31 #include <sensrvorientationsensor.h>

    32 

    33 #include "MCamAppController.h"

    34 #include "CamControllerObservers.h"

    35 #include "mcamsettingsmodelobserver.h"

    36 #include "CamSettings.hrh"

    37 #include "Cam.hrh"          // TCamSoundId

    38 #include "CamSettingsInternal.hrh"

    39 

    40 #include "mcamplayerobserver.h"

    41 

    42 #include "CamImageSaveActive.h"

    43 #include "CamCallStateAo.h"

    44 #include "CamObserver.h"

    45 #include "CamBurstModeObserver.h"

    46 #include "CamPerformance.h"

    47 

    48 #ifndef __WINSCW__

    49 #include <rlocationtrail.h>

    50 #endif

    51 

    52 #include "CamPropertyObserver.h"

    53 

    54 // <CAMERAAPP_CAPI_V2_MIGRATION>

    55 #include "mcamcameraobserver.h" 

    56 #include "camcamerarequests.h"

    57 #include "camfolderutility.h"

    58 #include "camcameracontroller.h"

    59 #include "CamDriveChangeNotifier.h"

    60 #include "CamSyncRotatorAo.h"

    61 

    62 

    63 // ===========================================================================

    64 // CONSTANTS

    65 

    66 // !Do not change the order of these without careful consideration!

    67 // 

    68 enum TCamCameraState

    69   {

    70   ECamCameraIdle          = 0,

    71   ECamCameraReserved      = 1 << 0,

    72   ECamCameraPowerOn       = 1 << 1,

    73   ECamCameraPreparedImage = 1 << 2,

    74   ECamCameraPreparedVideo = 1 << 3,

    75   ECamCameraStateLast // Not valid state, only marker

    76   };

    77 

    78 /**

    79 * Flags for ongoing operations

    80 */

    81 enum TCamBusyFlags

    82   {

    83   EBusyNone     = 0,

    84   EBusyRequest  = 1<<0,

    85   EBusySequence = 1<<1,

    86   EBusySetting  = 1<<2,

    87   EBusyLast // Marker

    88   };

    89 

    90 

    91 // ===========================================================================

    92 // FORWARD DECLARATIONS

    93 class CRepository;

    94 //class CCamSettingsModelBase;

    95 class MCamAppController;

    96 class MCamSettingsModel;

    97 class MCamSettingPreviewHandler;   // <CAMERAAPP_CAPI_V2_MIGRATION/>

    98 //class CCamConstantSettingProvider; // <CAMERAAPP_CAPI_V2_MIGRATION/>

    99 class CCamSettingProvider; // <CAMERAAPP_CAPI_V2_MIGRATION/>

   100 class CCamTimer;

   101 class CCamObserverHandler;

   102 class CCamBurstCaptureArray;

   103 class CCamAudioPlayerController;

   104 class MCamStaticSettings;

   105 class CCamGSInterface;

   106 class CCameraUiConfigManager;

   107 class CCamPropertyWatcher;

   108 class CCamSnapShotRotator;

   109 

   110 

   111 class CCamFlashStatus;

   112 class CCamConfiguration;

   113 class CCFClient;

   114 

   115 // ===========================================================================

   116 // CLASS DECLARATION

   117 

   118 class TCamAppControllerInfo

   119   {

   120   public:

   121     TCamAppControllerInfo();

   122 

   123   public:

   124     TCamActiveCamera      iActiveCamera;

   125 

   126     TCamCameraMode        iMode;

   127     TCamCameraMode        iTargetMode;

   128 

   129     TCamImageCaptureMode  iImageMode; // ECamImageCaptureNone in video controller mode

   130     TCamImageCaptureMode  iTargetImageMode; 

   131 

   132     TCamCaptureOperation iOperation; // Current operation 

   133 

   134     // Target viewfinder state and mode

   135     TCamCameraTriState iTargetVfState;

   136     TBool              iViewfinderMirror; // set when viewfinder initialized

   137 

   138     // Target image parameters        

   139     TInt               iTargetImageResolution;

   140     TInt               iTargetImageQuality;

   141     

   142     // Target video parameters

   143     /** not supported yet */

   144 

   145     // Request being handled        

   146     TCamCameraRequestId iBusyRequestId;

   147   };

   148 

   149 

   150 /**

   151 * Handle intercommunication between camcorder UI and engine.

   152 *

   153 *  @since 2.8

   154 */

   155 class CCamAppController : public CBase, 

   156                           public MCamAppController,

   157                           public MCamSettingsModelObserver,

   158                           public MCamCameraObserver,

   159                           public MCamImageSaveObserver,

   160                           public MCamCallStateObserver,

   161                           public MPropertyObserver,

   162                           public MSensrvDataListener,

   163                           public MCamPlayerObserver,

   164                           public MCamObserver,

   165                           public MCamBurstModeObserver,

   166                           public MCFListener

   167                           ,public MCamDriveChangeNotifierObserver

   168                           ,public MBitmapRotationObserver 

   169                           

   170     {

   171     public:  // Constructors and destructor

   172         

   173         /**

   174         * Two-phased constructor.

   175         * @since 2.8

   176         * @return pointer to the created CCamAppController object

   177         */

   178         static CCamAppController* NewL();

   179         

   180                

   181         /**

   182         * Complete construction of the engine and issue notification requests.

   183         * The camera engine cannot be instantiated until the application

   184         * orientation has been set by the CCamAppUi. This does not

   185         * exist when the CCamAppController is constructed. CompleteConstructionL

   186         * must be called in the CCamAppUi::ConstructL()

   187         * @since 3.0

   188         */ 

   189         void CompleteConstructionL();

   190 

   191         

   192         /**

   193         * Destructor.

   194         * @since 2.8

   195         */

   196         virtual ~CCamAppController();

   197 

   198    public:		

   199      /** 

   200       * Calls CamSettingModel to save user defined FT setting

   201       * @since S60 5.0

   202       * @param None

   203       * @return None

   204       */

   205       void StoreFaceTrackingValue();		

   206 

   207   // -------------------------------------------------------

   208   // From MCamCameraObserver

   209   public:

   210 

   211     virtual void HandleCameraEventL( TInt              aStatus, 

   212                                      TCamCameraEventId aEventId, 

   213                                      TAny*             aEventData /*= NULL*/ );

   214 

   215 

   216 

   217   // -------------------------------------------------------

   218   // from MCamSettingsModelObserver 

   219   public:

   220 

   221     virtual void IntSettingChangedL( TCamSettingItemIds aSettingItem, 

   222                                      TInt               aSettingValue );

   223     virtual void TextSettingChangedL( TCamSettingItemIds aSettingItem, 

   224                                       const TDesC&       aSettingValue );

   225 

   226 

   227   // -------------------------------------------------------

   228   // from MCamBurstModeObserver

   229   

   230     /**

   231     * Burst mode activation has changed

   232     * @since 2.8

   233     * @param aActive whether or not burst mode is active

   234     * @param aStillModeActive whether or not still capture is active

   235     */

   236     virtual void BurstModeActiveL( TBool aActive, TBool aStillModeActive );

   237 

   238   // -------------------------------------------------------

   239   // from MCamAudioPlayerObserver

   240     virtual void PlayComplete( TInt aStatus, TInt aSoundId );

   241 

   242 

   243   // -------------------------------------------------------

   244   public:

   245     // From MCFListener ( Context framework for publishing zoom state.

   246     /**

   247     * Indicates a change in context for subscribed clients.

   248     * If client has subscribed to partial context class path,

   249     * only the changed context will be indicated.

   250     * 

   251     * @since S60 4.0

   252     * @param aIndication: Context indication.

   253     * @return None

   254     */

   255     inline void ContextIndicationL(

   256             const CCFContextIndication& /*aChangedContext*/ ) {};

   257     

   258     /**

   259     * Indicates that specified action is needed to be executed.

   260     * When action indication is received certain rule has been triggered

   261     * and action is needed to be performed.

   262     *

   263     * @since S60 4.0

   264     * @param aActionToExecute Action indication.

   265     * @return None

   266     */

   267     inline void ActionIndicationL(

   268         const CCFActionIndication& /*aActionToExecute*/ ) {};

   269             

   270     /**

   271     * Indicates that error has occured.

   272     * @since S60 4.0

   273     * @param aError Error code.

   274     * @return None

   275     */

   276     inline void HandleContextFrameworkError( TCFError /*aError*/,

   277             const TDesC& /*aSource*/,

   278             const TDesC& /*aType*/ ){};

   279     

   280     /**

   281     * Returns an extension interface.

   282     * The extension interface is mapped with the extension UID.

   283     *

   284     * If the client does not support the requested interface,

   285     * client must return NULL. Otherwise client needs to return

   286     * the correct interface combined with the UID.

   287     *

   288     * @since S60 5.0

   289     * @param aExtensionUid: The identifier of the extension.

   290     * @return Pointer to the extension.

   291     */

   292    inline TAny* Extension( const TUid& /*aExtensionUid*/ ) const { return NULL; };

   293     

   294     // New Function

   295 

   296     /*

   297     * Method to publish the zoom key and setting the

   298     * value or the state to enabled or disabled.

   299     * @Paran aEnabled used to set the the state of zoom key

   300     * to be enabled or disabled.

   301     */

   302     void PublishZoomStateL( const TBool aEnabled );

   303 

   304   public: 

   305     

   306       /**

   307       * Returns whether or not the current profile is silent

   308       * @since 3.0

   309       * @return ETrue if current profile is silent

   310       */

   311       TBool IsProfileSilent();    

   312     

   313       /**

   314       * Returns whether or not we have touch screen support in the device

   315       * @return ETrue if device supports touch screen

   316       */

   317       TBool IsTouchScreenSupported();

   318     

   319       /**

   320       * Returns whether or not we have direct screen viewfinder support in the device

   321       * @return ETrue if device supports direct screen viewfinder

   322       */

   323       TBool IsDirectScreenVFSupported( TBool aPrimaryCamera = ETrue );

   324     

   325 	// ---------------------------------------------------------------------------

   326 	//Helper function for making notification about deleted files

   327 	//Added this method to do notification if files have been

   328 	//deleted outside camera application and then camera is

   329 	//put back to foreground in postcapture view.

   330 	//Security note. Contents of the files might have been

   331 	//changed when camera was in background.

   332 	// ---------------------------------------------------------------------------

   333 	//

   334 	void  MediaFileChangedNotification();

   335     

   336 	TBool EngineRequestsPending() const; 	

   337     /**

   338     * Set settings restore to be done at earliest

   339     * convenient time.

   340     */

   341     void  SetSettingsRestoreNeeded();

   342 

   343     /**

   344     * Set the flag to indicate that the original values 

   345     * of remaining images is stored

   346     */

   347      void SetRemainingImageStored();

   348     

   349     /** 

   350     * Returns the flag that indicates if the original value 

   351     * of remaing images is stored or not.

   352     */    

   353      TBool IsRemainingImageStored() const;

   354     

   355     /** 

   356     * Return whether saving is still in progress.

   357     */    

   358     TBool IsSavingInProgress() const;

   359      

   360     /**

   361     * Return if settings restore is set pending.

   362     */

   363     TBool IsSettingsRestoreNeeded() const;

   364   

   365 	

   366     void RestartTimeLapseTimerL();

   367 	

   368   

   369     static TInt CamerasAvailable();

   370 

   371     /**

   372     * Is time lapse supported.

   373     * Value read from Central Repository.

   374     */

   375     TBool TimeLapseSupported();

   376     

   377     /**

   378     * Is time lapse supported.

   379     * Value read from Central Repository.

   380     */

   381     TBool AlwaysOnSupported();

   382 

   383     /**

   384     * Release version number.

   385     * Value read from Central Repository.

   386     */

   387     const TVersion& Version();

   388 

   389     /***

   390     * Can a new request be made to controller or not.

   391     * Shutdown may be requested at any moment.

   392     */

   393     TBool Busy() const;

   394 

   395     /**

   396     * Returns true if the last captured image was saved

   397     * @since 2.8

   398     * @return ETrue if the last captured image has been saved.

   399     */

   400     TBool SavedCurrentImage() const;

   401 

   402     /**

   403     * Rename image/video.

   404     * @since 2.8

   405     * @param aNewName the new name for the current capture array file.

   406     * @param aMode the current capture mode.

   407     * @return ETrue if the file has been renamed successfully. 

   408     */

   409     TBool RenameCurrentFileL( const TDesC&          aNewName, 

   410                               const TCamCameraMode& aMode    );

   411 

   412     /**

   413     * Add a controller observer.

   414     * @since 2.8

   415     * @param aObserver Pointer to an object implementing 

   416     *                   MCamControllerObserver

   417     * @return ?description

   418     */

   419     void AddControllerObserverL( const MCamControllerObserver* aObserver );

   420 

   421     /**

   422     * Remove a controller observer

   423     * @since 2.8

   424     * @param aObserver Pointer to the observer to remove. The object

   425     *                  does not have to be added as an observer.

   426     */

   427     void RemoveControllerObserver

   428         ( const MCamControllerObserver* aObserver );

   429 

   430     /**

   431     * Add camera observer.

   432     * Forwards call to CCamCameraController.

   433     * @see CCamCameraController for more details.

   434     */

   435     void AddCameraObserverL( const MCamCameraObserver* aObserver, 

   436                              const TUint&              aEventInterest );

   437     

   438     /**

   439     * Removes camera observer.

   440     * Forwards call to CCamCameraController.

   441     * @see CCamCameraController for more details.

   442     */

   443     void RemoveCameraObserver( const MCamCameraObserver* aObserver );

   444 

   445     void AddSettingsObserverL( const MCamSettingsModelObserver* aObserver );

   446     void RemoveSettingsObserver( const MCamSettingsModelObserver* aObserver );

   447 

   448     TBool CameraControllerBusy() const;

   449     TUint CameraControllerState() const;

   450 

   451     TCamCameraState       CameraState() const;

   452     TCamCameraMode        CurrentMode() const;

   453     TCamCameraMode        TargetMode() const;

   454     TCamImageCaptureMode  CurrentImageModeSetup() const;

   455     TCamCaptureOperation  CurrentOperation() const;

   456     TCamCaptureOperation  CurrentImageOperation() const;

   457     TCamCaptureOperation  CurrentVideoOperation() const;

   458     TCamImageCaptureMode  CurrentImageMode() const;

   459     

   460 

   461     TInt CaptureLimit() const;

   462     TInt CaptureLimitSetting() const;

   463     void SetCaptureLimitL( TInt aLimit );

   464     

   465     /**

   466     * From MBitmapRotationObserver

   467     * Notification of bitmap rotation complete events

   468     * @param aErr KErrNone if successful

   469     */

   470     void RotationCompleteL( TInt aErr );

   471 

   472 private:

   473     void ReadVariantFlagsL();

   474 

   475 

   476     void SetMode( const TCamCameraMode& aNewMode );

   477     void SetTargetMode( const TCamCameraMode& aNewMode );

   478 

   479     void SetImageMode( const TCamImageCaptureMode& aNewMode );

   480     void SetTargetImageMode( const TCamImageCaptureMode& aNewMode );

   481     

   482     void SetOperation( TCamCaptureOperation aNewOperation, 

   483                        TInt                 aError = KErrNone );

   484                                      

   485     TCamCameraTriState ViewfinderTargetState() const;

   486 

   487 

   488 public:

   489     /*

   490      *  Handle to Camera Ui Config Manager

   491      */

   492     CCameraUiConfigManager* UiConfigManagerPtr();

   493     

   494     /*

   495     * De-register harvester client events.

   496     */

   497     void DeRegisterHarverterClientEvents();

   498         

   499     /**

   500     * Return resource id for video viewfinder layout

   501     * @since 3.0

   502     * @param aResolution for current resolution

   503     * @return Resource id for video viewfinder layout

   504     */

   505     TInt VideoViewFinderResourceId( TCamVideoResolution aResolution );

   506 

   507     /**

   508     * Start the viewfinder for the specified mode

   509     * as soon as the engine is intialised

   510     * @since 2.8

   511     * @param aMode The viewfinder mode being entered

   512     */

   513     void EnterViewfinderMode( const TCamCameraMode& aMode );

   514 

   515     /**

   516     * ExitViewinderMode    

   517     * @since 2.8

   518     * @param aMode The viewfinder mode being exited

   519     */

   520     void ExitViewfinderMode( const TCamCameraMode& aMode );

   521 

   522     /**

   523     * FreezeViewFinder    

   524     * @since 2.8

   525     * @param aFreeze Whether or not the viewfinder is

   526     * being frozen after this frame

   527     */

   528     void FreezeViewFinder( TBool aFreeze );

   529 

   530     /**

   531     * Return number of images that can still be captured

   532     * @since 2.8

   533     * @param aStorage storage location - defaults to current loation

   534     * @param aBurstActive - set to ETrue if burst mode is active

   535     * @return the number of images

   536     */

   537     TInt ImagesRemaining( TCamMediaStorage aStorage,

   538                           TBool            aBurstActive );

   539 

   540     /**

   541     * Return number of images that can still be captured for a particular

   542     * image quality

   543     * @since 2.8

   544     * @param aStorage storage location - defaults to current loation

   545     * @param aBurstActive - set to ETrue if burst mode is active

   546     * @param aQualityIndex - index of the image quality

   547     * @return the number of images

   548     */

   549     TInt ImagesRemaining( TCamMediaStorage aStorage,

   550                           TBool            aBurstActive, 

   551                           TInt             aQualityIndex );

   552 

   553     /**

   554     * Return amount of video that has been captured

   555     * @since 2.8

   556     * @return the amount of video in micro secs

   557     */

   558     TTimeIntervalMicroSeconds RecordTimeElapsed() const;

   559 

   560 

   561     /**

   562     * Set amount of video that has been captured

   563 	* @param aElapsed - recorded video time.

   564     */

   565     void RecordTimeElapsed(TTimeIntervalMicroSeconds aElapsed );

   566 

   567 

   568     /*

   569     * Return amount of video that can still be captured

   570     * @since 2.8

   571     * @return the amount of video in secs

   572     */

   573     TTimeIntervalMicroSeconds RecordTimeRemaining();

   574 

   575     /**

   576     * Updates the interval used in next TimeLapse capture

   577     * @since 3.0

   578     * @param aInterval The new interval to use

   579     */        

   580     void SetTimeLapseInterval( TTimeIntervalMicroSeconds aInterval );   

   581 

   582     /**

   583     * Returns the interval used in next TimeLapse capture

   584     * @since 3.0

   585     * @return The current time lapse interval in microseconds

   586     */

   587     TTimeIntervalMicroSeconds TimeLapseInterval();

   588     

   589     /**

   590     * Returns the remaining time lapse interval until the next capture

   591     * @since 3.0

   592     * @return The remaining time to the next timelapse capture

   593     */

   594     TTimeIntervalMicroSeconds TimeLapseCountdown();

   595 

   596     /** 

   597     * Start the autofocus procedure

   598     * @since 2.8

   599     */

   600     void StartAutoFocus();

   601 

   602     /**

   603     * Begin the capture procedure

   604     * @since 2.8

   605     */

   606     void Capture();               

   607 

   608     /**

   609     * Stop the burst capture operation

   610     * @since 2.8

   611     */

   612     void StopSequenceCaptureL();

   613 

   614     /**

   615     * Whether or not a still capture operation is pending

   616     * i.e. a request to start still capture has been made and is 

   617     * waiting for the focus operation to complete.

   618     * @since 2.8

   619     * @return ETrue if a still capture operation is pending

   620     */

   621     TBool CapturePending() const;

   622 

   623 	/**

   624     * Whether or not a capture key pressed during image saving

   625     * @since 2.8

   626     * @return ETrue if capture key is pressed during image saving

   627     */

   628     TBool CaptureKeyPressedWhileImageSaving() const;

   629 

   630 	/**

   631     * Stores shutter key press during saving image

   632     * @since 2.8

   633     */

   634     void SetCaptureKeyPressedWhileImageSaving(TBool aCaptureKeyPressed);

   635     

   636     /**

   637     * Whether or not a video recording operation is pending

   638     * i.e. a request to start video recording has been made and is

   639     * waiting for the engine to complete a video name update operation.

   640     * @since 2.8

   641     * @return ETrue if a record operation is pending

   642     */

   643     TBool VideoRecordPending() const;

   644 

   645     /**

   646     * Whether or not a sequence capture is in progress

   647     * @since 2.8

   648     * @return ETrue if a sequence capture is in progress

   649     */

   650     TBool SequenceCaptureInProgress() const;

   651 

   652     /**

   653     * Begin the recording procedure

   654     * @since 2.8

   655     */

   656     void StartVideoRecordingL();

   657 

   658     /**

   659     * End the recording procedure

   660     * @since 2.8

   661     */

   662     void StopVideoRecording();

   663 

   664     /**

   665     * End the recording procedure

   666     * @since 5.0

   667     */

   668     void StopVideoRecordingAsync();

   669     

   670     /**

   671     * Store the cause of the video stop

   672     * @since 3.0

   673     */

   674     void SetVideoStoppedForPhoneApp( TBool aIsPhoneApp );

   675 

   676     /**

   677     * Pause the recording procedure

   678     * @since 2.8

   679     */

   680     void PauseVideoRecording();

   681 

   682     /**

   683     * Continue the recording procedure

   684     * @since 2.8

   685     */

   686     void ContinueVideoRecording();

   687 

   688     /**

   689     * Issue AF request.

   690     */

   691     TBool TryAFRequest( TInt aAFRequest );

   692     

   693     /**

   694     * Cancel ongoing AutoFocus.

   695     */

   696     void CancelAFNow();

   697 	

   698     /**

   699     * Cancel a requested capture

   700     * @since 2.8

   701     */

   702     void CancelFocusAndCapture();

   703 

   704     /**

   705     * Return the current snapshot image

   706     * @since 2.8

   707     * @return the current snapshot image

   708     */

   709     const CFbsBitmap* SnapshotImage() const;

   710 

   711     /**

   712     * Sets the specified burst mode item as the current image, in 

   713     * preparation for a Post-capture view of the image.

   714     * @since 2.8        

   715     * @param aIndex The index of the burst item in "CCamBurstCaptureArray"

   716     */

   717     void SetAsCurrentImage( TInt aIndex );

   718 

   719     /**

   720     * Get the user-visible name for next image.

   721     * @since 2.8

   722     * @return file name for the current image or video without path or

   723     *         extension

   724     */

   725     const TDesC& CurrentImageName() const;

   726 

   727     /**

   728     * Delete the current image/video file

   729     * @since 2.8

   730         * @param aNofity Should notification be sent to observers about

   731         *                change in media files. When this call is made

   732         *                several times in a row, it's worth to do the

   733         *                notification only once.

   734     * @return KErrNone if delete successful, otherwise system-wide 

   735     * error code

   736     */

   737     TInt DeleteCurrentFile( TBool aNotify = ETrue );

   738     

   739     /**

   740     * Delete the timelapse sequence files

   741     * @since 3.0

   742     */

   743     void DeleteTimeLapseFiles();

   744     

   745     /**

   746     * Indicate whether or not the controller is actively engaged in still

   747     * or video capture - this includes paused video, saving photos/videos,

   748     * periods in between timelapse captures and pending captures 

   749     * (captures that have been requested but not yet started)

   750     * @since 3.0

   751     * @return EFalse if not currently capturing, otherwise ETrue

   752     */

   753     TBool IsProcessingCapture();

   754     

   755     /**

   756     * Complete current capture asap, then report completion to the observer

   757     * @since 3.0

   758     * @param aObserver To be notified when the current capture process completes

   759     * @param aSafeCompletion ETrue if all captures should be saved. EFalse to complete 

   760     * sooner and lose any images that have not yet begun to save

   761     */

   762     void CompleteCaptureAndNotifyL( MCamObserver* aObserver, TBool aSafeCompletion );

   763 

   764     /**

   765     * The application is closing. Complete any active operations then

   766     * exit the application.

   767     * @param aImmediateShutdown ETrue: shutdown immediately or 

   768     * EFalse: wait for pending operations to complete.

   769     * @since 2.8

   770     */

   771     void EnterShutdownMode( TBool aImmediateShutdown );

   772 

   773     /**

   774     * Whether or not the controller is in shutdown mode

   775     * @since 2.8

   776     * @return ETrue if the controller is in shutdown mode else EFalse

   777     */

   778     TBool IsInShutdownMode() const;

   779       

   780     /**

   781     * Returns true if AppUi has been constructed, and not yet

   782     * destructed.               

   783     */

   784     TBool IsAppUiAvailable() const;

   785     

   786     /**

   787     * Sets AppUi availablility (see IsAppUiAvailable())

   788     */

   789     void SetAppUiAvailable( TBool aAvailable );        

   790 

   791 

   792     /**

   793     * Called to return the range of supported zoom values

   794     * @since 2.8

   795     * @param aMinZoom on return contains the minimum zoom value

   796     * @param aMaxZoom on return contains the maximum zoom value

   797     */

   798     void GetZoomRange( TInt& aMinZoom, TInt& aMaxZoom ) const;

   799 

   800     /**

   801     * Called to return current zoom value

   802     * @since 2.8

   803     * @return the current zoom value

   804     */

   805     TInt ZoomValue() const;

   806 

   807     /**

   808     * Sets the current zoom value

   809     * @since 2.8

   810     * @param aValue the new zoom value to be used

   811     */

   812     void SetZoomValue( TInt aValue );

   813 

   814     /**

   815     * Resets all user scene settings to their defaults.

   816     * @since 2.8

   817     */

   818         void ResetUserSceneL();

   819  

   820         /**

   821     * Previews a new value for the specified integer setting

   822     * @param aSettingItem specifies which setting item that want 

   823     * to preview.

   824     * @param aSettingValue the new integer value for the specified 

   825     * setting item to be previewed.

   826     * @since 2.8

   827     */

   828     void PreviewSettingChangeL( TInt aSettingItem, TInt aSettingValue );

   829 

   830     /**

   831     * Cancels all preview changes, since last commit/cancel.

   832     * @since 2.8

   833     */

   834     void CancelPreviewChangesL();

   835 

   836     /**

   837     * Commits last preview change.

   838     * @since 2.8

   839     */

   840     void CommitPreviewChanges();

   841 

   842     /**

   843     * Re-prepare video after e.g. a setting change requires this.

   844     */

   845     void RePrepareVideoL();

   846 

   847     /**

   848     * Returns the current integer value for the specified setting

   849     * @return the current integer setting value

   850     * @param aSettingItem specifies which setting item that want 

   851     * the value of.

   852     * @since 2.8

   853     */

   854     TInt IntegerSettingValue( TInt aSettingItem ) const;

   855 

   856     /**

   857     * Returns the current integer value for the specified setting

   858     * without the filtering usually performed on storage location.

   859     * This is neccesary to allow the video/photo settings list to show

   860     * the selected storage location rather than the forced storage location.

   861     * @return the current integer setting value

   862     * @param aSettingItem specifies which setting item that want the value of.

   863     * @since 2.8

   864     */

   865     TInt IntegerSettingValueUnfiltered( TInt aSettingItem ) const;

   866 

   867     /**

   868     * Sets a new value for the specified integer setting

   869     * @param aSettingItem specifies which setting item that want 

   870     * to set the value of.

   871     * @param aSettingValue the new integer value for the specified 

   872     * setting item.

   873     * @since 2.8

   874     */

   875     void SetIntegerSettingValueL( TInt aSettingItem, TInt aSettingValue );

   876 

   877     /**

   878     * Sets pathnames for video and image files to point to the specified storage

   879     * @param aMediaStorage specifies phone memory or MMC

   880     * @since 2.8

   881     */

   882     void SetPathnamesToNewStorageL( TCamMediaStorage aMediaStorage );

   883 

   884    /**

   885     * Sets a new text value for the specified setting

   886     * @param aSettingItem specifies which setting item that want to set

   887     * the text value of.

   888     * @param aSettingValue the new text value for the specified setting 

   889     * item.

   890     * @since 2.8

   891     */

   892     void SetTextSettingValueL( TInt aSettingItem, 

   893         const TDesC& aSettingValue );

   894 

   895 

   896     /**

   897     * Returns the current text value for the specified setting

   898     * @return the current text setting value

   899     * @param aSettingItem specifies which setting item that want 

   900     * the text value of.

   901     * @since 2.8

   902     */

   903     TPtrC TextSettingValue( TInt aSettingItem ) const;

   904 

   905     /**

   906     * Returns whether a particular setting value can be set or not.

   907     * @return ETrue if can be set. Otherwise, EFalse.

   908     * @param aSettingItem the setting item in question. 

   909     * @param aSettingValue the value in question. 

   910     * @since 2.8

   911     */

   912     TBool SettingValueEnabled( TInt aSettingItem, TInt aSettingValue ) const;

   913 

   914     /**

   915     * Loads the settings from shared data, or if unable to from the 

   916     * resource file. 

   917     * @param aIsEmbedded whether or not the application is running in

   918     * embedded mode.

   919     * @since 2.8

   920     */       

   921     void LoadStaticSettingsL( TBool aIsEmbedded );   

   922 

   923     /**

   924     * Get the default value for a setting item.

   925     * @param  aSettingId The id of the setting.

   926     * @return The default value for setting item or KErrNotFound if not found.

   927     */

   928     TInt DynamicSettingDefaultValue( TInt aSettingId ) const;

   929 

   930     /**

   931     * Sets all dynamic settings to their defaults.

   932     * @since 2.8

   933     */       

   934     void SetDynamicSettingsToDefaults();

   935 

   936     /**

   937     * Sets a single dynamic setting to its default.

   938     * @since 2.8

   939     */       

   940     void SetDynamicSettingToDefault(TInt aSettingItem);

   941     

   942     /**

   943     * Set scene default value to a dynamic setting.

   944     * @param aSceneId    Id of the scene to use.

   945     * @param aSceneField Id of scene field.

   946     * @param aSettingId  If of the dynamic setting to set.

   947     * @param aVideoScene Does aSceneId refer to a video scene.

   948     * @return KErrNotFound, if setting could not be set.

   949     */

   950     TInt SetDynamicSettingToSceneDefaultL( TInt  aSceneId,

   951                                            TInt  aSceneField,

   952                                            TInt  aSettingId,

   953                                            TBool aVideoScene );

   954     

   955 

   956 #ifdef PRODUCT_USES_GENERIC_SETUP_INDICATOR

   957     /**

   958     * Returns whether or not the video setup settings are set to the

   959     * defaults for its current scene.

   960     * @since 2.8

   961     * @return ETrue if set to defaults. Otherwise, EFalse

   962     */       

   963     TBool VideoSceneDefaultsAreSet();

   964 

   965     /**

   966     * Returns whether or not the photo setup settings are set to the

   967     * defaults for its current scene.

   968     * @since 2.8

   969     * @return ETrue if set to defaults. Otherwise, EFalse

   970     */       

   971     TBool PhotoSceneDefaultsAreSet();

   972 #endif // PRODUCT_USES_GENERIC_SETUP_INDICATOR

   973 

   974     /**

   975     * Returns the file name of the most recent saved image/video clip

   976     * @return Filename of most recent captured image/video 

   977     * @since 2.8

   978     */

   979     const TDesC& CurrentFullFileName() const;

   980 

   981     /**

   982     * Get the current video filename.

   983     */

   984     const TDesC& CurrentVideoFileName() const;

   985 

   986     /**

   987     * Returns a pointer to an array representing the images in a burst

   988     * capture

   989     * @return reference to the burst capture array

   990     * @since 2.8

   991     */

   992     CCamBurstCaptureArray* BurstCaptureArray() const;

   993 

   994     /**

   995     * Returns the number of non-deleted items in the array

   996     * @return count of non-deleted items

   997     * @since 2.8

   998     */

   999     TInt CurrentItemCount();

  1000     

  1001     /**

  1002     * Returns the number of burst capture moments that have taken

  1003     * place in a current burst. If no burst is active this returns

  1004     * 0

  1005     * @return count of burst capture moments

  1006     * @since 3.0

  1007     */

  1008     TInt CurrentCapturedCount();

  1009     

  1010     /**

  1011     * Returns the number of items in a timelapse sequence

  1012     * @return count of timelapse sequence items

  1013     * @since 3.0

  1014     */

  1015     TInt TimeLapseImageCount();

  1016  

  1017     /**

  1018     * Resets the array of filenames used in timelapse capture

  1019     * @since 3.0

  1020     */   

  1021     void ResetTimelapseArray();

  1022 

  1023     /**

  1024     * Initiates the playing of the specified sound.

  1025     * @since 2.8

  1026     * @param aSoundId The enum value of the sound to play

  1027     * @param aEnableCallback Whether we want a callback when play complete

  1028     */

  1029     void PlaySound( TCamSoundId aSoundId, TBool aEnableCallback );

  1030 

  1031     /**

  1032     * Initiates the playing of the specified tone

  1033     * @since 2.8

  1034     * @param aToneHz The frequency of the tone to play in Hertz

  1035     * @param aLenMicSec The length of tone to play in microseconds

  1036     * @param aVolume The volume of the tone, range 0.0 to 1.0

  1037     * @param aEnableCallback Whether to be called back when playback complete

  1038     */

  1039     void PlayTone( TInt aToneHz, TInt aLenMicSec, TReal32 aVolume,  TBool aEnableCallback );

  1040 

  1041     /** 

  1042     * Releases the camera hardware for other apps to use

  1043     * @since 2.8

  1044     */

  1045     void ReleaseCamera();

  1046 

  1047     /**

  1048     * Increments the engine usage count

  1049     * @since 2.8

  1050     */

  1051     void IncCameraUsers();

  1052 

  1053     /**

  1054     * Decrements the engine usage count If the engine is no longer required

  1055     * then it is released. If it is still processing, the engine count will 

  1056     * be checked when the current process completes and the engine will be 

  1057     * released if it is no longer needed.

  1058     * @since 2.8

  1059     */

  1060     void DecCameraUsers();

  1061     

  1062     /*

  1063     * Gets the handle to the static settings model, which is used inturn by the

  1064     * plugin to call the interfaces for performing needed actions.

  1065     */

  1066     MCamStaticSettings& StaticSettingsModel();

  1067     

  1068     /*

  1069     * Check if image/video scene mode is supported

  1070     */

  1071     TBool IsSceneSupported( const TInt aSceneId, TBool aPhotoScene = ETrue  ) const;

  1072 

  1073     /** 

  1074     * Whether a call is active, including the ringing state

  1075     * @since 2.8

  1076     * @return ETrue if in call or ringing, else EFalse

  1077     */

  1078     TBool InCallOrRinging() const;

  1079 

  1080     /** 

  1081     * Whether a video call is active, including the ringing state

  1082     * @return ETrue if in videocall or ringing, else EFalse

  1083     */

  1084     TBool InVideocallOrRinging();

  1085     

  1086     /** 

  1087     * Whether or not a video clip is currently being saved

  1088     * @since 2.8

  1089     * @return ETrue if saving, else EFalse

  1090     */

  1091     TBool CurrentlySavingVideo() const;

  1092 

  1093     /**

  1094     * Returns whether all the settings list options for a particular setting

  1095     * item are visible or not

  1096     * @since 2.8

  1097     * @param aSettingItem The setting item to be checked.

  1098     * @param aRevisedResourceId Receives the id of a resource if the return

  1099     * value is EFalse. The resource contains the list of  visible

  1100     * options.

  1101     * @return ETrue if all options are visible. Otherwise, EFalse.

  1102     */

  1103     TBool AllOptionsVisibleForSettingItem( TInt aSettingItem, 

  1104                                                    TInt& aRevisedResourceId );

  1105 

  1106     /**

  1107     * Switches the camera being used

  1108     * @since 2.8

  1109     */

  1110     void SwitchCameraL();

  1111 

  1112     /**

  1113     * Returns the active camera

  1114     * @since 2.8

  1115     * @return @return either primary, secondary or none ( if in process of switching )

  1116     */

  1117     TCamActiveCamera ActiveCamera() const;

  1118     

  1119     /**

  1120     * Whether we currently have a camera switch required

  1121     * @since 2.8

  1122     * @return TCameraSwitchRequired a camera switch is required or not

  1123     */

  1124     TCameraSwitchRequired CameraSwitchQueued() const;

  1125 

  1126     /**

  1127     * Check if exit is required

  1128     * @since 2.8

  1129     * @return TBool True if exit is required

  1130     */

  1131     TBool CheckExitStatus();

  1132         

  1133     /**

  1134     * Informs the controller that an end key event is waiting