// Copyright (C) 2024 The Qt Company Ltd. // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only #include #include "QtGraphs/QSplineSeries" #include "QtGraphs/QXYSeries" #include "private/qgraphtransition_p.h" #include "private/qsplinecontrolanimation_p.h" #include "private/qsplineseries_p.h" #include "private/qxyseries_p.h" #include "private/qxyseriesanimation_p.h" /*! \qmltype GraphTransition \inqmlmodule QtGraphs \ingroup graphs_qml_2D \brief A container in which all animations are defined. GraphTransition is a container for animations inside on Graphs2D. Define this class inside a graph type to enable animated changes for XYSeries within 2D graphs. To define individual animations, add them inside of the GraphTransition. The individual animations within the same GraphTransition are animated in parallel. If a GraphTransition is found by the graph during a call to a supported function which appends or replaces a point, then the values are interpolated according to the animations that are added. This example shows how to define a GraphTransition within a graph. \snippet doc_src_qmlgraphs.cpp 11 \note GraphTransition requires it to be defined directly inside the graph which needs to be animated. Currently only XYSeries are supported. \sa GraphPointAnimation, SplineControlAnimation */ /*! \qmlproperty enumeration GraphTransition::TransitionType Type of the transition. \value None No transition. \value PointAdded A point has been added. \value PointReplaced A point has been replaced. \value PointRemoved A point has been removed. */ QGraphTransition::QGraphTransition(QObject *parent) : QObject(parent) , m_animationGroup(this) , m_initialized(false) {} QGraphTransition::~QGraphTransition() {} void QGraphTransition::componentComplete() { // Currently only assuming animations in QXYSeries Q_ASSERT(parent() != nullptr && qobject_cast(parent())); auto series = qobject_cast(parent()); if (series) series->d_func()->m_graphTransition = this; } void QGraphTransition::onPointChanged(TransitionType type, int index, QPointF point) { auto series = qobject_cast(parent()); if (!series || !series->hasLoaded()) return; if (m_animationGroup.state() == QAbstractAnimation::Running) m_animationGroup.stop(); for (auto child : m_animationGroup.children()) { auto childAnimation = qobject_cast(child); childAnimation->updateCurrent(type, index, point); } for (auto child : m_animationGroup.children()) { auto childAnimation = qobject_cast(child); childAnimation->animate(); } #ifdef USE_SPLINEGRAPH auto spline = qobject_cast(series); if (spline && !contains(QGraphAnimation::GraphAnimationType::ControlPoint)) spline->d_func()->calculateSplinePoints(); #endif m_animationGroup.start(); } void QGraphTransition::initialize() { auto series = qobject_cast(parent()); if (!series || m_initialized) return; const auto &animationChildren = m_animationGroup.children(); for (qsizetype i = 0; i < animationChildren.size(); ++i) { auto childAnimation = qobject_cast(animationChildren[i]); //GraphPointAnimation needs to be the first for the transition to work if (childAnimation->animationType() == QGraphAnimation::GraphAnimationType::GraphPoint && i != 0) return; } m_initialized = true; } void QGraphTransition::stop() { m_animationGroup.stop(); for (auto child : m_animationGroup.children()) { auto childAnimation = qobject_cast(child); childAnimation->end(); } } bool QGraphTransition::initialized() { return m_initialized; } bool QGraphTransition::contains(QGraphAnimation::GraphAnimationType type) { for (const auto anim : m_animations) { if (anim->animationType() == type) return true; } return false; } /*! \qmlproperty list GraphTransition::animations A container for all the animations in the GraphTransition. Currently only supports animations to be added and cleared. By default, the list is empty. */ QQmlListProperty QGraphTransition::animations() { return QQmlListProperty{this, nullptr, &QGraphTransition::append, nullptr, nullptr, &QGraphTransition::clear}; } void QGraphTransition::classBegin() {} void QGraphTransition::append(QQmlListProperty *animationProps, QObject *animation) { auto graphTransition = qobject_cast(animationProps->object); if (graphTransition) { auto graphAnimation = qobject_cast(animation); graphTransition->m_animations.append(graphAnimation); graphTransition->m_animationGroup.addAnimation(graphAnimation); } } void QGraphTransition::clear(QQmlListProperty *) { Q_UNIMPLEMENTED(); }