spark.effects.animationKeyframe Класс Keyframe определяет значение свойства в определенное время в течение выполнения эффекта.The <s:Keyframe> tag inherits the tag attributes of its superclass, and adds the following tag attributes:

  <s:Keyframe 
    id="ID"
    easier="Linear"
    time="val"
    value="val"
    valueBy="val"
  />

]]>Object Класс Keyframe определяет значение свойства в определенное время в течение выполнения эффекта. Например, можно создать три ключевых кадра, которые определяют значение свойства в начале, в середине и в конце эффекта. Данный эффект анимирует изменение свойства целевого объекта от одного ключевого кадра к другому во время выполнения эффекта.

Совокупность ключевых кадров эффекта называется путем движения эффекта. Путь движения может определять любое количество ключевых кадров. Эффект вычисляет значение свойства путем интерполяции между значениями, указанными двумя ключевыми кадрами.

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

MotionPath

Keyframe Конструктор.timeunknownВремя (в миллисекундах), когда целевой объект эффекта данного ключевого кадра должен принять значение, указанное параметром value. valuenullЗначение, которое целевой объект эффекта должен иметь при данном значении time. valueBynullДополнительный параметр, который в случае его предоставления вызывает динамическое вычисление значения value посредством добавления значенияvalueBy к значению value предыдущего ключевого кадра в наборе ключевых кадров в объекте MotionPath. Это значение игнорируется, если данный ключевой кадр является первым в последовательности. Конструктор. clone Возвращает копию данного объекта ключевого кадра.Копия данного объекта ключевого кадра. spark.effects.animation:Keyframe Возвращает копию данного объекта ключевого кадра. easer К движению применено поведение замедления между предыдущим объектом ключевого кадра в пути движения и данным объектом ключевого кадра.unknownspark.effects.easing:IEaserLinear К движению применено поведение замедления между предыдущим объектом ключевого кадра в пути движения и данным объектом ключевого кадра. По умолчанию замедление линейно или вообще отсутствует.

Следует отметить, что вышестоящий эффект уже, возможно, имеет примененное ко всей анимации замедление. Поэтому если взамен необходима анимация по интервалам ключевого кадра, то, возможно, потребуется установить линейный общий эффект замедления (spark.effects.easing.Linear), а затем по мере необходимости установить easer в каждом соответствующем ключевом кадре.

Поскольку это свойство оказывает влияние на интервал в последовательности между предыдущим и данным объектами ключевого кадра, то свойство easer игнорируется для первого в последовательности объекта ключевого кадра.

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

Схожим образом, если не определено значение value в данном ключевом кадре, но значения valueBy в данном и value в предыдущем ключевых кадрах установлены, то значение value в данном ключевом кадре вычисляется как value в предыдущем кадре плюс valueBy в данном ключевом кадре.

Значение valueBy игнорируется для первого ключевого кадра в последовательности, так как оно применимо только к интервалу, предшествующему ключевому кадру, которого не существует для первого ключевого кадра.

value Значение, которое свойство целевого объекта эффекта должно принимать в момент времени, определенный свойством time. Значение, которое свойство целевого объекта эффекта должно принимать в момент времени, определенный свойствомtime. IAnimationTarget Интерфейс IAnimationTarget реализуется классами, поддерживающими события экземпляра Animation. Интерфейс IAnimationTarget реализуется классами, поддерживающими события экземпляра Animation.

spark.effects.animation.Animation

animationEnd Вызывается при завершении экземпляра Animation.animationspark.effects.animation:AnimationОбъект Animation. Вызывается при завершении экземпляра Animation. animationRepeat Вызывается при повторении экземпляра Animation.animationspark.effects.animation:AnimationОбъект Animation. Вызывается при повторении экземпляра Animation. Свойство repeatCount экземпляра Animation должно быть равно 0 (бесконечное число повторений) или иметь значение больше 1. animationStart Вызывается при запуске экземпляра Animation.animationspark.effects.animation:AnimationОбъект Animation. Вызывается при запуске экземпляра Animation. Если для элемента Animation задано свойство startDelay, данная функция вызывается по истечении указанного времени задержки. animationStop Вызывается при остановке экземпляра Animation.animationspark.effects.animation:AnimationОбъект Animation. Вызывается при остановке экземпляра Animation. Это отличается от метода animationEnd, вызываемого при окончании анимации, автоматически устанавливая конечные значения целевых объектов. Метод animationStop() вызывается при остановке анимации в позиции, в которой она находится. Обработка этого события позволяет выполнить необходимую очистку при прерывании анимации. animationUpdate Вызывается в ходе каждого обновления экземпляра Animation.animationspark.effects.animation:AnimationОбъект Animation. Вызывается в ходе каждого обновления экземпляра Animation. Если класс реализации обеспечивает прослушивание элемента Animation для получения возможности выполнения каких-либо операций после вычисления значений Animation для заданного периода времени, указанные значения должны быть использованы именно в этой функции. Другие методы в этом интерфейсе являются более информационными. Они сообщат прослушивателям о начале, остановке или повторе анимации. Этот метод вызывается после вычисления значений, когда с ними могут быть произведены какие-либо операции. MotionPath Класс MotionPath определяет совокупность объектов ключевых кадров эффекта и имя свойства целевого объекта для анимации.The <s:MotionPath> tag inherits the tag attributes of its superclass, and adds the following tag attributes:

  <s:MotionPath 
    id="ID"
    interpolator="NumberInterpolator"
    keyframes="val"
    property="val"
  />

]]>Object Класс MotionPath определяет совокупность объектов ключевых кадров эффекта и имя свойства целевого объекта для анимации. Каждый объект ключевого кадра определяет значение свойства в определенный момент времени в процессе выполнения эффекта. Эффект вычисляет значение свойства target путем интерполяции между значениями, указанными двумя ключевыми кадрами.

Ключевой кадрspark.effects.interpolation.NumberInterpolator

MotionPath Конструктор.propertynullИмя свойства целевого объекта, которое используется для анимации. Конструктор. clone Возвращает копию данного объекта MotionPath, включая копии каждого ключевого кадра.Копия данного объекта MotionPath, включая копии каждого ключевого кадра. spark.effects.animation:MotionPath Возвращает копию данного объекта MotionPath, включая копии каждого ключевого кадра. getValue При задании истекшей доли времени вычисляет и возвращает интерполированное значение.Интерполированное значение. fractionДоля полной продолжительности эффекта (значение от 0,0 до 1,0). При задании истекшей доли времени вычисляет и возвращает интерполированное значение. Функция определяет интервал ключевого кадра, в который попадает эта доля, и выполняет интерполяцию в пределах этого интервала между значениями граничных ключевых кадров данного интервала. interpolator Интерполятор определяет способ вычисления промежуточных значений в процессе анимации.unknownspark.effects.interpolation:IInterpolator Интерполятор определяет способ вычисления промежуточных значений в процессе анимации. По умолчанию, класс MotionPath предполагает наличие значений типа Number и может автоматически вычислять промежуточные числовые значения. Если для класса MotionPath заданы ключевые кадры с нечисловыми значениями или если для требуемого поведения необходимо использовать иной способ интерполяции (например, интерполяция цвета по каналам), то потребуется предоставить какой-либо интерполятор.

Flex поддерживает предопределенные интерполяторы в пакете spark.effects.interpolation.

keyframes Последовательность объектов ключевых кадров, представляющих собой пары «время/значение», которые свойство принимает в процессе анимации. Последовательность объектов ключевых кадров, представляющих собой пары «время/значение», которые свойство принимает в процессе анимации. Каждая последовательная пара ключевых кадров управляет анимацией в течение промежутка времени между ними. Дополнительные свойства easer и valueBy последнего ключевого кадра используются для определения поведения в течение этого интервала. Последовательность ключевых кадров должна быть отсортирована в порядке увеличения значений времени.

Анимация всегда начинается на значении time=0 и продолжается в течение времени, равного значению time последнего ключевого кадра. Если ключевой кадр для значения time=0 не определен, то он является неявным и анимация начинается с использованием значения свойства target.

Поскольку ключевые кадры явно задают времена, задействованные в процессе анимации, продолжительность какого-либо эффекта, использующего ключевые кадры, устанавливается в соответствии с максимальным временем последнего ключевого кадра из всех MotionPaths данного эффекта. Например, если для эффекта заданы ключевые кадры со значениями времени, равными 0, 500, 1000 и 2000, то эффективная продолжительность этого эффекта будет 2000 мс, независимо от того, какое значение установлено для свойства данного эффекта duration. Поскольку последний ключевой кадр определяет продолжительность, то он должен присутствовать в любом MotionPath. Таким образом, продолжительность MotionPath задается неявно значением времени последнего ключевого кадра.

Значение value любого ключевого кадра может остаться неопределенным (незаданным, либо со значением null, либо со значением NaN). В этом случае, значение value определяется динамически при запуске анимации. Любое неопределенное значение определяется следующим образом.

В случае если это первый ключевой кадр, то значение вычисляется из следующего ключевого кадра, если таковой имеет заданные значения value и valueBy; при этом вычисляемое значение будет разницей значений value и valueBy. В противном случае ему присваивается текущее значение свойства целевого объекта.
В случае если это последний ключевой кадр и анимация выполняется в процессе перехода, то используется значение состояния представления целевого объекта перехода.
В противном случае, значение value любого ключевого кадра вычисляется путем добавления значения value предыдущего ключевого кадра к значению valueBy текущего, если значение valueBy задано.

Ключевой кадр

property Имя свойства целевого объекта эффекта, подлежащего анимации. Имя свойства целевого объекта эффекта, подлежащего анимации. RepeatBehavior Класс RepeatBehavior определяет константы для использования вместе со свойством repeatBehavior классов Animate и Animation.Object Класс RepeatBehavior определяет константы для использования вместе со свойством repeatBehavior классов Animate и Animation.

spark.effects.Animate.repeatBehaviorAnimation.repeatBehavior

LOOP Указывает на то, что повторяемая анимация должна воспроизводиться в прямом направлении в каждой итерации.loop Указывает на то, что повторяемая анимация должна воспроизводиться в прямом направлении в каждой итерации. REVERSE Указывает на то, что повторяемая анимация должна воспроизводиться в обратном направлении в каждой итерации.reverse Указывает на то, что повторяемая анимация должна воспроизводиться в обратном направлении в каждой итерации. Например, реверсированная анимация будет воспроизведена в прямом направлении на четных итерациях и в обратном направлении на нечетных. SimpleMotionPath Класс SimpleMotionPath определяет имя свойства и значения, которые это свойство принимает во времени для экземпляров эффекта Animate.spark.effects.animation:MotionPath Класс SimpleMotionPath определяет имя свойства и значения, которые это свойство принимает во времени для экземпляров эффекта Animate.

Этот класс, являющийся простым подклассом MotionPath, служит для определения двух ключевых кадров, содержащих свойства valueFrom, valueTo и valueBy. Сам по себе класс MotionPath может определять любое количество ключевых кадров.

MotionPath

SimpleMotionPath Конструктор.propertynullИмя свойства, подлежащего анимации. valueFromnullНачальное значение свойства. valueTonullКонечное значение свойства. valueBynullДополнительный параметр, указывающий значение дельты, используемое для вычисления значений «с» либо «до», если одно из них опущено. Конструктор. Можно указать оба параметра valueFrom и valueTo, либо параметр valueBy, и или параметрvalueFrom или valueTo. Если эти параметры опущены, Flex вычисляет их исходя из целевого объекта эффекта. valueBy Необязательное свойство, указывающее значение дельта, используемое для вычисления значений valueFrom или valueTo. Необязательное свойство, указывающее значение дельта, используемое для вычисления значений valueFrom или valueTo. Предоставление этого необязательного свойства позволяет эффекту вычислять необходимое значения «до» или «после», если они не предоставлены или должны быть определены динамически в начале анимации.

Использование значения valueBy зависит от того, какие другие значения установлены. Если ни одно из них не установлено, то значение valueFrom определяется из текущего значения свойства в целевом объекте, а свойство valueTo приравнивается valueFrom + valueBy. Если установлено только одно значение, то неустановленное значение вычисляется с помощью другого значения: valueTo = valueFrom + valueBy или valueFrom = valueTo - valueBy). Если установлены оба значения, то свойство valueBy игнорируется.

Следует отметить, что valueBy относится к типу объект, и эффект не может непосредственно вычислить другие значения из него. Свойство использует интерполятор эффекта для вычисления значений, вызывая методы интерполятора increment() и decrement(). Если интерполятор не установлен, то по умолчанию используется NumberInterpolator.

valueFrom Начальное значение свойства в процессе анимации. Начальное значение свойства в процессе анимации.

Значение Null или NaN (для чисел) указывает на то, что значение должно быть определено динамически в процессе выполнения либо путем прямого извлечения значения из свойства target, либо путем его вычисления, если другое значение допустимо и предоставлено допустимое значение valueBy.

valueTo Целевое значение анимации именованного свойства. Целевое значение анимации именованного свойства.

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

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

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

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

spark.effects.Animatespark.effects.supportClasses.AnimateInstance

Animation Конструктор.duration500Продолжительность анимации в миллисекундах. propertynullАнимируемые свойства. startValuenullНачальное значение свойства. endValuenullКонечное значение свойства. Конструктор. Необязательные параметры property, startValue и endValue определяют простую анимацию с одним объектом MotionPath и двумя ключевыми кадрами. Если одно из значений не равно null, startValue становится value первого ключевого кадра в точке time=0 и endValue становится value второго ключевого кадра в конце анимации. end Прерывает анимацию, переходит непосредственно в конец анимации и запускает функцию animationEnd() на animationTarget. Прерывает анимацию, переходит непосредственно в конец анимации и запускает функцию animationEnd() на animationTarget. pause Приостанавливает эффект до вызова метода resume(). Приостанавливает эффект до вызова метода resume(). Если метод stop() вызывается перед методом resume(), продолжение анимации будет невозможно. play Запуск анимации. Запуск анимации. Если анимация уже воспроизводится, то она будет остановлена, а затем вновь воспроизведена. resume Продолжает воспроизведение эффекта после установки паузы путем вызова метода pause(). Продолжает воспроизведение эффекта после установки паузы путем вызова метода pause(). stop Останавливает анимацию, заканчивая ее без вызова метода end(). Останавливает анимацию, заканчивая ее без вызова метода end(). Будет вызвана функция animationStop() на animationTarget. currentValue Object, содержащий рассчитанные значения с текущего кадра элемента Animation. Object, содержащий рассчитанные значения с текущего кадра элемента Animation. Значения хранятся в виде значений карты с использованием имен свойств в качестве ключа. duration Продолжительность анимации в миллисекундах без учета всех повторений, определенных свойством repeatCount.500500 Продолжительность анимации в миллисекундах без учета всех повторений, определенных свойством repeatCount. interpolator Интерполятор, используемый экземпляром Animation для вычисления значений между начальным и конечным значениями свойства.nullspark.effects.interpolation:IInterpolator Интерполятор, используемый экземпляром Animation для вычисления значений между начальным и конечным значениями свойства. По умолчанию класс использует класс NumberInterpolator или, в случае если начальные и конечные значения являются массивами или векторами, класс MultiValueInterpolator. Интерполяция других типов данных или таких чисел, которые должны быть интерполированы по-другому, например значения uint, содержащие информацию о цветовых каналах, могут быть обработаны при помощи другого интерполятора.

spark.effects.interpolation.NumberInterpolatorspark.effects.interpolation.MultiValueInterpolator

motionPaths Набор объектов MotionPath, определяющих свойства и значения, которые будут анимированы с помощью Animation. Набор объектов MotionPath, определяющих свойства и значения, которые будут анимированы с помощью Animation.

spark.effects.animation.MotionPath

animationTarget Объект IAnimationTarget, получающий информацию обо всех событиях начала, окончания, повторения и обновления для этой анимации.spark.effects.animation:IAnimationTargetnull Объект IAnimationTarget, получающий информацию обо всех событиях начала, окончания, повторения и обновления для этой анимации. Значение null указывает на отсутствие целевого адреса для уведомления. cycleFraction Текущая доля затраченного времени в анимации после применения замедления. Текущая доля затраченного времени в анимации после применения замедления. Это значение от 0 до 1. Анимационный «цикл» определен как однократное повторение анимации, где свойство repeatCount определяет количество циклов, которые будут воспроизведены. cycleTime Текущая позиция в миллисекундах в текущем цикле анимации. Текущая позиция в миллисекундах в текущем цикле анимации. Это значение лежит в диапазоне между 0 и duration. Анимационный «цикл» определен как однократное повторение анимации, где свойство repeatCount определяет количество циклов, которые будут воспроизведены. Для изменения позиции анимации используйте метод seek(). easer Реакция замедления для этого эффекта.spark.effects.easing:IEaserSine(.5) Реакция замедления для этого эффекта. Этот объект IEaser используется для преобразования доли времени, потребовавшегося на анимацию, в долю времени, затраченного на замедление, которая затем используется для расчета значений по этой доле затраченного на замедление времени.

Значение null указывает то, что замедление не используется, что эквивалентно применению линейного замедления или animation.easer = Linear.getInstance();.

isPlaying Если значение равно true, анимация воспроизводится в настоящий момент.false Если значение равно true, анимация воспроизводится в настоящий момент. Значение false присваивается, если анимация была воспроизведена без остановки (программным способом или автоматически) или приостановлена. playReversed Если значение равно true, анимация воспроизводится в обратном направлении.false Если значение равно true, анимация воспроизводится в обратном направлении. Если в настоящее время анимация воспроизводится в обратном направлении к указанному значению playReversed, то анимация изменит направление динамически. playheadTime Общее затраченное время анимации, включая любую задержку начала и повторения. Общее затраченное время анимации, включая любую задержку начала и повторения. Для анимации с воспроизводимым первым циклом это значение будет равно значению параметра cycleTime. repeatBehavior Задает поведение повторяющейся анимации.RepeatBehavior.LOOP Задает поведение повторяющейся анимации. Свойство repeatCount повторяющейся анимации имеет значение 0 или целочисленное значение больше 1. Этим значением может являться либо RepeatBehavior.LOOP, что означает повторение анимации в одном и том же порядке при каждом вызове, либо RepeatBehavior.REVERSE, что означает смену направления анимации для каждой итерации.

spark.effects.animation.RepeatBehavior

repeatCount Число повторений этой анимации.1 Число повторений этой анимации. Значение 0 указывает на бесконечное количество повторений. repeatDelay Время задержки в миллисекундах перед началом каждого цикла повторения.0 Время задержки в миллисекундах перед началом каждого цикла повторения. Установка в качестве данного значения числа, отличного от 0, обеспечивает завершение предыдущего цикла анимации точно на его конечном значении. Однако во время плавного перехода анимации от ожидания завершения одного цикла к началу следующего цикла это значение может быть пропущено повторениями без заданного параметра задержки. Это свойство должно иметь значение >= 0.

Эти свойство используется для первого повторения после первого цикла анимации. Для задержки первого цикла анимации применяется свойство startDelay.

startDelay

startDelay Время ожидания начала анимации.0 Время ожидания начала анимации. Это свойство должно иметь значение >= 0.