// Copyright (C) 2017 Klaralvdalens Datakonsult AB (KDAB). // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only #include "qcallbackmapping.h" #include "qcallbackmapping_p.h" #include #include QT_BEGIN_NAMESPACE namespace Qt3DAnimation { QCallbackMappingPrivate::QCallbackMappingPrivate() : QAbstractChannelMappingPrivate() , m_channelName() , m_type(static_cast(QMetaType::UnknownType)) , m_callback(nullptr) { m_mappingType = QAbstractChannelMappingPrivate::CallbackMapping; } /*! \class Qt3DAnimation::QCallbackMapping \inherits Qt3DCore::QAbstractChannelMapping \inmodule Qt3DAnimation \brief Allows to map the channels within the clip onto an invocation of a callback object. */ QCallbackMapping::QCallbackMapping(Qt3DCore::QNode *parent) : QAbstractChannelMapping(*new QCallbackMappingPrivate, parent) { } QCallbackMapping::QCallbackMapping(QCallbackMappingPrivate &dd, Qt3DCore::QNode *parent) : QAbstractChannelMapping(dd, parent) { } QCallbackMapping::~QCallbackMapping() { } QString QCallbackMapping::channelName() const { Q_D(const QCallbackMapping); return d->m_channelName; } QAnimationCallback *QCallbackMapping::callback() const { Q_D(const QCallbackMapping); return d->m_callback; } void QCallbackMapping::setChannelName(const QString &channelName) { Q_D(QCallbackMapping); if (d->m_channelName == channelName) return; d->m_channelName = channelName; emit channelNameChanged(channelName); } /*! Associates a \a callback object with this channel mapping. Such mappings do not have to have a target object and property name. When the \a callback object is set, every change in the animated value will lead to invoking the callback's \l {Qt3DAnimation::QAnimationCallback::valueChanged}{valueChanged} function either on the gui/main thread, or directly on one of the thread pool's worker thread. This is controlled by \a flags. \a type specifies the type (for example, QMetaType::QVector3D, QMetaType::QColor, or QMetaType::Float) of the animated value. When animating node properties this does not need to be provided separately, however it becomes important to supply this when there is only a callback. \note A mapping can be associated both with a node property and a callback. It is important however that \a type matches the type of the property in this case. Note also that for properties of type QVariant (for example, QParameter::value), the \a type is the type of the value stored in the QVariant. \note The \a callback pointer is expected to stay valid while any associated animators are running. */ void QCallbackMapping::setCallback(int type, QAnimationCallback *callback, QAnimationCallback::Flags flags) { Q_D(QCallbackMapping); if (d->m_type != type) { d->m_type = type; d->update(); } if (d->m_callback != callback) { d->m_callback = callback; d->update(); } if (d->m_callbackFlags != flags) { d->m_callbackFlags = flags; d->update(); } } } // namespace Qt3DAnimation QT_END_NAMESPACE #include "moc_qcallbackmapping.cpp"