Revision control
++ // Copyright (C) 2024 The Qt Company Ltd.
++ // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only
++ // Qt-Security score:significant reason:default
++
++
++ #include <QtCore/QPointF>
++ #include <QtGraphs/qgraphsglobal.h>
++ #if QT_CONFIG(graphs_2d_area) || QT_CONFIG(graphs_2d_line)
++ #include <QtGraphs/QLineSeries>
++ #endif
++ #include "private/qgraphpointanimation_p.h"
++ #include "private/qgraphtransition_p.h"
++ #include "private/qxyseries_p.h"
++
++ QT_BEGIN_NAMESPACE
++
++ /*!
++ \qmltype GraphPointAnimation
++ \inqmlmodule QtGraphs
++ \ingroup graphs_qml_2D
++ \inherits XYSeriesAnimation
++ \brief An animation type which signifies the animation for points.
++
++ GraphPointAnimation is an animation type derived from QVariantAnimation which defines how points are animated.
++ It can make use of QVariantAnimation functionality and properties for its animations, such as \c duration and \c easing.
++ These animations are housed inside of a QParallelAnimationGroup and hence will run in parallel.
++
++ This example shows how to use a GraphPointAnimation to set points to animate with
++ a \c duration of 1000ms and \c easing of OutCubic:
++
++ \snippet doc_src_qmlgraphs.cpp 12
++
++ For XYSeries, this is considered to be the main list of points defined inside
++ the series. The point is linearly interpolated from the start to the end value.
++
++ \note GraphPointAnimation currently supports animating only the last point in
++ a series when a point is appended or removed. If a point is replaced, the
++ animation will be triggered regardless of the point’s index within the
++ series.
++
++ \sa GraphTransition, SplineControlAnimation
++ */
++
++ QGraphPointAnimation::QGraphPointAnimation(QObject *parent)
++ : QXYSeriesAnimation(parent)
++ {
++ setDuration(800);
++ setEasingCurve(QEasingCurve::OutCubic);
++ }
++
++ QGraphPointAnimation::~QGraphPointAnimation() {}
++
++ QGraphAnimation::GraphAnimationType QGraphPointAnimation::animationType()
++ {
++ return QGraphAnimation::GraphAnimationType::GraphPoint;
++ }
++
++ void QGraphPointAnimation::setAnimatingValue(const QVariant &start, const QVariant &end)
++ {
++ setStartValue(start);
++ setEndValue(end);
++ }
++
++ QVariant QGraphPointAnimation::interpolated(const QVariant &start,
++ const QVariant &end,
++ qreal progress) const
++ {
++ auto startPoint = qvariant_cast<QPointF>(start);
++ auto endPoint = qvariant_cast<QPointF>(end);
++
++ auto interpolatedPoint = QPointF{
++ qreal(startPoint.x() * (1.0 - progress) + endPoint.x() * progress),
++ qreal(startPoint.y() * (1.0 - progress) + endPoint.y() * progress),
++ };
++
++ return QVariant::fromValue(interpolatedPoint);
++ }
++
++ void QGraphPointAnimation::animate()
++ {
++ // Hierarchy should look like GraphAnimation -> ParallelAnimationGroup -> GraphTransition -> QXYSeries
++ auto series = qobject_cast<QXYSeries *>(parent()->parent()->parent());
++
++ if (!series) {
++ qCCritical(lcAnimation, "QGraphPointAnimation::animate. XYSeries not found.");
++ return;
++ }
++
++ if (animating() == QGraphAnimation::AnimationState::Playing) {
++ end();
++ m_activePointIndex = m_newPointIndex;
++ }
++
++ setAnimating(QGraphAnimation::AnimationState::Playing);
++
++ auto &pointList = series->d_func()->m_points;
++
++ switch (m_currentTransitionType) {
++ default:
++ case QGraphTransition::TransitionType::PointAdded: {
++ pointList.append(series->points().size() >= 1 ? pointList.last() : m_newPoint);
++
++ auto startv = QVariant::fromValue(pointList.last());
++ auto endv = QVariant::fromValue(m_newPoint);
++
++ qCDebug(lcAnimation) << "transition type:" << m_currentTransitionType
++ << "start value:" << startv.toPointF()
++ << "end value:" << endv.toPointF();
++
++ setAnimatingValue(startv, endv);
++ } break;
++ case QGraphTransition::TransitionType::PointReplaced: {
++ auto startv = QVariant::fromValue(pointList[m_activePointIndex]);
++ auto endv = QVariant::fromValue(m_newPoint);
++
++ qCDebug(lcAnimation) << "transition type:" << m_currentTransitionType
++ << "start value:" << startv.toPointF()
++ << "end value:" << endv.toPointF();
++ setAnimatingValue(startv, endv);
++ } break;
++ case QGraphTransition::TransitionType::PointRemoved: {
++ if (series->points().size() < 1)
++ break;
++
++ auto startv = QVariant::fromValue(pointList[pointList.size() - 1]);
++ auto endv = QVariant::fromValue(
++ pointList[pointList.size() > 1 ? pointList.size() - 2 : pointList.size() - 1]);
++
++ qCDebug(lcAnimation) << "transition type:" << m_currentTransitionType
++ << "start value:" << startv.toPointF()
++ << "end value:" << endv.toPointF();
++
++
++ setAnimatingValue(startv, endv);
++ } break;
++ }
++
++ m_previousTransitionType = m_currentTransitionType;
++ }
++
++ void QGraphPointAnimation::end()
++ {
++ auto series = qobject_cast<QXYSeries *>(parent()->parent()->parent());
++
++ if (!series || animating() == QGraphAnimation::AnimationState::Stopped) {
++ m_previousTransitionType = m_currentTransitionType;
++ return;
++ }
++
++ setAnimating(QGraphAnimation::AnimationState::Stopped);
++ stop();
++
++ auto &points = series->d_func()->m_points;
++
++ switch (m_previousTransitionType) {
++ default:
++ case QGraphTransition::TransitionType::PointAdded: {
++ points.replace(m_activePointIndex, qvariant_cast<QPointF>(endValue()));
++ emit series->pointAdded(points.size() - 1);
++ emit series->countChanged();
++ } break;
++ case QGraphTransition::TransitionType::PointReplaced: {
++ points.replace(m_activePointIndex, qvariant_cast<QPointF>(endValue()));
++ emit series->pointReplaced(m_activePointIndex);
++ } break;
++ case QGraphTransition::TransitionType::PointRemoved: {
++ points.remove(points.size() - 1);
++ emit series->countChanged();
++ emit series->pointRemoved(points.size() - 1);
++ } break;
++ }
++
++ m_previousTransitionType = m_currentTransitionType;
++ emit series->update();
++ }
++
++ void QGraphPointAnimation::valueUpdated(const QVariant &value)
++ {
++ auto series = qobject_cast<QXYSeries *>(parent()->parent()->parent());
++
++ if (!series)
++ return;
++
++ auto val = qvariant_cast<QPointF>(value);
++ auto &points = series->d_func()->m_points;
++
++ switch (m_currentTransitionType) {
++ default:
++ case QGraphTransition::TransitionType::PointAdded: {
++ points.replace(m_activePointIndex, val);
++ } break;
++ case QGraphTransition::TransitionType::PointReplaced: {
++ points.replace(m_activePointIndex, val);
++ } break;
++ case QGraphTransition::TransitionType::PointRemoved: {
++ if (points.size() > 1)
++ points.replace(points.size() - 1, val);
++ } break;
++ }
++
++ emit series->update();
++ }
++
++ QT_END_NAMESPACE
++
++ #include "moc_qgraphpointanimation_p.cpp"