Paket | flash.filters |
Klasse | public final class DropShadowFilter |
Vererbung | DropShadowFilter BitmapFilter Object |
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
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 der Wert der 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
Eigenschaft | Definiert von | ||
---|---|---|---|
alpha : Number
Der Alphatransparenzwert der Schattenfarbe. | DropShadowFilter | ||
angle : Number
Der Winkel des Schattens. | DropShadowFilter | ||
blurX : Number
Der Grad der horizontalen Weichzeichnung. | DropShadowFilter | ||
blurY : Number
Der Grad der vertikalen Weichzeichnung. | DropShadowFilter | ||
color : uint
Die Farbe des Schattens. | DropShadowFilter | ||
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
distance : Number
Der Versatz des Schattens in Pixel. | DropShadowFilter | ||
hideObject : Boolean
Gibt an, ob das Objekt ausgeblendet wird oder nicht. | DropShadowFilter | ||
inner : Boolean
Gibt an, ob es sich bei dem Schatten um einen inneren Schatten handelt. | DropShadowFilter | ||
knockout : Boolean
Wendet einen Aussparungseffekt (true) an, der die Objektfüllung transparent macht und die Hintergrundfarbe des Dokuments zum Vorschein bringt. | DropShadowFilter | ||
quality : int
Gibt an, wie oft der Filter angewendet werden soll. | DropShadowFilter | ||
strength : Number
Die Stärke des Abdrucks oder Auftragens. | DropShadowFilter |
Methode | Definiert von | ||
---|---|---|---|
DropShadowFilter(distance:Number = 4.0, angle:Number = 45, color:uint = 0, alpha:Number = 1.0, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1.0, quality:int = 1, inner:Boolean = false, knockout:Boolean = false, hideObject:Boolean = false)
Erstellt eine neue DropShadowFilter-Instanz mit den angegebenen Parametern. | DropShadowFilter | ||
[override]
Gibt eine Kopie dieses Filterobjekts zurück. | DropShadowFilter | ||
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 Schattenfarbe. Die zulässigen Werte liegen zwischen 0.0 und 1.0. Mit dem Wert 0,25 wird beispielsweise ein Transparenzwert von 25 % festgelegt. Der Standardwert ist 1.0.
Implementierung
public function get alpha():Number
public function set alpha(value:Number):void
angle | Eigenschaft |
angle:Number
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Der Winkel des Schattens. Die zulässigen Werte liegen zwischen 0 und 360 Grad (Gleitkommazahl). Der Standardwert ist 45.
Implementierung
public function get angle():Number
public function set angle(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.0 (Gleitkomma). Der Standardwert ist 4.0.
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.0 (Gleitkomma). Der Standardwert ist 4.0.
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 Schattens. Die zulässigen Werte werden im Hexadezimalformat 0xRRGGBB angegeben. Der Standardwert lautet 0x000000.
Implementierung
public function get color():uint
public function set color(value:uint):void
distance | Eigenschaft |
hideObject | Eigenschaft |
hideObject:Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Gibt an, ob das Objekt ausgeblendet wird oder nicht. Der Wert true
gibt an, dass nicht das Objekt selbst sondern nur sein Schatten sichtbar ist. Der Standardwert lautet false
(das Objekt wird angezeigt).
Implementierung
public function get hideObject():Boolean
public function set hideObject(value:Boolean):void
inner | Eigenschaft |
inner:Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Gibt an, ob es sich bei dem Schatten um einen inneren Schatten handelt. Der Wert true
zeigt einen inneren Schatten an. Der Standardwert lautet false
, gibt also einen äußeren Schatten an, d. h. einen Schatten 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 |
Wendet einen Aussparungseffekt (true
) an, der die Objektfüllung transparent macht und die Hintergrundfarbe des Dokuments zum Vorschein bringt. 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.
In den meisten Fällen reicht die Angabe der niedrigen, mittleren oder hohen Qualität für „quality“ aus. 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 Schatten und dem Hintergrund. Die zulässigen Werte liegen zwischen 0 und 255.0. Der Standardwert lautet 1.0.
Implementierung
public function get strength():Number
public function set strength(value:Number):void
DropShadowFilter | () | Konstruktor |
public function DropShadowFilter(distance:Number = 4.0, angle:Number = 45, color:uint = 0, alpha:Number = 1.0, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1.0, quality:int = 1, inner:Boolean = false, knockout:Boolean = false, hideObject:Boolean = false)
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Erstellt eine neue DropShadowFilter-Instanz mit den angegebenen Parametern.
Parameterdistance:Number (default = 4.0 ) — Der Offset des Schattens in Pixeln.
| |
angle:Number (default = 45 ) — Der Winkel des Schattens von 0 bis 360 Grad (Gleitkommazahl).
| |
color:uint (default = 0 ) — Die Farbe des Schattens im Hexadezimalformat 0xRRGGBB. Der Standardwert lautet 0x000000.
| |
alpha:Number (default = 1.0 ) — Der Alphatransparenzwert der Schattenfarbe. Die zulässigen Werte liegen zwischen 0,0 und 1,0. Mit dem Wert 0,25 wird beispielsweise ein Transparenzwert von 25 % festgelegt.
| |
blurX:Number (default = 4.0 ) — Der Grad der horizontalen Weichzeichnung. Die zulässigen Werte liegen zwischen 0 und 255.0 (Gleitkomma).
| |
blurY:Number (default = 4.0 ) — Der Grad der vertikalen Weichzeichnung. Die zulässigen Werte liegen zwischen 0 und 255.0 (Gleitkomma).
| |
strength:Number (default = 1.0 ) — 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 Schatten und dem Hintergrund. Die zulässigen Werte liegen zwischen 0 und 255.0.
| |
quality:int (default = 1 ) — Gibt an, wie oft der Filter angewendet werden soll. Verwenden Sie die BitmapFilterQuality-Konstanten:
Weitere Informationen zu diesem Parameter finden Sie in der Beschreibung der | |
inner:Boolean (default = false ) — Gibt an, ob es sich bei dem Schatten um einen inneren Schatten handelt. Der Wert true gibt einen inneren Schatten an. Der Wert false gibt einen äußeren Schatten an, d. h. einen Schatten um die äußeren Ränder des Objekts.
| |
knockout:Boolean (default = false ) — Wendet einen Aussparungseffekt (true ) an, der die Objektfüllung transparent macht und die Hintergrundfarbe des Dokuments zum Vorschein bringt.
| |
hideObject:Boolean (default = false ) — Gibt an, ob das Objekt ausgeblendet wird oder nicht. Der Wert true gibt an, dass nicht das Objekt selbst sondern nur sein Schatten sichtbar ist.
|
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 DropShadowFilter-Instanz mit allen Eigenschaften der ursprünglichen Instanz.
|
- Deklarieren Sie drei Eigenschaften, mit denen das Quadrat gezeichnet und auf das der Filter angewendet wird.
- Erstellen Sie die Konstruktorfunktion. Der Konstruktor ruft die Methode
draw()
auf. Diese Methode verwendet Methoden der Graphics-Klasse, auf die über die Eigenschaftgraphics
der Klasse Sprite zugegriffen wird, um ein orangefarbenes Quadrat zu zeichnen. - Deklarieren Sie im Konstruktor die Variable
filter
als BitmapFilter-Objekt, und weisen Sie es dem Wert zu, der sich aus dem Aufruf vongetBitmapFilter()
ergibt. Mit der MethodegetBitmapFilter()
wird der verwendete Schlagschatten-Filter definiert. - Erstellen Sie neues Array-Objekt
myFilters
, und fügen Siefilter
zum Array hinzu. Weisen Sie den ArraymyFilters
der Eigenschaftfilters
des DropShadowFilterExample-Objekts zu. Dadurch werden alle inmyFilters
vorgefundenen Filter angewendet; in diesem Fall nurfilter
.
package { import flash.display.Sprite; import flash.events.Event; import flash.events.MouseEvent; import flash.filters.BitmapFilter; import flash.filters.BitmapFilterQuality; import flash.filters.DropShadowFilter; public class DropShadowFilterExample extends Sprite { private var bgColor:uint = 0xFFCC00; private var size:uint = 80; private var offset:uint = 50; public function DropShadowFilterExample() { draw(); var filter:BitmapFilter = getBitmapFilter(); var myFilters:Array = new Array(); myFilters.push(filter); filters = myFilters; } private function getBitmapFilter():BitmapFilter { var color:Number = 0x000000; var angle:Number = 45; var alpha:Number = 0.8; var blurX:Number = 8; var blurY:Number = 8; var distance:Number = 15; var strength:Number = 0.65; var inner:Boolean = false; var knockout:Boolean = false; var quality:Number = BitmapFilterQuality.HIGH; return new DropShadowFilter(distance, angle, 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