Animator

Pakiet	fl.motion
Klasa	public class Animator
Dziedziczenie	Animator AnimatorBase EventDispatcher Object

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Klasa Animator stosuje opis XML do pośrednich faz ruchu wyświetlanego obiektu. Właściwości i metody klasy Animator kontrolują odtwarzanie ruchu, a program Flash Player generuje zdarzenia w odpowiedzi na zmiany statusu ruchu. Jeśli nie ma zawartości trójwymiarowej, opcja Kopiuj ruch (jako polecenie ActionScript w programie Flash CS4) korzysta z klasy Animator. W przypadku zawartości trójwymiarowej zamiast tego używana jest klasa Animator3D, która współkorzysta z tej samej klasy podstawowej, co klasa Animator, ale jest przeznaczona dla zawartości trójwymiarowej. Polecenia języka ActionScript można edytować przy użyciu interfejsu API lub można konstruować własne animacje.

Jeśli użytkownik chce wywoływać klasę Animator w funkcji, należy zadeklarować instancję Animator poza funkcją, tak aby zakres obiektu nie został ograniczony do samej funkcji. Jeśli wystąpienie zostanie zadeklarowane w funkcji, program Flash Player usunie wystąpienie klasy Animator na koniec funkcji — jest to rutynowy proces czyszczenia pamięci, jaki przeprowadza program Flash Player. W takim przypadku obiekt docelowy nie będzie animowany.

Uwaga: W programie Flash CS3 niektóre właściwości i metody obsługiwane przez tę klasę należały wyłącznie do niej. W programie Flash CS4 wprowadzono klasę bazową AnimatorBase zawierającą te właściwości i metody, które są teraz współużytkowane przez inne klasy w ramach łańcucha dziedziczenia. Dotychczasowi użytkownicy programu Flash CS3 powinni zwrócić uwagę, że w wersjach programu Flash Professional późniejszych niż Flash CS3 te właściwości i metody nadal są dostępne w klasie Animator, ale należą do klasy AnimatorBase. Podobnie jak w przypadku pozostałych klas opisanych w niniejszej dokumentacji, aby wyświetlić wszystkie właściwości i metody obsługiwane przez tę klasę, należy wybrać opcję wyświetlania dziedziczonych właściwości publicznych i opcję wyświetlania dziedziczonych metod publicznych.

Domyślna właściwość MXMLmotion

Powiązane elementy interfejsu API

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
		autoRewind : Boolean = false Konfiguruje animację, tak aby po zakończeniu była uruchamiana ponownie.	AnimatorBase
		constructor : Object Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu.	Object
		frameEvent : String Nazwa obiektu zdarzenia utworzonego przez zdarzenie Event.ENTER_FRAME.	AnimatorBase
		initialPosition : Array [tylko do zapisu] Tablica współrzędnych definiujących położenie początkowe animacji.	AnimatorBase
		instanceFactoryClass : Class Podczas tworzenia wystąpień za pomocą kodu ActionScript ta klasa tworzy wystąpienia.	AnimatorBase
		isPlaying : Boolean [tylko do odczytu] Wskazuje, czy animacja jest w tej chwili odtwarzana.	AnimatorBase
		motion : MotionBase Obiekt, który zawiera właściwości fazy pośredniej ruchu dla animacji.	AnimatorBase
		motionArray : Array Tablica (Array) obiektów, które zawierają właściwości animacji dla animacji.	AnimatorBase
		orientToPath : Boolean = false Określa położenie wyświetlanego obiektu wzdłuż ścieżki ruchu.	AnimatorBase
		placeholderName : String Podczas tworzenia instancji za pomocą ActionScript jest to instancja, która pojawia się na stole montażowym, a która zostanie zastąpiona.	AnimatorBase
		positionMatrix : Matrix Obiekt Matrix, który stosuje transformację do ścieżki ruchu.	AnimatorBase
		repeatCount : int = 1 Liczba powtórzeń animacji.	AnimatorBase
		sceneName : String Odniesienie do wyeksportowanych scen (dla ruchu 3D) umożliwiające wczytanie sceny do macierzystej osi czasu.	AnimatorBase
		spanEnd : int [tylko do odczytu] Zwraca klatkę obiektu nadrzędnego obiektu docelowego, przy której zakończy się animacja obiektu docelowego.	AnimatorBase
		spanStart : int [tylko do odczytu] Zwraca klatkę obiektu macierzystego obiektu docelowego, od której rozpocznie się animacja obiektu docelowego.	AnimatorBase
		target : DisplayObject Wyświetlany obiekt animowany.	AnimatorBase
		targetName : String Nazwa obiektu docelowego widziana przez obiekt nadrzędny DisplayObjectContainer.	AnimatorBase
		targetParent : DisplayObjectContainer Animowany docelowy obiekt nadrzędny DisplayObjectContainer, który może być używany w połączeniu z obiektem targetName w celu pobierania obiektu docelowego po jego usunięciu, a następnie ponownym umieszczeniu na osi czasu.	AnimatorBase
		targetParentButton : SimpleButton	AnimatorBase
		targetState3D : Array Wstępna orientacja obiektu docelowego.	AnimatorBase
		time : int Wartość całkowita zliczana od zera, która wskazuje i kontroluje czas w aktualnej animacji.	AnimatorBase
		transformationPoint : Point Punkt odniesienia dla operacji obracania lub skalowania wyświetlanego obiektu.	AnimatorBase
		transformationPointZ : int Punkt odniesienia na osi Z dla operacji obracania lub skalowania wyświetlanego obiektu.	AnimatorBase
		usingCurrentFrame : Boolean [tylko do odczytu] Wskazuje, czy właściwość currentFrame została sprawdzona (zawsze po wprowadzeniu nowej klatki) oraz czy animacja obiektu docelowego została zsynchronizowana z klatkami na nadrzędnej osi czasu lub czy zawsze wyprzedza niezależnie od aktualnej klatki obiektu nadrzędnego.	AnimatorBase

Metody publiczne

Ukryj dziedziczone metody publiczne

Pokaż dziedziczone metody publiczne

	Metoda		Zdefiniowane przez
		Animator(xml:XML = null, target:DisplayObject = null) Tworzy obiekt Animator w celu zastosowania opisu pośredniej fazy ruchu na bazie języka XML do obiektu wyświetlanego.	Animator
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Rejestruje obiekt detektora zdarzeń w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu.	EventDispatcher
		dispatchEvent(event:Event):Boolean Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń.	EventDispatcher
		end(reset:Boolean = false, stopEnterFrame:Boolean = true, pastLastFrame:Boolean = false):void Powoduje zatrzymanie animacji i program Flash Player przechodzi natychmiast do ostatniej klatki w sekwencji animacji.	AnimatorBase
		fromXMLString(xmlString:String, target:DisplayObject = null):Animator [statyczny] Tworzy obiekt Animator z ciągu XML.	Animator
		hasEventListener(type:String):Boolean Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń.	EventDispatcher
		hasOwnProperty(name:String):Boolean Wskazuje, czy dla obiektu zdefiniowano określoną właściwość.	Object
		isPrototypeOf(theClass:Object):Boolean Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr.	Object
		matricesEqual(a:Matrix, b:Matrix):Boolean [statyczny] Porównuje dwie macierze podane jako parametry i zwraca wartość true, jeśli są równe.	Animator
		nextFrame(reset:Boolean = false, stopEnterFrame:Boolean = true):void Powoduje przejście programu Flash Player do kolejnej klatki w sekwencji animacji.	AnimatorBase
		pause():void Wstrzymuje animację do czasu wywołania metody resume().	AnimatorBase
		play(startTime:int = -1, startEnterFrame:Boolean = true):void Rozpoczyna animację.	AnimatorBase
		processCurrentFrame(parent:MovieClip, anim:AnimatorBase, startEnterFrame:Boolean, playOnly:Boolean = false):void [statyczny]	AnimatorBase
		propertyIsEnumerable(name:String):Boolean Wskazuje, czy określona właściwość istnieje i jest przeliczalna.	Object
		registerParentFrameHandler(parent:MovieClip, anim:AnimatorBase, spanStart:int, repeatCount:int = 0, useCurrentFrame:Boolean = false):void [statyczny] Rejestruje obiekt MovieClip i instancję AnimatorBase dla obiektu podrzędnego tego obiektu MovieClip.	AnimatorBase
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Usuwa detektor z obiektu EventDispatcher.	EventDispatcher
		resume():void Wznawia animację, która została wstrzymana za pomocą metody pause().	AnimatorBase
		rewind():void Powoduje przejście programu Flash Player do pierwszej klatki w sekwencji animacji.	AnimatorBase
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Ustawia dostępność właściwości dynamicznej używanej w pętlach.	Object
		startFrameEvents():void Inicjuje zdarzenia klatki.	AnimatorBase
		stop():void Powoduje zatrzymanie animacji i natychmiastowe przejście programu Flash Player do pierwszej klatki w sekwencji animacji.	AnimatorBase
		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
		useCurrentFrame(enable:Boolean, spanStart:int):void Ustawia właściwość currentFrame po wprowadzeniu nowej klatki, a następnie określa, czy animacja obiektu docelowego jest synchronizowana z klatkami na osi czasu jej nadrzędnego obiektu MovieClips.	AnimatorBase
		valueOf():Object Zwraca pierwotną wartość dla określonego obiektu.	Object
		willTrigger(type:String):Boolean Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych.	EventDispatcher

Zdarzenia

Kliknij, aby uzyskać więcej informacji o zdarzeniach

Ukryj zdarzenia dziedziczone

Pokaż zdarzenia dziedziczone

	Podsumowanie	Zdefiniowane przez
activate	[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja środowiska wykonawczego AIR uzyskuje fokus w systemie operacyjnym i przechodzi w stan aktywny.	EventDispatcher
deactivate	[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja AIR traci fokus w systemie operacyjnym i przechodzi w stan nieaktywny.	EventDispatcher
motionEnd	Operacja wywoływana, gdy obiekt Motion zakończy odtwarzanie: zarówno w przypadku faktycznego zakończenia, jak i przerwy spowodowanej wywołaniem metody stop() lub end().	AnimatorBase
motionStart	Wywoływane po rozpoczęciu odtwarzania obiektu Motion.	AnimatorBase
motionUpdate	Wywoływane po zmianie obiektu Motion lub uaktualnieniu ekranu.	AnimatorBase
timeChange	Wywoływane po zmianie wartości time obiektu Animator, a ekran nie został jeszcze uaktualniony (tj. w trakcie zdarzenia motionUpdate).	AnimatorBase

Konstruktor Szczegół

()

Konstruktor

public function Animator(xml:XML = null, target:DisplayObject = null)

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Tworzy obiekt Animator w celu zastosowania opisu klatki kluczowej opartej na kodzie XML do obiektu obiektu ekranowego.

Parametry

	`xml:XML` (default = `null`) — Obiekt E4X zawierający opis pośredniej fazy ruchu na bazie języka XML.

	`target:DisplayObject` (default = `null`) — Obiekt ekranowy, który korzysta z klatki kluczowej.

Powiązane elementy interfejsu API

Elementy XML dotyczące ruchu

Szczegół metody

fromXMLString

()

metoda

public static function fromXMLString(xmlString:String, target:DisplayObject = null):Animator

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9.0.28.0, AIR 1.0

Tworzy obiekt Animator z ciągu XML. Ta metoda jest alternatywą do korzystania z konstruktora Animator, który akceptuje obiekt E4X.

Parametry

	`xmlString:String` — Ciąg znaków w języku XML, który opisuje pośrednią fazę ruchu.

	`target:DisplayObject` (default = `null`) — Obiekt ekranowy, który korzysta z klatki kluczowej.

Zwraca

Animator — Instancja Animator, która stosuje określoną instrukcję xmlString do obiektu target.

Powiązane elementy interfejsu API

Elementy XML dotyczące ruchu

matricesEqual

()

metoda

public static function matricesEqual(a:Matrix, b:Matrix):Boolean

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS5

Wersje środowiska wykonawczego:

Flash Player 10.1, AIR 2

Porównuje dwie macierze podane jako parametry i zwraca wartość true, jeśli są równe.

Parametry

	`a:Matrix` — Pierwsze wystąpienie obiektu Matrix do porównania.

	`b:Matrix` — Drugie wystąpienie obiektu Matrix do porównania.

Zwraca

Boolean — Wartość typu Boolean — true (gdy macierze są równe) lub false (gdy macierze nie są równe).

Informacje prawne | Zasady prywatności online

Animator - AS3 Flash

Pakietyx

Elementy językowe

Dodatki

Pakiet fl.motion

Animator

fromXMLString

matricesEqual