Referencia de ActionScript® 3.0 para la plataforma de Adobe® Flash®
Inicio  |  Ocultar lista de paquetes y clases |  Paquetes  |  Clases  |  Novedades  |  Índice  |  Apéndices  |  ¿Por qué hay texto en inglés?
Filtros: Recuperando datos del servidor...
Recuperando datos del servidor...
flash.geom 

Transform  - AS3

Paqueteflash.geom
Clasepublic class Transform
HerenciaTransform Inheritance Object
Subclases Transform

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

La clase Transform proporciona acceso a las propiedades de ajuste de color y a los objetos de transformación bidimensionales o tridimensionales que se pueden aplicar a un objeto de visualización. Durante la transformación, el color o la orientación y posición de un objeto de visualización se ajusta (desplaza) desde los valores o las coordenadas actuales a los nuevos valores o coordenadas. La clase Transform también recopila datos sobre el color y las transformaciones de matriz bidimensionales que se aplican a un objeto de visualización y a todos sus objetos secundarios. Se puede acceder a estas transformaciones combinadas a través de las propiedades concatenatedColorTransform y concatenatedMatrix.

Para aplicar transformaciones de color, cree un objeto ColorTransform, establezca los ajustes de color mediante los métodos y las propiedades del objeto y, a continuación, asigne la propiedad colorTransformation de la propiedad transform del objeto de visualización al nuevo objeto ColorTransformation.

Para aplicar transformaciones bidimensionales, cree un objeto Matrix, establezca la transformación bidimensional de la matriz y, a continuación, asigne la propiedad transform.matrix del objeto de visualización al nuevo objeto Matrix.

Para aplicar transformaciones tridimensionales, comience con un objeto de visualización tridimensional. Un objeto de visualización tridimensional tiene un valor de la propiedad z distinto a cero. No es necesario crear el objeto Matrix3D. Para todos los objetos tridimensionales, al asignar un valor z a un objeto de visualización, se crea automáticamente un objeto Matrix3D. Puede acceder al objeto Matrix3D del objeto de visualización a través de la propiedad transform de este último. Mediante los métodos de la clase Matrix3D, puede añadir o modificar los parámetros de configuración de la transformación existente. También puede crear un objeto Matrix3D personalizado, establecer los elementos de transformación de dicho objeto y asignar el nuevo objeto Matrix3D al objeto de visualización mediante la propiedad transform.matrix.

Para modificar una proyección de perspectiva del objeto escenario o raíz, utilice la propiedad transform.matrix del objeto de visualización raíz para tener acceso al objeto PerspectiveProjection. O bien, aplique unas propiedades de proyección de perspectiva diferentes a un objeto de visualización mediante la definición de las propiedades de proyección de perspectiva del elemento principal del objeto de visualización. El objeto de visualización secundario heredará las nuevas propiedades. Específicamente, cree un objeto PerspectiveProjection y establezca sus propiedades. A continuación, asígnelo a la propiedad perspectiveProjection de la propiedad transform del objeto de visualización principal. La transformación de la proyección especificada se aplica a todos los elementos secundarios tridimensionales del objeto de visualización.

Como los objetos PerspectiveProjection y Matrix3D realizan transformaciones de perspectiva, no asigne ambos a un objeto de visualización a la vez. Utilice el objeto PerspectiveProjection para realizar cambios en la distancia focal y el centro de la proyección. Para conseguir mayor control sobre la transformación de perspectiva, cree un objeto Matrix3D de proyección de perspectiva.

Ver los ejemplos

Elementos de API relacionados



Propiedades públicas
 PropiedadDefinido por
  colorTransform : flash.geom:ColorTransform
Objeto ColorTransform que contiene valores que ajustan globalmente los colores en el objeto de visualización.
Transform
  concatenatedColorTransform : flash.geom:ColorTransform
[solo lectura] Objeto ColorTransform que representa las transformaciones de color aplicadas al objeto de visualización y todas las de sus objetos principales hasta el nivel de la raíz, combinadas.
Transform
  concatenatedMatrix : Matrix
[solo lectura] Objeto Matrix que representa las matrices de transformación aplicadas al objeto de visualización y todas las de sus objetos principales hasta el nivel de la raíz, combinadas.
Transform
 Inheritedconstructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
Object
  matrix : Matrix
Objeto Matrix que contiene valores que modifican la escala, rotación y traslación del objeto de visualización.
Transform
  matrix3D : Matrix3D
Proporciona acceso al objeto Matrix3D de un objeto de visualización tridimensional.
Transform
  perspectiveProjection : PerspectiveProjection
Proporciona acceso al objeto PerspectiveProjection de un objeto de visualización tridimensional.
Transform
  pixelBounds : Rectangle
[solo lectura] Un objeto Rectangle que define el rectángulo de delimitación del objeto de visualización en el escenario.
Transform
Métodos públicos
 MétodoDefinido por
  
Devuelve un objeto Matrix3D, que puede transformar el espacio de un objeto de visualización especificado en relación al espacio del objeto de visualización actual.
Transform
 Inherited
Indica si un objeto tiene definida una propiedad especificada.
Object
 Inherited
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.
Object
 Inherited
Indica si existe la propiedad especificada y si es enumerable.
Object
 Inherited
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
Object
 Inherited
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional.
Object
 Inherited
Devuelve la representación de cadena del objeto especificado.
Object
 Inherited
Devuelve el valor simple del objeto especificado.
Object
Información sobre propiedades

colorTransform

propiedad
colorTransform:flash.geom:ColorTransform

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Objeto ColorTransform que contiene valores que ajustan globalmente los colores en el objeto de visualización.



Implementación
    public function get colorTransform():flash.geom:ColorTransform
    public function set colorTransform(value:flash.geom:ColorTransform):void

Emite
TypeError — El objeto colorTransform es null cuando se define

Elementos de API relacionados

concatenatedColorTransform

propiedad 
concatenatedColorTransform:flash.geom:ColorTransform  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Objeto ColorTransform que representa las transformaciones de color aplicadas al objeto de visualización y todas las de sus objetos principales hasta el nivel de la raíz, combinadas. Si se han aplicado transformaciones de color diferentes en niveles distintos, para esta propiedad se concatenarán todas en un objeto ColorTransform.



Implementación
    public function get concatenatedColorTransform():flash.geom:ColorTransform

Elementos de API relacionados

concatenatedMatrix

propiedad 
concatenatedMatrix:Matrix  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Objeto Matrix que representa las matrices de transformación aplicadas al objeto de visualización y todas las de sus objetos principales hasta el nivel de la raíz, combinadas. Si se han aplicado matrices de transformación diferentes en niveles distintos, para esta propiedad se concatenarán todas en un objeto Matrix. Asimismo, para contenido SWF que pueda cambiar de tamaño y que se ejecute en un navegador, esta propiedad influye en la diferencia entre las coordenadas del escenario y las de la ventana, debido al cambio de tamaño. De este modo, la propiedad convierte las coordenadas locales en coordenadas de ventana, que pueden no coincidir con las del espacio de coordenadas del escenario.



Implementación
    public function get concatenatedMatrix():Matrix

matrix

propiedad 
matrix:Matrix

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Objeto Matrix que contiene valores que modifican la escala, rotación y traslación del objeto de visualización.

Si la propiedad matrix se establece en un valor (no null), la propiedad matrix3D es null. Si la propiedad matrix3D se establece en un valor (no null), la propiedad matrix es null.



Implementación
    public function get matrix():Matrix
    public function set matrix(value:Matrix):void

Emite
TypeError — La matriz es null cuando se define

Elementos de API relacionados

matrix3D

propiedad 
matrix3D:Matrix3D

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10, AIR 1.5

Proporciona acceso al objeto Matrix3D de un objeto de visualización tridimensional. El objeto Matrix3D representa una matriz de transformación que determina la posición y orientación del objeto de visualización. Un objeto Matrix3D también puede realizar una proyección de perspectiva.

Si la propiedad matrix se establece en un valor (no null), la propiedad matrix3D es null. Si la propiedad matrix3D se establece en un valor (no null), la propiedad matrix es null.



Implementación
    public function get matrix3D():Matrix3D
    public function set matrix3D(value:Matrix3D):void

Elementos de API relacionados

perspectiveProjection

propiedad 
perspectiveProjection:PerspectiveProjection

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10, AIR 1.5

Proporciona acceso al objeto PerspectiveProjection de un objeto de visualización tridimensional. El objeto PerspectiveProjection se puede utilizar para modificar la transformación de perspectiva del escenario o para asignar una transformación de perspectiva a todos los elementos secundarios tridimensionales de un objeto de visualización.

Según el campo de vista y la proporción (dimensiones) del escenario, se asigna un objeto PerspectiveProjection predeterminado al objeto raíz.



Implementación
    public function get perspectiveProjection():PerspectiveProjection
    public function set perspectiveProjection(value:PerspectiveProjection):void

Elementos de API relacionados

pixelBounds

propiedad 
pixelBounds:Rectangle  [solo lectura]

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: AIR 1.0, Flash Player 9, Flash Lite 4

Un objeto Rectangle que define el rectángulo de delimitación del objeto de visualización en el escenario.



Implementación
    public function get pixelBounds():Rectangle
Información sobre métodos

getRelativeMatrix3D

()método
public function getRelativeMatrix3D(relativeTo:DisplayObject):Matrix3D

Versión del lenguaje: ActionScript 3.0
Versiones de motor de ejecución: Flash Player 10, AIR 1.5

Devuelve un objeto Matrix3D, que puede transformar el espacio de un objeto de visualización especificado en relación al espacio del objeto de visualización actual. Puede utilizar el método getRelativeMatrix3D() para mover un objeto de visualización tridimensional relativo a otro.

Parámetros

relativeTo:DisplayObject — El objeto de visualización en relación al cual se realiza la transformación. Para obtener un objeto Matrix3D relativo al escenario, establezca el parámetro en el objeto root o stage. Para obtener la matriz relativa al mundo del objeto de visualización, establezca el parámetro en un objeto de visualización que tenga una transformación de perspectiva aplicada.

Valor devuelto
Matrix3D — Se puede utilizar un objeto Matrix3D para transformar el espacio del objeto de visualización relativeTo en el espacio del objeto de visualización actual.

Elementos de API relacionados

TransformExample.as

En el ejemplo siguiente, se utiliza la clase TransformExample para sesgar la parte inferior de un elemento sprite cuadrado con la forma de un cuadrado relleno con un patrón de degradado. Cada vez que el usuario hace clic en el cuadrado, la aplicación transforma el elemento sprite sesgándolo con los pasos siguientes:
  1. El constructor TransformExample() crea un nuevo objeto sprite target.
  2. El constructor TransformExample() llama al método draw(), que dibuja un cuadrado con degradado en el elemento sprite.
  3. El constructor TransformExample() añade un detector de eventos click para el elemento sprite, que se controla con el método clickHandler().
  4. El método clickHandler() crea un nuevo objeto Matrix, skewMatrix, que se define para aplicar un efecto de sesgo. Otro objeto Matrix, tempMatrix, se asigna a la matriz de transformación actual del elemento sprite y, a continuación, se combina con skewMatrix utilizando el método concat(). Esta matriz se asigna a la propiedad transform.matrix del elemento sprite cuadrado. Cada vez que el usuario hace clic en el cuadrado, la llamada a clickHandler() modifica la forma del cuadrado, sesgándola.
  5. Asimismo, el método clickHandler() crea un nuevo objeto ColorTransform. La propiedad redOffset del nuevo objeto ColorTransform se define con el valor actual de redOffset y se incrementa en 25. Del mismo modo, la propiedad blueOffset se reduce en 25. Con cada clic, los colores del elemento sprite cambian.
package {
    import flash.display.Sprite;
    import flash.display.GradientType;
    import flash.geom.Matrix;
    import flash.geom.ColorTransform;
    import flash.events.MouseEvent;

    public class TransformExample extends Sprite {
        public function TransformExample() { 
            var target:Sprite = new Sprite();
            draw(target);
            addChild(target);
            target.useHandCursor = true;
            target.buttonMode = true;
            target.addEventListener(MouseEvent.CLICK, clickHandler)
        }
        public function draw(sprite:Sprite):void {
            var red:uint = 0xFF0000;
            var green:uint = 0x00FF00;
            var blue:uint = 0x0000FF;
            var size:Number = 100;
            sprite.graphics.beginGradientFill(GradientType.LINEAR, [red, blue, green], [1, 0.5, 1], [0, 200, 255]);
            sprite.graphics.drawRect(0, 0, 100, 100);
        }
        public function clickHandler(event:MouseEvent):void {
            var skewMatrix:Matrix = new Matrix();
            skewMatrix.c = 0.25;
            var tempMatrix:Matrix = this.transform.matrix;
            tempMatrix.concat(skewMatrix);
            this.transform.matrix = tempMatrix;
            
            var rOffset:Number = this.transform.colorTransform.redOffset + 25;
            var bOffset:Number = this.transform.colorTransform.blueOffset - 25;
            this.transform.colorTransform = new ColorTransform(1, 1, 1, 1, rOffset, 0, bOffset, 0);            
        }
    }
}




[ X ]¿Por qué hay texto en inglés?
Cierto contenido de la Referencia de ActionScript 3.0 se muestra en inglés

No todo el contenido de la Referencia de ActionScript 3.0 se traduce a todos los idiomas. Si un elemento del lenguaje no se traduce, aparecerá en inglés. Por ejemplo, la clase ga.controls.HelpBox no está traducida en ningún idioma. Por lo tanto, en la versión en español de la referencia, la clase ga.controls.HelpBox aparecerá en inglés.