1/****************************************************************************
2**
3** Copyright (C) 2016 The Qt Company Ltd.
4** Contact: http://www.qt.io/licensing/
5**
6** This file is part of the Qt3D module of the Qt Toolkit.
7**
8** $QT_BEGIN_LICENSE:LGPL3$
9** Commercial License Usage
10** Licensees holding valid commercial Qt licenses may use this file in
11** accordance with the commercial license agreement provided with the
12** Software or, alternatively, in accordance with the terms contained in
13** a written agreement between you and The Qt Company. For licensing terms
14** and conditions see http://www.qt.io/terms-conditions. For further
15** information use the contact form at http://www.qt.io/contact-us.
16**
17** GNU Lesser General Public License Usage
18** Alternatively, this file may be used under the terms of the GNU Lesser
19** General Public License version 3 as published by the Free Software
20** Foundation and appearing in the file LICENSE.LGPLv3 included in the
21** packaging of this file. Please review the following information to
22** ensure the GNU Lesser General Public License version 3 requirements
23** will be met: https://www.gnu.org/licenses/lgpl.html.
24**
25** GNU General Public License Usage
26** Alternatively, this file may be used under the terms of the GNU
27** General Public License version 2.0 or later as published by the Free
28** Software Foundation and appearing in the file LICENSE.GPL included in
29** the packaging of this file. Please review the following information to
30** ensure the GNU General Public License version 2.0 requirements will be
31** met: http://www.gnu.org/licenses/gpl-2.0.html.
32**
33** $QT_END_LICENSE$
34**
35****************************************************************************/
36
37#ifndef QT3DANIMATION_QMORPHINGANIMATION_H
38#define QT3DANIMATION_QMORPHINGANIMATION_H
39
40#include <Qt3DRender/qgeometryrenderer.h>
41
42#include <Qt3DAnimation/qabstractanimation.h>
43#include <Qt3DAnimation/qmorphtarget.h>
44#include <Qt3DAnimation/qt3danimation_global.h>
45
46#include <QtCore/qeasingcurve.h>
47
48QT_BEGIN_NAMESPACE
49
50namespace Qt3DAnimation {
51
52class QMorphingAnimationPrivate;
53
54class Q_3DANIMATIONSHARED_EXPORT QMorphingAnimation : public QAbstractAnimation
55{
56 Q_OBJECT
57 Q_PROPERTY(QVector<float> targetPositions READ targetPositions WRITE setTargetPositions NOTIFY targetPositionsChanged)
58 Q_PROPERTY(float interpolator READ interpolator NOTIFY interpolatorChanged)
59 Q_PROPERTY(Qt3DRender::QGeometryRenderer *target READ target WRITE setTarget NOTIFY targetChanged)
60 Q_PROPERTY(QString targetName READ targetName WRITE setTargetName NOTIFY targetNameChanged)
61 Q_PROPERTY(Method method READ method WRITE setMethod NOTIFY methodChanged)
62 Q_PROPERTY(QEasingCurve easing READ easing WRITE setEasing NOTIFY easingChanged)
63
64public:
65 enum Method
66 {
67 Normalized,
68 Relative
69 };
70 Q_ENUM(Method)
71
72 explicit QMorphingAnimation(QObject *parent = nullptr);
73
74 QVector<float> targetPositions() const;
75 float interpolator() const;
76 Qt3DRender::QGeometryRenderer *target() const;
77 QString targetName() const;
78 QMorphingAnimation::Method method() const;
79 QEasingCurve easing() const;
80
81 void setMorphTargets(const QVector<Qt3DAnimation::QMorphTarget *> &targets);
82 void addMorphTarget(Qt3DAnimation::QMorphTarget *target);
83 void removeMorphTarget(Qt3DAnimation::QMorphTarget *target);
84
85 void setWeights(int positionIndex, const QVector<float> &weights);
86 QVector<float> getWeights(int positionIndex);
87
88 QVector<Qt3DAnimation::QMorphTarget *> morphTargetList();
89
90public Q_SLOTS:
91 void setTargetPositions(const QVector<float> &targetPositions);
92 void setTarget(Qt3DRender::QGeometryRenderer *target);
93 void setTargetName(const QString name);
94 void setMethod(QMorphingAnimation::Method method);
95 void setEasing(const QEasingCurve &easing);
96
97Q_SIGNALS:
98 void targetPositionsChanged(const QVector<float> &targetPositions);
99 void interpolatorChanged(float interpolator);
100 void targetChanged(Qt3DRender::QGeometryRenderer *target);
101 void targetNameChanged(const QString &name);
102 void methodChanged(QMorphingAnimation::Method method);
103 void easingChanged(const QEasingCurve &easing);
104
105private:
106
107 void updateAnimation(float position);
108
109 Q_DECLARE_PRIVATE(QMorphingAnimation)
110};
111
112} // Qt3DAnimation
113
114QT_END_NAMESPACE
115
116#endif // QT3DANIMATION_QMORPHINGANIMATION_H
117