Source code
Revision control
Copy as Markdown
// 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
\nativetype 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"