| Absolute File Name: | /home/opencoverage/opencoverage/guest-scripts/qtdeclarative/src/qtdeclarative/src/quick/util/qquickanimator.cpp |
| Source code | Switch to Preprocessed file |
| Line | Source | Count | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | /**************************************************************************** | - | ||||||||||||
| 2 | ** | - | ||||||||||||
| 3 | ** Copyright (C) 2016 The Qt Company Ltd. | - | ||||||||||||
| 4 | ** Contact: https://www.qt.io/licensing/ | - | ||||||||||||
| 5 | ** | - | ||||||||||||
| 6 | ** This file is part of the QtQuick module of the Qt Toolkit. | - | ||||||||||||
| 7 | ** | - | ||||||||||||
| 8 | ** $QT_BEGIN_LICENSE:LGPL$ | - | ||||||||||||
| 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 https://www.qt.io/terms-conditions. For further | - | ||||||||||||
| 15 | ** information use the contact form at https://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.LGPL3 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-3.0.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 (at your option) the GNU General | - | ||||||||||||
| 28 | ** Public license version 3 or any later version approved by the KDE Free | - | ||||||||||||
| 29 | ** Qt Foundation. The licenses are as published by the Free Software | - | ||||||||||||
| 30 | ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 | - | ||||||||||||
| 31 | ** included in the packaging of this file. Please review the following | - | ||||||||||||
| 32 | ** information to ensure the GNU General Public License requirements will | - | ||||||||||||
| 33 | ** be met: https://www.gnu.org/licenses/gpl-2.0.html and | - | ||||||||||||
| 34 | ** https://www.gnu.org/licenses/gpl-3.0.html. | - | ||||||||||||
| 35 | ** | - | ||||||||||||
| 36 | ** $QT_END_LICENSE$ | - | ||||||||||||
| 37 | ** | - | ||||||||||||
| 38 | ****************************************************************************/ | - | ||||||||||||
| 39 | - | |||||||||||||
| 40 | #include "qquickanimator_p_p.h" | - | ||||||||||||
| 41 | #include "qquickanimatorjob_p.h" | - | ||||||||||||
| 42 | - | |||||||||||||
| 43 | #include <private/qquickitem_p.h> | - | ||||||||||||
| 44 | - | |||||||||||||
| 45 | QT_BEGIN_NAMESPACE | - | ||||||||||||
| 46 | - | |||||||||||||
| 47 | /*! | - | ||||||||||||
| 48 | \qmltype Animator | - | ||||||||||||
| 49 | \instantiates QQuickAnimator | - | ||||||||||||
| 50 | \inqmlmodule QtQuick | - | ||||||||||||
| 51 | \since 5.2 | - | ||||||||||||
| 52 | \ingroup qtquick-transitions-animations | - | ||||||||||||
| 53 | \inherits Animation | - | ||||||||||||
| 54 | \brief Is the base of all QML animators. | - | ||||||||||||
| 55 | - | |||||||||||||
| 56 | Animator types are a special type of animation which operate | - | ||||||||||||
| 57 | directly on Qt Quick's scene graph, rather than the QML objects and their | - | ||||||||||||
| 58 | properties like regular Animation types do. This has the benefit that | - | ||||||||||||
| 59 | Animator based animations can animate on the \l | - | ||||||||||||
| 60 | {Threaded Render Loop ("threaded")}{scene graph's rendering thread} even when the | - | ||||||||||||
| 61 | UI thread is blocked. | - | ||||||||||||
| 62 | - | |||||||||||||
| 63 | The value of the QML property will be updated after the animation has | - | ||||||||||||
| 64 | finished. The property is not updated while the animation is running. | - | ||||||||||||
| 65 | - | |||||||||||||
| 66 | The Animator types can be used just like any other Animation type. | - | ||||||||||||
| 67 | - | |||||||||||||
| 68 | \snippet qml/animators.qml mixed | - | ||||||||||||
| 69 | - | |||||||||||||
| 70 | If all sub-animations of ParallelAnimation and SequentialAnimation | - | ||||||||||||
| 71 | are Animator types, the ParallelAnimation and SequentialAnimation will | - | ||||||||||||
| 72 | also be treated as an Animator and be run on the scene graph's rendering | - | ||||||||||||
| 73 | thread when possible. | - | ||||||||||||
| 74 | - | |||||||||||||
| 75 | The Animator types can be used for animations during transitions, but | - | ||||||||||||
| 76 | they do not support the \l {Transition::reversible}{reversible} | - | ||||||||||||
| 77 | property. | - | ||||||||||||
| 78 | - | |||||||||||||
| 79 | The Animator type cannot be used directly in a QML file. It exists | - | ||||||||||||
| 80 | to provide a set of common properties and methods, available across all the | - | ||||||||||||
| 81 | other animator types that inherit from it. Attempting to use the Animator | - | ||||||||||||
| 82 | type directly will result in an error. | - | ||||||||||||
| 83 | */ | - | ||||||||||||
| 84 | - | |||||||||||||
| 85 | QQuickAnimator::QQuickAnimator(QQuickAnimatorPrivate &dd, QObject *parent) | - | ||||||||||||
| 86 | : QQuickAbstractAnimation(dd, parent) | - | ||||||||||||
| 87 | { | - | ||||||||||||
| 88 | } executed 8 times by 1 test: end of blockExecuted by:
| 8 | ||||||||||||
| 89 | - | |||||||||||||
| 90 | QQuickAnimator::QQuickAnimator(QObject *parent) | - | ||||||||||||
| 91 | : QQuickAbstractAnimation(*new QQuickAnimatorPrivate, parent) | - | ||||||||||||
| 92 | { | - | ||||||||||||
| 93 | } executed 28 times by 2 tests: end of blockExecuted by:
| 28 | ||||||||||||
| 94 | - | |||||||||||||
| 95 | /*! | - | ||||||||||||
| 96 | \qmlproperty QtQuick::Item QtQuick::Animator::target | - | ||||||||||||
| 97 | - | |||||||||||||
| 98 | This property holds the target item of the animator. | - | ||||||||||||
| 99 | - | |||||||||||||
| 100 | \note Animator targets must be Item based types. | - | ||||||||||||
| 101 | */ | - | ||||||||||||
| 102 | - | |||||||||||||
| 103 | void QQuickAnimator::setTargetItem(QQuickItem *target) | - | ||||||||||||
| 104 | { | - | ||||||||||||
| 105 | Q_D(QQuickAnimator); | - | ||||||||||||
| 106 | if (target == d->target)
| 0-24 | ||||||||||||
| 107 | return; never executed: return; | 0 | ||||||||||||
| 108 | d->target = target; | - | ||||||||||||
| 109 | Q_EMIT targetItemChanged(d->target); | - | ||||||||||||
| 110 | } executed 24 times by 2 tests: end of blockExecuted by:
| 24 | ||||||||||||
| 111 | - | |||||||||||||
| 112 | QQuickItem *QQuickAnimator::targetItem() const | - | ||||||||||||
| 113 | { | - | ||||||||||||
| 114 | Q_D(const QQuickAnimator); | - | ||||||||||||
| 115 | return d->target; never executed: return d->target; | 0 | ||||||||||||
| 116 | } | - | ||||||||||||
| 117 | - | |||||||||||||
| 118 | /*! | - | ||||||||||||
| 119 | \qmlproperty int QtQuick::Animator::duration | - | ||||||||||||
| 120 | This property holds the duration of the animation in milliseconds. | - | ||||||||||||
| 121 | - | |||||||||||||
| 122 | The default value is 250. | - | ||||||||||||
| 123 | */ | - | ||||||||||||
| 124 | void QQuickAnimator::setDuration(int duration) | - | ||||||||||||
| 125 | { | - | ||||||||||||
| 126 | Q_D(QQuickAnimator); | - | ||||||||||||
| 127 | if (duration == d->duration)
| 0-36 | ||||||||||||
| 128 | return; never executed: return; | 0 | ||||||||||||
| 129 | d->duration = duration; | - | ||||||||||||
| 130 | Q_EMIT durationChanged(duration); | - | ||||||||||||
| 131 | } executed 36 times by 2 tests: end of blockExecuted by:
| 36 | ||||||||||||
| 132 | - | |||||||||||||
| 133 | int QQuickAnimator::duration() const | - | ||||||||||||
| 134 | { | - | ||||||||||||
| 135 | Q_D(const QQuickAnimator); | - | ||||||||||||
| 136 | return d->duration; never executed: return d->duration; | 0 | ||||||||||||
| 137 | } | - | ||||||||||||
| 138 | - | |||||||||||||
| 139 | /*! | - | ||||||||||||
| 140 | \qmlpropertygroup QtQuick::Animator::easing | - | ||||||||||||
| 141 | \qmlproperty enumeration QtQuick::Animator::easing.type | - | ||||||||||||
| 142 | \qmlproperty real QtQuick::Animator::easing.amplitude | - | ||||||||||||
| 143 | \qmlproperty real QtQuick::Animator::easing.overshoot | - | ||||||||||||
| 144 | \qmlproperty real QtQuick::Animator::easing.period | - | ||||||||||||
| 145 | \qmlproperty list<real> QtQuick::Animator::easing.bezierCurve | - | ||||||||||||
| 146 | \include qquickanimation.cpp propertyanimation.easing | - | ||||||||||||
| 147 | */ | - | ||||||||||||
| 148 | - | |||||||||||||
| 149 | void QQuickAnimator::setEasing(const QEasingCurve &easing) | - | ||||||||||||
| 150 | { | - | ||||||||||||
| 151 | Q_D(QQuickAnimator); | - | ||||||||||||
| 152 | if (easing == d->easing)
| 0-8 | ||||||||||||
| 153 | return; never executed: return; | 0 | ||||||||||||
| 154 | d->easing = easing; | - | ||||||||||||
| 155 | Q_EMIT easingChanged(d->easing); | - | ||||||||||||
| 156 | } executed 8 times by 1 test: end of blockExecuted by:
| 8 | ||||||||||||
| 157 | - | |||||||||||||
| 158 | QEasingCurve QQuickAnimator::easing() const | - | ||||||||||||
| 159 | { | - | ||||||||||||
| 160 | Q_D(const QQuickAnimator); | - | ||||||||||||
| 161 | return d->easing; executed 8 times by 1 test: return d->easing;Executed by:
| 8 | ||||||||||||
| 162 | } | - | ||||||||||||
| 163 | - | |||||||||||||
| 164 | /*! | - | ||||||||||||
| 165 | \qmlproperty real QtQuick::Animator::to | - | ||||||||||||
| 166 | This property holds the end value for the animation. | - | ||||||||||||
| 167 | - | |||||||||||||
| 168 | If the Animator is defined within a \l Transition or \l Behavior, | - | ||||||||||||
| 169 | this value defaults to the value defined in the end state of the | - | ||||||||||||
| 170 | \l Transition, or the value of the property change that triggered the | - | ||||||||||||
| 171 | \l Behavior. | - | ||||||||||||
| 172 | */ | - | ||||||||||||
| 173 | - | |||||||||||||
| 174 | void QQuickAnimator::setTo(qreal to) | - | ||||||||||||
| 175 | { | - | ||||||||||||
| 176 | Q_D(QQuickAnimator); | - | ||||||||||||
| 177 | if (to == d->to)
| 10-26 | ||||||||||||
| 178 | return; executed 10 times by 2 tests: return;Executed by:
| 10 | ||||||||||||
| 179 | d->isToDefined = true; | - | ||||||||||||
| 180 | d->to = to; | - | ||||||||||||
| 181 | Q_EMIT toChanged(d->to); | - | ||||||||||||
| 182 | } executed 26 times by 1 test: end of blockExecuted by:
| 26 | ||||||||||||
| 183 | - | |||||||||||||
| 184 | qreal QQuickAnimator::to() const | - | ||||||||||||
| 185 | { | - | ||||||||||||
| 186 | Q_D(const QQuickAnimator); | - | ||||||||||||
| 187 | return d->to; never executed: return d->to; | 0 | ||||||||||||
| 188 | } | - | ||||||||||||
| 189 | - | |||||||||||||
| 190 | /*! | - | ||||||||||||
| 191 | \qmlproperty real QtQuick::Animator::from | - | ||||||||||||
| 192 | This property holds the starting value for the animation. | - | ||||||||||||
| 193 | - | |||||||||||||
| 194 | If the Animator is defined within a \l Transition or \l Behavior, | - | ||||||||||||
| 195 | this value defaults to the value defined in the starting state of the | - | ||||||||||||
| 196 | \l Transition, or the current value of the property at the moment the | - | ||||||||||||
| 197 | \l Behavior is triggered. | - | ||||||||||||
| 198 | - | |||||||||||||
| 199 | \sa {Animation and Transitions in Qt Quick} | - | ||||||||||||
| 200 | */ | - | ||||||||||||
| 201 | - | |||||||||||||
| 202 | void QQuickAnimator::setFrom(qreal from) | - | ||||||||||||
| 203 | { | - | ||||||||||||
| 204 | Q_D(QQuickAnimator); | - | ||||||||||||
| 205 | if (from == d->from)
| 12-24 | ||||||||||||
| 206 | return; executed 12 times by 1 test: return;Executed by:
| 12 | ||||||||||||
| 207 | d->isFromDefined = true; | - | ||||||||||||
| 208 | d->from = from; | - | ||||||||||||
| 209 | Q_EMIT fromChanged(d->from); | - | ||||||||||||
| 210 | } executed 24 times by 2 tests: end of blockExecuted by:
| 24 | ||||||||||||
| 211 | - | |||||||||||||
| 212 | qreal QQuickAnimator::from() const | - | ||||||||||||
| 213 | { | - | ||||||||||||
| 214 | Q_D(const QQuickAnimator); | - | ||||||||||||
| 215 | return d->from; never executed: return d->from; | 0 | ||||||||||||
| 216 | } | - | ||||||||||||
| 217 | - | |||||||||||||
| 218 | void QQuickAnimatorPrivate::apply(QQuickAnimatorJob *job, | - | ||||||||||||
| 219 | const QString &propertyName, | - | ||||||||||||
| 220 | QQuickStateActions &actions, | - | ||||||||||||
| 221 | QQmlProperties &modified, | - | ||||||||||||
| 222 | QObject *defaultTarget) | - | ||||||||||||
| 223 | { | - | ||||||||||||
| 224 | - | |||||||||||||
| 225 | if (actions.size()) {
| 0-36 | ||||||||||||
| 226 | for (int i=0; i<actions.size(); ++i) {
| 0 | ||||||||||||
| 227 | QQuickStateAction &action = actions[i]; | - | ||||||||||||
| 228 | if (action.property.name() != propertyName)
| 0 | ||||||||||||
| 229 | continue; never executed: continue; | 0 | ||||||||||||
| 230 | modified << action.property; | - | ||||||||||||
| 231 | - | |||||||||||||
| 232 | job->setTarget(qobject_cast<QQuickItem *>(action.property.object())); | - | ||||||||||||
| 233 | - | |||||||||||||
| 234 | if (isFromDefined)
| 0 | ||||||||||||
| 235 | job->setFrom(from); never executed: job->setFrom(from); | 0 | ||||||||||||
| 236 | else if (action.fromValue.isValid())
| 0 | ||||||||||||
| 237 | job->setFrom(action.fromValue.toReal()); never executed: job->setFrom(action.fromValue.toReal()); | 0 | ||||||||||||
| 238 | else | - | ||||||||||||
| 239 | job->setFrom(action.property.read().toReal()); never executed: job->setFrom(action.property.read().toReal()); | 0 | ||||||||||||
| 240 | - | |||||||||||||
| 241 | if (isToDefined)
| 0 | ||||||||||||
| 242 | job->setTo(to); never executed: job->setTo(to); | 0 | ||||||||||||
| 243 | else if (action.toValue.isValid())
| 0 | ||||||||||||
| 244 | job->setTo(action.toValue.toReal()); never executed: job->setTo(action.toValue.toReal()); | 0 | ||||||||||||
| 245 | else | - | ||||||||||||
| 246 | job->setTo(action.property.read().toReal()); never executed: job->setTo(action.property.read().toReal()); | 0 | ||||||||||||
| 247 | - | |||||||||||||
| 248 | // This magic line is in sync with what PropertyAnimation does | - | ||||||||||||
| 249 | // and prevents the animation to end up in the "completeList" | - | ||||||||||||
| 250 | // which forces action.toValue to be written directly to | - | ||||||||||||
| 251 | // the item when a transition is cancelled. | - | ||||||||||||
| 252 | action.fromValue = action.toValue; | - | ||||||||||||
| 253 | } never executed: end of block | 0 | ||||||||||||
| 254 | } never executed: end of block | 0 | ||||||||||||
| 255 | - | |||||||||||||
| 256 | if (modified.isEmpty()) {
| 0-36 | ||||||||||||
| 257 | job->setTarget(target); | - | ||||||||||||
| 258 | job->setFrom(from); | - | ||||||||||||
| 259 | job->setTo(to); | - | ||||||||||||
| 260 | } executed 36 times by 2 tests: end of blockExecuted by:
| 36 | ||||||||||||
| 261 | - | |||||||||||||
| 262 | if (!job->target()) {
| 12-24 | ||||||||||||
| 263 | if (defaultProperty.object())
| 0-12 | ||||||||||||
| 264 | job->setTarget(qobject_cast<QQuickItem *>(defaultProperty.object())); executed 12 times by 1 test: job->setTarget(qobject_cast<QQuickItem *>(defaultProperty.object()));Executed by:
| 12 | ||||||||||||
| 265 | else | - | ||||||||||||
| 266 | job->setTarget(qobject_cast<QQuickItem *>(defaultTarget)); never executed: job->setTarget(qobject_cast<QQuickItem *>(defaultTarget)); | 0 | ||||||||||||
| 267 | } | - | ||||||||||||
| 268 | - | |||||||||||||
| 269 | job->setDuration(duration); | - | ||||||||||||
| 270 | job->setLoopCount(loopCount); | - | ||||||||||||
| 271 | job->setEasingCurve(easing); | - | ||||||||||||
| 272 | } executed 36 times by 2 tests: end of blockExecuted by:
| 36 | ||||||||||||
| 273 | - | |||||||||||||
| 274 | QAbstractAnimationJob *QQuickAnimator::transition(QQuickStateActions &actions, | - | ||||||||||||
| 275 | QQmlProperties &modified, | - | ||||||||||||
| 276 | TransitionDirection direction, | - | ||||||||||||
| 277 | QObject *defaultTarget) | - | ||||||||||||
| 278 | { | - | ||||||||||||
| 279 | Q_D(QQuickAnimator); | - | ||||||||||||
| 280 | - | |||||||||||||
| 281 | if (d->defaultProperty.isValid() && propertyName() != d->defaultProperty.name()) {
| 0-24 | ||||||||||||
| 282 | qDebug() << Q_FUNC_INFO << "property name conflict..."; | - | ||||||||||||
| 283 | return nullptr; never executed: return nullptr; | 0 | ||||||||||||
| 284 | } | - | ||||||||||||
| 285 | - | |||||||||||||
| 286 | // The animation system cannot handle backwards uncontrolled animations. | - | ||||||||||||
| 287 | if (direction == Backward)
| 0-36 | ||||||||||||
| 288 | return nullptr; never executed: return nullptr; | 0 | ||||||||||||
| 289 | - | |||||||||||||
| 290 | QQuickAnimatorJob *job = createJob(); | - | ||||||||||||
| 291 | if (!job)
| 0-36 | ||||||||||||
| 292 | return nullptr; never executed: return nullptr; | 0 | ||||||||||||
| 293 | - | |||||||||||||
| 294 | d->apply(job, propertyName(), actions, modified, defaultTarget); | - | ||||||||||||
| 295 | - | |||||||||||||
| 296 | if (!job->target()) {
| 0-36 | ||||||||||||
| 297 | delete job; | - | ||||||||||||
| 298 | return nullptr; never executed: return nullptr; | 0 | ||||||||||||
| 299 | } | - | ||||||||||||
| 300 | - | |||||||||||||
| 301 | return job; executed 36 times by 2 tests: return job;Executed by:
| 36 | ||||||||||||
| 302 | } | - | ||||||||||||
| 303 | - | |||||||||||||
| 304 | /*! | - | ||||||||||||
| 305 | \qmltype XAnimator | - | ||||||||||||
| 306 | \instantiates QQuickXAnimator | - | ||||||||||||
| 307 | \inqmlmodule QtQuick | - | ||||||||||||
| 308 | \since 5.2 | - | ||||||||||||
| 309 | \ingroup qtquick-transitions-animations | - | ||||||||||||
| 310 | \inherits Animator | - | ||||||||||||
| 311 | \brief The XAnimator type animates the x position of an Item. | - | ||||||||||||
| 312 | - | |||||||||||||
| 313 | \l{Animator} types are different from normal Animation types. When | - | ||||||||||||
| 314 | using an Animator, the animation can be run in the render thread | - | ||||||||||||
| 315 | and the property value will jump to the end when the animation is | - | ||||||||||||
| 316 | complete. | - | ||||||||||||
| 317 | - | |||||||||||||
| 318 | The value of Item::x is updated after the animation has finished. | - | ||||||||||||
| 319 | - | |||||||||||||
| 320 | The following snippet shows how to use a XAnimator together | - | ||||||||||||
| 321 | with a Rectangle item. | - | ||||||||||||
| 322 | - | |||||||||||||
| 323 | \snippet qml/animators.qml x target | - | ||||||||||||
| 324 | - | |||||||||||||
| 325 | It is also possible to use the \c on keyword to tie the | - | ||||||||||||
| 326 | XAnimator directly to an Item instance. | - | ||||||||||||
| 327 | - | |||||||||||||
| 328 | \snippet qml/animators.qml x on | - | ||||||||||||
| 329 | - | |||||||||||||
| 330 | - | |||||||||||||
| 331 | */ | - | ||||||||||||
| 332 | - | |||||||||||||
| 333 | QQuickXAnimator::QQuickXAnimator(QObject *parent) : QQuickAnimator(parent) {} executed 4 times by 1 test: end of blockExecuted by:
| 4 | ||||||||||||
| 334 | - | |||||||||||||
| 335 | QQuickAnimatorJob *QQuickXAnimator::createJob() const { return new QQuickXAnimatorJob(); } executed 4 times by 1 test: return new QQuickXAnimatorJob();Executed by:
| 4 | ||||||||||||
| 336 | - | |||||||||||||
| 337 | /*! | - | ||||||||||||
| 338 | \qmltype YAnimator | - | ||||||||||||
| 339 | \instantiates QQuickYAnimator | - | ||||||||||||
| 340 | \inqmlmodule QtQuick | - | ||||||||||||
| 341 | \since 5.2 | - | ||||||||||||
| 342 | \ingroup qtquick-transitions-animations | - | ||||||||||||
| 343 | \inherits Animator | - | ||||||||||||
| 344 | \brief The YAnimator type animates the y position of an Item. | - | ||||||||||||
| 345 | - | |||||||||||||
| 346 | \l{Animator} types are different from normal Animation types. When | - | ||||||||||||
| 347 | using an Animator, the animation can be run in the render thread | - | ||||||||||||
| 348 | and the property value will jump to the end when the animation is | - | ||||||||||||
| 349 | complete. | - | ||||||||||||
| 350 | - | |||||||||||||
| 351 | The value of Item::y is updated after the animation has finished. | - | ||||||||||||
| 352 | - | |||||||||||||
| 353 | The following snippet shows how to use a YAnimator together | - | ||||||||||||
| 354 | with a Rectangle item. | - | ||||||||||||
| 355 | - | |||||||||||||
| 356 | \snippet qml/animators.qml y target | - | ||||||||||||
| 357 | - | |||||||||||||
| 358 | It is also possible to use the \c on keyword to tie the | - | ||||||||||||
| 359 | YAnimator directly to an Item instance. | - | ||||||||||||
| 360 | - | |||||||||||||
| 361 | \snippet qml/animators.qml y on | - | ||||||||||||
| 362 | - | |||||||||||||
| 363 | - | |||||||||||||
| 364 | */ | - | ||||||||||||
| 365 | - | |||||||||||||
| 366 | QQuickYAnimator::QQuickYAnimator(QObject *parent) : QQuickAnimator(parent) {} executed 8 times by 1 test: end of blockExecuted by:
| 8 | ||||||||||||
| 367 | - | |||||||||||||
| 368 | QQuickAnimatorJob *QQuickYAnimator::createJob() const { return new QQuickYAnimatorJob(); } executed 8 times by 1 test: return new QQuickYAnimatorJob();Executed by:
| 8 | ||||||||||||
| 369 | - | |||||||||||||
| 370 | /*! | - | ||||||||||||
| 371 | \qmltype ScaleAnimator | - | ||||||||||||
| 372 | \instantiates QQuickScaleAnimator | - | ||||||||||||
| 373 | \inqmlmodule QtQuick | - | ||||||||||||
| 374 | \since 5.2 | - | ||||||||||||
| 375 | \ingroup qtquick-transitions-animations | - | ||||||||||||
| 376 | \inherits Animator | - | ||||||||||||
| 377 | \brief The ScaleAnimator type animates the scale factor of an Item. | - | ||||||||||||
| 378 | - | |||||||||||||
| 379 | \l{Animator} types are different from normal Animation types. When | - | ||||||||||||
| 380 | using an Animator, the animation can be run in the render thread | - | ||||||||||||
| 381 | and the property value will jump to the end when the animation is | - | ||||||||||||
| 382 | complete. | - | ||||||||||||
| 383 | - | |||||||||||||
| 384 | The value of Item::scale is updated after the animation has finished. | - | ||||||||||||
| 385 | - | |||||||||||||
| 386 | The following snippet shows how to use a ScaleAnimator together | - | ||||||||||||
| 387 | with a Rectangle item. | - | ||||||||||||
| 388 | - | |||||||||||||
| 389 | \snippet qml/animators.qml scale target | - | ||||||||||||
| 390 | - | |||||||||||||
| 391 | It is also possible to use the \c on keyword to tie the | - | ||||||||||||
| 392 | ScaleAnimator directly to an Item instance. | - | ||||||||||||
| 393 | - | |||||||||||||
| 394 | \snippet qml/animators.qml scale on | - | ||||||||||||
| 395 | - | |||||||||||||
| 396 | \sa Item::transformOrigin, RotationAnimator | - | ||||||||||||
| 397 | */ | - | ||||||||||||
| 398 | - | |||||||||||||
| 399 | QQuickScaleAnimator::QQuickScaleAnimator(QObject *parent) : QQuickAnimator(parent) {} executed 10 times by 1 test: end of blockExecuted by:
| 10 | ||||||||||||
| 400 | - | |||||||||||||
| 401 | QQuickAnimatorJob *QQuickScaleAnimator::createJob() const { return new QQuickScaleAnimatorJob(); } executed 10 times by 1 test: return new QQuickScaleAnimatorJob();Executed by:
| 10 | ||||||||||||
| 402 | - | |||||||||||||
| 403 | /*! | - | ||||||||||||
| 404 | \qmltype OpacityAnimator | - | ||||||||||||
| 405 | \instantiates QQuickOpacityAnimator | - | ||||||||||||
| 406 | \inqmlmodule QtQuick | - | ||||||||||||
| 407 | \since 5.2 | - | ||||||||||||
| 408 | \ingroup qtquick-transitions-animations | - | ||||||||||||
| 409 | \inherits Animator | - | ||||||||||||
| 410 | \brief The OpacityAnimator type animates the opacity of an Item. | - | ||||||||||||
| 411 | - | |||||||||||||
| 412 | \l{Animator} types are different from normal Animation types. When | - | ||||||||||||
| 413 | using an Animator, the animation can be run in the render thread | - | ||||||||||||
| 414 | and the property value will jump to the end when the animation is | - | ||||||||||||
| 415 | complete. | - | ||||||||||||
| 416 | - | |||||||||||||
| 417 | The value of Item::opacity is updated after the animation has finished. | - | ||||||||||||
| 418 | - | |||||||||||||
| 419 | The following snippet shows how to use a OpacityAnimator together | - | ||||||||||||
| 420 | with a Rectangle item. | - | ||||||||||||
| 421 | - | |||||||||||||
| 422 | \snippet qml/animators.qml opacity target | - | ||||||||||||
| 423 | - | |||||||||||||
| 424 | It is also possible to use the \c on keyword to tie the | - | ||||||||||||
| 425 | OpacityAnimator directly to an Item instance. | - | ||||||||||||
| 426 | - | |||||||||||||
| 427 | \snippet qml/animators.qml opacity on | - | ||||||||||||
| 428 | - | |||||||||||||
| 429 | */ | - | ||||||||||||
| 430 | - | |||||||||||||
| 431 | QQuickOpacityAnimator::QQuickOpacityAnimator(QObject *parent) : QQuickAnimator(parent) {} executed 6 times by 2 tests: end of blockExecuted by:
| 6 | ||||||||||||
| 432 | - | |||||||||||||
| 433 | QQuickAnimatorJob *QQuickOpacityAnimator::createJob() const { return new QQuickOpacityAnimatorJob(); } executed 6 times by 2 tests: return new QQuickOpacityAnimatorJob();Executed by:
| 6 | ||||||||||||
| 434 | - | |||||||||||||
| 435 | /*! | - | ||||||||||||
| 436 | \qmltype RotationAnimator | - | ||||||||||||
| 437 | \instantiates QQuickRotationAnimator | - | ||||||||||||
| 438 | \inqmlmodule QtQuick | - | ||||||||||||
| 439 | \since 5.2 | - | ||||||||||||
| 440 | \ingroup qtquick-transitions-animations | - | ||||||||||||
| 441 | \inherits Animator | - | ||||||||||||
| 442 | \brief The RotationAnimator type animates the rotation of an Item. | - | ||||||||||||
| 443 | - | |||||||||||||
| 444 | \l{Animator} types are different from normal Animation types. When | - | ||||||||||||
| 445 | using an Animator, the animation can be run in the render thread | - | ||||||||||||
| 446 | and the property value will jump to the end when the animation is | - | ||||||||||||
| 447 | complete. | - | ||||||||||||
| 448 | - | |||||||||||||
| 449 | The value of Item::rotation is updated after the animation has finished. | - | ||||||||||||
| 450 | - | |||||||||||||
| 451 | The following snippet shows how to use a RotationAnimator together | - | ||||||||||||
| 452 | with a Rectangle item. | - | ||||||||||||
| 453 | - | |||||||||||||
| 454 | \snippet qml/animators.qml rotation target | - | ||||||||||||
| 455 | - | |||||||||||||
| 456 | It is also possible to use the \c on keyword to tie the | - | ||||||||||||
| 457 | RotationAnimator directly to the \c rotation property of an Item | - | ||||||||||||
| 458 | instance. | - | ||||||||||||
| 459 | - | |||||||||||||
| 460 | \snippet qml/animators.qml rotation on | - | ||||||||||||
| 461 | - | |||||||||||||
| 462 | \sa Item::transformOrigin, ScaleAnimator | - | ||||||||||||
| 463 | */ | - | ||||||||||||
| 464 | - | |||||||||||||
| 465 | QQuickRotationAnimator::QQuickRotationAnimator(QObject *parent) | - | ||||||||||||
| 466 | : QQuickAnimator(*new QQuickRotationAnimatorPrivate, parent) | - | ||||||||||||
| 467 | { | - | ||||||||||||
| 468 | } executed 4 times by 1 test: end of blockExecuted by:
| 4 | ||||||||||||
| 469 | - | |||||||||||||
| 470 | QQuickAnimatorJob *QQuickRotationAnimator::createJob() const { | - | ||||||||||||
| 471 | Q_D(const QQuickRotationAnimator); | - | ||||||||||||
| 472 | QQuickRotationAnimatorJob *job = new QQuickRotationAnimatorJob(); | - | ||||||||||||
| 473 | job->setDirection(d->direction); | - | ||||||||||||
| 474 | return job; executed 4 times by 1 test: return job;Executed by:
| 4 | ||||||||||||
| 475 | } | - | ||||||||||||
| 476 | - | |||||||||||||
| 477 | /*! | - | ||||||||||||
| 478 | \qmlproperty enumeration QtQuick::RotationAnimator::direction | - | ||||||||||||
| 479 | This property holds the direction of the rotation. | - | ||||||||||||
| 480 | - | |||||||||||||
| 481 | Possible values are: | - | ||||||||||||
| 482 | - | |||||||||||||
| 483 | \list | - | ||||||||||||
| 484 | \li RotationAnimator.Numerical (default) - Rotate by linearly interpolating between the two numbers. | - | ||||||||||||
| 485 | A rotation from 10 to 350 will rotate 340 degrees clockwise. | - | ||||||||||||
| 486 | \li RotationAnimator.Clockwise - Rotate clockwise between the two values | - | ||||||||||||
| 487 | \li RotationAnimator.Counterclockwise - Rotate counterclockwise between the two values | - | ||||||||||||
| 488 | \li RotationAnimator.Shortest - Rotate in the direction that produces the shortest animation path. | - | ||||||||||||
| 489 | A rotation from 10 to 350 will rotate 20 degrees counterclockwise. | - | ||||||||||||
| 490 | \endlist | - | ||||||||||||
| 491 | */ | - | ||||||||||||
| 492 | void QQuickRotationAnimator::setDirection(RotationDirection dir) | - | ||||||||||||
| 493 | { | - | ||||||||||||
| 494 | Q_D(QQuickRotationAnimator); | - | ||||||||||||
| 495 | if (d->direction == dir)
| 0 | ||||||||||||
| 496 | return; never executed: return; | 0 | ||||||||||||
| 497 | d->direction = dir; | - | ||||||||||||
| 498 | Q_EMIT directionChanged(d->direction); | - | ||||||||||||
| 499 | } never executed: end of block | 0 | ||||||||||||
| 500 | - | |||||||||||||
| 501 | QQuickRotationAnimator::RotationDirection QQuickRotationAnimator::direction() const | - | ||||||||||||
| 502 | { | - | ||||||||||||
| 503 | Q_D(const QQuickRotationAnimator); | - | ||||||||||||
| 504 | return d->direction; never executed: return d->direction; | 0 | ||||||||||||
| 505 | } | - | ||||||||||||
| 506 | - | |||||||||||||
| 507 | #if QT_CONFIG(quick_shadereffect) && QT_CONFIG(opengl) | - | ||||||||||||
| 508 | /*! | - | ||||||||||||
| 509 | \qmltype UniformAnimator | - | ||||||||||||
| 510 | \instantiates QQuickUniformAnimator | - | ||||||||||||
| 511 | \inqmlmodule QtQuick | - | ||||||||||||
| 512 | \since 5.2 | - | ||||||||||||
| 513 | \ingroup qtquick-transitions-animations | - | ||||||||||||
| 514 | \inherits Animator | - | ||||||||||||
| 515 | \brief The UniformAnimator type animates a uniform of a ShaderEffect. | - | ||||||||||||
| 516 | - | |||||||||||||
| 517 | \l{Animator} types are different from normal Animation types. When | - | ||||||||||||
| 518 | using an Animator, the animation can be run in the render thread | - | ||||||||||||
| 519 | and the property value will jump to the end when the animation is | - | ||||||||||||
| 520 | complete. | - | ||||||||||||
| 521 | - | |||||||||||||
| 522 | The value of the QML property defining the uniform is updated after | - | ||||||||||||
| 523 | the animation has finished. | - | ||||||||||||
| 524 | - | |||||||||||||
| 525 | The following snippet shows how to use a UniformAnimator together | - | ||||||||||||
| 526 | with a ShaderEffect item. | - | ||||||||||||
| 527 | - | |||||||||||||
| 528 | \snippet qml/animators.qml shader target | - | ||||||||||||
| 529 | - | |||||||||||||
| 530 | It is also possible to use the \c on keyword to tie the | - | ||||||||||||
| 531 | UniformAnimator directly to a uniform of a ShaderEffect | - | ||||||||||||
| 532 | instance. | - | ||||||||||||
| 533 | - | |||||||||||||
| 534 | \snippet qml/animators.qml shader on | - | ||||||||||||
| 535 | - | |||||||||||||
| 536 | \sa ShaderEffect, ShaderEffectSource | - | ||||||||||||
| 537 | */ | - | ||||||||||||
| 538 | - | |||||||||||||
| 539 | QQuickUniformAnimator::QQuickUniformAnimator(QObject *parent) | - | ||||||||||||
| 540 | : QQuickAnimator(*new QQuickUniformAnimatorPrivate, parent) | - | ||||||||||||
| 541 | { | - | ||||||||||||
| 542 | } executed 4 times by 1 test: end of blockExecuted by:
| 4 | ||||||||||||
| 543 | - | |||||||||||||
| 544 | /*! | - | ||||||||||||
| 545 | \qmlproperty string QtQuick::UniformAnimator::uniform | - | ||||||||||||
| 546 | This property holds the name of the uniform to animate. | - | ||||||||||||
| 547 | - | |||||||||||||
| 548 | The value of the uniform must correspond to both a property | - | ||||||||||||
| 549 | on the target ShaderEffect and must be a uniform of type | - | ||||||||||||
| 550 | \c float in the fragment or vertex shader. | - | ||||||||||||
| 551 | */ | - | ||||||||||||
| 552 | void QQuickUniformAnimator::setUniform(const QString &uniform) | - | ||||||||||||
| 553 | { | - | ||||||||||||
| 554 | Q_D(QQuickUniformAnimator); | - | ||||||||||||
| 555 | if (d->uniform == uniform)
| 0-2 | ||||||||||||
| 556 | return; never executed: return; | 0 | ||||||||||||
| 557 | d->uniform = uniform; | - | ||||||||||||
| 558 | Q_EMIT uniformChanged(d->uniform); | - | ||||||||||||
| 559 | } executed 2 times by 1 test: end of blockExecuted by:
| 2 | ||||||||||||
| 560 | - | |||||||||||||
| 561 | QString QQuickUniformAnimator::uniform() const | - | ||||||||||||
| 562 | { | - | ||||||||||||
| 563 | Q_D(const QQuickUniformAnimator); | - | ||||||||||||
| 564 | return d->uniform; never executed: return d->uniform; | 0 | ||||||||||||
| 565 | } | - | ||||||||||||
| 566 | - | |||||||||||||
| 567 | QString QQuickUniformAnimator::propertyName() const | - | ||||||||||||
| 568 | { | - | ||||||||||||
| 569 | Q_D(const QQuickUniformAnimator); | - | ||||||||||||
| 570 | if (!d->uniform.isEmpty())
| 4-6 | ||||||||||||
| 571 | return d->uniform; executed 4 times by 1 test: return d->uniform;Executed by:
| 4 | ||||||||||||
| 572 | return d->defaultProperty.name(); executed 6 times by 1 test: return d->defaultProperty.name();Executed by:
| 6 | ||||||||||||
| 573 | } | - | ||||||||||||
| 574 | - | |||||||||||||
| 575 | QQuickAnimatorJob *QQuickUniformAnimator::createJob() const | - | ||||||||||||
| 576 | { | - | ||||||||||||
| 577 | QString u = propertyName(); | - | ||||||||||||
| 578 | if (u.isEmpty())
| 0-4 | ||||||||||||
| 579 | return nullptr; never executed: return nullptr; | 0 | ||||||||||||
| 580 | - | |||||||||||||
| 581 | QQuickUniformAnimatorJob *job = new QQuickUniformAnimatorJob(); | - | ||||||||||||
| 582 | job->setUniform(u.toLatin1()); | - | ||||||||||||
| 583 | return job; executed 4 times by 1 test: return job;Executed by:
| 4 | ||||||||||||
| 584 | } | - | ||||||||||||
| 585 | #endif | - | ||||||||||||
| 586 | - | |||||||||||||
| 587 | QT_END_NAMESPACE | - | ||||||||||||
| 588 | - | |||||||||||||
| 589 | #include "moc_qquickanimator_p.cpp" | - | ||||||||||||
| Source code | Switch to Preprocessed file |