Paketflash.filters
Klassepublic final class BevelFilter
VererbungBevelFilter Inheritance BitmapFilter Inheritance Object

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Mit der BevelFilter-Klasse können Sie einen Geschliffen-Effekt auf Anzeigeobjekte anwenden. Durch diesen Geschliffen-Effekt erhalten Objekte, beispielsweise Schaltflächen, ein dreidimensionales Aussehen. Dabei haben Sie die Möglichkeit, diesen Effekt mithilfe verschiedener Glanzlicht- und Schattenfarben anzupassen. Darüber hinaus können Sie die Weichzeichnung, den Winkel und die Position der geschliffenen Kanten und des Aussparungseffekts festlegen. 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.

Verwenden Sie zum Erstellen eines neuen Filters den Konstruktor new BevelFilter(). Die Verwendung von Filtern hängt davon ab, auf welches Objekt sie jeweils angewendet werden:

Wenn Sie einen Filter auf ein Anzeigeobjekt anwenden, wird der Wert der cacheAsBitmap-Eigenschaft des Objekts 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 100 % 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 mehr als 2.880 Pixel breit bzw. hoch ist. Wenn Sie beispielsweise einen großen Movieclip mit aktiviertem Filter vergrößert darstellen, wird der Filter deaktiviert, sobald das Ergebnisbild die Grenze von 2.880 Pixel erreicht.

Beispiele anzeigen

Siehe auch

flash.display.DisplayObject.filters
flash.display.DisplayObject.cacheAsBitmap
flash.display.BitmapData.applyFilter()


Öffentliche Eigenschaften
 EigenschaftDefiniert von
  angle : Number
Der Winkel der geschliffenen Kante.
BevelFilter
  blurX : Number
Der Grad der horizontalen Weichzeichnung in Pixel.
BevelFilter
  blurY : Number
Der Grad der vertikalen Weichzeichnung in Pixel.
BevelFilter
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  distance : Number
Der Versatz der geschliffenen Kante.
BevelFilter
  highlightAlpha : Number
Der Alphatransparenzwert der Glanzlichtfarbe.
BevelFilter
  highlightColor : uint
Die Glanzlichtfarbe der geschliffenen Kante.
BevelFilter
  knockout : Boolean
Wendet einen Aussparungseffekt (true) an, der die Objektfüllung transparent macht und die Hintergrundfarbe des Dokuments zum Vorschein bringt.
BevelFilter
 Inheritedprototype : Object
[static] Ein Verweis auf das Prototypobjekt einer Klasse oder eines Funktionsobjekts.
Object
  quality : int
Gibt an, wie oft der Filter angewendet werden soll.
BevelFilter
  shadowAlpha : Number
Der Alphatransparenzwert der Schattenfarbe.
BevelFilter
  shadowColor : uint
Die Schattenfarbe der geschliffenen Kante.
BevelFilter
  strength : Number
Die Stärke des Abdrucks oder Auftragens.
BevelFilter
  type : String
Die Platzierung des Geschliffen-Effekts am Objekt.
BevelFilter
Öffentliche Methoden
 MethodeDefiniert von
  
BevelFilter(distance:Number = 4.0, angle:Number = 45, highlightColor:uint = 0xFFFFFF, highlightAlpha:Number = 1.0, shadowColor:uint = 0x000000, shadowAlpha:Number = 1.0, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1, quality:int = 1, type:String = "inner", knockout:Boolean = false)
Initialisiert eine neue BevelFilter-Instanz mit den angegebenen Parametern.
BevelFilter
  
Gibt eine Kopie dieses Filterobjekts zurück.
BevelFilter
 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
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Eigenschaftsdetail
angleEigenschaft
angle:Number  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Der Winkel der geschliffenen Kante. Die zulässigen Werte liegen zwischen 0 und 360 Grad. Der Standardwert ist 45 Grad.

Dieser Wert stellt den Winkel einer imaginären, das Objekt beleuchtenden Lichtquelle dar und gibt die Position des Effekts relativ zu diesem Objekt an. Wenn die distance-Eigenschaft auf 0 (null) gesetzt wird, ist der Versatz des Effekts gleich null und die angle-Eigenschaft hat keine Auswirkungen.


Implementierung
    public function get angle():Number
    public function set angle(value:Number):void
blurXEigenschaft 
blurX:Number  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Der Grad der horizontalen Weichzeichnung in Pixel. Die zulässigen Werte liegen zwischen 0 und 255,0 (Gleitkommazahl). Der Standardwert ist 4. 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
blurYEigenschaft 
blurY:Number  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Der Grad der vertikalen Weichzeichnung in Pixel. Die zulässigen Werte liegen zwischen 0 und 255,0 (Gleitkommazahl). Der Standardwert ist 4. 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
distanceEigenschaft 
distance:Number  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Der Versatz der geschliffenen Kante. Die zulässigen Werte sind in Pixel angegeben (Gleitkommazahl). Der Standardwert lautet 4.


Implementierung
    public function get distance():Number
    public function set distance(value:Number):void
highlightAlphaEigenschaft 
highlightAlpha:Number  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Der Alphatransparenzwert der Glanzlichtfarbe. Wird als normalisierter Wert von 0 bis 1 angegeben. Mit dem Wert 0,25 wird beispielsweise ein Transparenzwert von 25 % festgelegt. Der Standardwert ist 1.


Implementierung
    public function get highlightAlpha():Number
    public function set highlightAlpha(value:Number):void
highlightColorEigenschaft 
highlightColor:uint  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Die Glanzlichtfarbe der geschliffenen Kante. Die zulässigen Werte werden im Hexadezimalformat 0xRRGGBB angegeben. Der Standardwert lautet 0xFFFFFF.


Implementierung
    public function get highlightColor():uint
    public function set highlightColor(value:uint):void
knockoutEigenschaft 
knockout:Boolean  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : 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
qualityEigenschaft 
quality:int  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : 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.

Mithilfe der folgenden BitmapFilterQuality-Konstanten können Sie die Werte der quality-Eigenschaft einstellen:


Implementierung
    public function get quality():int
    public function set quality(value:int):void
shadowAlphaEigenschaft 
shadowAlpha:Number  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Der Alphatransparenzwert der Schattenfarbe. Wird als normalisierter Wert von 0 bis 1 angegeben. Mit dem Wert 0,25 wird beispielsweise ein Transparenzwert von 25 % festgelegt. Der Standardwert lautet 1.


Implementierung
    public function get shadowAlpha():Number
    public function set shadowAlpha(value:Number):void
shadowColorEigenschaft 
shadowColor:uint  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Die Schattenfarbe der geschliffenen Kante. Die zulässigen Werte werden im Hexadezimalformat 0xRRGGBB angegeben. Der Standardwert lautet 0x000000.


Implementierung
    public function get shadowColor():uint
    public function set shadowColor(value:uint):void
strengthEigenschaft 
strength:Number  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Die Stärke des Abdrucks oder Auftragens. Die zulässigen Werte liegen zwischen 0 und 255. Je höher der Wert, desto mehr Farbe wird aufgedruckt und desto stärker ist der Kontrast zwischen dem geschliffenen Bereich und dem Hintergrund. Der Standardwert ist 1.


Implementierung
    public function get strength():Number
    public function set strength(value:Number):void
typeEigenschaft 
type:String  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Die Platzierung des Geschliffen-Effekts am Objekt. Innere und äußere Geschliffen-Effekte werden am inneren bzw. äußeren Rand platziert. Ein vollständiger Geschliffen-Effekt wird auf dem gesamten Objekt platziert. Bei den zulässigen Werten handelt es sich um die BitmapFilterType-Konstanten:


Implementierung
    public function get type():String
    public function set type(value:String):void

Auslöser
TypeError — Der String ist leer, wenn gesetzt.
Konstruktordetail
BevelFilter()Konstruktor
public function BevelFilter(distance:Number = 4.0, angle:Number = 45, highlightColor:uint = 0xFFFFFF, highlightAlpha:Number = 1.0, shadowColor:uint = 0x000000, shadowAlpha:Number = 1.0, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1, quality:int = 1, type:String = "inner", knockout:Boolean = false)

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Initialisiert eine neue BevelFilter-Instanz mit den angegebenen Parametern.

Parameter
distance:Number (default = 4.0) — Der Versatz der geschliffenen Kante in Pixel (Gleitkommazahl).
 
angle:Number (default = 45) — Der Winkel der geschliffenen Kante von 0 bis 360 Grad.
 
highlightColor:uint (default = 0xFFFFFF) — Die Glanzlichtfarbe der geschliffenen Kante im Format 0xRRGGBB.
 
highlightAlpha:Number (default = 1.0) — Der Alphatransparenzwert der Glanzlichtfarbe. Die zulässigen Werte liegen zwischen 0,0 und 1,0. Mit dem Wert 0,25 wird beispielsweise ein Transparenzwert von 25 % festgelegt.
 
shadowColor:uint (default = 0x000000) — Die Schattenfarbe der geschliffenen Kante im Format 0xRRGGBB.
 
shadowAlpha: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 in Pixel. Die zulässigen Werte liegen zwischen 0 und 255., (Gleitkomma).
 
blurY:Number (default = 4.0) — Der Grad der vertikalen Weichzeichnung in Pixel. Die zulässigen Werte liegen zwischen 0 und 255, (Gleitkomma).
 
strength:Number (default = 1) — 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 geschliffenen Bereich und dem Hintergrund. Die zulässigen Werte liegen zwischen 0 und 255,0
 
quality:int (default = 1) — Die Qualität der geschliffenen Kante. Die zulässigen Werte liegen zwischen 0 und 15. In den meisten Anwendungen können Sie jedoch die BitmapFilterQuality-Konstanten verwenden:
  • BitmapFilterQuality.LOW
  • BitmapFilterQuality.MEDIUM
  • BitmapFilterQuality.HIGH

Filter mit niedrigen Werten werden schneller dargestellt. Sie können die anderen verfügbaren Zahlenwerte verwenden, um andere Effekte zu erzielen.

 
type:String (default = "inner") — Der Typ der geschliffenen Kante. Bei den zulässigen Werten handelt es sich um die BitmapFilterType-Konstanten: BitmapFilterType.INNER, BitmapFilterType.OUTER oder BitmapFilterType.FULL.
 
knockout:Boolean (default = false) — Wendet einen Aussparungseffekt (true) an, der die Objektfüllung transparent macht und die Hintergrundfarbe des Dokuments zum Vorschein bringt.

Siehe auch

Methodendetail
clone()Methode
public override function clone():BitmapFilter

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Gibt eine Kopie dieses Filterobjekts zurück.

Rückgabewerte
BitmapFilter — Eine neue BevelFilter-Instanz mit allen Eigenschaften der ursprünglichen BevelFilter-Instanz.
Beispiele Verwendung von Beispielen
BevelFilterExample.as

Im folgenden Beispiel wird ein dunkelgelbes Quadrat erstellt, auf das ein leuchtend gelbes (0xFFFF00) Glanzlicht und ein blauer (0x0000FF) Schatten angewendet werden. Der allgemeine Workflow dieses Beispiels lautet wie folgt:
  1. Importieren Sie die erforderlichen Klassen.
  2. Deklarieren Sie drei Eigenschaften für die draw()-Funktion, mit der das Objekt, auf das der Geschliffen-Filter angewendet wird, gezeichnet wird.
  3. Erstellen Sie die BevelFilterExample()-Konstruktorfunktion, die Folgendes bewirkt:
    • Ruft die draw()-Funktion auf, die später deklariert wird.
    • Deklariert eine Variable filter als BitmapFilter-Objekt und weist es dem Wert zu, der sich aus dem Aufruf von getBitmapFilter() ergibt.
    • Erstellt ein neues Array-Objekt myFilters und fügt filter zum Array hinzu. Anschließend wird myFilters der filters-Eigenschaft des BevelFilterExample-Objekts zugewiesen. Dadurch werden alle in myFilters vorgefundenen Filter angewendet; in diesem Fall nur filter.
  4. Erstellen Sie die getBitmapFilter-Funktion, mit der Eigenschaften für den Filter erstellt und festgelegt werden.
  5. Erstellen Sie die draw()-Funktion. Diese Funktion verwendet Methoden der Graphics-Klasse, auf die über die Eigenschaft graphics der Sprite-Klasse zugegriffen wird, um das Quadrat zu zeichnen.
package {
    import flash.display.Sprite;
    import flash.filters.BevelFilter;
    import flash.filters.BitmapFilter;
    import flash.filters.BitmapFilterQuality;
    import flash.filters.BitmapFilterType;

    public class BevelFilterExample extends Sprite {
        private var bgColor:uint = 0xFFCC00;
        private var size:uint    = 80;
        private var offset:uint  = 50;

        public function BevelFilterExample() {
            draw();
            var filter:BitmapFilter = getBitmapFilter();
            var myFilters:Array = new Array();
            myFilters.push(filter);
            filters = myFilters;
        }

        private function getBitmapFilter():BitmapFilter {
            var distance:Number       = 5;
            var angleInDegrees:Number = 45;
            var highlightColor:Number = 0xFFFF00;
            var highlightAlpha:Number = 0.8;
            var shadowColor:Number    = 0x0000FF;
            var shadowAlpha:Number    = 0.8;
            var blurX:Number          = 5;
            var blurY:Number          = 5;
            var strength:Number       = 5;
            var quality:Number        = BitmapFilterQuality.HIGH;
            var type:String           = BitmapFilterType.INNER;
            var knockout:Boolean      = false;

            return new BevelFilter(distance,
                                   angleInDegrees,
                                   highlightColor,
                                   highlightAlpha,
                                   shadowColor,
                                   shadowAlpha,
                                   blurX,
                                   blurY,
                                   strength,
                                   quality,
                                   type,
                                   knockout);
        }

        private function draw():void {
            graphics.beginFill(bgColor);
            graphics.drawRect(offset, offset, size, size);
            graphics.endFill();
        }
    }
}




 

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/filters/BevelFilter.html