Animator QML Type

Is the base of all QML animators. More...

• List of all members, including inherited members

Properties

• duration : int
• easing
  • easing.amplitude : real
  • easing.bezierCurve : list<real>
  • easing.overshoot : real
  • easing.period : real
  • easing.type : enumeration
• from : real
• target : QtQuick::Item
• to : real

Detailed Description

Animator types are a special type of animation which operate directly on Qt Quick's scene graph, rather than the QML objects and their properties like regular Animation types do. This has the benefit that Animator based animations can animate on the scene graph's rendering thread even when the UI thread is blocked.

The value of the QML property will be updated after the animation has finished. The property is not updated while the animation is running.

The Animator types can be used just like any other Animation type.

 Rectangle {
     id: mixBox
     width: 50
     height: 50
     ParallelAnimation {
         ColorAnimation {
             target: mixBox
             property: "color"
             from: "forestgreen"
             to: "lightsteelblue";
             duration: 1000
         }
         ScaleAnimator {
             target: mixBox
             from: 2
             to: 1
             duration: 1000
         }
         running: true
     }
 }

If all sub-animations of ParallelAnimation and SequentialAnimation are Animator types, the ParallelAnimation and SequentialAnimation will also be treated as an Animator and be run on the scene graph's rendering thread when possible.

The Animator types can be used for animations during transitions, but they do not support the reversible property.

The Animator type cannot be used directly in a QML file. It exists to provide a set of common properties and methods, available across all the other animator types that inherit from it. Attempting to use the Animator type directly will result in an error.

Property Documentation

duration : int

This property holds the duration of the animation in milliseconds.

The default value is 250.

easing group

from : real

This property holds the starting value for the animation.

If the Animator is defined within a Transition or Behavior, this value defaults to the value defined in the starting state of the Transition, or the current value of the property at the moment the Behavior is triggered.

See also Animation and Transitions in Qt Quick.

target : QtQuick::Item

This property holds the target item of the animator.

to : real

This property holds the end value for the animation.

If the Animator is defined within a Transition or Behavior, this value defaults to the value defined in the end state of the Transition, or the value of the property change that triggered the Behavior.