| Пакет | 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):voidcurrentValue | свойство |
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():NumbercycleTime | свойство |
cycleTime:Number [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4 |
| Версии среды выполнения: | Flash Player 10, AIR 1.5 |
Текущая позиция в миллисекундах в текущем цикле анимации. Это значение лежит в диапазоне между 0 и duration. Анимационный «цикл» определен как однократное повторение анимации, где свойство repeatCount определяет количество циклов, которые будут воспроизведены. Для изменения позиции анимации используйте метод seek().
Реализация
public function get cycleTime():Numberduration | свойство |
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):voidinterpolator | свойство |
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():BooleanmotionPaths | свойство |
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):voidplayReversed | свойство |
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):voidrepeatBehavior | свойство |
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):voidrepeatDelay | свойство |
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):voidAnimation | () | Конструктор |
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