Пакет | 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):void
listener | свойство |
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