MotionBase

Pakiet	fl.motion
Klasa	public class MotionBase
Dziedziczenie	MotionBase Object
Podklasy	Motion

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Klasa MotionBase zawiera sekwencję animacji klatek kluczowych, które mogą zostać zastosowane do wyświetlanego obiektu. Dane animacji obejmują pozycję, skalę, rotację, pochylenie, kolor, filtry i zmiany dynamiki. Klasa MotionBase zawiera metody umożliwiające pobieranie danych w określonych punktach klatki kluczowej. W celu pobrania wartości przybliżonych między klatkami kluczowymi, należy użyć klasy Motion.

Wyświetl przykłady

Powiązane elementy interfejsu API

Klasa Motion
Elementy XML dotyczące ruchu

Właściwości publiczne

Ukryj dziedziczone właściwości publiczne

Pokaż dziedziczone właściwości publiczne

	Właściwość		Zdefiniowane przez
		constructor : Object Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu.	Object
		duration : int Kontroluje czas trwania instancji Motion, przy czym czas jest mierzony w liczbie klatek.	MotionBase
		is3D : Boolean Określa, czy ruch obejmuje zmiany właściwości 3D.	MotionBase
		keyframes : Array Tablica klatek kluczowych, określająca działanie obiektu Motion w czasie.	MotionBase

Metody publiczne

Ukryj dziedziczone metody publiczne

Pokaż dziedziczone metody publiczne

	Metoda		Zdefiniowane przez
		MotionBase(xml:XML = null) Konstruktor instancji MotionBase.	MotionBase
		addFilterPropertyArray(index:int, name:String, values:Array, startFrame:int = -1, endFrame:int = -1):void Modyfikuje właściwość filter we wszystkich odpowiednich klatkach kluczowych dla obiektu Motion.	MotionBase
		addKeyframe(newKeyframe:KeyframeBase):void Dodaje obiekt klatki kluczowej do instancji Motion.	MotionBase
		addPropertyArray(name:String, values:Array, startFrame:int = -1, endFrame:int = -1):void Zawiera tablicę wartości odpowiednich klatek kluczowych dla zadeklarowanej właściwości klasy Motion.	MotionBase
		getColorTransform(index:int):flash.geom:ColorTransform Pobiera przybliżony obiekt ColorTransform w miejsce wskazane przez określony indeks czasowy z instancji Motion.	MotionBase
		getCurrentKeyframe(index:int, tweenableName:String = ""):KeyframeBase Pobiera klatkę kluczową, która jest w tej chwili aktywna i skojarzona z konkretną klatką z instancji Motion.	MotionBase
		getFilters(index:Number):Array Pobiera przybliżoną tablicę filtrów w miejsce wskazane przez określony indeks czasowy z wystąpienia klasy Motion.	MotionBase
		getMatrix(index:int):Matrix Zwraca obiekt Matrix dla określonej pozycji indeksu klatki animacji.	MotionBase
		getMatrix3D(index:int):Object Zwraca obiekt Matrix3D dla określonej pozycji indeksu klatki animacji.	MotionBase
		getNextKeyframe(index:int, tweenableName:String = ""):KeyframeBase Pobiera kolejną klatkę kluczową, następującą po konkretnej klatce z instancji Motion.	MotionBase
		getValue(index:Number, tweenableName:String):Number Pobiera wartość właściwość animacji skojarzoną z konkretnym punktem na osi czasu.	MotionBase
		hasOwnProperty(name:String):Boolean Wskazuje, czy dla obiektu zdefiniowano określoną właściwość.	Object
		initFilters(filterClasses:Array, gradientSubarrayLengths:Array, startFrame:int = -1, endFrame:int = -1):void Inicjuje listę filtrów dla obiektu docelowego i kopiuje listę filtrów do każdej instancji Keyframe obiektu Motion.	MotionBase
		isPrototypeOf(theClass:Object):Boolean Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr.	Object
		overrideTargetTransform(scale:Boolean = true, skew:Boolean = true, rotate:Boolean = true):void	MotionBase
		propertyIsEnumerable(name:String):Boolean Wskazuje, czy określona właściwość istnieje i jest przeliczalna.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Ustawia dostępność właściwości dynamicznej używanej w pętlach.	Object
		setValue(index:int, tweenableName:String, value:Number):void Ustawia konkretną właściwość animacji tweenables w miejscu określonego indeksu czasowego w instancji Motion.	MotionBase
		toLocaleString():String Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych.	Object
		toString():String Zwraca ciąg reprezentujący określony obiekt.	Object
		useRotationConcat(index:int):Boolean Obraca obiekt docelowy, gdy dane dla ruchu zostaną dostarczone przez metodę addPropertyArray().	MotionBase
		valueOf():Object Zwraca pierwotną wartość dla określonego obiektu.	Object

Szczegół właściwości

duration

właściwość

duration:int

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Kontroluje czas trwania instancji Motion, przy czym czas jest mierzony w liczbie klatek. Cza trwania nie może być krótszy niż czas, przez jaki zajmowane są klatki kluczowe instancji Motion.

Wartością domyślną jest 0.

Implementacja
public function get duration():int
public function set duration(value:int):void

is3D

właściwość

is3D:Boolean

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 10, AIR 1.5, AIR 1.0

Określa, czy ruch obejmuje zmiany właściwości 3D. Jeśli wartością jest true, ruch zawiera zmiany właściwości 3D.

Wartością domyślną jest false.

Implementacja
public function get is3D():Boolean
public function set is3D(value:Boolean):void

keyframes

właściwość

public var keyframes:Array

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Tablica klatek kluczowych, określająca działanie obiektu Motion w czasie. Ta właściwość jest tablicą rzadką, w której klatka kluczowa jest umieszczana w indeksie w tablicy, który jest zgodny z jej własnym indeksem. Obiekt motion z klatkami kluczowymi w pozycjach 0 i 5 zawiera tablicę klatek kluczowych o długości 6. Indeksy 0 i 5 w tablicy zawierają klatki kluczowe, a indeksy od 1 do 4 zawierają wartości null.

Konstruktor Szczegół

()

Konstruktor

public function MotionBase(xml:XML = null)

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Konstruktor instancji MotionBase. Domyślnie jedna wstępna klatka kluczowa jest tworzona automatycznie z domyślnymi właściwościami transformacji.

Parametry

xml:XML (default = null) — Opcjonalny obiekt E4X XML definiujący instancję Motion.

Szczegół metody

addFilterPropertyArray

()

metoda

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

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Modyfikuje właściwość filter we wszystkich odpowiednich klatkach kluczowych dla obiektu Motion. Przed użyciem tej metody należy wywołać metodę initFilters(). Kolejność wartości w tablicy określa przypisanie poszczególnych wartości do właściwości filter we wszystkich klatkach kluczowych. Dla każdej wartości innej niż null w określonej tablicy values ta metoda znajduje klatkę kluczową odpowiadającą indeksowi wartości w tablicy oraz przechowuje parę nazwa/wartość właściwości filter w klatce kluczowej.

Parametry

	`index:int` — Pozycja indeksu liczona od zera w tablicy filtrów.

	`name:String` — Nazwa właściwości filter, jaka będzie przechowywana w każdej klatce kluczowej.

	`values:Array` — Tablica wartości dla właściwości określonej w parametrze `name`. Każda wartość inna niż null jest przypisywana do filtru w klatce kluczowej, która odpowiada indeksowi wartości w tablicy.

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

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

Powiązane elementy interfejsu API

initFilters()
flash.filters

addKeyframe

()

metoda

public function addKeyframe(newKeyframe:KeyframeBase):void

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Dodaje obiekt klatki kluczowej do wystąpienia klasy Motion.

Parametry

newKeyframe:KeyframeBase — Obiekt klatki kluczowej z ustawioną już właściwością index.

Powiązane elementy interfejsu API

fl.motion.Keyframe

addPropertyArray

()

metoda

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

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Zawiera tablicę wartości odpowiednich klatek kluczowych dla zadeklarowanej właściwości klasy Motion. Kolejność wartości w tablicy określa przypisanie poszczególnych wartości do klatki kluczowej. Dla każdej wartości innej niż null w określonej tablicy values ta metoda znajduje klatkę kluczową odpowiadającą indeksowi wartości w tablicy lub tworzy nową klatkę kluczową dla indeksu oraz przechowuje parę nazwa/wartość właściwości w klatce kluczowej.

Parametry

	`name:String` — Nazwa właściwości klasy Motion, jaka jest zapisywana w każdej klatce kluczowej.

	`values:Array` — Tablica wartości dla właściwości określonej w parametrze `name`. Każda wartość inna niż null jest przypisywana do klatki kluczowej, która odpowiada kolejności wartości w tablicy.

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

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

Powiązane elementy interfejsu API

fl.motion.Motion

getColorTransform

()

metoda

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

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Pobiera przybliżony obiekt ColorTransform w miejsce wskazane przez określony indeks czasowy z wystąpienia klasy Motion.

Parametry

index:int — Indeks czasowy klatki w wystąpieniu klasy Motion, jako wartość całkowita większa niż lub równa zero.

Zwraca

flash.geom:ColorTransform — Przybliżony obiekt ColorTransform.

Powiązane elementy interfejsu API

flash.geom.ColorTransform

getCurrentKeyframe

()

metoda

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

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Pobiera klatkę kluczową, która jest w tej chwili aktywna i skojarzona z konkretną klatką z instancji Motion. Klatka, która nie jest aktualnie kluczowa pobiera swoje wartości z klatki kluczowej, która ją poprzedza.

Ta metoda umożliwia również filtrowanie wartości wg nazwy określonej właściwości tweenables. Dla x można znaleźć aktualnie aktywną klatkę kluczową — może to być inna klatka kluczowa niż aktualnie obowiązująca aktywna klatka kluczowa.

Parametry

	`index:int` — Indeks klatki w instancji Motion, jako wartość całkowita większa lub równa zero.

	`tweenableName:String` (default = "") — Opcjonalna nazwa właściwości tweenables (np. `„x”` lub `„rotation”`).

Zwraca

KeyframeBase — Najbliższa zgodna klatka kluczowa o numerze indeksu równym lub wcześniejszym niż numer określonej klatki.

Powiązane elementy interfejsu API

fl.motion.Tweenables

getFilters

()

metoda

public function getFilters(index:Number):Array

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Pobiera przybliżoną tablicę filtrów w miejsce wskazane przez określony indeks czasowy z instancji Motion.

Parametry

index:Number — Indeks czasowy klatki w Motion, jako wartość całkowita większa lub równa zero.

Zwraca

Array — Przybliżona tablica filtrów. Jeśli nie ma odpowiednich filtrów, zwraca pustą tablicę.

Powiązane elementy interfejsu API

flash.filters

getMatrix

()

metoda

public function getMatrix(index:int):Matrix

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 10, AIR 1.5, AIR 1.0

Zwraca obiekt Matrix dla określonej pozycji indeksu klatki animacji.

Parametry

index:int — Liczony od zera indeks klatki animacji zawierającej macierz

Zwraca

Matrix — Obiekt Matrix lub wartość null. Ta metoda może zwracać wartość null, nawet jeśli właściwość MotionBase.is ma wartość false, ponieważ zmiany innej właściwości animacji ruchu mogą być używane bez obiektu Matrix3D.

Powiązane elementy interfejsu API

flash.geom.Matrix

getMatrix3D

()

metoda

public function getMatrix3D(index:int):Object

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 10, AIR 1.5, AIR 1.0

Zwraca obiekt Matrix3D dla określonej pozycji indeksu klatki animacji.

Parametry

index:int — Liczony od zera indeks klatki animacji zawierającej macierz 3D.

Zwraca

Object — Obiekt Matrix3D lub wartość null. Ta metoda może zwracać wartość null, nawet jeśli właściwość MotionBase.is3D ma wartość true, ponieważ zmiany innej właściwości pośredniej fazy ruchu 3D mogą być używane bez obiektu Matrix3D.

Powiązane elementy interfejsu API

flash.geom.Matrix3D

getNextKeyframe

()

metoda

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

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Pobiera kolejną klatkę kluczową, następującą po konkretnej klatce z instancji Motion. Jeśli klatka nie jest klatką kluczową i znajduje się w środku pośredniej fazy ruchu, ta metoda pobiera jej wartości z poprzedzającej i kolejnej klatki kluczowej.

Ta metoda umożliwia również filtrowanie wg nazw określonych właściwości tweenables w celu wyszukiwania kolejnej klatki kluczowej dla właściwości, która może być inna niż kolejna obowiązująca klatka kluczowa.

Parametry

	`index:int` — Indeks klatki w instancji Motion, jako wartość całkowita większa lub równa zero.

	`tweenableName:String` (default = "") — Opcjonalna nazwa właściwości tweenables (np. `„x”` lub `„rotation”`).

Zwraca

KeyframeBase — Najbliższa zgodna klatka kluczowa o numerze indeksu, który wypada po określonym indeksie klatki.

Powiązane elementy interfejsu API

fl.motion.Tweenables

getValue

()

metoda

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

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Pobiera wartość właściwość animacji skojarzoną z konkretnym punktem na osi czasu.

Parametry

	`index:Number` — Indeks czasowy klatki w instancji Motion, jako wartość całkowita większa lub równa zero.

	`tweenableName:String` — Nazwa właściwości tweenables (np. `„x”` lub `„rotation”`).

Zwraca

Number — Wartość liczbowa dla właściwości określonej przez parametr tweenableName.

Powiązane elementy interfejsu API

fl.motion.Tweenables

initFilters

()

metoda

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

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Inicjuje listę filtrów dla obiektu docelowego i kopiuje listę filtrów do każdego wystąpienia Keyframe obiektu Motion.

Parametry

	`filterClasses:Array` — Tablica klas filtrów. Każdy element tablicy jest pełną nazwą klasy (w formacie ciągu znaków) dla typu filtru, który znajduje się w konkretnej pozycji indeksu.

	`gradientSubarrayLengths:Array` — Tablica liczb zawierająca wartość dla każdego filtru, który będzie znajdował się na liście filtrów dla danego ruchu (każda nazwa klasy z tablicy `filterClasses`). Wartość w tablicy `gradientSubarrayLengths` jest używana tylko wówczas, gdy wpis klasy filtru pod danym numerem indeksu w tablicy `filterClasses` to GradientGlowFilter lub GradientBevelFilter. Odpowiednia wartość w tablicy `gradientSubarrayLengths` jest liczbą, która określa długość dla tablic inicjujących parametry `colors`, `alphas` i `ratios` dla funkcji GradientGlowFilter i GradientBevelFilter konstruktora.

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

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

Powiązane elementy interfejsu API

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

overrideTargetTransform

()

metoda

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

Parametry

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

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

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

setValue

()

metoda

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

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Ustawia konkretną właściwość animacji tweenables w miejscu określonego indeksu czasowego w instancji Motion. Jeśli klatka kluczowa nie istnieje w danym indeksie, zostaje utworzona automatycznie.

Parametry

	`index:int` — Indeks czasowy klatki w instancji Motion, jako liczba całkowita większa od zera. Jeśli indeks ma wartość zero, nie jest wykonywana żadna zmiana. Właściwośći transformacji są określane względem początkowych wartości transformacji obiektu docelowego, a wartości dla pierwszej klatki (wartośc indeksu zero) są zawsze wartościami domyślnymi i nie powinny być zmieniane.

	`tweenableName:String` — Nazwa właściwości tweenables jako ciąg znaków (np. `„x”` lub `„rotation”`).

	`value:Number` — Nowa wartość właściwości tweenables.

Powiązane elementy interfejsu API

fl.motion.Tweenables

useRotationConcat

()

metoda

public function useRotationConcat(index:int):Boolean

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 10, AIR 1.5, AIR 1.0

Obraca obiekt docelowy, gdy dane dla ruchu zostaną dostarczone przez metodę addPropertyArray().

Parametry

index:int — Indeks klatki animacji.

Zwraca

Boolean — Wskazuje, czy obiekt docelowy będzie obracany przy użyciu właściwości zapisanej w obiekcie KeyframeBase.rotationConcat.

Powiązane elementy interfejsu API

addPropertyArray()
fl.motion.KeyframeBase.rotationConcat

Przykłady Sposób korzystania z tego przykładu

MotionBaseExample.as

Ten przykład przedstawia sposób animowania ikony a pomocą klas MotionBase i AnimatorFactory. Do obiektu MotionBase przypisywane są tablice współrzędnych x i y, a następnie ten obiekt jest używany w celu utworzenia obiektu AnimatorFactory. Obiekt AnimatorFactory jest na koniec kierowany do ikonki, w postaci wypełnionego prostokąta.

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);
          }
     }    
}

Informacje prawne | Zasady prywatności online

MotionBase - AS3 Flash

Pakietyx

Elementy językowe

Dodatki

Pakiet fl.motion

duration

is3D

keyframes

MotionBase

addFilterPropertyArray

addKeyframe

addPropertyArray

getColorTransform

getCurrentKeyframe

getFilters

getMatrix

getMatrix3D

getNextKeyframe

getValue

initFilters

overrideTargetTransform

setValue

useRotationConcat