summaryrefslogtreecommitdiffstats
path: root/src/animation/frontend/qmorphtarget.cpp
blob: bc0f79c161f3b494d30cecf7c05f2b5a3773ac76 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
// Copyright (C) 2017 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only

#include "qmorphtarget.h"
#include "Qt3DAnimation/private/qmorphtarget_p.h"

QT_BEGIN_NAMESPACE

namespace Qt3DAnimation {

/*!
    \class Qt3DAnimation::QMorphTarget
    \brief A class providing morph targets to blend-shape animation.
    \inmodule Qt3DAnimation
    \since 5.9
    \inherits QObject

    A Qt3DAnimation::QMorphTarget class is a convenience class, which provides a list
    of \l {Qt3DCore::QAttribute} {QAttributes}, which the QMorphingAnimation uses
    to animate geometry. A QMorphTarget can also be created based on existing
    \l Qt3DCore::QGeometry.

*/
/*!
    \qmltype MorphTarget
    \brief A type providing morph targets to blend-shape animation.
    \inqmlmodule Qt3D.Animation
    \since 5.9
    \inherits QtObject
    \instantiates Qt3DAnimation::QMorphTarget

    A MorphTarget type is a convenience type, which provides a list
    of \l {Qt3D.Core::Attribute} {Attributes}, which the MorphingAnimation uses
    to animate geometry. A MorphTarget can also be created based on existing
    \l {Qt3D.Core::Geometry}{Geometry}.

*/

/*!
    \property Qt3DAnimation::QMorphTarget::attributeNames
    Holds a list of attribute names contained in the morph target.
    \readonly
*/

/*!
    \qmlproperty list<string> MorphTarget::attributeNames
    Holds a list of attribute names contained in the morph target.
    \readonly
*/
/*!
    \qmlproperty list<Attribute> MorphTarget::attributes
    Holds the list of attributes in the morph target.
*/
/*!
    \qmlmethod MorphTarget Qt3D.Animation::MorphTarget::fromGeometry(geometry, stringList)
    Returns a morph target based on the attributes defined by the given \a stringList from
    the given \a geometry.
*/

QMorphTargetPrivate::QMorphTargetPrivate()
    : QObjectPrivate()
{

}

void QMorphTargetPrivate::updateAttributeNames()
{
    m_attributeNames.clear();
    for (const Qt3DCore::QAttribute *attr : std::as_const(m_targetAttributes))
        m_attributeNames.push_back(attr->name());
}

/*!
    Constructs a QMorphTarget with given \a parent.
*/
QMorphTarget::QMorphTarget(QObject *parent)
    : QObject(*new QMorphTargetPrivate, parent)
{

}

/*!
    Returns a list of attributes contained in the morph target.
*/
QList<Qt3DCore::QAttribute *> QMorphTarget::attributeList() const
{
    Q_D(const QMorphTarget);
    return d->m_targetAttributes;
}

QStringList QMorphTarget::attributeNames() const
{
    Q_D(const QMorphTarget);
    return d->m_attributeNames;
}

/*!
    Sets \a attributes to the morph target. Old attributes are cleared.
*/
void QMorphTarget::setAttributes(const QList<Qt3DCore::QAttribute *> &attributes)
{
    Q_D(QMorphTarget);
    d->m_targetAttributes = attributes;
    d->m_attributeNames.clear();
    for (const Qt3DCore::QAttribute *attr : attributes)
        d->m_attributeNames.push_back(attr->name());

    emit attributeNamesChanged(d->m_attributeNames);
}

/*!
    Adds an \a attribute the morph target. An attribute with the same
    name must not have been added previously to the morph target.
*/
void QMorphTarget::addAttribute(Qt3DCore::QAttribute *attribute)
{
    Q_D(QMorphTarget);
    for (const Qt3DCore::QAttribute *attr : std::as_const(d->m_targetAttributes)) {
        if (attr->name() == attribute->name())
            return;
    }
    d->m_targetAttributes.push_back(attribute);
    d->m_attributeNames.push_back(attribute->name());
    emit attributeNamesChanged(d->m_attributeNames);
}

/*!
    Removes an \a attribute from the morph target.
*/
void QMorphTarget::removeAttribute(Qt3DCore::QAttribute *attribute)
{
    Q_D(QMorphTarget);
    if (d->m_targetAttributes.contains(attribute)) {
        d->m_targetAttributes.removeAll(attribute);
        d->updateAttributeNames();
        emit attributeNamesChanged(d->m_attributeNames);
    }
}

/*!
    Returns a morph target based on the \a attributes in the given \a geometry.
*/
QMorphTarget *QMorphTarget::fromGeometry(Qt3DCore::QGeometry *geometry, const QStringList &attributes)
{
    QMorphTarget *target = new QMorphTarget();
    const auto geometryAttributes = geometry->attributes();
    for (Qt3DCore::QAttribute *attr : geometryAttributes) {
        if (attributes.contains(attr->name()))
            target->addAttribute(attr);
    }
    return target;
}

} // Qt3DAnimation

QT_END_NAMESPACE

#include "moc_qmorphtarget.cpp"