Пакетfl.motion
Классpublic class MotionBase
НаследованиеMotionBase Inheritance Object
Подклассы Motion

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.0.28.0

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

См. также

Класс Motion
XML-элементы движения


Общедоступные свойства
 СвойствоОпределено
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
  duration : int
Управляет продолжительностью движения в экземпляре компонента Motion, которая измеряется в кадрах.
MotionBase
  is3D : Boolean
Определяет, содержит ли движение изменения свойства 3D.
MotionBase
  keyframes : Array
Массив ключевых кадров, определяющих движение во времени.
MotionBase
 Inheritedprototype : Object
[статические] Ссылка на модель объекта класса или функции.
Object
Общедоступные методы
 МетодОпределено
  
MotionBase(xml:XML = null)
Конструктор экземпляров MotionBase.
MotionBase
  
addFilterPropertyArray(index:int, name:String, values:Array, startFrame:int = -1, endFrame:int = -1):void
Изменяет свойство filter во всех соответствующих ключевых кадрах объекта Motion.
MotionBase
  
Добавляет объект ключевого кадра в экземпляр компонента Motion.
MotionBase
  
addPropertyArray(name:String, values:Array, startFrame:int = -1, endFrame:int = -1):void
Сохраняет массив значений в соответствующих ключевых кадрах для свойства declared класса Motion.
MotionBase
  
Возвращает интерполированный объект ColorTransform по заданному индексу времени в экземпляре компонента Motion.
MotionBase
  
getCurrentKeyframe(index:int, tweenableName:String = ""):KeyframeBase
Возвращает ключевой кадр, активный в настоящий момент на указанном кадре экземпляра компонента Motion.
MotionBase
  
Возвращает интерполированный массив фильтров по заданному индексу времени в экземпляре компонента Motion.
MotionBase
  
Возвращает объект Matrix3D для кадра анимации с заданным номером.
MotionBase
  
getNextKeyframe(index:int, tweenableName:String = ""):KeyframeBase
Возвращает следующий ключевой кадр после указанного кадра экземпляра компонента Motion.
MotionBase
  
getValue(index:Number, tweenableName:String):Number
Возвращает значение для свойства animation в заданный момент времени.
MotionBase
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
  
initFilters(filterClasses:Array, gradientSubarrayLengths:Array, startFrame:int = -1, endFrame:int = -1):void
Инициализирует список фильтров для целевого объекта и копирует его в каждый экземпляр Keyframe объекта Motion.
MotionBase
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
  
setValue(index:int, tweenableName:String, value:Number):void
Задает значение заданного свойства tweenable по указанному индексу времени в экземпляре компонента Motion.
MotionBase
 Inherited
Возвращает строковое представление заданного объекта.
Object
  
Поворачивает целевой объект, после того как данные для движения будут заданы методом addPropertyArray().
MotionBase
 Inherited
Возвращает элементарное значение заданного объекта.
Object
Сведения о свойстве
durationсвойство
duration:int  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.0.28.0

Управляет продолжительностью движения в экземпляре компонента Motion, которая измеряется в кадрах. Продолжительность не может быть меньше времени, занимаемого ключевыми кадрами экземпляра компонента Motion.

Значение по умолчанию 0


Реализация
    public function get duration():int
    public function set duration(value:int):void
is3Dсвойство 
is3D:Boolean  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения: Flash Player 10

Определяет, содержит ли движение изменения свойства 3D. При значении true движение содержит изменения свойства 3D.

Значение по умолчанию false


Реализация
    public function get is3D():Boolean
    public function set is3D(value:Boolean):void
keyframesсвойство 
public var keyframes:Array

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.0.28.0

Массив ключевых кадров, определяющих движение во времени. Это свойство представляет собой разреженный массив, в котором ключевой кадр расположен в массиве по индексу, соответствующему его собственному индексу. Объекту движения с нулевым и пятым ключевыми кадрами соответствует массив из 6 элементов. Оба индекса, нулевой и пятый, содержат по ключевому кадру, а индексы с 1-го по 4-й содержат пустые значения (null).

Сведения о конструкторе
MotionBase()Конструктор
public function MotionBase(xml:XML = null)

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.0.28.0

Конструктор экземпляров MotionBase. По умолчанию первый ключевой кадр создается автоматически со свойствами преобразования, используемыми по умолчанию.

Параметры
xml:XML (default = null) — XML-объект E4X XML, определяющий экземпляр компонента Motion (необязательный).
Сведения о методе
addFilterPropertyArray()метод
public function addFilterPropertyArray(index:int, name:String, values:Array, startFrame:int = -1, endFrame:int = -1):void

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.0.28.0

Изменяет свойство filter во всех соответствующих ключевых кадрах объекта Motion. Перед использованием этого метода нужно вызвать метод initFilters(). Порядок следования значений в массиве определяет назначение каждого значения свойству filter всех ключевых кадров. Для каждого значения, не равного null, в указанном массиве values этот метод находит ключевой кадр, соответствующий позиции индекса этого значения в массиве, и сохраняет пару свойств "имя-значение" для фильтра в ключевом кадре.

Параметры

index:int — Позиция индекса (начиная с нуля) в массиве фильтров.
 
name:String — Имя свойства filter, которое хранится в каждом ключевом кадре.
 
values:Array — Массив значений для свойства, которое указано в параметре name. Каждое значение, не равное null, назначается фильтру в ключевом кадре, который соответствует порядковому номеру значения в массиве.
 
startFrame:int (default = -1)
 
endFrame:int (default = -1)

См. также

addKeyframe()метод 
public function addKeyframe(newKeyframe:KeyframeBase):void

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.0.28.0

Добавляет объект ключевого кадра в экземпляр компонента Motion.

Параметры

newKeyframe:KeyframeBase — Объект ключевого кадра с заданным свойством index.

См. также

addPropertyArray()метод 
public function addPropertyArray(name:String, values:Array, startFrame:int = -1, endFrame:int = -1):void

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.0.28.0

Сохраняет массив значений в соответствующих ключевых кадрах для свойства declared класса Motion. Порядок следования значений в массиве определяет назначение каждого значения ключевому кадру. Для каждого значения, не равного null, в заданном массиве values этот метод находит ключевой кадр, соответствующий номеру позиции значения в массиве, или создает новый ключевой кадр для этого номера позиции и сохраняет пару свойств "имя/значение" в ключевой кадр.

Параметры

name:String — Имя свойства класса Motion, используемого для хранения каждого ключевого кадра.
 
values:Array — Массив значений для свойства, которое указано в параметре name. Каждое значение, не равное null, назначается ключевому кадру, который соответствует порядковому номеру значения в массиве.
 
startFrame:int (default = -1)
 
endFrame:int (default = -1)

См. также

getColorTransform()метод 
public function getColorTransform(index:int):ColorTransform

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.0.28.0

Возвращает интерполированный объект ColorTransform по заданному индексу времени в экземпляре компонента Motion.

Параметры

index:int — Индекс времени кадра в экземпляре компонента Motion в виде целого неотрицательного числа.

Возвращает
ColorTransform — Интерполированный объект ColorTransform.

См. также

getCurrentKeyframe()метод 
public function getCurrentKeyframe(index:int, tweenableName:String = ""):KeyframeBase

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.0.28.0

Возвращает ключевой кадр, активный в настоящий момент на указанном кадре экземпляра компонента Motion. Кадр, не являющийся ключевым, наследует свои значения от предыдущего ключевого кадра.

В этом методе также предусмотрена фильтрация значений по имени определенного свойства tweenable. Можно найти активный в настоящий момент ключевой кадр для x, который может отличаться от ключевого кадра, который в настоящий момент является активным в общем случае.

Параметры

index:int — Индекс кадра в экземпляре компонента Motion в виде целого неотрицательного числа.
 
tweenableName:String (default = "") — Имя свойства tweenable (например, x или rotation) (необязательно).

Возвращает
KeyframeBase — Ближайший подходящий ключевой кадр с заданным номером или номером, идущим перед ним.

См. также

getFilters()метод 
public function getFilters(index:Number):Array

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.0.28.0

Возвращает интерполированный массив фильтров по заданному индексу времени в экземпляре компонента Motion.

Параметры

index:Number — Индекс времени кадра в экземпляре компонента Motion в виде целого неотрицательного числа.

Возвращает
Array — Интерполированный массив фильтров. Если применяемые фильтры отсутствуют, возвращает пустой массив.

См. также

getMatrix3D()метод 
public function getMatrix3D(index:int):Object

Язык версии : ActionScript 3.0
Версии среды выполнения: Flash Player 10

Возвращает объект Matrix3D для кадра анимации с заданным номером.

Параметры

index:int — Номер кадра анимации (начиная с нуля), который содержит 3D-матрицу.

Возвращает
Object — Объект Matrix3D или значение null. Этот метод может вернуть значение null, даже если свойство MotionBase.is3D имеет значение true, потому что остальные изменения свойства анимации трехмерного движения могут использоваться без объекта Matrix3D.

См. также

getNextKeyframe()метод 
public function getNextKeyframe(index:int, tweenableName:String = ""):KeyframeBase

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.0.28.0

Возвращает следующий ключевой кадр после указанного кадра экземпляра компонента Motion. Если кадр не является ключевым и находится в середине анимации движения, этот метод наследует его значения как от предыдущего, так и от следующего кадра.

В этом методе предусмотрена фильтрация по имени определенного свойства tweenables для поиска следующего кадра для данного свойства, Этот кадр может отличаться от следующего ключевого кадра в общем случае.

Параметры

index:int — Индекс кадра в экземпляре компонента Motion в виде целого неотрицательного числа.
 
tweenableName:String (default = "") — Имя свойства tweenable (например, x или rotation) (необязательно).

Возвращает
KeyframeBase — Ближайший подходящий ключевой кадр с номером, идущим после заданного.

См. также

getValue()метод 
public function getValue(index:Number, tweenableName:String):Number

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.0.28.0

Возвращает значение для свойства animation в заданный момент времени.

Параметры

index:Number — Индекс времени кадра в экземпляре компонента Motion в виде целого неотрицательного числа.
 
tweenableName:String — Имя свойства tweenable (например, x или rotation).

Возвращает
Number — Числовое значение свойства, указанного в параметре tweenableName.

См. также

initFilters()метод 
public function initFilters(filterClasses:Array, gradientSubarrayLengths:Array, startFrame:int = -1, endFrame:int = -1):void

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.0.28.0

Инициализирует список фильтров для целевого объекта и копирует его в каждый экземпляр Keyframe объекта Motion.

Параметры

filterClasses:Array — Массив классов фильтров. Каждый элемент массива представляет собой полное имя класса (в виде строки) того типа фильтра, который находится по этому индексу.
 
gradientSubarrayLengths:Array — Массив чисел, который содержит значение каждого фильтра, присутствующего в списке фильтров движения (имя каждого класса в массиве filterClasses). Значение из массива gradientSubarrayLengths используется только в том случае, если запись о классе фильтра с таким же индексом позиции в массиве filterClasses содержит значение GradientGlowFilter или GradientBevelFilter. Соответствующее значение в массиве gradientSubarrayLengths является числом, определяющим длину массивов, инициализирующих параметры colors, alphas и ratios в конструкторах GradientGlowFilter и GradientBevelFilter.
 
startFrame:int (default = -1)
 
endFrame:int (default = -1)

См. также

setValue()метод 
public function setValue(index:int, tweenableName:String, value:Number):void

Язык версии : ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9.0.28.0

Задает значение заданного свойства tweenable по указанному индексу времени в экземпляре компонента Motion. Если ключевой кадр с таким номером отсутствует, он создается автоматически.

Параметры

index:int — Индекс времени кадра в экземпляре компонента Motion в виде целого неотрицательного числа. Если индекс равен нулю, изменений не было. Свойства преобразования связаны с начальными значениями преобразования целевого объекта. Значениями для первого кадра (номер равен нулю) всегда выступают значения по умолчанию, и их нельзя изменить.
 
tweenableName:String — Имя свойства tweenable в виде строки (например, x или rotation).
 
value:Number — Новое значение свойства tweenable.

См. также

useRotationConcat()метод 
public function useRotationConcat(index:int):Boolean

Язык версии : ActionScript 3.0
Версии среды выполнения: Flash Player 10

Поворачивает целевой объект, после того как данные для движения будут заданы методом addPropertyArray().

Параметры

index:int — Номер кадра анимации.

Возвращает
Boolean — Указывает, будет ли целевой объект повернут с использованием сохраненного свойства KeyframeBase.rotationConcat.

См. также