mx.geom.Transform - Adobe® Flex® 4 Language Reference (Flex 4)

Package	mx.geom
Class	public class Transform
Inheritance	Transform Transform Object

Language Version:

ActionScript 3.0

Product Version:

Flex 4

Runtime Versions:

Flash Player 10, AIR 1.5

The mx.geom.Transform class adds synchronization support on top of the flash.geom.Transform class. The class has a target property which is the IVisualElement that the Transform has been assigned to. The IVisualElement implementations will typically set the target to themselves when the Transform is assigned to their transform property. Changes to the Transform properties automatically get pushed to the target. Reading from the Transform properties reads directly from the target's transform.

See also

Using MXML graphics

Public Properties

Hide Inherited Public Properties

Show Inherited Public Properties

	Property		Defined By
		colorTransform : flash.geom:ColorTransform A ColorTransform object containing values that universally adjust the colors in the display object.	Transform
		concatenatedColorTransform : flash.geom:ColorTransform [read-only] A ColorTransform object representing the combined color transformations applied to the display object and all of its parent objects, back to the root level.	Transform
		concatenatedMatrix : Matrix [read-only] A Matrix object representing the combined transformation matrixes of the display object and all of its parent objects, back to the root level.	Transform
		constructor : Object A reference to the class object or constructor function for a given object instance.	Object
		matrix : Matrix A Matrix object containing values that alter the scaling, rotation, and translation of the display object.	Transform
		matrix3D : Matrix3D [override] Provides access to the Matrix3D object of a three-dimensional display object.	Transform
		perspectiveProjection : PerspectiveProjection Provides access to the PerspectiveProjection object of a three-dimensional display object.	Transform
		pixelBounds : Rectangle [read-only] A Rectangle object that defines the bounding rectangle of the display object on the stage.	Transform
		prototype : Object [static] A reference to the prototype object of a class or function object.	Object
		target : IVisualElement The IVisualElement with which the Transform will keep in synch.	Transform

Public Methods

Hide Inherited Public Methods

Show Inherited Public Methods

	Method		Defined By
		Transform(src:DisplayObject = null) Constructor.	Transform
		getRelativeMatrix3D(relativeTo:DisplayObject):Matrix3D [override] Returns a Matrix3D object, which can transform the space of a specified display object in relation to the current display object's space.	Transform
		hasOwnProperty(name:String):Boolean Indicates whether an object has a specified property defined.	Object
		isPrototypeOf(theClass:Object):Boolean Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.	Object
		propertyIsEnumerable(name:String):Boolean Indicates whether the specified property exists and is enumerable.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Sets the availability of a dynamic property for loop operations.	Object
		toLocaleString():String Returns the string representation of this object, formatted according to locale-specific conventions.	Object
		toString():String Returns the string representation of the specified object.	Object
		valueOf():Object Returns the primitive value of the specified object.	Object

Property Detail

matrix3D

property

matrix3D:Matrix3D[override]

Provides access to the Matrix3D object of a three-dimensional display object. The Matrix3D object represents a transformation matrix that determines the display object's position and orientation. A Matrix3D object can also perform perspective projection.

If the matrix property is set to a value (not null), the matrix3D property is null. And if the matrix3D property is set to a value (not null), the matrix property is null.

Implementation
override public function get matrix3D():Matrix3D
override public function set matrix3D(value:Matrix3D):void

target

property

target:IVisualElement

Language Version:

ActionScript 3.0

Product Version:

Flex 4

Runtime Versions:

Flash Player 10, AIR 1.5

The IVisualElement with which the Transform will keep in synch. The IVisualElement implementations will typically set the target to themselves when the Transform is assigned to their transform property.

Implementation
public function get target():IVisualElement
public function set target(value:IVisualElement):void

Constructor Detail

Transform

()

Constructor

public function Transform(src:DisplayObject = null)

Language Version:

ActionScript 3.0

Product Version:

Flex 4

Runtime Versions:

Flash Player 10, AIR 1.5

Constructor.

Parameters

src:DisplayObject (default = null)

Method Detail

getRelativeMatrix3D

()

method

override public function getRelativeMatrix3D(relativeTo:DisplayObject):Matrix3D

Returns a Matrix3D object, which can transform the space of a specified display object in relation to the current display object's space. You can use the getRelativeMatrix3D() method to move one three-dimensional display object relative to another three-dimensional display object.

Parameters

relativeTo:DisplayObject — The display object relative to which the transformation occurs. To get a Matrix3D object relative to the stage, set the parameter to the root or stage object. To get the world-relative matrix of the display object, set the parameter to a display object that has a perspective transformation applied to it.

Returns

Matrix3D — A Matrix3D object that can be used to transform the space from the relativeTo display object to the current display object space.