MotionBase

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

Язык версии:

ActionScript 3.0

Версия продукта:

Flash CS3

Версии среды выполнения:

Flash Player 9.0.28.0, AIR 1.0

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

Посмотреть примеры

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

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

Общедоступные свойства

Скрыть унаследованные общедоступные свойства

Показать унаследованные общедоступные свойства

	Свойство		Определено
		constructor : Object Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.	Object
		duration : int Управляет продолжительностью движения в экземпляре компонента Motion, которая измеряется в кадрах.	MotionBase
		is3D : Boolean Определяет, содержит ли движение изменения свойства 3D.	MotionBase
		keyframes : Array Массив ключевых кадров, определяющих движение во времени.	MotionBase

Общедоступные методы

Скрыть унаследованные общедоступные методы

Показать унаследованные общедоступные методы

	Метод		Определено
		MotionBase(xml:XML = null) Конструктор экземпляров MotionBase.	MotionBase
		addFilterPropertyArray(index:int, name:String, values:Array, startFrame:int = -1, endFrame:int = -1):void Изменяет свойство filter во всех соответствующих ключевых кадрах объекта Motion.	MotionBase
		addKeyframe(newKeyframe:KeyframeBase):void Добавляет объект ключевого кадра в экземпляр компонента Motion.	MotionBase
		addPropertyArray(name:String, values:Array, startFrame:int = -1, endFrame:int = -1):void Сохраняет массив значений в соответствующих ключевых кадрах для свойства declared класса Motion.	MotionBase
		getColorTransform(index:int):flash.geom:ColorTransform Возвращает интерполированный объект ColorTransform по заданному индексу времени в экземпляре компонента Motion.	MotionBase
		getCurrentKeyframe(index:int, tweenableName:String = ""):KeyframeBase Возвращает ключевой кадр, активный в настоящий момент на указанном кадре экземпляра компонента Motion.	MotionBase
		getFilters(index:Number):Array Возвращает интерполированный массив фильтров по заданному индексу времени в экземпляре компонента Motion.	MotionBase
		getMatrix(index:int):Matrix Возвращает объект Matrix для кадра анимации с заданным номером.	MotionBase
		getMatrix3D(index:int):Object Возвращает объект Matrix3D для кадра анимации с заданным номером.	MotionBase
		getNextKeyframe(index:int, tweenableName:String = ""):KeyframeBase Возвращает следующий ключевой кадр после указанного кадра экземпляра компонента Motion.	MotionBase
		getValue(index:Number, tweenableName:String):Number Возвращает значение для свойства animation в заданный момент времени.	MotionBase
		hasOwnProperty(name:String):Boolean Показывает, определено ли заданное свойство для объекта.	Object
		initFilters(filterClasses:Array, gradientSubarrayLengths:Array, startFrame:int = -1, endFrame:int = -1):void Инициализирует список фильтров для целевого объекта и копирует его в каждый экземпляр Keyframe объекта Motion.	MotionBase
		isPrototypeOf(theClass:Object):Boolean Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.	Object
		overrideTargetTransform(scale:Boolean = true, skew:Boolean = true, rotate:Boolean = true):void	MotionBase
		propertyIsEnumerable(name:String):Boolean Показывает наличие заданного свойства и его перечисляемость.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Задает доступность динамического свойства для операций цикла.	Object
		setValue(index:int, tweenableName:String, value:Number):void Задает значение заданного свойства tweenable по указанному индексу времени в экземпляре компонента Motion.	MotionBase
		toLocaleString():String Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.	Object
		toString():String Возвращает строковое представление заданного объекта.	Object
		useRotationConcat(index:int):Boolean Возвращает целевой объект, когда данные для движения передаются методом addPropertyArray().	MotionBase
		valueOf():Object Возвращает элементарное значение заданного объекта.	Object

Сведения о свойстве

duration

свойство

duration:int

Язык версии:

ActionScript 3.0

Версия продукта:

Flash CS3

Версии среды выполнения:

Flash Player 9.0.28.0, AIR 1.0

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

Значением по умолчанию является 0.

Реализация
public function get duration():int
public function set duration(value:int):void

is3D

свойство

is3D:Boolean

Язык версии:

ActionScript 3.0

Версия продукта:

Flash CS3

Версии среды выполнения:

Flash Player 10, AIR 1.5, AIR 1.0

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

Значением по умолчанию является false.

Реализация
public function get is3D():Boolean
public function set is3D(value:Boolean):void

keyframes

свойство

public var keyframes:Array

Язык версии:

ActionScript 3.0

Версия продукта:

Flash CS3

Версии среды выполнения:

Flash Player 9.0.28.0, AIR 1.0

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

Сведения о конструкторе

()

Конструктор

public function MotionBase(xml:XML = null)

Язык версии:

ActionScript 3.0

Версия продукта:

Flash CS3

Версии среды выполнения:

Flash Player 9.0.28.0, AIR 1.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

Версия продукта:

Flash CS3

Версии среды выполнения:

Flash Player 9.0.28.0, AIR 1.0

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

Параметры

	`index:int` — Позиция индекса (начиная с нуля) в массиве фильтров.

	`name:String` — Имя свойства filter, которое хранится в каждом ключевом кадре.

	`values:Array` — Массив значений для свойства, которое указано в параметре `name`. Каждое значение, не равное null, назначается фильтру в ключевом кадре, который соответствует порядковому номеру значения в массиве.

	`startFrame:int` (default = `-1`)

	`endFrame:int` (default = `-1`)

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

initFilters()
flash.filters

addKeyframe

()

метод

public function addKeyframe(newKeyframe:KeyframeBase):void

Язык версии:

ActionScript 3.0

Версия продукта:

Flash CS3

Версии среды выполнения:

Flash Player 9.0.28.0, AIR 1.0

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

Параметры

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

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

fl.motion.Keyframe

addPropertyArray

()

метод

public function addPropertyArray(name:String, values:Array, startFrame:int = -1, endFrame:int = -1):void

Язык версии:

ActionScript 3.0

Версия продукта:

Flash CS3

Версии среды выполнения:

Flash Player 9.0.28.0, AIR 1.0

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

Параметры

	`name:String` — Имя свойства класса Motion, используемого для хранения каждого ключевого кадра.

	`values:Array` — Массив значений для свойства, которое указано в параметре `name`. Каждое значение, не равное null, назначается ключевому кадру, который соответствует порядковому номеру значения в массиве.

	`startFrame:int` (default = `-1`)

	`endFrame:int` (default = `-1`)

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

fl.motion.Motion

getColorTransform

()

метод

public function getColorTransform(index:int):flash.geom:ColorTransform

Язык версии:

ActionScript 3.0

Версия продукта:

Flash CS3

Версии среды выполнения:

Flash Player 9.0.28.0, AIR 1.0

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

Параметры

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

Возвращает

flash.geom:ColorTransform — Интерполированный объект ColorTransform.

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

flash.geom.ColorTransform

getCurrentKeyframe

()

метод

public function getCurrentKeyframe(index:int, tweenableName:String = ""):KeyframeBase

Язык версии:

ActionScript 3.0

Версия продукта:

Flash CS3

Версии среды выполнения:

Flash Player 9.0.28.0, AIR 1.0

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

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

Параметры

	`index:int` — Индекс кадра в экземпляре Motion, т.к. целое больше или равняется нулю.

	`tweenableName:String` (default = "") — Необязательное имя свойства, которое можно подвергнуть анимации движения (например, `"x"` или `"rotation"`).

Возвращает

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

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

fl.motion.Tweenables

getFilters

()

метод

public function getFilters(index:Number):Array

Язык версии:

ActionScript 3.0

Версия продукта:

Flash CS3

Версии среды выполнения:

Flash Player 9.0.28.0, AIR 1.0

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

Параметры

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

Возвращает

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

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

flash.filters

getMatrix

()

метод

public function getMatrix(index:int):Matrix

Язык версии:

ActionScript 3.0

Версия продукта:

Flash CS3

Версии среды выполнения:

Flash Player 10, AIR 1.5, AIR 1.0

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

Параметры

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

Возвращает

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

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

flash.geom.Matrix

getMatrix3D

()

метод

public function getMatrix3D(index:int):Object

Язык версии:

ActionScript 3.0

Версия продукта:

Flash CS3

Версии среды выполнения:

Flash Player 10, AIR 1.5, AIR 1.0

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

Параметры

index:int — Начинающийся с нуля индекс кадра анимации, состоящий из трехмерной матрицы.

Возвращает

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

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

flash.geom.Matrix3D

getNextKeyframe

()

метод

public function getNextKeyframe(index:int, tweenableName:String = ""):KeyframeBase

Язык версии:

ActionScript 3.0

Версия продукта:

Flash CS3

Версии среды выполнения:

Flash Player 9.0.28.0, AIR 1.0

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

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

Параметры

	`index:int` — Индекс кадра в экземпляре Motion, т.к. целое больше или равняется нулю.

	`tweenableName:String` (default = "") — Необязательное имя свойства, которое можно подвергнуть анимации движения (например, `"x"` или `"rotation"`).

Возвращает

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

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

fl.motion.Tweenables

getValue

()

метод

public function getValue(index:Number, tweenableName:String):Number

Язык версии:

ActionScript 3.0

Версия продукта:

Flash CS3

Версии среды выполнения:

Flash Player 9.0.28.0, AIR 1.0

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

Параметры

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

	`tweenableName:String` — Имя свойства, которое можно подвергнуть анимации движения (например, `"x"` или`"rotation"`).

Возвращает

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

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

fl.motion.Tweenables

initFilters

()

метод

 public function initFilters(filterClasses:Array, gradientSubarrayLengths:Array, startFrame:int = -1, endFrame:int = -1):void

Язык версии:

ActionScript 3.0

Версия продукта:

Flash CS3

Версии среды выполнения:

Flash Player 9.0.28.0, AIR 1.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`)

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

flash.filters
flash.filters.GradientGlowFilter
flash.filters.GradientBevelFilter

overrideTargetTransform

()

метод

public function overrideTargetTransform(scale:Boolean = true, skew:Boolean = true, rotate:Boolean = true):void

Параметры

	`scale:Boolean` (default = `true`)

	`skew:Boolean` (default = `true`)

	`rotate:Boolean` (default = `true`)

setValue

()

метод

public function setValue(index:int, tweenableName:String, value:Number):void

Язык версии:

ActionScript 3.0

Версия продукта:

Flash CS3

Версии среды выполнения:

Flash Player 9.0.28.0, AIR 1.0

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

Параметры

	`index:int` — Индекс времени кадра в экземпляре компонента Motion в виде целого неотрицательного числа. Если индекс равен нулю, изменений не было. Свойства трансформации связаны с начальными значениями трансформациями целевого объекта, значения первого кадра (с нулевым индексом) всегда являются значениями по умолчанию и не должны меняться.

	`tweenableName:String` — Имя свойства tweenable в виде строки (например,`"x"` или `"rotation"`).

	`value:Number` — Новое значение свойства tweenable.

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

fl.motion.Tweenables

useRotationConcat

()

метод

public function useRotationConcat(index:int):Boolean

Язык версии:

ActionScript 3.0

Версия продукта:

Flash CS3

Версии среды выполнения:

Flash Player 10, AIR 1.5, AIR 1.0

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

Параметры

index:int — Адрес индекса кадра анимации.

Возвращает

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

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

addPropertyArray()
fl.motion.KeyframeBase.rotationConcat

Примеры Использование этого примера

MotionBaseExample.as

В этом примере демонстрируется анимация спрайта с помощью классов MotionBase и AnimatorFactory. Объекту MotionBase назначаются массивы координат x и y, и затем он используется для создания объекта AnimatorFactory. Затем объект AnimatorFactory передается спрайту в виде заполненного прямоугольника.

package 
{
     import flash.display.MovieClip;
     import flash.display.Sprite;
     import fl.motion.AnimatorFactory;
     import fl.motion.MotionBase;
     import flash.geom.Point;
    
     public class  MotionBaseExample extends MovieClip
     {
          private var motionBase:MotionBase;
          private var animFactory:AnimatorFactory;
          private var size:uint    = 100;
          private var bgColor:uint = 0xFFCC00;

          public function MotionBaseExample():void
          {
               var boxObj:sprite = new Sprite();
               boxObj.graphics.beginFill(bgColor);
               boxObj.graphics.drawRect(0, 0, size, size);
               boxObj.graphics.endFill();
               addChild(boxObj);

               motionBase = new MotionBase();
               motionBase.duration = 20;
               motionBase.addPropertyArray("x",[0,50,95,134,169,199,225,247,265,280]);
               motionBase.addPropertyArray("y",[0,1,0,4,12,21,32,44,52,38]);
               animFactory = new AnimatorFactory(motionBase);
               animFactory.transformationPoint = new Point(2, 2);
               animFactory.addTarget(boxObj, 0);
          }
     }    
}

Юридическая информация | Политика конфиденциальности онлайн

MotionBase - AS3 Flash

Пакетыx

Элементы языка

Приложения

Пакет fl.motion

duration

is3D

keyframes

MotionBase

addFilterPropertyArray

addKeyframe

addPropertyArray

getColorTransform

getCurrentKeyframe

getFilters

getMatrix

getMatrix3D

getNextKeyframe

getValue

initFilters

overrideTargetTransform

setValue

useRotationConcat