Paqueteflash.geom
Clasepublic class ColorTransform
HerenciaColorTransform Inheritance Object
Subclases Color

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

La clase ColorTransform permite ajustar valores de colores en un objeto de visualización. El ajuste de color o transformación de color se puede a los cuatro canales: rojo, verde, azul o transparencia alfa.

Cuando se aplica un objeto ColorTransform a un objeto de visualización, se calcula de este modo un valor nuevo para cada canal de color:

Si alguno de los valores de canales de color es superior a 255 después del cálculo, se establece en 255. Si es inferior a 0, se establece en 0.

Puede utilizar objetos ColorTransform del modo siguiente:

Debe utilizar el constructor new ColorTransform() nuevo para crear un objeto ColorTransform antes de llamar a los métodos del objeto ColorTransform.

Las transformaciones de color no se aplican al color del fondo de un clip de película (como un objeto SWF cargado). Sólo se aplican a gráficos y símbolos asociados al clip de película.

Ver los ejemplos

Véase también

flash.geom.Transform
flash.display.DisplayObject.transform
flash.display.BitmapData.colorTransform()


Propiedades públicas
 PropiedadDefinido por
  alphaMultiplier : Number
Valor decimal que se multiplica por el valor del canal de transparencia alfa.
ColorTransform
  alphaOffset : Number
Número de -255 a 255 que se añade al valor del canal de transparencia alfa después de multiplicarse por el valor de alphaMultiplier.
ColorTransform
  blueMultiplier : Number
Valor decimal que se multiplica por el valor del canal azul.
ColorTransform
  blueOffset : Number
Número de -255 a 255 que se añade al valor del canal azul después de multiplicarse por el valor de blueMultiplier.
ColorTransform
  color : uint
Valor del color RVA de un objeto ColorTransform.
ColorTransform
 Inheritedconstructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
Object
  greenMultiplier : Number
Valor decimal que se multiplica por el valor del canal verde.
ColorTransform
  greenOffset : Number
Número de -255 a 255 que se añade al valor del canal verde después de multiplicarse por el valor de greenMultiplier.
ColorTransform
 Inheritedprototype : Object
[static] Una referencia al objeto prototipo de una clase u objeto de función.
Object
  redMultiplier : Number
Valor decimal que se multiplica por el valor del canal rojo.
ColorTransform
  redOffset : Number
Número de -255 a 255 que se añade al valor del canal rojo después de multiplicarse por el valor de redMultiplier.
ColorTransform
Métodos públicos
 MétodoDefinido por
  
ColorTransform(redMultiplier:Number = 1.0, greenMultiplier:Number = 1.0, blueMultiplier:Number = 1.0, alphaMultiplier:Number = 1.0, redOffset:Number = 0, greenOffset:Number = 0, blueOffset:Number = 0, alphaOffset:Number = 0)
Crea un objeto ColorTransform para un objeto de visualización con los valores de canales de color y alfa especificados.
ColorTransform
  
Concatena el objeto ColorTransform especificado por el parámetro second con el objeto ColorTransform actual y establece el objeto actual como resultado, lo que supone una combinación aditiva de las dos conversiones de color.
ColorTransform
 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
  
Formatea y devuelve una cadena que describe todas las propiedades del objeto ColorTransform.
ColorTransform
 Inherited
Devuelve el valor simple del objeto especificado.
Object
Información sobre propiedades
alphaMultiplierpropiedad
public var alphaMultiplier:Number

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Valor decimal que se multiplica por el valor del canal de transparencia alfa.

Si establece el valor de transparencia alfa de un objeto de visualización utilizando directamente la propiedad alpha de la instancia DisplayObject, afectará al valor de la propiedad alphaMultiplier de la propiedad transform.colorTransform de dicho objeto de visualización.

Véase también

alphaOffsetpropiedad 
public var alphaOffset:Number

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Número de -255 a 255 que se añade al valor del canal de transparencia alfa después de multiplicarse por el valor de alphaMultiplier.

blueMultiplierpropiedad 
public var blueMultiplier:Number

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Valor decimal que se multiplica por el valor del canal azul.

blueOffsetpropiedad 
public var blueOffset:Number

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Número de -255 a 255 que se añade al valor del canal azul después de multiplicarse por el valor de blueMultiplier.

colorpropiedad 
color:uint  [read-write]

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Valor del color RVA de un objeto ColorTransform.

Cuando define esta propiedad, cambia en consecuencia los tres valores de desplazamiento de color (redOffset, greenOffset y blueOffset) y define los tres valores de multiplicador de color (redMultiplier, greenMultiplier y blueMultiplier) como 0. El multiplicador y los valores de desplazamiento de alfa no se modifican.

Al pasar un valor para esta propiedad, utilice el formato 0xRRGGBB. RR, GG y BB constan cada uno de dos dígitos hexadecimales que especifican el desplazamiento de cada componente de color. El 0x indica al compilador de ActionScript que el número es un valor hexadecimal.


Implementación
    public function get color():uint
    public function set color(value:uint):void
greenMultiplierpropiedad 
public var greenMultiplier:Number

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Valor decimal que se multiplica por el valor del canal verde.

greenOffsetpropiedad 
public var greenOffset:Number

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Número de -255 a 255 que se añade al valor del canal verde después de multiplicarse por el valor de greenMultiplier.

redMultiplierpropiedad 
public var redMultiplier:Number

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Valor decimal que se multiplica por el valor del canal rojo.

redOffsetpropiedad 
public var redOffset:Number

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Número de -255 a 255 que se añade al valor del canal rojo después de multiplicarse por el valor de redMultiplier.

Información sobre constructores
ColorTransform()constructor
public function ColorTransform(redMultiplier:Number = 1.0, greenMultiplier:Number = 1.0, blueMultiplier:Number = 1.0, alphaMultiplier:Number = 1.0, redOffset:Number = 0, greenOffset:Number = 0, blueOffset:Number = 0, alphaOffset:Number = 0)

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Crea un objeto ColorTransform para un objeto de visualización con los valores de canales de color y alfa especificados.

Parámetros
redMultiplier:Number (default = 1.0) — El valor del multiplicador rojo, en el rango de 0 a 1.
 
greenMultiplier:Number (default = 1.0) — El valor del multiplicador verde, en el rango de 0 a 1.
 
blueMultiplier:Number (default = 1.0) — El valor del multiplicador azul, en el rango de 0 a 1.
 
alphaMultiplier:Number (default = 1.0) — El valor del multiplicador de transparencia alfa, en el rango de 0 a 1.
 
redOffset:Number (default = 0) — El valor del desplazamiento del canal de color rojo, en el rango de -255 a 255.
 
greenOffset:Number (default = 0) — El valor del desplazamiento del canal de color verde, en el rango de -255 a 255.
 
blueOffset:Number (default = 0) — El valor del desplazamiento del canal de color azul, en el rango de -255 a 255.
 
alphaOffset:Number (default = 0) — El desplazamiento del valor del canal de transparencia alfa, en el rango de 0 a 255.
Información sobre métodos
concat()método
public function concat(second:ColorTransform):void

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Concatena el objeto ColorTransform especificado por el parámetro second con el objeto ColorTransform actual y establece el objeto actual como resultado, lo que supone una combinación aditiva de las dos conversiones de color. Al aplicar el objeto ColorTransform concatenado, el efecto es el mismo que al aplicar la transformación de color second después de la transformación de color original.

Parámetros

second:ColorTransform — El objeto ColorTransform para combinarlo con el objeto ColorTransform actual.

toString()método 
public function toString():String

Versión del lenguaje: ActionScript 3.0
Versión del reproductor: Flash Player 9

Formatea y devuelve una cadena que describe todas las propiedades del objeto ColorTransform.

Valor devuelto
String — Una cadena que muestra todas las propiedades del objeto ColorTransform.
Ejemplos Cómo utilizar los ejemplos
ColorTransformExample.as

En el ejemplo siguiente, se utiliza la clase TransformExample para crear un elemento sprite simple 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 los colores del elemento sprite cuadrado, añadiendo el canal del color rojo y suavizando el canal del color azul. Esto se consigue con los pasos siguientes:
  1. El constructor crea un nuevo objeto sprite target.
  2. El constructor CustomButton() llama al método draw(), que dibuja un cuadrado con degradado en el elemento sprite.
  3. El constructor CustomButton() añade un detector de eventos click para el elemento sprite, que se controla con el método clickHandler().
  4. En el método clickHandler(), se definen dos propiedades como las propiedades redOffset y blueOffset de la transformación de color actual. Cada una se ajusta en 25. Posteriormente, la propiedad transform.colorTransform del elemento sprite cuadrado se modifica para utilizar los nuevos valores de desplazamiento. Cada vez que el usuario hace clic en el cuadrado, la llamada al método clickHandler() modifica el color del cuadrado, aumentando su valor de color rojo y reduciendo su valor de color azul.
package {
    import flash.display.Sprite;
    import flash.display.GradientType;
    import flash.geom.ColorTransform;
    import flash.events.MouseEvent;

    public class ColorTransformExample extends Sprite {
        public function ColorTransformExample() {
            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 rOffset:Number = transform.colorTransform.redOffset + 25;
            var bOffset:Number = transform.colorTransform.redOffset - 25;
            this.transform.colorTransform = new ColorTransform(1, 1, 1, 1, rOffset, 0, bOffset, 0);
        }
    }
}    




 

Enviarme un mensaje de correo electrónico cuando se añadan comentarios a esta página | Informe de comentarios

Página actual: http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/flash/geom/ColorTransform.html