/**************************************************************************** ** ** Copyright (C) 2016 The Qt Company Ltd. ** Contact: https://www.qt.io/licensing/ ** ** This file is part 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 "qcameraimageprocessing.h" #include "qmediaobject_p.h" #include #include #include #include #include #include #include #include QT_BEGIN_NAMESPACE static void qRegisterCameraImageProcessingMetaTypes() { qRegisterMetaType(); qRegisterMetaType(); } Q_CONSTRUCTOR_FUNCTION(qRegisterCameraImageProcessingMetaTypes) /*! \class QCameraImageProcessing \brief The QCameraImageProcessing class provides an interface for image processing related camera settings. \inmodule QtMultimedia \ingroup multimedia \ingroup multimedia_camera After capturing the data for a camera frame, the camera hardware and software performs various image processing tasks to produce a final image. This includes compensating for ambient light color, reducing noise, as well as making some other adjustments to the image. You can retrieve this class from an instance of a \l QCamera object. For example, you can set the white balance (or color temperature) used for processing images: \snippet multimedia-snippets/camera.cpp Camera image whitebalance Or adjust the amount of denoising performed: \snippet multimedia-snippets/camera.cpp Camera image denoising In some cases changing these settings may result in a longer delay before an image is ready. For more information on image processing of camera frames, see \l {camera_image_processing}{Camera Image Processing}. \sa QCameraImageProcessingControl */ class QCameraImageProcessingFakeControl : public QCameraImageProcessingControl { public: QCameraImageProcessingFakeControl(QObject *parent) : QCameraImageProcessingControl(parent) {} bool isParameterSupported(ProcessingParameter) const override { return false; } bool isParameterValueSupported(ProcessingParameter, const QVariant &) const override { return false; } QVariant parameter(ProcessingParameter) const override { return QVariant(); } void setParameter(ProcessingParameter, const QVariant &) override {} }; class QCameraImageProcessingPrivate : public QMediaObjectPrivate { Q_DECLARE_NON_CONST_PUBLIC(QCameraImageProcessing) public: void initControls(); QCamera *camera; QCameraImageProcessingControl *imageControl; bool available; }; void QCameraImageProcessingPrivate::initControls() { imageControl = 0; QMediaService *service = camera->service(); if (service) imageControl = qobject_cast(service->requestControl(QCameraImageProcessingControl_iid)); available = (imageControl != nullptr); if (!imageControl) imageControl = new QCameraImageProcessingFakeControl(q_ptr); } /*! Construct a QCameraImageProcessing for \a camera. */ QCameraImageProcessing::QCameraImageProcessing(QCamera *camera) : QObject(*new QCameraImageProcessingPrivate, camera) { Q_D(QCameraImageProcessing); d->camera = camera; d->initControls(); } /*! Destroys the camera focus object. */ QCameraImageProcessing::~QCameraImageProcessing() { } /*! Returns true if image processing related settings are supported by this camera. */ bool QCameraImageProcessing::isAvailable() const { return d_func()->available; } /*! Returns the white balance mode being used. */ QCameraImageProcessing::WhiteBalanceMode QCameraImageProcessing::whiteBalanceMode() const { return d_func()->imageControl->parameter(QCameraImageProcessingControl::WhiteBalancePreset) .value(); } /*! Sets the white balance to \a mode. */ void QCameraImageProcessing::setWhiteBalanceMode(QCameraImageProcessing::WhiteBalanceMode mode) { d_func()->imageControl->setParameter( QCameraImageProcessingControl::WhiteBalancePreset, QVariant::fromValue(mode)); } /*! Returns true if the white balance \a mode is supported. */ bool QCameraImageProcessing::isWhiteBalanceModeSupported(QCameraImageProcessing::WhiteBalanceMode mode) const { return d_func()->imageControl->isParameterValueSupported( QCameraImageProcessingControl::WhiteBalancePreset, QVariant::fromValue(mode)); } /*! Returns the current color temperature if the current white balance mode is \c WhiteBalanceManual. For other modes the return value is undefined. */ qreal QCameraImageProcessing::manualWhiteBalance() const { return d_func()->imageControl->parameter(QCameraImageProcessingControl::ColorTemperature).toReal(); } /*! Sets manual white balance to \a colorTemperature. This is used when whiteBalanceMode() is set to \c WhiteBalanceManual. The units are Kelvin. */ void QCameraImageProcessing::setManualWhiteBalance(qreal colorTemperature) { d_func()->imageControl->setParameter( QCameraImageProcessingControl::ColorTemperature, QVariant(colorTemperature)); } /*! Returns the brightness adjustment setting. */ qreal QCameraImageProcessing::brightness() const { return d_func()->imageControl->parameter(QCameraImageProcessingControl::BrightnessAdjustment).toReal(); } /*! Set the brightness adjustment to \a value. Valid brightness adjustment values range between -1.0 and 1.0, with a default of 0. */ void QCameraImageProcessing::setBrightness(qreal value) { d_func()->imageControl->setParameter(QCameraImageProcessingControl::BrightnessAdjustment, QVariant(value)); } /*! Returns the contrast adjustment setting. */ qreal QCameraImageProcessing::contrast() const { return d_func()->imageControl->parameter(QCameraImageProcessingControl::ContrastAdjustment).toReal(); } /*! Set the contrast adjustment to \a value. Valid contrast adjustment values range between -1.0 and 1.0, with a default of 0. */ void QCameraImageProcessing::setContrast(qreal value) { d_func()->imageControl->setParameter(QCameraImageProcessingControl::ContrastAdjustment, QVariant(value)); } /*! Returns the saturation adjustment value. */ qreal QCameraImageProcessing::saturation() const { return d_func()->imageControl->parameter(QCameraImageProcessingControl::SaturationAdjustment).toReal(); } /*! Sets the saturation adjustment value to \a value. Valid saturation values range between -1.0 and 1.0, with a default of 0. */ void QCameraImageProcessing::setSaturation(qreal value) { d_func()->imageControl->setParameter(QCameraImageProcessingControl::SaturationAdjustment, QVariant(value)); } /*! Returns the sharpening adjustment level. */ qreal QCameraImageProcessing::sharpeningLevel() const { return d_func()->imageControl->parameter(QCameraImageProcessingControl::SharpeningAdjustment).toReal(); } /*! Sets the sharpening adjustment \a level. Valid sharpening values range between -1.0 and 1.0, with a default of 0. */ void QCameraImageProcessing::setSharpeningLevel(qreal level) { d_func()->imageControl->setParameter(QCameraImageProcessingControl::SharpeningAdjustment, QVariant(level)); } /*! Returns the denoising adjustment level. */ qreal QCameraImageProcessing::denoisingLevel() const { return d_func()->imageControl->parameter(QCameraImageProcessingControl::DenoisingAdjustment).toReal(); } /*! Sets the denoising adjustment \a level. Valid denoising values range between -1.0 and 1.0, with a default of 0. If the parameter value is set to 0, the amount of denoising applied is selected by camera and depends on camera capabilities and settings. Changing value in -1.0..1.0 range adjusts the amount of denoising applied within the supported range. */ void QCameraImageProcessing::setDenoisingLevel(qreal level) { d_func()->imageControl->setParameter(QCameraImageProcessingControl::DenoisingAdjustment, QVariant(level)); } /*! \enum QCameraImageProcessing::WhiteBalanceMode \value WhiteBalanceAuto Auto white balance mode. \value WhiteBalanceManual Manual white balance. In this mode the white balance should be set with setManualWhiteBalance() \value WhiteBalanceSunlight Sunlight white balance mode. \value WhiteBalanceCloudy Cloudy white balance mode. \value WhiteBalanceShade Shade white balance mode. \value WhiteBalanceTungsten Tungsten (incandescent) white balance mode. \value WhiteBalanceFluorescent Fluorescent white balance mode. \value WhiteBalanceFlash Flash white balance mode. \value WhiteBalanceSunset Sunset white balance mode. \value WhiteBalanceVendor Base value for vendor defined white balance modes. */ /*! \enum QCameraImageProcessing::ColorFilter \value ColorFilterNone No filter is applied to images. \value ColorFilterGrayscale A grayscale filter. \value ColorFilterNegative A negative filter. \value ColorFilterSolarize A solarize filter. \value ColorFilterSepia A sepia filter. \value ColorFilterPosterize A posterize filter. \value ColorFilterWhiteboard A whiteboard filter. \value ColorFilterBlackboard A blackboard filter. \value ColorFilterAqua An aqua filter. \value ColorFilterVendor The base value for vendor defined filters. \since 5.5 */ /*! Returns the color filter which will be applied to image data captured by the camera. \since 5.5 */ QCameraImageProcessing::ColorFilter QCameraImageProcessing::colorFilter() const { return d_func()->imageControl->parameter(QCameraImageProcessingControl::ColorFilter) .value(); } /*! Sets the color \a filter which will be applied to image data captured by the camera. \since 5.5 */ void QCameraImageProcessing::setColorFilter(QCameraImageProcessing::ColorFilter filter) { d_func()->imageControl->setParameter( QCameraImageProcessingControl::ColorFilter, QVariant::fromValue(filter)); } /*! Returns true if a color \a filter is supported. \since 5.5 */ bool QCameraImageProcessing::isColorFilterSupported(QCameraImageProcessing::ColorFilter filter) const { return d_func()->imageControl->isParameterValueSupported( QCameraImageProcessingControl::ColorFilter, QVariant::fromValue(filter)); } QT_END_NAMESPACE #include "moc_qcameraimageprocessing.cpp"