AnimateTransform3D

Paket	spark.effects
Klasse	public class AnimateTransform3D
Vererbung	AnimateTransform3D AnimateTransform Animate Effect EventDispatcher Object
Unterklassen	Move3D, Rotate3D, Scale3D

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Der AnimateTransform3D-Effekt erweitert die Möglichkeiten des AnimateTransform-Effekts auf 3D-Transformationseigenschaften. Wie AnimateTransform ist dieser Effekt nicht für eine direkte Verwendung geeignet, er bietet stattdessen allgemeine Funktionen, die von den zugehörigen Unterklassen verwendet werden. Verwenden Sie zum Erhalten von 3D-Effekten die Unterklassen Move3D, Rotate3D und Scale3D.

Genauso wie bei AnimateTransform gibt es einige Eigenschaften bei diesem Effekt, die mit allen anderen Transformationseffekten gemeinsam verwendet werden, mit denen der Effekt während der Laufzeit kombiniert wird. Insbesondere sind die projektionsbezogenen Eigenschaften applyLocalProjection, removeProjectionWhenComplete, autoCenterProjection, fieldOfView, focalLength, projectionX und projectionY gemeinsam genutzte Eigenschaften. Legen Sie diese Eigenschaften ebenso auf allen 3D-Effekten fest, die zu einem zusammengesetzten Effekt kombiniert werden, um voraussehbare Ergebnisse zu erhalten.

MXML-Syntax expanded

MXML-Syntax ausblenden

The <s:AnimateTransform> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <s:AnimateTransform
    Properties
    id="ID"
    applyChangesPostLayout="true"
    applyLocalProjection="false"
    autoCenterProjection="true"
    fieldOfView="no default"
    focalLength="no default"
    projectionX="0"
    projectionY="0"
    removeLocalProjectionWhenComplete="false"
  />

Standard-MXML-EigenschaftmotionPaths

Verwandte API-Elemente

spark.effects.supportClasses.AnimateTransformInstance

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		applyChangesPostLayout : Boolean [override] Von den Unterklassen von AnimateTransform verwendet, um anzugeben, ob der Effekt die vom Layoutmanager verwendeten Transformationswerte ändert, oder ob er die nach der Ausführung des Layouts verwendeten Werte ändert.	AnimateTransform3D
		applyLocalProjection : Boolean Wenn „true“, erstellt der Effekt eine perspektivische Projektion. Dabei werden die anderen projektionsbezogenen Eigenschaften des Effekts verwendet und auf das übergeordnete Objekt der Zielkomponente beim Abspielstart angewendet.	AnimateTransform3D
		autoCenterProjection : Boolean = true Setzen Sie den Wert auf „false“, um die Funktion zu deaktivieren, dass ein 3D-Effekt den Projektionspunkt automatisch auf die Mitte des Ziels festlegt.	AnimateTransform3D
		autoCenterTransform : Boolean = false Gibt an, ob der Transformationseffekt um die Mitte des Ziels (Breite/2, Höhe/2) herum auftritt, wenn die Wiedergabe des Effekts beginnt.	AnimateTransform
		className : String [schreibgeschützt] Name der Effektklasse wie „Fade“.	Effect
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		customFilter : mx.effects:EffectTargetFilter Gibt ein benutzerdefiniertes Filterobjekt des Typs EffectTargetFilter an, das zur Ermittlung der Ziele dient, bei denen der Effekt wiedergegeben wird.	Effect
		disableLayout : Boolean Wenn der Wert „true“ ist, wird durch den Effekt das Layout auf den übergeordneten Containern der Ziele deaktiviert, indem die autoLayout-Eigenschaft der Container auf „false“ gesetzt wird, und alle Layoutbeschränkungen auf Zielobjekten werden deaktivert.	Animate
		duration : Number Dauer des Effekts in Millisekunden.	Effect
		easer : IEaser Das Beschleunigungsverhalten für diesen Effekt.	Animate
		effectTargetHost : mx.effects:IEffectTargetHost Eine Eigenschaft, die Ihnen den Zugriff auf listenbasierte Zielsteuerelemente eines Dateneffekts ermöglicht.	Effect
		fieldOfView : Number Legt einen Winkel für das dreidimensionale Blickfeld als Gradwert zwischen 0 und 180 fest.	AnimateTransform3D
		filter : String Gibt einen Algorithmus zum Filtern der Ziele für einen Effekt an.	Effect
		focalLength : Number Der Abstand zwischen dem Auge oder dem Ursprung des Blickpunkts (0,0,0) und dem auf der z-Achse liegenden Anzeigeobjekt.	AnimateTransform3D
		hideFocusRing : Boolean Bestimmt, ob der Effekt den Fokusring beim Start ausblenden soll.	Effect
		instanceClass : Class Ein Objekt der type-Klasse, das die Effektinstanzklasse für diese Effektklasse angibt.	Effect
		interpolator : IInterpolator Der Interpolator, der von diesem Effekt verwendet wird, um Werte zwischen den Anfangs- und Endwerten einer Eigenschaft zu berechnen.	Animate
		isPlaying : Boolean [schreibgeschützt] Ein Flag für den Schreibschutz, das auf „true“ gesetzt ist, wenn Instanzen des Effekts aktuell wiedergegeben werden, und andernfalls auf „false“.	Effect
		motionPaths : Vector.<MotionPath> Ein Vektor von MotionPath-Objekten, die alle den Namen einer zu animierenden Eigenschaft und die während der Animation von der Eigenschaft verwendeten Werte enthalten.	Animate
		perElementOffset : Number Zusätzliche Verzögerung (in Millisekunden) für Effektziele nach dem ersten Ziel des Effekts.	Effect
		playheadTime : Number Aktuelle Zeitposition des Effekts.	Effect
		projectionX : Number = 0 Legt den Projektionspunkt als Offset des Projektionspunkts in der x-Richtung von der Koordinate (0, 0) des Ziels fest.	AnimateTransform3D
		projectionY : Number = 0 Legt den Projektionspunkt als Offset des Projektionspunkts in der y-Richtung von der Koordinate (0, 0) des Ziels fest.	AnimateTransform3D
		relevantProperties : Array Ein Array von Eigenschaftsnamen zur Verwendung beim Filtern.	Effect
		relevantStyles : Array Ein Array von Stilnamen zur Verwendung beim Filtern.	Effect
		removeLocalProjectionWhenComplete : Boolean = false Wenn der Wert „true“ ist, entfernt der Effekt die perspektivische Projektion aus dem übergeordneten Element der Zielkomponente, nachdem die Wiedergabe abgeschlossen ist.	AnimateTransform3D
		startDelay : int = 0 Wartezeit in Millisekunden vor dem Starten des Effekts.	Effect
		target : Object Das Objekt, auf das dieser Effekt angewendet wird.	Effect
		targets : Array Ein Array von Objekten, die als Ziele des Effekts verwendet werden können.	Effect
		transformX : Number Legt die x-Koordinate für die Transformationsmitte fest, es sei denn, sie wird von der autoCenterTransform-Eigenschaft überschrieben.	AnimateTransform
		transformY : Number Legt die y-Koordinate für die Transformationsmitte fest, es sei denn sie wird von der autoCenterTransform-Eigenschaft überschrieben.	AnimateTransform
		transformZ : Number Legt die z-Koordinate für die Transformationsmitte fest, es sei denn sie wird von der autoCenterTransform-Eigenschaft überschrieben.	AnimateTransform
		triggerEvent : Event Der EffectManager übergibt diesem Effekt das Ereignisobjekt, wenn ein Effekt ausgelöst wird, oder null, wenn der Effekt nicht vom EffectManager wiedergegeben wird.	Effect

Geschützte Eigenschaften

Vererbte geschützte Eigenschaften ausblenden

Vererbte geschützte Eigenschaften anzeigen

	Eigenschaft		Definiert von
		applyTransitionEndProperties : Boolean Dieses Flag steuert, ob der Effekt, wenn er in einem Übergang ausgeführt wird, automatisch die Eigenschaftswerte des Endstatus anwendet, statt die durch den Effekt eingestellten Werte beizubehalten.	Effect
		endValuesCaptured : Boolean = false Wenn dieses Flag auf „true“ gesetzt ist, wurden die Werte eines Effekts bereits bestimmt. Bei „false“ werden die Werte beim Ausführen des Effekts aus den aktuellen Eigenschaften der Effektziele übernommen.	Effect

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		AnimateTransform3D(target:Object = null) Konstruktor.	AnimateTransform3D
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.	EventDispatcher
		captureEndValues():void Erfasst die aktuellen Werte der relevanten Eigenschaften der Ziele des Effekts und speichert sie als Endwerte.	Effect
		captureMoreStartValues(targets:Array):void Erfasst die aktuellen Werte der relevanten Eigenschaften eines zusätzlichen Zielsatzes. Flex verwendet diese Funktion, wenn ein Datenänderungseffekt ausgeführt wird.	Effect
		captureStartValues():void Erfasst die aktuellen Werte der relevanten Eigenschaften der Ziele des Effekts.	Effect
		createInstance(target:Object = null):IEffectInstance Erstellt eine einzelne Effektinstanz und initialisiert sie.	Effect
		createInstances(targets:Array = null):Array Verwendet ein Array von Zielobjekten und ruft die createInstance()-Methode auf jedem Ziel auf.	Effect
		deleteInstance(instance:IEffectInstance):void Entfernt Ereignis-Listener von einer Instanz und entfernt sie aus der Liste der Instanzen.	Effect
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	EventDispatcher
		end(effectInstance:IEffectInstance = null):void Unterbricht einen aktuell wiedergegebenen Effekt und springt sofort zum Ende des Effekts.	Effect
		getAffectedProperties():Array Gibt ein Array von Strings zurück, wobei jeder String dem Namen einer Eigenschaft entspricht, die von diesem Effekt geändert wird.	Effect
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	EventDispatcher
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		pause():void Hält den Effekt an, bis die resume()-Methode aufgerufen wird.	Effect
		play(targets:Array = null, playReversedFromEnd:Boolean = false):Array Startet die Wiedergabe des Effekts.	Effect
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	EventDispatcher
		resume():void Setzt den Effekt fort, nachdem er durch Aufrufen der pause()-Methode vorübergehend unterbrochen wurde.	Effect
		reverse():void Gibt den aktuell wiedergegebenen Effekt rückwärts wieder und beginnt dabei an der aktuellen Position des Effekts.	Effect
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		stop():void Hält den Effekt an und behält den aktuellen Status der Effektziele bei.	Effect
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object
		willTrigger(type:String):Boolean Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.	EventDispatcher

Geschützte Methoden

Vererbte geschützte Methoden ausblenden

Vererbte geschützte Methoden anzeigen

	Methode		Definiert von
		applyValueToTarget(target:Object, property:String, value:*, props:Object):void Wird intern von der Effektinfrastruktur verwendet.	Effect
		effectEndHandler(event:EffectEvent):void Wird aufgerufen, wenn die Wiedergabe einer Effektinstanz abgeschlossen ist.	Effect
		effectStartHandler(event:EffectEvent):void Diese Methode wird aufgerufen, wenn die Wiedergabe der Effektinstanz beginnt.	Effect
		effectStopHandler(event:EffectEvent):void Wird aufgerufen, wenn eine Effektinstanz durch einen Aufruf der stop()-Methode angehalten wurde.	Effect
		filterInstance(propChanges:Array, target:Object):Boolean Bestimmt die Logik zum Filtern einer Effektinstanz.	Effect
		getValueFromTarget(target:Object, property:String):* Wird von der captureStartValues()-Methode aufgerufen, um den Wert einer Eigenschaft des Ziels abzurufen.	Effect
		initInstance(instance:IEffectInstance):void Kopiert Eigenschaften des Effekts in die Effektinstanz.	Effect

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

Vererbte Ereignisse ausblenden

Vererbte Ereignisse anzeigen

	Übersicht	Definiert von
activate	[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.	EventDispatcher
deactivate	[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.	EventDispatcher
effectEnd	Wird ausgelöst, wenn die Wiedergabe einer der Effektinstanzen beendet wurde, da die Instanz das Ende erreicht hatte oder da der Effekt durch den Aufruf der end()-Methode unterbrochen wurde.	Effect
effectRepeat	Wird ausgelöst, wenn der Effekt eine neue Wiederholung beginnt, und zwar für jeden Effekt, der mehr als einmal wiederholt wird.	Animate
effectStart	Wird ausgelöst, wenn die Wiedergabe eines Effekts gestartet wird.	Effect
effectStop	Wird ausgelöst, wenn der Effekt angehalten wurde. Dies geschieht nur, wenn der Effekt durch Aufrufen der stop()-Methode unterbrochen wird.	Effect
effectUpdate	Wird jedes Mal ausgelöst, wenn der Effekt das Ziel aktualisiert.	Animate

Eigenschaftendetails

applyChangesPostLayout

Eigenschaft

applyChangesPostLayout:Boolean[override]

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Von den Unterklassen von AnimateTransform verwendet, um anzugeben, ob der Effekt die vom Layoutmanager verwendeten Transformationswerte ändert, oder ob er die nach der Ausführung des Layouts verwendeten Werte ändert. Da das Flex-Layoutsystem 3D-Transformationseigenschaften ignoriert, überschreibt diese Klasse die AnimateTransform.applyChangesPostLayout-Eigenschaft, um den Standardwert für 3D-Effekte auf true zu setzen.

Der Standardwert ist true.

Implementierung
override public function get applyChangesPostLayout():Boolean
override public function set applyChangesPostLayout(value:Boolean):void

applyLocalProjection

Eigenschaft

applyLocalProjection:Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Wenn true, erstellt der Effekt eine perspektivische Projektion. Dabei werden die anderen projektionsbezogenen Eigenschaften des Effekts verwendet und auf das übergeordnete Objekt der Zielkomponente beim Abspielstart angewendet. Standardmäßig verbleibt die Projektion auf dem übergeordneten Objekt, wenn der Effekt beendet ist. Um die Projektion bei Effektende zu entfernen, setzen Sie removeLocalProjectionWhenComplete auf true.

Der Standardwert ist true.

Implementierung
public function get applyLocalProjection():Boolean
public function set applyLocalProjection(value:Boolean):void

Verwandte API-Elemente

removeLocalProjectionWhenComplete

autoCenterProjection

Eigenschaft

public var autoCenterProjection:Boolean = true

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Setzen Sie den Wert auf false, um die Funktion zu deaktivieren, dass ein 3D-Effekt den Projektionspunkt automatisch auf die Mitte des Ziels festlegt. Anschließend verwenden Sie die projectionX- und projectionY-Eigenschaften, um den Projektionspunkt ausdrücklich als Offset des Projektionspunkts von der Koordinate (0, 0) des Ziels festzulegen.

Die 3D-Effekte funktionieren so, dass ein dreidimensionales Bild einer zweidimensionalen Darstellung zur Anzeige auf dem Computerbildschirm zugeordnet wird. Der Projektionspunkt definiert die Mitte des Ansichtsfelds und steuert, wie das Ziel aus drei Dimensionen auf den Bildschirm projiziert wird.

Diese Eigenschaft wird nur verwendet, wenn für applyLocalProjection der Wert true festgelegt ist.

Der Standardwert ist true.

Verwandte API-Elemente

applyLocalProjection

fieldOfView

Eigenschaft

public var fieldOfView:Number

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Legt einen Winkel für das dreidimensionale Blickfeld als Gradwert zwischen 0 und 180 fest. Dieser Wert legt fest, wie stark die perspektivische Transformation und Verzerrung auf ein dreidimensionales Anzeigeobjekt angewendet werden, dessen z-Koordinate nicht null ist.

Ein Wert nahe 0, bedeutet das, dass die zweidimensionalen x- und y-Koordinaten des Bildschirms nahezu dieselben sind wie die dreidimensionalen x-, y- und z-Koordinaten und wenig oder keine Verzerrung auftritt. Anders ausgedrückt bewegt sich ein Anzeigeobjekt bei einem kleinen Winkel nur wenig entlang der z-Achse nach unten und seine Größe scheint sich kaum zu ändern.

Ein Wert nahe 180 Grad führt zu einem Fischaugenobjektiveffekt: Positionen mit einem z-Wert kleiner als 0 werden vergrößert, dagegen werden Positionen mit einem z-Wert größer als 0 verkleinert. Bei einem großen Winkel bewegt sich das Anzeigeobjekt entlang der z-Achse weit nach unten und seine Größe ändert sich rasch. Ist das Sichtfeld auf 0 oder 180 gesetzt, ist auf dem Bildschirm nichts zu sehen.

Diese Eigenschaft wird nur verwendet, wenn für applyLocalProjection der Wert true festgelegt ist.

Verwandte API-Elemente

applyLocalProjection
flash.geom.PerspectiveProjection

focalLength

Eigenschaft

public var focalLength:Number

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Der Abstand zwischen dem Auge oder dem Ursprung des Blickpunkts (0,0,0) und dem auf der z-Achse liegenden Anzeigeobjekt. Während der perspektivischen Transformation wird focalLength dynamisch anhand des Sichtfeldwinkels und des Seitenverhältnisses der Bühne (Bühnenbreite dividiert durch Bühnenhöhe) berechnet.

Diese Eigenschaft wird nur verwendet, wenn für applyLocalProjection der Wert true festgelegt ist.

Verwandte API-Elemente

applyLocalProjection
flash.geom.PerspectiveProjection

projectionX

Eigenschaft

public var projectionX:Number = 0

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Legt den Projektionspunkt als Offset des Projektionspunkts in der x-Richtung von der Koordinate (0, 0) des Ziels fest. Beim Anwenden eines 3D-Effekts legt der Effekt automatisch den Projektionspunkt auf die Mitte des Ziels fest. Sie können die autoCenterProjection-Eigenschaft des Effekts auf false setzen, um diese Standardeinstellung zu deaktivieren und stattdessen die projectionX- und projectionY-Eigenschaften verwenden.

Diese Eigenschaft wird nur verwendet, wenn für applyLocalProjection der Wert true festgelegt ist.

Verwandte API-Elemente

applyLocalProjection

projectionY

Eigenschaft

public var projectionY:Number = 0

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Legt den Projektionspunkt als Offset des Projektionspunkts in der y-Richtung von der Koordinate (0, 0) des Ziels fest. Beim Anwenden eines 3D-Effekts legt der Effekt automatisch den Projektionspunkt auf die Mitte des Ziels fest. Sie können die autoCenterProjection-Eigenschaft des Effekts auf false setzen, um diese Standardeinstellung zu deaktivieren und stattdessen die projectionX- und projectionY-Eigenschaften verwenden.

Diese Eigenschaft wird nur verwendet, wenn für applyLocalProjection der Wert true festgelegt ist.

Verwandte API-Elemente

applyLocalProjection

removeLocalProjectionWhenComplete

Eigenschaft

public var removeLocalProjectionWhenComplete:Boolean = false

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Wenn der Wert true ist, entfernt der Effekt die perspektivische Projektion aus dem übergeordneten Element der Zielkomponente, nachdem die Wiedergabe abgeschlossen ist. Standardmäßig wird die perspektivische Projektion beibehalten.

Diese Eigenschaft wird nur verwendet, wenn für applyLocalProjection der Wert true festgelegt ist.

Der Standardwert ist false.

Verwandte API-Elemente

applyLocalProjection

Konstruktordetails

()

Konstruktor

public function AnimateTransform3D(target:Object = null)

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Konstruktor.

Parameter

target:Object (default = null) — Das Objekt, das mit diesem Effekt animiert wird.

Rechtliche Hinweise | Onlinedatenschutzerklärung

AnimateTransform3D - AS3 Flex

Klassen x

applyChangesPostLayout

applyLocalProjection

autoCenterProjection

fieldOfView

focalLength

projectionX

projectionY

removeLocalProjectionWhenComplete

AnimateTransform3D