diff options
Diffstat (limited to 'src/extras/Private/qquickmathutils.cpp')
| -rw-r--r-- | src/extras/Private/qquickmathutils.cpp | 111 |
1 files changed, 111 insertions, 0 deletions
diff --git a/src/extras/Private/qquickmathutils.cpp b/src/extras/Private/qquickmathutils.cpp new file mode 100644 index 000000000..8f4b2a6bc --- /dev/null +++ b/src/extras/Private/qquickmathutils.cpp @@ -0,0 +1,111 @@ +/**************************************************************************** +** +** Copyright (C) 2015 The Qt Company Ltd. +** Contact: http://www.qt.io/licensing/ +** +** This file is part of the Qt Quick Extras module of the Qt Toolkit. +** +** $QT_BEGIN_LICENSE:LGPL3$ +** 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 http://www.qt.io/terms-conditions. For further +** information use the contact form at http://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.LGPLv3 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.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 later as published by the Free +** Software Foundation and appearing in the file LICENSE.GPL included in +** the packaging of this file. Please review the following information to +** ensure the GNU General Public License version 2.0 requirements will be +** met: http://www.gnu.org/licenses/gpl-2.0.html. +** +** $QT_END_LICENSE$ +** +****************************************************************************/ + +#include "qquickmathutils_p.h" + +#include <qmath.h> + +QQuickMathUtils::QQuickMathUtils(QObject *parent) : + QObject(parent) +{ +} + +qreal QQuickMathUtils::pi2() const +{ + return M_PI * 2; +} + +/*! + Converts the angle \a degrees to radians. +*/ +qreal QQuickMathUtils::degToRad(qreal degrees) const { + return degrees * (M_PI / 180); +} + +/*! + Converts the angle \a degrees to radians. + + This function assumes that the angle origin (0) is north, as this + is the origin used by all of the Extras. The angle + returned will have its angle origin (0) pointing east, in order to be + consistent with standard angles used by \l {QtQuick::Canvas}{Canvas}, + for example. +*/ +qreal QQuickMathUtils::degToRadOffset(qreal degrees) const { + return (degrees - 90) * (M_PI / 180); +} + +/*! + Converts the angle \a radians to degrees. +*/ +qreal QQuickMathUtils::radToDeg(qreal radians) const { + return radians * (180 / M_PI); +} + +/*! + Converts the angle \a radians to degrees. + + This function assumes that the angle origin (0) is east; as is standard for + mathematical operations using radians (this origin is used by + \l {QtQuick::Canvas}{Canvas}, for example). The angle returned in degrees + will have its angle origin (0) pointing north, which is what the extras + expect. +*/ +qreal QQuickMathUtils::radToDegOffset(qreal radians) const { + return radians * (180 / M_PI) + 90; +} + +/*! + Returns the top left position of the item if it were centered along + a circle according to \a angleOnCircle and \a distanceAlongRadius. + + \a angleOnCircle is from 0.0 - M_PI2. + \a distanceAlongRadius is the distance along the radius in M_PIxels. +*/ +QPointF QQuickMathUtils::centerAlongCircle(qreal xCenter, qreal yCenter, + qreal width, qreal height, qreal angleOnCircle, qreal distanceAlongRadius) const { + return QPointF( + (xCenter - width / 2) + (distanceAlongRadius * cos(angleOnCircle)), + (yCenter - height / 2) + (distanceAlongRadius * sin(angleOnCircle))); +} + +/*! + Returns \a number rounded to the nearest even integer. +*/ +qreal QQuickMathUtils::roundEven(qreal number) const { + int rounded = qRound(number); + return rounded % 2 == 0 ? rounded : rounded + 1; +} |
