Paketflash.geom
Klassepublic class ColorTransform
VererbungColorTransform Inheritance Object
Unterklassen Color

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Mit der ColorTransform-Klasse können Sie die Farbwerte in einem Anzeigeobjekt ändern. Die auch als Farbtransformation bezeichnete Farbanpassungsfunktion kann auf alle vier Kanäle angewendet werden: Rot, Grün, Blau oder Alpha-Transparenz.

Wenn ein ColorTransform-Objekt auf ein Anzeigeobjekt angewendet wird, wird der neue Wert der einzelnen Farbkanäle folgendermaßen berechnet:

Wenn einer der Farbkanalwerte nach der Berechnung größer als 255 ist, wird er auf 255 gesetzt. Wenn ein Wert kleiner 0 ist, wird er auf 0 gesetzt.

Sie können ColorTransform-Objekte folgendermaßen verwenden:

Bevor Sie die Methoden des ColorTransform-Objekts aufrufen können, müssen Sie zuerst ein ColorTransform-Objekt mithilfe des new ColorTransform()-Konstruktors erstellen.

Farbtransformationen können nicht auf die Hintergrundfarbe eines Movieclips (z. B. eines geladenen SWF-Objekts) angewendet werden. Sie gelten nur für Grafiken und Symbole, die mit dem Movieclip verknüpft sind.

Beispiele anzeigen

Siehe auch

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


Öffentliche Eigenschaften
 EigenschaftDefiniert von
  alphaMultiplier : Number
Ein Dezimalwert, der mit dem Wert des Alphatransparenzkanals multipliziert wird.
ColorTransform
  alphaOffset : Number
Eine Zahl zwischen -255 und 255, die zum Alphakanalwert addiert wird, nachdem dieser mit dem "alphaMultiplier"-Wert multipliziert wurde.
ColorTransform
  blueMultiplier : Number
Ein Dezimalwert, der mit dem Wert des Blaukanals multipliziert wird.
ColorTransform
  blueOffset : Number
Eine Zahl zwischen -255 und 255, die zum Blau-Kanalwert addiert wird, nachdem dieser mit dem "blueMultiplier"-Wert multipliziert wurde.
ColorTransform
  color : uint
Der RGB-Farbwert eines ColorTransform-Objekts.
ColorTransform
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  greenMultiplier : Number
Ein Dezimalwert, der mit dem Wert des Grünkanals multipliziert wird.
ColorTransform
  greenOffset : Number
Eine Zahl zwischen -255 und 255, die zum Grün-Kanalwert addiert wird, nachdem dieser mit dem "greenMultiplier"-Wert multipliziert wurde.
ColorTransform
 Inheritedprototype : Object
[static] Ein Verweis auf das Prototypobjekt einer Klasse oder eines Funktionsobjekts.
Object
  redMultiplier : Number
Ein Dezimalwert, der mit dem Wert des Rotkanals multipliziert wird.
ColorTransform
  redOffset : Number
Eine Zahl zwischen -255 und 255, die zum Rot-Kanalwert addiert wird, nachdem dieser mit dem "redMultiplier"-Wert multipliziert wurde.
ColorTransform
Öffentliche Methoden
 MethodeDefiniert von
  
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)
Erstellt von einem Anzeigeobjekt anhand der angegebenen Farb- und Alphakanalparameter ein ColorTransform-Objekt.
ColorTransform
  
Verkettet das durch den "second"-Parameter angegebene ColorTransform-Objekt mit dem aktuellen ColorTransform-Objekt und legt das aktuelle Objekt als Ergebnis fest. Dabei handelt es sich um eine additive Kombination der beiden Farbtransformationen.
ColorTransform
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
  
Formatiert und gibt einen String zurück, der alle Eigenschaften des ColorTransform-Objekts beschreibt.
ColorTransform
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Eigenschaftsdetail
alphaMultiplierEigenschaft
public var alphaMultiplier:Number

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Ein Dezimalwert, der mit dem Wert des Alphatransparenzkanals multipliziert wird.

Wenn Sie den Alphatransparenzwert eines Anzeigeobjekts direkt über die alpha-Eigenschaft der DisplayObject-Instanz festlegen, ändert sich dadurch der Wert der alphaMultiplier-Eigenschaft der transform.colorTransform-Eigenschaft des Anzeigeobjekts.

Siehe auch

alphaOffsetEigenschaft 
public var alphaOffset:Number

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Eine Zahl zwischen -255 und 255, die zum Alphakanalwert addiert wird, nachdem dieser mit dem alphaMultiplier-Wert multipliziert wurde.

blueMultiplierEigenschaft 
public var blueMultiplier:Number

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Ein Dezimalwert, der mit dem Wert des Blaukanals multipliziert wird.

blueOffsetEigenschaft 
public var blueOffset:Number

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Eine Zahl zwischen -255 und 255, die zum Blaukanalwert addiert wird, nachdem dieser mit dem blueMultiplier-Wert multipliziert wurde.

colorEigenschaft 
color:uint  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Der RGB-Farbwert eines ColorTransform-Objekts.

Wenn Sie diese Eigenschaft festlegen, werden die drei Offset-Farbwerte (redOffset, greenOffset und blueOffset) entsprechend geändert und die drei Farbmultiplikatorwerte (redMultiplier, greenMultiplier und blueMultiplier) auf 0 gesetzt. Die Multiplikator- und Offset-Werte der Alphatransparenz ändern sich nicht.

Verwenden Sie beim Übergeben eines Werts für diese Eigenschaft das Format 0xRRGGBB. RR, GG und BB setzen sich aus jeweils zwei Hexadezimalziffern zusammen, die den Offset für jede Farbkomponente festlegen. 0x teilt dem ActionScript-Compiler mit, dass die Zahl ein Hexadezimalwert ist.


Implementierung
    public function get color():uint
    public function set color(value:uint):void
greenMultiplierEigenschaft 
public var greenMultiplier:Number

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Ein Dezimalwert, der mit dem Wert des Grünkanals multipliziert wird.

greenOffsetEigenschaft 
public var greenOffset:Number

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Eine Zahl zwischen -255 und 255, die zum Grünkanalwert addiert wird, nachdem dieser mit dem greenMultiplier-Wert multipliziert wurde.

redMultiplierEigenschaft 
public var redMultiplier:Number

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Ein Dezimalwert, der mit dem Wert des Rotkanals multipliziert wird.

redOffsetEigenschaft 
public var redOffset:Number

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Eine Zahl zwischen -255 und 255, die zum Rotkanalwert addiert wird, nachdem dieser mit redMultiplier multiplizert wurde.

Konstruktordetail
ColorTransform()Konstruktor
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)

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Erstellt von einem Anzeigeobjekt anhand der angegebenen Farb- und Alphakanalparameter ein ColorTransform-Objekt.

Parameter
redMultiplier:Number (default = 1.0) — Der Wert des Multiplikators für den Rotkanal im Bereich zwischen 0 und 1.
 
greenMultiplier:Number (default = 1.0) — Der Wert des Multiplikators für den Grünkanal im Bereich zwischen 0 und 1.
 
blueMultiplier:Number (default = 1.0) — Der Wert des Multiplikators für den Blaukanal zwischen 0 und 1.
 
alphaMultiplier:Number (default = 1.0) — Der Wert des Multiplikators für den Alphatransparenzkanal im Bereich zwischen 0 und 1.
 
redOffset:Number (default = 0) — Der Offset-Wert für den Rotkanal zwischen -255 und 255.
 
greenOffset:Number (default = 0) — Der Offset-Wert für den Grünkanal im Bereich zwischen -255 und 255.
 
blueOffset:Number (default = 0) — Der Offset-Wert für den Blaukanal zwischen -255 und 255.
 
alphaOffset:Number (default = 0) — Der Offset-Wert für den Alphatransparenzkanal zwischen -255 und 255.
Methodendetail
concat()Methode
public function concat(second:ColorTransform):void

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Verkettet das durch den Parameter second angegebene ColorTransform-Objekt mit dem aktuellen ColorTransform-Objekt und legt das aktuelle Objekt als Ergebnis fest. Dabei handelt es sich um eine additive Kombination der beiden Farbtransformationen. Die Anwendung des verketteten ColorTransform-Objekts hat die gleichen Auswirkungen wie die Anwendung der second-Farbtransformation nach der original-Farbtransformation.

Parameter

second:ColorTransform — Das ColorTransform-Objekt, das mit dem aktuellen ColorTransform-Objekt kombiniert wird.

toString()Methode 
public function toString():String

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Formatiert und gibt einen String zurück, der alle Eigenschaften des ColorTransform-Objekts beschreibt.

Rückgabewerte
String — Ein String, der alle Eigenschaften des ColorTransform-Objekts angibt.
Beispiele Verwendung von Beispielen
ColorTransformExample.as

Im folgenden Beispiel wird mithilfe der TransformExample-Klasse ein einfaches Sprite in Form eines Quadrats mit Farbverlaufsfüllung erstellt. Bei jedem Klicken des Benutzers auf das Quadrat werden die Farben des quadratischen Sprites transformiert, und zwar wird der Wert des Rotkanals erhöht und der Wert des Blaukanals gesenkt. Dies wird in den folgenden Schritten erreicht:
  1. Der Konstruktor erstellt ein neues Sprite-Objekt mit dem Namen target.
  2. Der CustomButton()-Konstruktor ruft die Methode draw() auf, die im Sprite ein Quadrat mit Farbverlaufsfüllung zeichnet.
  3. Der CustomButton()-Konstruktor fügt dem Sprite einen click-Ereignis-Listener hinzu, der von derclickHandler()-Methode verarbeitet wird.
  4. In der clickHandler()-Methode wurden zwei Eigenschaften auf die redOffset- und blueOffset-Eigenschaften der aktuellen Farbtransformation gesetzt. Bei beiden wurde der Wert um 25 geändert. Anschließend werden die neuen Offset-Werte der transform.colorTransform-Eigenschaft des quadratischen Sprites zugewiesen. Bei jedem Klicken des Benutzers auf das Quadrat wird die clickHandler()-Methode aufgerufen. Dadurch wird die Farbe des Quadrats geändert, da der Wert des Rotkanals erhöht und der Wert des Blaukanals gesenkt wird.
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);
        }
    }
}    




 

Eine E-Mail an mich senden, wenn dieser Seite Kommentare hinzugefügt werden | Kommentarbericht

Aktuelle Seite: http://livedocs.adobe.com/flash/9.0_de/ActionScriptLangRefV3/flash/geom/ColorTransform.html