path: root/src/multimedia/camera/qcameraviewfindersettings.cpp

/****************************************************************************
**
** 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 "qcameraviewfindersettings.h"

QT_BEGIN_NAMESPACE

static void qRegisterViewfinderSettingsMetaType()
{
    qRegisterMetaType<QCameraViewfinderSettings>();
}

Q_CONSTRUCTOR_FUNCTION(qRegisterViewfinderSettingsMetaType)


class QCameraViewfinderSettingsPrivate  : public QSharedData
{
public:
    QCameraViewfinderSettingsPrivate() :
        isNull(true),
        minimumFrameRate(0.0),
        maximumFrameRate(0.0),
        pixelFormat(QVideoFrame::Format_Invalid)
    {
    }

    QCameraViewfinderSettingsPrivate(const QCameraViewfinderSettingsPrivate &other):
        QSharedData(other),
        isNull(other.isNull),
        resolution(other.resolution),
        minimumFrameRate(other.minimumFrameRate),
        maximumFrameRate(other.maximumFrameRate),
        pixelFormat(other.pixelFormat),
        pixelAspectRatio(other.pixelAspectRatio)
    {
    }

    bool isNull;
    QSize resolution;
    qreal minimumFrameRate;
    qreal maximumFrameRate;
    QVideoFrame::PixelFormat pixelFormat;
    QSize pixelAspectRatio;

private:
    QCameraViewfinderSettingsPrivate& operator=(const QCameraViewfinderSettingsPrivate &other);
};


/*!
    \class QCameraViewfinderSettings
    \since 5.5
    \brief The QCameraViewfinderSettings class provides a set of viewfinder settings.

    \inmodule QtMultimedia
    \ingroup multimedia
    \ingroup multimedia_camera

    A viewfinder settings object is used to specify the viewfinder settings used by QCamera.
    Viewfinder settings are selected by constructing a QCameraViewfinderSettings object,
    setting the desired properties and then passing it to a QCamera instance using the
    QCamera::setViewfinderSettings() function.

    \snippet multimedia-snippets/camera.cpp Camera viewfinder settings

    Different cameras may have different capabilities. The application should query the camera
    capabilities before setting parameters. For example, the application should call
    QCamera::supportedViewfinderResolutions() before calling setResolution().

    \sa QCamera
*/

/*!
    Constructs a null viewfinder settings object.
*/
QCameraViewfinderSettings::QCameraViewfinderSettings()
    : d(new QCameraViewfinderSettingsPrivate)
{
}

/*!
    Constructs a copy of the viewfinder settings object \a other.
*/
QCameraViewfinderSettings::QCameraViewfinderSettings(const QCameraViewfinderSettings &other)
    : d(other.d)
{

}

/*!
    Destroys a viewfinder settings object.
*/
QCameraViewfinderSettings::~QCameraViewfinderSettings()
{

}

/*!
    Assigns the value of \a other to a viewfinder settings object.
*/
QCameraViewfinderSettings &QCameraViewfinderSettings::operator=(const QCameraViewfinderSettings &other)
{
    d = other.d;
    return *this;
}

/*! \fn QCameraViewfinderSettings &QCameraViewfinderSettings::operator=(QCameraViewfinderSettings &&other)

    Moves \a other to this viewfinder settings object and returns a reference to this object.
*/

/*!
    \fn void QCameraViewfinderSettings::swap(QCameraViewfinderSettings &other)

    Swaps this viewfinder settings object with \a other. This
    function is very fast and never fails.
*/

/*!
    \relates QCameraViewfinderSettings
    \since 5.5

    Determines if \a lhs is of equal value to \a rhs.

    Returns true if the settings objects are of equal value, and false if they
    are not of equal value.
*/
bool operator==(const QCameraViewfinderSettings &lhs, const QCameraViewfinderSettings &rhs) Q_DECL_NOTHROW
{
    return (lhs.d == rhs.d) ||
           (lhs.d->isNull == rhs.d->isNull &&
            lhs.d->resolution == rhs.d->resolution &&
            lhs.d->minimumFrameRate == rhs.d->minimumFrameRate &&
            lhs.d->maximumFrameRate == rhs.d->maximumFrameRate &&
            lhs.d->pixelFormat == rhs.d->pixelFormat &&
            lhs.d->pixelAspectRatio == rhs.d->pixelAspectRatio);
}

/*!
    \fn bool operator!=(const QCameraViewfinderSettings &lhs, const QCameraViewfinderSettings &rhs)
    \relates QCameraViewfinderSettings
    \since 5.5

    Determines if \a lhs is of equal value to \a rhs.

    Returns true if the settings objects are not of equal value, and false if
    they are of equal value.
*/

/*!
    Identifies if a viewfinder settings object is uninitalized.

    Returns true if the settings are null, and false if they are not.
*/
bool QCameraViewfinderSettings::isNull() const
{
    return d->isNull;
}

/*!
    Returns the viewfinder resolution.
*/
QSize QCameraViewfinderSettings::resolution() const
{
    return d->resolution;
}

/*!
    Sets the viewfinder \a resolution.

    If the given \a resolution is empty, the backend makes an optimal choice based on the
    supported resolutions and the other viewfinder settings.

    If the camera is used to capture videos or images, the viewfinder resolution might be
    ignored if it conflicts with the capture resolution.

    \sa QVideoEncoderSettings::setResolution(), QImageEncoderSettings::setResolution(),
    QCamera::supportedViewfinderResolutions()
*/
void QCameraViewfinderSettings::setResolution(const QSize &resolution)
{
    d->isNull = false;
    d->resolution = resolution;
}

/*!
    \fn QCameraViewfinderSettings::setResolution(int width, int height)

    This is an overloaded function.

    Sets the \a width and \a height of the viewfinder resolution.
*/

/*!
    Returns the viewfinder minimum frame rate in frames per second.

    \sa maximumFrameRate()
*/
qreal QCameraViewfinderSettings::minimumFrameRate() const
{
    return d->minimumFrameRate;
}

/*!
    Sets the viewfinder minimum frame \a rate in frames per second.

    If the minimum frame \a rate is equal to the maximum frame rate, the frame rate is fixed.
    If not, the actual frame rate fluctuates between the minimum and the maximum.

    If the given \a rate equals to \c 0, the backend makes an optimal choice based on the
    supported frame rates and the other viewfinder settings.

    \sa setMaximumFrameRate(), QCamera::supportedViewfinderFrameRateRanges()
*/
void QCameraViewfinderSettings::setMinimumFrameRate(qreal rate)
{
    d->isNull = false;
    d->minimumFrameRate = rate;
}

/*!
    Returns the viewfinder maximum frame rate in frames per second.

    \sa minimumFrameRate()
*/
qreal QCameraViewfinderSettings::maximumFrameRate() const
{
    return d->maximumFrameRate;
}

/*!
    Sets the viewfinder maximum frame \a rate in frames per second.

    If the maximum frame \a rate is equal to the minimum frame rate, the frame rate is fixed.
    If not, the actual frame rate fluctuates between the minimum and the maximum.

    If the given \a rate equals to \c 0, the backend makes an optimal choice based on the
    supported frame rates and the other viewfinder settings.

    \sa setMinimumFrameRate(), QCamera::supportedViewfinderFrameRateRanges()
*/
void QCameraViewfinderSettings::setMaximumFrameRate(qreal rate)
{
    d->isNull = false;
    d->maximumFrameRate = rate;
}

/*!
    Returns the viewfinder pixel format.
*/
QVideoFrame::PixelFormat QCameraViewfinderSettings::pixelFormat() const
{
    return d->pixelFormat;
}

/*!
    Sets the viewfinder pixel \a format.

    If the given \a format is equal to QVideoFrame::Format_Invalid, the backend uses the
    default format.

    \sa QCamera::supportedViewfinderPixelFormats()
*/
void QCameraViewfinderSettings::setPixelFormat(QVideoFrame::PixelFormat format)
{
    d->isNull = false;
    d->pixelFormat = format;
}

/*!
    Returns the viewfinder pixel aspect ratio.
*/
QSize QCameraViewfinderSettings::pixelAspectRatio() const
{
    return d->pixelAspectRatio;
}

/*!
    Sets the viewfinder pixel aspect \a ratio.
*/
void QCameraViewfinderSettings::setPixelAspectRatio(const QSize &ratio)
{
    d->isNull = false;
    d->pixelAspectRatio = ratio;
}

/*!
    \fn QCameraViewfinderSettings::setPixelAspectRatio(int horizontal, int vertical)

    This is an overloaded function.

    Sets the \a horizontal and \a vertical elements of the viewfinder's pixel aspect ratio.
*/

QT_END_NAMESPACE