1 /*

     2 * Copyright (c) 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:

    15 *

    16 */

    17 #ifndef CXEENGINE_H

    18 #define CXEENGINE_H

    19 

    20 #include <QObject> 

    21 #include "cxenamespace.h"

    22 

    23 class CxeCameraDeviceControl;

    24 class CxeViewfinderControl;

    25 class CxeStillCaptureControl;

    26 class CxeVideoCaptureControl;

    27 class CxeAutoFocusControl;

    28 class CxeZoomControl;

    29 class CxeImageDataQueue;

    30 class CxeFeatureManager;

    31 class CxeSettings;

    32 

    33 /**

    34  * CxeEngine provides the the entry point into CameraX engine. This is the

    35  * first class the client needs to initialize. CxeEngine then provides

    36  * references to other CameraX engine objects. 

    37  */

    38 class CxeEngine : public QObject

    39 {

    40     Q_OBJECT

    41 public:

    42     /**

    43      * Create a new engine instance. This is the first call the client needs to

    44      * do when using CxeEngine.

    45      */

    46     IMPORT_C static CxeEngine* createEngine();

    47 

    48     virtual ~CxeEngine();

    49 

    50     /**

    51      * Access the camera device control.

    52      */

    53     virtual CxeCameraDeviceControl &cameraDeviceControl() = 0;

    54 

    55     /**

    56      * Access the viewfinder control.

    57      */

    58     virtual CxeViewfinderControl &viewfinderControl() = 0;

    59 

    60     /**

    61      * Access the still capture control.

    62      */

    63     virtual CxeStillCaptureControl &stillCaptureControl() = 0;

    64 

    65     /**

    66      * Access the video capture control.

    67      */

    68     virtual CxeVideoCaptureControl &videoCaptureControl() = 0;

    69 

    70     /**

    71      * Access the auto-focus control.

    72      */

    73     virtual CxeAutoFocusControl &autoFocusControl() = 0;

    74 

    75     /**

    76      * Access the zoom control.

    77      */

    78     virtual CxeZoomControl &zoomControl() = 0;

    79 

    80     /**

    81      * Access the settings model.

    82      */

    83     virtual CxeSettings &settings() = 0;

    84     virtual CxeFeatureManager &featureManager() = 0;

    85 

    86     /**

    87      * Get current camera mode.

    88      */

    89     virtual Cxe::CameraMode mode() const = 0;

    90 

    91     /**

    92      * Initialize the camera in either still or video mode. This method is also

    93      * used to switch between modes.

    94      */

    95     virtual void initMode( Cxe::CameraMode cameraMode ) = 0;

    96 

    97     //! returns if the engine is ready or not

    98     virtual bool isEngineReady() = 0;

    99 

   100 protected:

   101     CxeEngine();

   102 

   103 private:

   104     Q_DISABLE_COPY( CxeEngine )

   105 };

   106 

   107 #endif // CXEENGINE_H