Paket | flash.geom |
Klasse | public class ColorTransform |
Vererbung | ColorTransform Object |
Unterklassen | Color |
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wenn ein ColorTransform-Objekt auf ein Anzeigeobjekt angewendet wird, wird der neue Wert der einzelnen Farbkanäle folgendermaßen berechnet:
- Neuer Rotwert = (Alter Rotwert *
redMultiplier
) +redOffset
- Neuer Grünwert = (Alter Grünwert *
greenMultiplier
) +greenOffset
- Neuer Blauwert = (Alter Blauwert *
blueMultiplier
) +blueOffset
- Neuer Alphawert = (Alter Alphawert *
alphaMultiplier
) +alphaOffset
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:
- im Parameter
colorTransform
für diecolorTransform()
-Methode der BitmapData-Klasse - als
colorTransform
-Eigenschaft eines Transform-Objekts (das alstransform
-Eigenschaft eines Anzeigeobjekts verwendet werden kann)
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.
Verwandte API-Elemente
Eigenschaft | Definiert 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 | ||
constructor : 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 | ||
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 |
Methode | Definiert 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 | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Formatiert und gibt einen String zurück, der alle Eigenschaften des ColorTransform-Objekts beschreibt. | ColorTransform | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object |
alphaMultiplier | Eigenschaft |
public var alphaMultiplier:Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
Verwandte API-Elemente
alphaOffset | Eigenschaft |
public var alphaOffset:Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Eine Zahl zwischen -255 und 255, die zum Alphakanalwert addiert wird, nachdem dieser mit dem alphaMultiplier
-Wert multipliziert wurde.
blueMultiplier | Eigenschaft |
public var blueMultiplier:Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Ein Dezimalwert, der mit dem Wert des Blaukanals multipliziert wird.
blueOffset | Eigenschaft |
public var blueOffset:Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Eine Zahl zwischen -255 und 255, die zum Blaukanalwert addiert wird, nachdem dieser mit dem blueMultiplier
-Wert multipliziert wurde.
color | Eigenschaft |
color:uint
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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
greenMultiplier | Eigenschaft |
public var greenMultiplier:Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Ein Dezimalwert, der mit dem Wert des Grünkanals multipliziert wird.
greenOffset | Eigenschaft |
public var greenOffset:Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Eine Zahl zwischen -255 und 255, die zum Grünkanalwert addiert wird, nachdem dieser mit dem greenMultiplier
-Wert multipliziert wurde.
redMultiplier | Eigenschaft |
public var redMultiplier:Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Ein Dezimalwert, der mit dem Wert des Rotkanals multipliziert wird.
redOffset | Eigenschaft |
public var redOffset:Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Eine Zahl zwischen -255 und 255, die zum Rotkanalwert addiert wird, nachdem dieser mit redMultiplier
multiplizert wurde.
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 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Erstellt von einem Anzeigeobjekt anhand der angegebenen Farb- und Alphakanalparameter ein ColorTransform-Objekt.
ParameterredMultiplier: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.
|
concat | () | Methode |
public function concat(second:flash.geom:ColorTransform):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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:flash.geom:ColorTransform — Das ColorTransform-Objekt, das mit dem aktuellen ColorTransform-Objekt kombiniert wird.
|
toString | () | Methode |
public function toString():String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Formatiert und gibt einen String zurück, der alle Eigenschaften des ColorTransform-Objekts beschreibt.
RückgabewerteString — Ein String, der alle Eigenschaften des ColorTransform-Objekts angibt.
|
- Der Konstruktor erstellt ein neues Sprite-Objekt
target
. - Der
CustomButton()
-Konstruktor ruft diedraw()
-Methode auf, die ein Quadrat mit Farbverlaufsfüllung im Sprite zeichnet. - Der
CustomButton()
-Konstruktor fügt einen click-Ereignis-Listener für das Sprite hinzu, der von derclickHandler()
-Methode verarbeitet wird. - In der
clickHandler()
-Methode wurden zwei Eigenschaften auf dieredOffset
- undblueOffset
-Eigenschaften der aktuellen Farbtransformation gesetzt. Bei beiden wurde der Wert um 25 geändert. Anschließend werden die neuen Offset-Werte dertransform.colorTransform
-Eigenschaft des quadratischen Sprites zugewiesen. Bei jedem Klicken des Benutzers auf das Quadrat wird dieclickHandler()
-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); } } }
Tue Jun 12 2018, 10:04 AM Z