qtmobility/src/multimedia/experimental/qimagecapturecontrol.cpp
changeset 4 90517678cc4f
parent 1 2b40d63a9c3d
child 5 453da2cfceef
equal deleted inserted replaced
1:2b40d63a9c3d 4:90517678cc4f
     1 /****************************************************************************
       
     2 **
       
     3 ** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
       
     4 ** All rights reserved.
       
     5 ** Contact: Nokia Corporation (qt-info@nokia.com)
       
     6 **
       
     7 ** This file is part of the Qt Mobility Components.
       
     8 **
       
     9 ** $QT_BEGIN_LICENSE:LGPL$
       
    10 ** No Commercial Usage
       
    11 ** This file contains pre-release code and may not be distributed.
       
    12 ** You may use this file in accordance with the terms and conditions
       
    13 ** contained in the Technology Preview License Agreement accompanying
       
    14 ** this package.
       
    15 **
       
    16 ** GNU Lesser General Public License Usage
       
    17 ** Alternatively, this file may be used under the terms of the GNU Lesser
       
    18 ** General Public License version 2.1 as published by the Free Software
       
    19 ** Foundation and appearing in the file LICENSE.LGPL included in the
       
    20 ** packaging of this file.  Please review the following information to
       
    21 ** ensure the GNU Lesser General Public License version 2.1 requirements
       
    22 ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
       
    23 **
       
    24 ** In addition, as a special exception, Nokia gives you certain additional
       
    25 ** rights.  These rights are described in the Nokia Qt LGPL Exception
       
    26 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
       
    27 **
       
    28 ** If you have questions regarding the use of this file, please contact
       
    29 ** Nokia at qt-info@nokia.com.
       
    30 **
       
    31 **
       
    32 **
       
    33 **
       
    34 **
       
    35 **
       
    36 **
       
    37 **
       
    38 ** $QT_END_LICENSE$
       
    39 **
       
    40 ****************************************************************************/
       
    41 
       
    42 #include <experimental/qimagecapturecontrol.h>
       
    43 #include <QtCore/qstringlist.h>
       
    44 
       
    45 QTM_BEGIN_NAMESPACE
       
    46 
       
    47 /*!
       
    48     \class QImageCaptureControl
       
    49     
       
    50     \brief The QImageCaptureControl class provides a control interface
       
    51     for image capture services.
       
    52 
       
    53     \ingroup camera
       
    54 
       
    55     \preliminary
       
    56 
       
    57     The interface name of QImageCaptureControl is \c com.nokia.Qt.QImageCaptureControl/1.0 as
       
    58     defined in QImageCaptureControl_iid.
       
    59 
       
    60 The Camera API of Qt Mobility is still in \bold Technology Preview. It has not undergone
       
    61 the same level of review and testing as the rest of the APIs.
       
    62 
       
    63 The API exposed by the classes in this component are not stable, and will
       
    64 undergo modification or removal prior to the final release of Qt Mobility.
       
    65 
       
    66     \sa QMediaService::control()
       
    67 */
       
    68 
       
    69 /*!
       
    70     \macro QImageCaptureControl_iid
       
    71 
       
    72     \c com.nokia.Qt.QImageCaptureControl/1.0
       
    73 
       
    74     Defines the interface name of the QImageCaptureControl class.
       
    75 
       
    76     \relates QImageCaptureControl
       
    77 */
       
    78 
       
    79 /*!
       
    80     Constructs a new image capture control object with the given \a parent
       
    81 */
       
    82 QImageCaptureControl::QImageCaptureControl(QObject *parent)
       
    83     :QMediaControl(parent)
       
    84 {
       
    85 }
       
    86 
       
    87 /*!
       
    88     Destroys an image capture control.
       
    89 */
       
    90 QImageCaptureControl::~QImageCaptureControl()
       
    91 {
       
    92 }
       
    93 
       
    94 /*!
       
    95     \fn QImageCaptureControl::isReadyForCapture() const
       
    96 
       
    97     Identifies if a capture control is ready to perform a capture.
       
    98 
       
    99     Returns true if the control is ready; and false if it is not.
       
   100 */
       
   101 
       
   102 /*!
       
   103     \fn QImageCaptureControl::readyForCaptureChanged(bool ready)
       
   104 
       
   105     Signals that a capture control's \a ready state has changed.
       
   106 */
       
   107 
       
   108 /*!
       
   109     \fn QImageCaptureControl::capture(const QString &fileName)
       
   110 
       
   111     Initiates the capture of an image to \a fileName.
       
   112 */
       
   113 
       
   114 /*!
       
   115     \fn QImageCaptureControl::imageCaptured(const QString &fileName, const QImage &preview)
       
   116 
       
   117     Signals that an image intendec to be saved to to \a fileName
       
   118     has been captured and a \a preview is available.
       
   119 */
       
   120 
       
   121 
       
   122 /*!
       
   123     \fn QImageCaptureControl::imageSaved(const QString &fileName)
       
   124 
       
   125     Signals that an captured image has been saved to \a fileName.
       
   126 */
       
   127 
       
   128 #include "moc_qimagecapturecontrol.cpp"
       
   129 QTM_END_NAMESPACE
       
   130