Справочник по ActionScript® 3.0 для платформы Adobe® Flash®
Домашняя страница  |  Скрыть список пакетов и классов |  Пакеты  |  Классы  |  Что нового  |  Указатель  |  Приложения  |  Почему по-английски?
Фильтры: Получение данных с сервера...
Получение данных с сервера...
spark.effects.animation 

Animation  - AS3 Flex

Пакетspark.effects.animation
Классpublic final class Animation
НаследованиеAnimation Inheritance Object

Язык версии: ActionScript 3.0
Версия продукта: Flex 4
Версии среды выполнения: Flash Player 10, AIR 1.5

Класс Animation определяет анимацию, осуществляемую между начальным и конечным значениями свойства в указанный период времени. К анимации относятся изменение позиции, выполняемое с помощью эффекта Move, изменение размеров, выполняемое с помощью эффекта Resize, изменение видимости, выполняемое с помощью эффекта Fade, а также другие виды анимации, используемые эффектами или выполняемые непосредственно с классом Animation.

Этот класс определяет временные параметры и значения анимации. Другой код (в эффектах или в коде приложения) связывает анимацию с целевыми объектами и свойствами таким образом, что значения анимации, созданные классом Animation, впоследствии могут быть применены к целевым объектам и свойствам для фактического инициирования анимации этих объектов.

При определении эффектов анимации, как правило, создается экземпляр класса Animate или подкласса Animate. Экземпляр Animation создается в методе play(). Экземпляр Animation принимает начальное и конечное значения, значение продолжительности и дополнительные параметры, например объекты замедления и интерполятора.

Объект Animation обеспечивает вызов прослушивателей сообщения в начале и конце анимации, при повторении анимации и через регулярные интервалы обновления в ходе анимации. В ходе этих вызовов выполняется передача значений, рассчитанных экземпляром Animation на основе начального и конечного значений и объектов замедления и интерполятора. Впоследствии данные значения можно использовать для установки значений свойств в целевых объектах.

Свойство MXML по умолчаниюmotionPaths

Связанные элементы API



Общедоступные свойства
 СвойствоОпределено
  animationTarget : spark.effects.animation:IAnimationTarget
Объект IAnimationTarget, получающий информацию обо всех событиях начала, окончания, повторения и обновления для этой анимации.
Animation
 Inheritedconstructor : 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
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
  
Приостанавливает эффект до вызова метода resume().
Animation
  
Запуск анимации.
Animation
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
  
Продолжает воспроизведение эффекта после установки паузы путем вызова метода pause().
Animation
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
  
Останавливает анимацию, заканчивая ее без вызова метода end().
Animation
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Возвращает элементарное значение заданного объекта.
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.





[ X ]Почему по-английски?
Содержимое Справочника ActionScript 3.0 отображается на английском языке

Не все части Справочника ActionScript 3.0 переводятся на все языки. Если какой-то текстовый элемент не переведен, он отображается на английском языке. Например, компонент ga.controls.HelpBox не переведен ни на один из языков. Это значит, что в русской версии справки компонент ga.controls.HelpBox будет отображаться на английском языке.