camerauis/cameraxui/cxengine/inc/api/cxeengine.h
changeset 19 d9aefe59d544
child 21 fa6d9f75d6a6
equal deleted inserted replaced
3:8b2d6d0384b0 19:d9aefe59d544
       
     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