| /**************************************************************************** |
| ** |
| ** Copyright (C) 2016 The Qt Company Ltd. |
| ** Contact: https://www.qt.io/licensing/ |
| ** |
| ** This file is part of the plugins of the Qt Toolkit. |
| ** |
| ** $QT_BEGIN_LICENSE:LGPL$ |
| ** Commercial License Usage |
| ** Licensees holding valid commercial Qt licenses may use this file in |
| ** accordance with the commercial license agreement provided with the |
| ** Software or, alternatively, in accordance with the terms contained in |
| ** a written agreement between you and The Qt Company. For licensing terms |
| ** and conditions see https://www.qt.io/terms-conditions. For further |
| ** information use the contact form at https://www.qt.io/contact-us. |
| ** |
| ** GNU Lesser General Public License Usage |
| ** Alternatively, this file may be used under the terms of the GNU Lesser |
| ** General Public License version 3 as published by the Free Software |
| ** Foundation and appearing in the file LICENSE.LGPL3 included in the |
| ** packaging of this file. Please review the following information to |
| ** ensure the GNU Lesser General Public License version 3 requirements |
| ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. |
| ** |
| ** GNU General Public License Usage |
| ** Alternatively, this file may be used under the terms of the GNU |
| ** General Public License version 2.0 or (at your option) the GNU General |
| ** Public license version 3 or any later version approved by the KDE Free |
| ** Qt Foundation. The licenses are as published by the Free Software |
| ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 |
| ** included in the packaging of this file. Please review the following |
| ** information to ensure the GNU General Public License requirements will |
| ** be met: https://www.gnu.org/licenses/gpl-2.0.html and |
| ** https://www.gnu.org/licenses/gpl-3.0.html. |
| ** |
| ** $QT_END_LICENSE$ |
| ** |
| ****************************************************************************/ |
| |
| #include "qdeclarativecamera_p.h" |
| #include "qdeclarativecameraflash_p.h" |
| |
| QT_BEGIN_NAMESPACE |
| |
| /*! |
| \qmltype CameraFlash |
| \instantiates QDeclarativeCameraFlash |
| \inqmlmodule QtMultimedia |
| \brief An interface for flash related camera settings. |
| \ingroup multimedia_qml |
| \ingroup camera_qml |
| |
| This type allows you to operate the camera flash |
| hardware and control the flash mode used. Not all cameras have |
| flash hardware (and in some cases it is shared with the |
| \l {Torch}{torch} hardware). |
| |
| It should not be constructed separately, instead the |
| \c flash property of a \l Camera should be used. |
| |
| \qml |
| |
| Camera { |
| id: camera |
| |
| exposure.exposureCompensation: -1.0 |
| flash.mode: Camera.FlashRedEyeReduction |
| } |
| |
| \endqml |
| */ |
| |
| /*! |
| Construct a declarative camera flash object using \a parent object. |
| */ |
| QDeclarativeCameraFlash::QDeclarativeCameraFlash(QCamera *camera, QObject *parent) |
| : QObject(parent) |
| { |
| m_exposure = camera->exposure(); |
| connect(m_exposure, SIGNAL(flashReady(bool)), this, SIGNAL(flashReady(bool))); |
| connect(camera, SIGNAL(statusChanged(QCamera::Status)), |
| this, SLOT(_q_cameraStatusChanged(QCamera::Status))); |
| } |
| |
| QDeclarativeCameraFlash::~QDeclarativeCameraFlash() |
| { |
| } |
| |
| /*! |
| \qmlproperty bool QtMultimedia::CameraFlash::ready |
| |
| This property indicates whether the flash is charged. |
| */ |
| bool QDeclarativeCameraFlash::isFlashReady() const |
| { |
| return m_exposure->isFlashReady(); |
| } |
| |
| /*! |
| \qmlproperty enumeration QtMultimedia::CameraFlash::mode |
| |
| This property holds the camera flash mode. |
| |
| The mode can be one of the following: |
| \table |
| \header \li Value \li Description |
| \row \li Camera.FlashOff \li Flash is Off. |
| \row \li Camera.FlashOn \li Flash is On. |
| \row \li Camera.FlashAuto \li Automatic flash. |
| \row \li Camera.FlashRedEyeReduction \li Red eye reduction flash. |
| \row \li Camera.FlashFill \li Use flash to fillin shadows. |
| \row \li Camera.FlashTorch \li Constant light source. If supported, torch can be |
| enabled without loading the camera. |
| \row \li Camera.FlashVideoLight \li Constant light source, useful for video capture. |
| The light is turned on only while the camera is active. |
| \row \li Camera.FlashSlowSyncFrontCurtain |
| \li Use the flash in conjunction with a slow shutter speed. |
| This mode allows better exposure of distant objects and/or motion blur effect. |
| \row \li Camera.FlashSlowSyncRearCurtain |
| \li The similar mode to FlashSlowSyncFrontCurtain but flash is fired at the end of exposure. |
| \row \li Camera.FlashManual \li Flash power is manually set. |
| \endtable |
| |
| */ |
| QDeclarativeCameraFlash::FlashMode QDeclarativeCameraFlash::flashMode() const |
| { |
| return QDeclarativeCameraFlash::FlashMode(int(m_exposure->flashMode())); |
| } |
| |
| void QDeclarativeCameraFlash::setFlashMode(QDeclarativeCameraFlash::FlashMode mode) |
| { |
| if (flashMode() != mode) { |
| m_exposure->setFlashMode(QCameraExposure::FlashModes(mode)); |
| emit flashModeChanged(mode); |
| } |
| } |
| |
| void QDeclarativeCameraFlash::_q_cameraStatusChanged(QCamera::Status status) |
| { |
| if (status != QCamera::UnloadedStatus && status != QCamera::LoadedStatus && |
| status != QCamera::ActiveStatus) |
| return; |
| |
| emit supportedModesChanged(); |
| } |
| |
| /*! |
| \qmlproperty list<FlashMode> QtMultimedia::CameraFlash::supportedModes |
| |
| This property holds the supported flash modes of the camera. If the list |
| only contains Camera.FlashOff, no flash is supported. |
| |
| \code |
| Camera { |
| id: camera |
| flash { |
| onSupportedModesChanged { |
| if (flash.supportedModes.length == 1) { |
| // no flash supported |
| } else { |
| // some flash is supported |
| } |
| } |
| } |
| } |
| \endcode |
| |
| \since 5.9 |
| \sa mode |
| */ |
| QVariantList QDeclarativeCameraFlash::supportedModes() const |
| { |
| QVariantList supportedModes; |
| |
| for (int i=1; i <= (int) QCameraExposure::FlashManual; i = (i << 1)) { |
| if (m_exposure->isFlashModeSupported((QCameraExposure::FlashMode) i)) |
| supportedModes.append(QVariant(i)); |
| } |
| |
| return supportedModes; |
| } |
| |
| /*! |
| \qmlsignal QtMultimedia::CameraFlash::flashModeChanged() |
| This signal is emitted when the \c flashMode property is changed. |
| The corresponding handler is \c onFlashModeChanged. |
| */ |
| |
| /*! |
| \qmlsignal QtMultimedia::CameraFlash::flashReady() |
| This signal is emitted when QCameraExposure indicates that |
| the flash is ready to use. |
| The corresponding handler is \c onFlashReadyChanged. |
| */ |
| |
| QT_END_NAMESPACE |
| |
| #include "moc_qdeclarativecameraflash_p.cpp" |