QMorphingAnimation Class

class Qt3DAnimation::QMorphingAnimation

A class implementing blend-shape morphing animation. More...

Header:	#include <QMorphingAnimation>
CMake:	find_package(Qt6 COMPONENTS 3danimation REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::3danimation)
qmake:	QT += 3danimation
Since:	Qt 5.9
Instantiated By:	MorphingAnimation
Inherits:	Qt3DAnimation::QAbstractAnimation

• List of all members, including inherited members

Public Types

enum	Method { Normalized, Relative }

Properties

easing : QEasingCurve interpolator : const float method : Method

target : Qt3DRender::QGeometryRenderer* targetName : QString targetPositions : QVector<float>

Public Functions

	QMorphingAnimation(QObject *parent = nullptr)
void	addMorphTarget(Qt3DAnimation::QMorphTarget *target)
QEasingCurve	easing() const
QVector<float>	getWeights(int positionIndex)
float	interpolator() const
QMorphingAnimation::Method	method() const
QVector<Qt3DAnimation::QMorphTarget *>	morphTargetList()
void	removeMorphTarget(Qt3DAnimation::QMorphTarget *target)
void	setMorphTargets(const QVector<Qt3DAnimation::QMorphTarget *> &targets)
void	setWeights(int positionIndex, const QVector<float> &weights)
Qt3DRender::QGeometryRenderer *	target() const
QString	targetName() const
QVector<float>	targetPositions() const

Public Slots

void	setEasing(const QEasingCurve &easing)
void	setMethod(QMorphingAnimation::Method method)
void	setTarget(Qt3DRender::QGeometryRenderer *target)
void	setTargetName(const QString name)
void	setTargetPositions(const QVector<float> &targetPositions)

Signals

void	easingChanged(const QEasingCurve &easing)
void	interpolatorChanged(float interpolator)
void	methodChanged(QMorphingAnimation::Method method)
void	targetChanged(Qt3DRender::QGeometryRenderer *target)
void	targetNameChanged(const QString &name)
void	targetPositionsChanged(const QVector<float> &targetPositions)

Detailed Description

A Qt3DAnimation::QMorphingAnimation class implements blend-shape morphing animation to a target QGeometryRenderer. The QMorphingAnimation sets the correct QAttributes from the morph targets to the target QGeometryRenderer::geometry and calculates interpolator for the current position. The actual blending between the attributes must be implemented in the material. Qt3DAnimation::QMorphPhongMaterial implements material with morphing support for phong lighting model. The blending happens between 2 attributes - 'base' and 'target'. The names for the base and target attributes are taken from the morph target names, where the base attribute retains the name it already has and the target attribute name gets 'Target' appended to the name. The interpolator can be set as a QParameter to the used material. All morph targets in the animation should contain the attributes with same names as those in the base geometry.

Member Type Documentation

enum QMorphingAnimation::Method

This enumeration specifies the morphing method.

Constant	Value	Description
Qt3DAnimation::QMorphingAnimation::Normalized	0	The blending should use the normalized formula; V' = Vbase * (1.0 - sum(Wi)) + sum[Vi * Wi]
Qt3DAnimation::QMorphingAnimation::Relative	1	The blending should use the relative formula; V' = Vbase + sum[Vi * Wi]

Member Function Documentation

QMorphingAnimation::QMorphingAnimation(QObject *parent = nullptr)

Construct a new QMorphingAnimation with parent.

void QMorphingAnimation::addMorphTarget(Qt3DAnimation::QMorphTarget *target)

Add new morph target at the end of the animation.

QVector<float> QMorphingAnimation::getWeights(int positionIndex)

Return morph weights at positionIndex.

QVector<Qt3DAnimation::QMorphTarget *> QMorphingAnimation::morphTargetList()

Return morph target list.

void QMorphingAnimation::removeMorphTarget(Qt3DAnimation::QMorphTarget *target)

Remove morph target from the animation.

void QMorphingAnimation::setMorphTargets(const QVector<Qt3DAnimation::QMorphTarget *> &targets)

Set morph targets to animation. Old targets are cleared.

void QMorphingAnimation::setWeights(int positionIndex, const QVector<float> &weights)

Sets morph weights at positionIndex.