Пакет | spark.effects.animation |
Класс | public final class Animation |
Наследование | Animation Object |
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Этот класс определяет временные параметры и значения анимации. Другой код (в эффектах или в коде приложения) связывает анимацию с целевыми объектами и свойствами таким образом, что значения анимации, созданные классом Animation, впоследствии могут быть применены к целевым объектам и свойствам для фактического инициирования анимации этих объектов.
При определении эффектов анимации, как правило, создается экземпляр класса Animate или подкласса Animate. Экземпляр Animation создается в методе play()
. Экземпляр Animation принимает начальное и конечное значения, значение продолжительности и дополнительные параметры, например объекты замедления и интерполятора.
Объект Animation обеспечивает вызов прослушивателей сообщения в начале и конце анимации, при повторении анимации и через регулярные интервалы обновления в ходе анимации. В ходе этих вызовов выполняется передача значений, рассчитанных экземпляром Animation на основе начального и конечного значений и объектов замедления и интерполятора. Впоследствии данные значения можно использовать для установки значений свойств в целевых объектах.
Свойство MXML по умолчаниюmotionPaths
Связанные элементы API
Свойство | Определено | ||
---|---|---|---|
animationTarget : spark.effects.animation:IAnimationTarget
Объект IAnimationTarget, получающий информацию обо всех событиях начала, окончания, повторения и обновления для этой анимации. | Animation | ||
constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | ||
currentValue : Object
Object, содержащий рассчитанные значения с текущего кадра элемента Animation. | Animation | ||
cycleFraction : Number [только для чтения]
Текущая доля затраченного времени в анимации после применения замедления. | Animation | ||
cycleTime : Number [только для чтения]
Текущая позиция в миллисекундах в текущем цикле анимации. | Animation | ||
duration : Number = 500
Продолжительность анимации в миллисекундах без учета всех повторений, определенных свойством repeatCount. | Animation | ||
easer : IEaser
Реакция замедления для этого эффекта. | Animation | ||
interpolator : IInterpolator = null
Интерполятор, используемый экземпляром Animation для вычисления значений между начальным и конечным значениями свойства. | Animation | ||
isPlaying : Boolean [только для чтения]
Если значение равно true, анимация воспроизводится в настоящий момент. | Animation | ||
motionPaths : Vector.<MotionPath>
Набор объектов MotionPath, определяющих свойства и значения, которые будут анимированы с помощью Animation. | Animation | ||
playheadTime : Number
Общее затраченное время анимации, включая любую задержку начала и повторения. | Animation | ||
playReversed : Boolean
Если значение равно true, анимация воспроизводится в обратном направлении. | Animation | ||
repeatBehavior : String
Задает поведение повторяющейся анимации. | Animation | ||
repeatCount : int
Число повторений этой анимации. | Animation | ||
repeatDelay : Number
Время задержки в миллисекундах перед началом каждого цикла повторения. | Animation | ||
startDelay : Number
Время ожидания начала анимации. | Animation |
Метод | Определено | ||
---|---|---|---|
Animation(duration:Number = 500, property:String = null, startValue:Object = null, endValue:Object = null)
Конструктор. | Animation | ||
Прерывает анимацию, переходит непосредственно в конец анимации и запускает функцию animationEnd() на animationTarget. | Animation | ||
Показывает, определено ли заданное свойство для объекта. | Object | ||
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | ||
Приостанавливает эффект до вызова метода resume(). | Animation | ||
Запуск анимации. | Animation | ||
Показывает наличие заданного свойства и его перечисляемость. | Object | ||
Продолжает воспроизведение эффекта после установки паузы путем вызова метода pause(). | Animation | ||
Задает доступность динамического свойства для операций цикла. | Object | ||
Останавливает анимацию, заканчивая ее без вызова метода end(). | Animation | ||
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | ||
Возвращает строковое представление заданного объекта. | Object | ||
Возвращает элементарное значение заданного объекта. | Object |
animationTarget | свойство |
animationTarget:spark.effects.animation:IAnimationTarget
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Объект IAnimationTarget, получающий информацию обо всех событиях начала, окончания, повторения и обновления для этой анимации. Значение null
указывает на отсутствие целевого адреса для уведомления.
Значением по умолчанию является null.
Реализация
public function get animationTarget():spark.effects.animation:IAnimationTarget
public function set animationTarget(value:spark.effects.animation:IAnimationTarget):void
currentValue | свойство |
public var currentValue:Object
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Object, содержащий рассчитанные значения с текущего кадра элемента Animation. Значения хранятся в виде значений карты с использованием имен свойств в качестве ключа.
cycleFraction | свойство |
cycleFraction:Number
[только для чтения] Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Текущая доля затраченного времени в анимации после применения замедления. Это значение от 0 до 1. Анимационный «цикл» определен как однократное повторение анимации, где свойство repeatCount
определяет количество циклов, которые будут воспроизведены.
Реализация
public function get cycleFraction():Number
cycleTime | свойство |
cycleTime:Number
[только для чтения] Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Текущая позиция в миллисекундах в текущем цикле анимации. Это значение лежит в диапазоне между 0 и duration
. Анимационный «цикл» определен как однократное повторение анимации, где свойство repeatCount
определяет количество циклов, которые будут воспроизведены. Для изменения позиции анимации используйте метод seek()
.
Реализация
public function get cycleTime():Number
duration | свойство |
public var duration:Number = 500
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Продолжительность анимации в миллисекундах без учета всех повторений, определенных свойством repeatCount
.
Значением по умолчанию является 500.
easer | свойство |
easer:IEaser
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Реакция замедления для этого эффекта. Этот объект IEaser используется для преобразования доли времени, потребовавшегося на анимацию, в долю времени, затраченного на замедление, которая затем используется для расчета значений по этой доле затраченного на замедление времени.
Значение null
указывает то, что замедление не используется, что эквивалентно применению линейного замедления или animation.easer = Linear.getInstance();
.
Значением по умолчанию является Sine(.5).
Реализация
public function get easer():IEaser
public function set easer(value:IEaser):void
interpolator | свойство |
public var interpolator:IInterpolator = null
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Интерполятор, используемый экземпляром Animation для вычисления значений между начальным и конечным значениями свойства. По умолчанию класс использует класс NumberInterpolator или, в случае если начальные и конечные значения являются массивами или векторами, класс MultiValueInterpolator. Интерполяция других типов данных или таких чисел, которые должны быть интерполированы по-другому, например значения uint
, содержащие информацию о цветовых каналах, могут быть обработаны при помощи другого интерполятора.
Связанные элементы API
isPlaying | свойство |
isPlaying:Boolean
[только для чтения] Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Если значение равно true
, анимация воспроизводится в настоящий момент. Значение false
присваивается, если анимация была воспроизведена без остановки (программным способом или автоматически) или приостановлена.
Значением по умолчанию является false.
Реализация
public function get isPlaying():Boolean
motionPaths | свойство |
public var motionPaths:Vector.<MotionPath>
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Набор объектов MotionPath, определяющих свойства и значения, которые будут анимированы с помощью Animation.
Связанные элементы API
playheadTime | свойство |
playheadTime:Number
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Общее затраченное время анимации, включая любую задержку начала и повторения. Для анимации с воспроизводимым первым циклом это значение будет равно значению параметра cycleTime
.
Реализация
public function get playheadTime():Number
public function set playheadTime(value:Number):void
playReversed | свойство |
playReversed:Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Если значение равно true
, анимация воспроизводится в обратном направлении. Если в настоящее время анимация воспроизводится в обратном направлении к указанному значению playReversed
, то анимация изменит направление динамически.
Значением по умолчанию является false.
Реализация
public function get playReversed():Boolean
public function set playReversed(value:Boolean):void
repeatBehavior | свойство |
repeatBehavior:String
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Задает поведение повторяющейся анимации. Свойство repeatCount
повторяющейся анимации имеет значение 0 или целочисленное значение больше 1. Этим значением может являться либо RepeatBehavior.LOOP
, что означает повторение анимации в одном и том же порядке при каждом вызове, либо RepeatBehavior.REVERSE
, что означает смену направления анимации для каждой итерации.
Значением по умолчанию является RepeatBehavior.LOOP.
Реализация
public function get repeatBehavior():String
public function set repeatBehavior(value:String):void
Связанные элементы API
repeatCount | свойство |
repeatCount:int
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Число повторений этой анимации. Значение 0 указывает на бесконечное количество повторений.
Значением по умолчанию является 1.
Реализация
public function get repeatCount():int
public function set repeatCount(value:int):void
repeatDelay | свойство |
repeatDelay:Number
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Время задержки в миллисекундах перед началом каждого цикла повторения. Установка в качестве данного значения числа, отличного от 0, обеспечивает завершение предыдущего цикла анимации точно на его конечном значении. Однако во время плавного перехода анимации от ожидания завершения одного цикла к началу следующего цикла это значение может быть пропущено повторениями без заданного параметра задержки. Это свойство должно иметь значение >= 0.
Эти свойство используется для первого повторения после первого цикла анимации. Для задержки первого цикла анимации применяется свойство startDelay
.
Значением по умолчанию является 0.
Реализация
public function get repeatDelay():Number
public function set repeatDelay(value:Number):void
Связанные элементы API
startDelay | свойство |
startDelay:Number
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Время ожидания начала анимации. Это свойство должно иметь значение >= 0.
Значением по умолчанию является 0.
Реализация
public function get startDelay():Number
public function set startDelay(value:Number):void
Animation | () | Конструктор |
public function Animation(duration:Number = 500, property:String = null, startValue:Object = null, endValue:Object = null)
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Конструктор. Необязательные параметры property
, startValue
и endValue
определяют простую анимацию с одним объектом MotionPath и двумя ключевыми кадрами. Если одно из значений не равно null, startValue
становится value
первого ключевого кадра в точке time=0 и endValue
становится value
второго ключевого кадра в конце анимации.
duration:Number (default = 500 ) — Продолжительность анимации в миллисекундах.
| |
property:String (default = null ) — Анимируемые свойства.
| |
startValue:Object (default = null ) — Начальное значение свойства.
| |
endValue:Object (default = null ) — Конечное значение свойства.
|
end | () | метод |
public function end():void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Прерывает анимацию, переходит непосредственно в конец анимации и запускает функцию animationEnd() на animationTarget
.
pause | () | метод |
public function pause():void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Приостанавливает эффект до вызова метода resume()
. Если метод stop()
вызывается перед методом resume()
, продолжение анимации будет невозможно.
play | () | метод |
public function play():void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Запуск анимации. Если анимация уже воспроизводится, то она будет остановлена, а затем вновь воспроизведена.
resume | () | метод |
public function resume():void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Продолжает воспроизведение эффекта после установки паузы путем вызова метода pause()
.
stop | () | метод |
public function stop():void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 4 |
Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Останавливает анимацию, заканчивая ее без вызова метода end()
. Будет вызвана функция animationStop() на animationTarget
.
Tue Jun 12 2018, 11:34 AM Z