/*

* Copyright (c) 2007-2008 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:  Data type definitions for Camera Controller.

*

*/

#ifndef CAM_CONTROLLERTYPES_H

#define CAM_CONTROLLERTYPES_H

#include "camcameracontrollerflags.hrh"

#include "camcamerarequests.h"

#ifdef CAMERAAPP_CAPI_V2_ADV

  #include <ecamadvsettings.h>

#endif

// Max video recording time is 1:29:59

// To be moved to a separate constants header.

const TInt64 KMaxRecordingLength = MAKE_TINT64( 1, 0x41CE33C0 );

typedef RArray<TCamCameraRequestId> RCamRequestArray;

enum TCamCameraStateFlags

  {

  ECamIdle      =    0,

  ECamReserved  = 1<<0,

  ECamPowerOn   = 1<<1,

  ECamVFOn      = 1<<2,

  ECamImageOn   = 1<<3,

  ECamVideoOn   = 1<<4

//  ECamCaptureOn = 1<<5

  };

enum TCamCameraCaptureState

  {

  ECamCaptureOff,

  ECamCaptureOn,

  ECamCapturePaused

  };

enum TCamCameraTriState

  {

  ECamTriIdle,

  ECamTriInactive,

  ECamTriActive

  };

enum TCamCameraReadyState

  {

  ECamUnknown,

  ECamNotReady,

  ECamReady

  };

enum TCamViewfinderMode

  {

  ECamViewfinderNone,

  ECamViewfinderBitmap,

  ECamViewfinderDirect

  };

enum TCamCameraControllerBusyFlags

  {

  ECamBusyOff      = 0,

  ECamBusySequence = 1,

  ECamBusySingle   = 2,

  ECamBusySetting  = 4

  };

class TCamVideoRecordingTimes

  {

  public:

    TTimeIntervalMicroSeconds iTimeElapsed;

    TTimeIntervalMicroSeconds iTimeRemaining;

  };

/**

* Camera controller information

*/

class TCamControllerInfo

  {

  // ===================================

  public:

    TCamControllerInfo();

    void Reset( TBool aPreserveBusyFlag    = EFalse,

                TBool aPreserveCameraIndex = EFalse );

    void PrintInfo() const;

  // ===================================

  // Data

  public:

    /** 

    * Current camera index 

    */

    TInt  iCurrentCamera;

    /**

    * Controller overall state.

    * TCamCameraStateFlags ORed.

    */

    TUint                  iState;

    /**

    * Current state of capturing image or video.

    */

    TCamCameraCaptureState iCaptureState;  //< Is capture on, off or paused

    TInt                   iCaptureLimit;  //< Amount of captures  (images) requested

    TInt                   iCaptureCount;  //< Amount of captures  (images) received

    TInt                   iSnapshotCount; //< Amount of snapshots (images) received

    /** 

    * Viewfinder details

    */

    TCamViewfinderMode iVfMode;

    TCamCameraTriState iVfState;

    TSize              iViewfinderSize;

    CCamera::TFormat   iViewfinderFormat;

    /** 

    * Snapshot details

    */

    TCamCameraTriState iSsState;

    TSize              iSnapshotSize;

    CCamera::TFormat   iSnapshotFormat;

    TBool              iSnapshotAspectMaintain;

#ifdef CAMERAAPP_CAPI_V2_ADV

    /**

    * Autofocus range

    */

    CCamera::CCameraAdvancedSettings::TFocusRange iCurrentFocusRange;    

#endif // CAMERAAPP_CAPI_V2_ADV

    /** 

    * Is controller busy handling requests?

    * New requests can not be issued if this is not EBusyOff.

    * CancelSequence and CancelRequest can still be used.

    */

    TUint iBusy;

  // ===================================

  };

#ifdef CAMERAAPP_CAPI_V2_ADV

/**

* Information on advanced settings.

* (These use CCameraAdvancedSettings.)

*

*/

class TCamAdvancedSettingInfo

  {

  // ===================================

  public:

    TCamAdvancedSettingInfo();

    ~TCamAdvancedSettingInfo();

    void Reset();

    void PrintInfo() const;

  // ===================================

  // Data

  //

  // NOTE: Remember to modify Reset() if members are added.

  public:

    // Camera index which this info matches

    TInt         iForCameraIndex;

    // Exposure compenstion support

    TInt         iEvModesSupport;

    RArray<TInt> iEvStepsSupport;

    TValueInfo   iEvStepsValueInfo;

    // ISO rate support

    RArray<TInt> iIsoRatesSupport;

    // Digital zoom steps support

    RArray<TInt> iDigitalZoomSupport;

    TValueInfo   iDigitalZoomValueInfo;

#ifdef CAMERAAPP_CAPI_V2_IP

    // Colour fx support

    RArray<TInt> iColourEffectSupport;

    TValueInfo   iColourEffectValueInfo;

    // Sharpness support

    RArray<TInt> iSharpnessSupport;

    TValueInfo   iSharpnessValueInfo;

#endif

    // Stabilization support

    TInt         iStabilizationModeSupport;

    TInt         iStabilizationEffectSupport;

    TInt         iStabilizationComplexitySupport;

  // ===================================

  };

#endif // CAMERAAPP_CAPI_V2_ADV

/**

* Container for CCamera supported resolutions

* for certain camera index and format.

*/

class TCamCameraResolutionSupport

  {

  // ===================================

  public:

    TCamCameraResolutionSupport();

    ~TCamCameraResolutionSupport();

    void Reset();    

  // ===================================

  // Data

  public:

    TInt             iForCameraIndex;

    TInt             iForCameraFormat;

    RArray<TSize>    iResolutions;

  // ===================================

  };

// ===========================================================================

// Debug strings

#ifdef _DEBUG

const TUint16* const KCamCameraCaptureStateNames[] =

  {

  (const TUint16* const)_S16("ECamCaptureOff"),

  (const TUint16* const)_S16("ECamCaptureOn"),

  (const TUint16* const)_S16("ECamCapturePaused")

  };

const TUint16* const KCamCameraTriStateNames[] =

  {

  (const TUint16* const)_S16("ECamTriIdle"),

  (const TUint16* const)_S16("ECamTriInactive"),

  (const TUint16* const)_S16("ECamTriActive")

  };

const TUint16* const KCamCameraReadyStateNames[] =

  {

  (const TUint16* const)_S16("ECamUnknown"),

  (const TUint16* const)_S16("ECamNotReady"),

  (const TUint16* const)_S16("ECamReady")

  };

const TUint16* const KCamViewfinderModeNames[] =

  {

  (const TUint16* const)_S16("ECamViewfinderNone"),

  (const TUint16* const)_S16("ECamViewfinderBitmap"),

  (const TUint16* const)_S16("ECamViewfinderDirect")

  };

#endif // _DEBUG

#endif // CAM_CONTROLLERTYPES_H

// end of file