Paket | flash.filters |
Klasse | public final class GlowFilter |
Vererbung | GlowFilter BitmapFilter Object |
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
distance
und angle
auf 0 (null) gesetzt sind. Sie können den Filter auf jedes Anzeigeobjekt anwenden (d. h. Objekte, die von der DisplayObject-Klasse erben), z. B. auf MovieClip-, SimpleButton-, TextField-, Video- sowie BitmapData-Objekte.
Die Verwendung von Filtern hängt davon ab, auf welches Objekt sie jeweils angewendet werden:
- Um Filter auf Anzeigeobjekte anzuwenden, verwenden Sie die
filters
-Eigenschaft (von DisplayObject übernommen). Durch die Einstellung derfilters
-Eigenschaft wird das betroffene Objekt selbst nicht verändert, und Sie können den Filter wieder entfernen, indem Sie diefilters
-Eigenschaft löschen. - Um Filter auf BitmapData-Objekte anzuwenden, verwenden Sie die
BitmapData.applyFilter()
-Methode. Durch den Aufruf vonapplyFilter()
bei einem BitmapData-Objekt wird das gefilterte Bild aus dem BitmapData-Quellobjekt und dem Filterobjekt generiert.
Wenn Sie einen Filter auf ein Anzeigeobjekt anwenden, wird die cacheAsBitmap
-Eigenschaft des Anzeigeobjekts auf true
gesetzt. Wenn Sie alle Filter entfernen, wird der ursprüngliche Wert von cacheAsBitmap
wiederhergestellt.
Dieser Filter unterstützt Bühnenskalierung. Allgemeine Skalierung, Drehung und Neigung werden dagegen nicht unterstützt. Wenn das Objekt selbst skaliert wird (also die Eigenschaften scaleX
und scaleY
ungleich 1,0 sind), wird der Filtereffekt nicht skaliert. Er wird nur dann skaliert, wenn die Bühne vergrößert dargestellt wird.
Ein Filter wird nicht angewendet, wenn das Ergebnisbild die maximalen Abmessungen überschreitet. In AIR 1.5 und Flash Player 10 beträgt die maximale Höhe oder Breite 8.191 Pixel; die gesamte Pixelzahl darf 16.777.215 nicht übersteigen. (Wenn ein Bild also 8.191 Pixel breit ist, darf es nur 2.048 Pixel hoch sein.) In Flash Player 9 und niedriger und AIR 1.1 und niedriger liegt die Grenze bei je 2.880 Pixel Höhe und Breite. Wenn Sie beispielsweise einen großen Movieclip mit aktiviertem Filter vergrößert darstellen, wird der Filter deaktiviert, sobald das Ergebnisbild die maximalen Abmessungen überschreitet.
Verwandte API-Elemente
flash.display.DisplayObject.filters
flash.display.DisplayObject.cacheAsBitmap
flash.display.DisplayObject.scaleX
flash.display.DisplayObject.scaleY
flash.filters.DropShadowFilter.distance
flash.filters.DropShadowFilter.angle
Eigenschaft | Definiert von | ||
---|---|---|---|
alpha : Number
Der Alphatransparenzwert der Farbe. | GlowFilter | ||
blurX : Number
Der Grad der horizontalen Weichzeichnung. | GlowFilter | ||
blurY : Number
Der Grad der vertikalen Weichzeichnung. | GlowFilter | ||
color : uint
Die Farbe des Glühen-Effekts. | GlowFilter | ||
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
inner : Boolean
Gibt an, ob es sich um ein inneres Glühen handelt. | GlowFilter | ||
knockout : Boolean
Gibt an, ob für das Objekt ein Aussparungseffekt definiert wurde. | GlowFilter | ||
quality : int
Gibt an, wie oft der Filter angewendet werden soll. | GlowFilter | ||
strength : Number
Die Stärke des Abdrucks oder Auftragens. | GlowFilter |
Methode | Definiert von | ||
---|---|---|---|
GlowFilter(color:uint = 0xFF0000, alpha:Number = 1.0, blurX:Number = 6.0, blurY:Number = 6.0, strength:Number = 2, quality:int = 1, inner:Boolean = false, knockout:Boolean = false)
Initialisiert eine neue GlowFilter-Instanz mit den angegebenen Parametern. | GlowFilter | ||
[override]
Gibt eine Kopie dieses Filterobjekts zurück. | GlowFilter | ||
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 | ||
Gibt das angegebene Objekt als String zurück. | Object | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object |
alpha | Eigenschaft |
alpha:Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Der Alphatransparenzwert der Farbe. Die zulässigen Werte liegen zwischen 0 und 1. Mit dem Wert 0,25 wird beispielsweise ein Transparenzwert von 25 % festgelegt. Der Standardwert ist 1.
Implementierung
public function get alpha():Number
public function set alpha(value:Number):void
blurX | Eigenschaft |
blurX:Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Der Grad der horizontalen Weichzeichnung. Die zulässigen Werte liegen zwischen 0 und 255 (Gleitkomma). Der Standardwert ist 6. Zweierpotenzen (z. B. 2, 4, 8, 16 und 32) sind optimiert und ergeben eine schnellere Anzeige als andere Werte.
Implementierung
public function get blurX():Number
public function set blurX(value:Number):void
blurY | Eigenschaft |
blurY:Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Der Grad der vertikalen Weichzeichnung. Die zulässigen Werte liegen zwischen 0 und 255 (Gleitkomma). Der Standardwert ist 6. Zweierpotenzen (z. B. 2, 4, 8, 16 und 32) sind optimiert und ergeben eine schnellere Anzeige als andere Werte.
Implementierung
public function get blurY():Number
public function set blurY(value:Number):void
color | Eigenschaft |
color:uint
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Die Farbe des Glühen-Effekts. Die zulässigen Werte werden im Hexadezimalformat 0xRRGGBB angegeben. Der Standardwert lautet 0xFF0000.
Implementierung
public function get color():uint
public function set color(value:uint):void
inner | Eigenschaft |
inner:Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Gibt an, ob es sich um ein inneres Glühen handelt. Der Wert true
gibt ein inneres Glühen an. Der Standardwert lautet false
, gibt also ein äußeres Glühen an, d. h. ein Glühen um die äußeren Ränder des Objekts.
Implementierung
public function get inner():Boolean
public function set inner(value:Boolean):void
knockout | Eigenschaft |
knockout:Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Gibt an, ob für das Objekt ein Aussparungseffekt definiert wurde. Mit true
wird eine transparente Füllung des Objekts definiert, die Hintergrundfarbe des Dokuments wird sichtbar. Der Standardwert lautet false
(keine Aussparung).
Implementierung
public function get knockout():Boolean
public function set knockout(value:Boolean):void
quality | Eigenschaft |
quality:int
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Gibt an, wie oft der Filter angewendet werden soll. Der Standardwert lautet BitmapFilterQuality.LOW
, was einer einmaligen Anwendung des Filters entspricht. Mit dem Wert BitmapFilterQuality.MEDIUM
wird der Filter zweimal angewendet und mit dem Wert BitmapFilterQuality.HIGH
dreimal. Filter mit niedrigen Werten werden schneller dargestellt.
Bei den meisten Anwendungen genügt die Angabe der niedrigen, mittleren oder hohen Qualität für quality
. Sie können zwar Werte bis 15 angeben, um unterschiedliche Effekte zu erzielen, höhere Werte führen jedoch auch zu einer langsameren Darstellung. Anstatt also den Wert von quality
zu erhöhen, können Sie einen ähnlichen Effekt mit gleichzeitig schnellerer Darstellung erzielen, indem Sie einfach die Eigenschaftswerte von blurX
und blurY
erhöhen.
Implementierung
public function get quality():int
public function set quality(value:int):void
Verwandte API-Elemente
strength | Eigenschaft |
strength:Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Die Stärke des Abdrucks oder Auftragens. Je höher der Wert, desto mehr Farbe wird aufgetragen und desto stärker ist der Kontrast zwischen dem Glühen und dem Hintergrund. Die zulässigen Werte liegen zwischen 0 und 255. Der Standardwert ist 2.
Implementierung
public function get strength():Number
public function set strength(value:Number):void
GlowFilter | () | Konstruktor |
public function GlowFilter(color:uint = 0xFF0000, alpha:Number = 1.0, blurX:Number = 6.0, blurY:Number = 6.0, strength:Number = 2, quality:int = 1, inner:Boolean = false, knockout:Boolean = false)
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Initialisiert eine neue GlowFilter-Instanz mit den angegebenen Parametern.
Parametercolor:uint (default = 0xFF0000 ) — Die Farbe des Glühen-Effekts im hexadezimalen Format 0xRRGGBB. Der Standardwert lautet 0xFF0000.
| |
alpha:Number (default = 1.0 ) — Der Alphatransparenzwert der Farbe. Die zulässigen Werte liegen zwischen 0 und 1. Mit dem Wert 0,25 wird beispielsweise ein Transparenzwert von 25 % festgelegt.
| |
blurX:Number (default = 6.0 ) — Der Grad der horizontalen Weichzeichnung. Die zulässigen Werte liegen zwischen 0 und 255 (Gleitkomma). Zweierpotenzen (z. B. 2, 4, 8, 16 und 32) sind optimiert und ergeben eine schnellere Anzeige als andere Werte.
| |
blurY:Number (default = 6.0 ) — Der Grad der vertikalen Weichzeichnung. Die zulässigen Werte liegen zwischen 0 und 255 (Gleitkomma). Zweierpotenzen (z. B. 2, 4, 8, 16 und 32) sind optimiert und ergeben eine schnellere Anzeige als andere Werte.
| |
strength:Number (default = 2 ) — Die Stärke des Abdrucks oder Auftragens. Je höher der Wert, desto mehr Farbe wird aufgetragen und desto stärker ist der Kontrast zwischen dem Glühen und dem Hintergrund. Die zulässigen Werte liegen zwischen 0 und 255.
| |
quality:int (default = 1 ) — Gibt an, wie oft der Filter angewendet werden soll. Verwenden Sie die BitmapFilterQuality-Konstanten:
Weitere Informationen finden Sie in der Beschreibung der | |
inner:Boolean (default = false ) — Gibt an, ob es sich um ein inneres Glühen handelt. Der Wert true gibt ein inneres Glühen an. Der Wert false gibt ein äußeres Glühen an, d. h. ein Glühen um die äußeren Ränder des Objekts.
| |
knockout:Boolean (default = false ) — Gibt an, ob für das Objekt ein Aussparungseffekt definiert wurde. Mit true wird eine transparente Füllung des Objekts definiert, die Hintergrundfarbe des Dokuments wird sichtbar.
|
Verwandte API-Elemente
clone | () | Methode |
override public function clone():BitmapFilter
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Gibt eine Kopie dieses Filterobjekts zurück.
RückgabewerteBitmapFilter — Eine neue GlowFilter-Instanz mit allen Eigenschaften der ursprünglichen GlowFilter-Instanz.
|
- Importieren Sie die erforderlichen Klassen.
- Deklarieren Sie drei Eigenschaften für die
draw()
-Methode. Diese Methode verwendet Methoden der Graphics-Klasse, auf die über die Eigenschaftgraphics
der Sprite-Klasse zugegriffen wird, um ein orangefarbenes Quadrat zu zeichnen. - Erstellen Sie die Konstruktorfunktion, die Folgendes bewirkt:
- Ruft die
draw
-Funktion auf, um ein Rechteck zu erstellen. - Erstellt ein BitmapFilter-Objekt
glowFilter
und weist ihm den Rückgabewert aus dergetBitmapFilter()
-Funktion zu. - Weist das Wertearray aus dem
glowFilter
-Objekt derfilters
-Eigenschaft des Stammanzeigeobjekts zu. In diesem Fall übernehmen alle untergeordneten Anzeigeobjekte des Stammanzeigeobjekts die glowfilter-Eigenschaften. Das Rechteck, das in derdraw()
-Funktion erstellt wird, zeigt also die Eigenschaften des Glühen-Filters an.
- Ruft die
package { import flash.display.Sprite; import flash.events.Event; import flash.events.MouseEvent; import flash.filters.BitmapFilter; import flash.filters.BitmapFilterQuality; import flash.filters.GlowFilter; public class GlowFilterExample extends Sprite { private var bgColor:uint = 0xFFCC00; private var size:uint = 80; private var offset:uint = 50; public function GlowFilterExample() { //draw the rectangle using the draw() function below draw(); //assign the values from getBitmapFilter function below //to a BitmapFilter object "glowFilter" var glowFilter:BitmapFilter = getBitmapFilter(); //populate the filters property of the root display object with the array of values //from the glowFilter object. filters = [ glowFilter ]; } private function getBitmapFilter():BitmapFilter { var color:Number = 0x33CCFF; var alpha:Number = 0.8; var blurX:Number = 35; var blurY:Number = 35; var strength:Number = 2; var inner:Boolean = false; var knockout:Boolean = false; var quality:Number = BitmapFilterQuality.HIGH; return new GlowFilter(color, alpha, blurX, blurY, strength, quality, inner, knockout); } private function draw():void { graphics.beginFill(bgColor); graphics.drawRect(offset, offset, size, size); graphics.endFill(); } } }
Tue Jun 12 2018, 10:04 AM Z