Revision control
Copy as Markdown
// 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/QList>
#include <QtGraphs/qgraphsglobal.h>
#include "QtGraphs/QXYSeries"
#include "private/qgraphtransition_p.h"
#if QT_CONFIG(graphs_2d_spline)
#include "private/qsplinecontrolanimation_p.h"
#include "private/qsplineseries_p.h"
#endif
#include "private/qxyseries_p.h"
#include "private/qxyseriesanimation_p.h"
QT_BEGIN_NAMESPACE
/*!
\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<QXYSeries *>(parent()));
auto series = qobject_cast<QXYSeries *>(parent());
if (series)
series->d_func()->m_graphTransition = this;
}
void QGraphTransition::onPointChanged(TransitionType type, int index, QPointF point)
{
auto series = qobject_cast<QXYSeries *>(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<QXYSeriesAnimation *>(child);
childAnimation->updateCurrent(type, index, point);
}
for (auto child : m_animationGroup.children()) {
auto childAnimation = qobject_cast<QXYSeriesAnimation *>(child);
childAnimation->animate();
}
#if QT_CONFIG(graphs_2d_spline)
auto spline = qobject_cast<QSplineSeries *>(series);
if (spline && !contains(QGraphAnimation::GraphAnimationType::ControlPoint))
spline->d_func()->calculateSplinePoints();
#endif
m_animationGroup.start();
}
void QGraphTransition::initialize()
{
auto series = qobject_cast<QXYSeries *>(parent());
if (!series || m_initialized)
return;
const auto &animationChildren = m_animationGroup.children();
for (qsizetype i = 0; i < animationChildren.size(); ++i) {
auto childAnimation = qobject_cast<QXYSeriesAnimation *>(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<QXYSeriesAnimation *>(child);
childAnimation->end();
}
}
bool QGraphTransition::initialized()
{
return m_initialized;
}
bool QGraphTransition::contains(QGraphAnimation::GraphAnimationType type)
{
for (const auto anim : std::as_const(m_animations)) {
if (anim->animationType() == type)
return true;
}
return false;
}
/*!
\qmlproperty list<object> 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<QObject> QGraphTransition::animations()
{
return QQmlListProperty<QObject>{this,
nullptr,
&QGraphTransition::append,
nullptr,
nullptr,
&QGraphTransition::clear};
}
void QGraphTransition::classBegin() {}
void QGraphTransition::append(QQmlListProperty<QObject> *animationProps, QObject *animation)
{
auto graphTransition = qobject_cast<QGraphTransition *>(animationProps->object);
if (graphTransition) {
auto graphAnimation = qobject_cast<QGraphAnimation *>(animation);
graphTransition->m_animations.append(graphAnimation);
graphTransition->m_animationGroup.addAnimation(graphAnimation);
}
}
void QGraphTransition::clear(QQmlListProperty<QObject> *)
{
Q_UNIMPLEMENTED();
}
QT_END_NAMESPACE
#include "moc_qgraphtransition_p.cpp"