Paket | spark.filters |
Klasse | public class DropShadowFilter |
Vererbung | DropShadowFilter ![]() ![]() ![]() ![]() |
Implementiert | IBitmapFilter |
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
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.) Wenn Sie beispielsweise einen großen Movieclip mit aktiviertem Filter vergrößert darstellen, wird der Filter deaktiviert, sobald das Ergebnisbild die maximalen Abmessungen überschreitet.
MXML-Syntax
The <s:DropShadowFilter>
tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:
<s:DropShadowFilter Properties alpha="1" angle="45" color="0xFF0000" distance="4" hideObject="false" inner="false" />
Verwandte API-Elemente
Eigenschaft | Definiert von | ||
---|---|---|---|
alpha : Number
Der Alphatransparenzwert der Farbe. | DropShadowFilter | ||
angle : Number
Der Winkel der Abschrägung. | DropShadowFilter | ||
![]() | blurX : Number
Der Grad der horizontalen Weichzeichnung. | BaseDimensionFilter | |
![]() | blurY : Number
Der Grad der vertikalen Weichzeichnung. | BaseDimensionFilter | |
color : uint
Die Farbe des Glühen-Effekts. | DropShadowFilter | ||
![]() | constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
distance : Number
Der Offset der Abschrägung. | DropShadowFilter | ||
hideObject : Boolean
Gibt an, ob das Objekt ausgeblendet wird oder nicht. | DropShadowFilter | ||
inner : Boolean
Gibt an, ob es sich um ein inneres Glühen handelt. | DropShadowFilter | ||
![]() | knockout : Boolean
Gibt an, ob für das Objekt ein Aussparungseffekt definiert wurde. | BaseDimensionFilter | |
![]() | quality : int
Gibt an, wie oft der Filter angewendet werden soll. | BaseDimensionFilter | |
![]() | strength : Number
Die Stärke des Abdrucks oder Auftragens. | BaseDimensionFilter |
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)
Konstruktor. | DropShadowFilter | ||
![]() | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. | EventDispatcher | |
Gibt eine Kopie dieses Filterobjekts zurück. | DropShadowFilter | ||
![]() |
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | |
![]() |
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | |
![]() |
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 | |
![]() |
Propagiert ein Change-Ereignis, wenn sich der Filter geändert hat. | BaseFilter | |
![]() |
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
![]() |
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | |
![]() |
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 | |
![]() |
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | EventDispatcher |
alpha | Eigenschaft |
alpha:Number
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
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
angle | Eigenschaft |
angle:Number
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Der Winkel der Abschrägung. Die zulässigen Werte liegen zwischen 0 und 360 Grad. Dieser Wert stellt den Winkel einer imaginären, das Objekt beleuchtenden Lichtquelle dar und bestimmt die Position des Effekts relativ zu diesem Objekt. Wenn die distance-Eigenschaft auf 0 (null) gesetzt wird, ist der Offset des Effekts gleich null und die angle-Eigenschaft hat keine Auswirkungen.
Der Standardwert ist 45.
Implementierung
public function get angle():Number
public function set angle(value:Number):void
color | Eigenschaft |
color:uint
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Die Farbe des Glühen-Effekts. Die zulässigen Werte werden im Hexadezimalformat 0xRRGGBB angegeben.
Der Standardwert ist 0xFF0000.
Implementierung
public function get color():uint
public function set color(value:uint):void
distance | Eigenschaft |
distance:Number
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Der Offset der Abschrägung. Die zulässigen Werte sind in Pixeln angegeben (Gleitkommazahl).
Der Standardwert ist 4.
Implementierung
public function get distance():Number
public function set distance(value:Number):void
hideObject | Eigenschaft |
hideObject:Boolean
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
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
, d. h. das Objekt wird angezeigt.
Der Standardwert ist false.
Implementierung
public function get hideObject():Boolean
public function set hideObject(value:Boolean):void
inner | Eigenschaft |
inner:Boolean
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Gibt an, ob es sich um ein inneres Glühen handelt. Der Wert true
gibt ein inneres Glühen an. Der Standardwert false
, erstellt ein äußeres Glühen, d. h. ein Glühen um die Außenkanten des Objekts.
Der Standardwert ist false.
Implementierung
public function get inner():Boolean
public function set inner(value:Boolean):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 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Konstruktor.
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 |
public function clone():BitmapFilter
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flex 4 |
Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Gibt eine Kopie dieses Filterobjekts zurück.
RückgabewerteBitmapFilter — Eine neue DropShadowFilter-Instanz mit allen Eigenschaften der ursprünglichen Instanz.
|
<?xml version="1.0"?> <!-- filters/examples/DropShadowFilterExample.mxml --> <s:Application xmlns:fx="http://ns.adobe.com/mxml/2009" xmlns:mx="library://ns.adobe.com/flex/mx" xmlns:s="library://ns.adobe.com/flex/spark" creationComplete="createFilters()"> <fx:Script><![CDATA[ import spark.filters.*; import flash.filters.BitmapFilterQuality; import flash.filters.BitmapFilterType; private var myDropShadowFilter:DropShadowFilter; private var color:Number = 0xFF33FF; public function createFilters():void { myDropShadowFilter = new DropShadowFilter(15, 45, color, 0.8, 8, 8, 0.65, BitmapFilterQuality.MEDIUM, false, false); b1.filters = [myDropShadowFilter]; } ]]></fx:Script> <s:VGroup> <!-- This button has a filter applied in ActionScript. --> <s:Button id="b1" label="Click me"/> <!-- This button has a filter applied in MXML. --> <s:Button id="b2" label="Click me"> <s:filters> <s:DropShadowFilter distance="15" angle="45" color="0xFF33FF" alpha=".8" blurX="8" blurY="8" strength=".65" quality="{BitmapFilterQuality.MEDIUM}" inner="false" knockout="false"/> </s:filters> </s:Button> </s:VGroup> </s:Application>
Tue Jun 12 2018, 10:04 AM Z