| Пакет | mx.effects |
| Класс | public class Tween |
| Наследование | Tween  EventDispatcher Object |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
 | Начиная с Flex 4.0, Adobe рекомендует вместо этого класса использовать класс spark.effects.animation.Animation. Tween представляет собой базовый класс анимации для эффектов в Flex 3. В Flex 4 для эффектов Spark используется класс spark.effects.animation.Animation, предоставляющий аналогичные функциональные возможности. |
Класс Tween определяет анимацию свойства, выполняемую для целевого объекта в течение некоторого интервала времени. К анимации относятся изменение позиции, например выполняемое с помощью эффекта Move; изменение размеров, выполняемое с помощью эффектов Resize или Zoom; изменение видимости, выполняемое с помощью эффектов Fade или Dissolve; и другие типы анимации.
При определении эффектов анимации, как правило, создается экземпляр класса Tween с переопределением метода EffectInstance.play(). Для определения анимации экземпляр Tween принимает свойства startValue, endValue и duration, а также дополнительную функцию замедления.
Объект Tween запускает функцию обратного вызова mx.effects.effectClasses.TweenEffectInstance.onTweenUpdate() в рамках стандартного интервала для экземпляра эффекта во время воспроизведения эффекта и передает методу onTweenUpdate() интерполированное значение в интервале между startValue и endValue. Как правило, функция обратного вызова обновляет некоторые свойства целевого объекта, что приводит к анимации объекта во время всего воспроизведения эффекта.
По завершении эффекта объект Tween запускает функцию обратного вызова mx.effects.effectClasses.TweenEffectInstance.onTweenEnd(), если она определена.
Связанные элементы API
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства| Свойство | Определено | ||
|---|---|---|---|
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| duration : Number = 3000
Продолжительность анимации в миллисекундах. | Tween | ||
| easingFunction : Function [только для записи]
Устанавливает функцию замедления для анимации. | Tween | ||
| listener : Object
Объект, получающий уведомление в каждом интервале анимации. | Tween | ||
| Метод | Определено | ||
|---|---|---|---|
Tween(listener:Object, startValue:Object, endValue:Object, duration:Number = -1, minFps:Number = -1, updateFunction:Function = null, endFunction:Function = null)
Конструктор. | Tween | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | |
|
Посылает событие в поток событий. | EventDispatcher | |
Прерывают анимацию, переходят непосредственно в конец анимации и запускают функцию обратного вызова onTweenEnd(). | Tween | ||
|
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
Приостанавливает эффект до вызова метода resume(). | Tween | ||
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | |
Продолжает воспроизведение эффекта после установки паузы путем вызова метода pause(). | Tween | ||
Воспроизводит эффект в обратном порядке, начиная с текущей позиции эффекта. | Tween | ||
Расширяет эффект анимации вплоть до указанной позиции. | Tween | ||
|
Задает доступность динамического свойства для операций цикла. | Object | |
По умолчанию класс Tween запускает функцию обратного вызова mx.effects.effectClasses.TweenEffectInstance.onTweenUpdate() в рамках стандартного интервала для экземпляра эффекта во время воспроизведения эффекта и дополнительную функцию обратного вызова mx.effects.effectClasses.TweenEffectInstance.onTweenEnd() в конце воспроизведения эффекта. | Tween | ||
Останавливает анимацию, заканчивает ее без отправки события или вызова функции анимации endFunction или onTweenEnd(). | Tween | ||
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
duration | свойство |
public var duration:Number = 3000| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Продолжительность анимации в миллисекундах.
easingFunction | свойство |
easingFunction:Function [только для записи] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Устанавливает функцию замедления для анимации. Функция замедления используется для интерполяции в диапазоне между значениями startValue и endValue. Стандартная функция замедления выполняет линейную интерполяцию, а более сложные функции замедления создают иллюзию ускорения и замедления, придающую анимации естественность.
Если функция замедления не указана, используется функция на основе метода Math.sin().
Функция замедления сопровождается подписью функции, популяризируемой Робертом Пеннером. Функция принимает четыре аргумента. Первый аргумент – «текущее время», где начальное время анимации равно 0. Второй аргумент – начальное значение в начале анимации (число). Третий аргумент – конечное значение минус начальное значение. Четвертый аргумент – продолжительность анимации. Возвращаемое значение – интерполированное значение для текущего времени (как правило, это значение между начальным и конечным значениями).
Flex включает ряд функций замедления, входящих в пакет в mx.effects.easing.
Реализация
public function set easingFunction(value:Function):voidlistener | свойство |
public var listener:Object| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Объект, получающий уведомление в каждом интервале анимации.
Tween | () | Конструктор |
public function Tween(listener:Object, startValue:Object, endValue:Object, duration:Number = -1, minFps:Number = -1, updateFunction:Function = null, endFunction:Function = null)| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Конструктор.
При вызове конструктора анимация воспроизводится автоматически.
Параметрыlistener:Object — Объект, получающий уведомление в каждом интервале анимации. Как правило, в качестве значения передается ключевое слово this. Listener должен определить метод onTweenUpdate() и, при необходимости, метод onTweenEnd(). Первый из двух методов вызывается для каждого интервала анимации, второй метод вызывается только после завершения анимации.
| |
startValue:Object — Начальные значения анимации. Число или массив чисел. Если передается число, Tween интерполирует значение в диапазоне между этим числом и числом, переданным параметром endValue. Если передается массив чисел, интерполируется каждое число в массиве.
| |
endValue:Object — Последние значения анимации. Тип этого аргумента должен соответствовать параметру startValue.
| |
duration:Number (default = -1) | |
minFps:Number (default = -1)onTweenUpdate() в секунду. Код Tween выполняет попытки вызова метода onTweenUpdate() настолько часто, насколько это возможно (до 100 раз в секунду). Однако если частота не превосходит minFps, продолжительность анимации автоматически увеличивается. В результате предварительно «замороженная» анимация (не получающая циклов ЦП) не осуществляет немедленный переход вперед, а возобновляется с момента останова.
| |
updateFunction:Function (default = null)listener.OnTweenUpdate()
| |
endFunction:Function (default = null)listener.OnTweenEnd()
|
endTween | () | метод |
public function endTween():void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Прерывают анимацию, переходят непосредственно в конец анимации и запускают функцию обратного вызова onTweenEnd().
pause | () | метод |
public function pause():void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Приостанавливает эффект до вызова метода resume().
resume | () | метод |
public function resume():void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Продолжает воспроизведение эффекта после установки паузы путем вызова метода pause().
reverse | () | метод |
public function reverse():void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Воспроизводит эффект в обратном порядке, начиная с текущей позиции эффекта.
seek | () | метод |
setTweenHandlers | () | метод |
public function setTweenHandlers(updateFunction:Function, endFunction:Function):void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
По умолчанию класс Tween запускает функцию обратного вызова mx.effects.effectClasses.TweenEffectInstance.onTweenUpdate() в рамках стандартного интервала для экземпляра эффекта во время воспроизведения эффекта и дополнительную функцию обратного вызова mx.effects.effectClasses.TweenEffectInstance.onTweenEnd() в конце воспроизведения эффекта.
Этот метод позволяет указывать другие методы в качестве функций обратного вызова для обновления и завершения.
Параметры
updateFunction:Function — Указывает функцию обратного вызова для обновления.
| |
endFunction:Function — Указывает функцию обратного вызова для завершения.
|
stop | () | метод |
public function stop():void| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Останавливает анимацию, заканчивает ее без отправки события или вызова функции анимации endFunction или onTweenEnd().
Tue Jun 12 2018, 11:34 AM Z