GradientGlowFilter

Paket	spark.filters
Klasse	public class GradientGlowFilter
Vererbung	GradientGlowFilter GradientFilter BaseDimensionFilter BaseFilter EventDispatcher Object
Implementiert	IBitmapFilter

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Mit der GradientGlowFilter-Klasse können Sie einen Glühen-Effekt mit Farbverlauf auf Anzeigeobjekte anwenden. Ein Glühen-Effekt mit Farbverlauf ist ein Glühen mit realistischem Aussehen in einem von Ihnen festgelegten Farbverlauf. Ein solcher Effekt kann um den inneren oder um den äußeren Rand eines Objekts oder über einem Objekt angewendet werden. 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. Durch die Einstellung der filters-Eigenschaft wird das betroffene Objekt selbst nicht verändert, und Sie können den Filter wieder entfernen, indem Sie die filters-Eigenschaft löschen.
Um Filter auf BitmapData-Objekte anzuwenden, verwenden Sie die BitmapData.applyFilter()-Methode. Durch den Aufruf von applyFilter() 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 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 expanded

MXML-Syntax ausblenden

The <s:GradientGlowFilter> tag inherits all of the tag attributes of its superclass and adds no tag attributes:

  <s:GradientGlowFilter/>

Standard-MXML-Eigenschaftentries

Beispiele anzeigen

Verwandte API-Elemente

spark.filters.GlowFilter
flash.filters.GradientGlowFilter
flash.display.BitmapData.applyFilter()
flash.display.DisplayObject.cacheAsBitmap
flash.display.DisplayObject.filters

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		angle : Number Der Winkel in Grad.	GradientFilter
		blurX : Number Der Grad der horizontalen Weichzeichnung.	BaseDimensionFilter
		blurY : Number Der Grad der vertikalen Weichzeichnung.	BaseDimensionFilter
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		distance : Number Der Offset des Glühen-Effekts.	GradientFilter
		entries : Array Ein Array von GradientEntry-Objekten, die die Füllungsmuster für die Verlaufsfläche definieren.	GradientFilter
		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
		type : String Die Platzierung des Filtereffekts.	GradientFilter

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		GradientGlowFilter(distance:Number = 4.0, angle:Number = 45, colors:Array = null, alphas:Array = null, ratios:Array = null, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1, quality:int = 1, type:String = "outer", knockout:Boolean = false) Konstruktor.	GradientGlowFilter
		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
		clone():BitmapFilter Gibt eine Kopie dieses Filterobjekts zurück.	GradientGlowFilter
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	EventDispatcher
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	EventDispatcher
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		notifyFilterChanged():void Propagiert ein Change-Ereignis, wenn sich der Filter geändert hat.	BaseFilter
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object
		willTrigger(type:String):Boolean Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.	EventDispatcher

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

Vererbte Ereignisse ausblenden

Vererbte Ereignisse anzeigen

	Ereignis		Übersicht	Definiert von
		activate	[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.	EventDispatcher
		deactivate	[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.	EventDispatcher

Öffentliche Konstanten

Vererbte öffentliche Konstanten ausblenden

Vererbte öffentliche Konstanten anzeigen

	Konstante		Definiert von

Konstruktordetails

()

Konstruktor

public function GradientGlowFilter(distance:Number = 4.0, angle:Number = 45, colors:Array = null, alphas:Array = null, ratios:Array = null, blurX:Number = 4.0, blurY:Number = 4.0, strength:Number = 1, quality:int = 1, type:String = "outer", knockout:Boolean = false)

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 4

Laufzeitversionen:

Flash Player 10, AIR 1.5

Konstruktor.

Parameter

	`distance:Number` (default = `4.0`) — Der Offset des Glühen-Effekts.

	`angle:Number` (default = `45`) — Der Winkel in Grad. Die zulässigen Werte liegen zwischen 0 und 360.

	`colors:Array` (default = `null`) — Ein Array von Farben, das einen Farbverlauf definiert. Rot beispielsweise hat den Wert 0xFF0000, Blau den Wert 0x0000FF usw.

	`alphas:Array` (default = `null`) — Ein Array mit Alphatransparenzwerten für die entsprechenden Farben im `colors`-Array. Die zulässigen Werte der einzelnen Elemente des Arrays liegen zwischen 0 und 1. Mit dem Wert 0,25 wird die Alphatransparenz beispielsweise auf 25 % gesetzt.

	`ratios:Array` (default = `null`) — Ein Array von Farbverteilungsverhältnissen. Die zulässigen Werte liegen zwischen 0 und 255. Dieser Wert gibt den Breitenanteil an, in dem die Farbe mit 100 % gesampelt wird.

	`blurX:Number` (default = `4.0`) — Der Grad der horizontalen Weichzeichnung. Die zulässigen Werte liegen zwischen 0 und 255. Eine Weichzeichnung mit einer Stärke von 1 oder weniger bedeutet, dass das Originalbild kopiert wird. Zweierpotenzen (z. B. 2, 4, 8, 16 und 32) sind optimiert und ergeben eine schnellere Anzeige als andere Werte.

	`blurY:Number` (default = `4.0`) — Der Grad der vertikalen Weichzeichnung. Die zulässigen Werte liegen zwischen 0 und 255. Eine Weichzeichnung mit einer Stärke von 1 oder weniger bedeutet, dass das Originalbild kopiert wird. Zweierpotenzen (z. B. 2, 4, 8, 16 und 32) sind optimiert und ergeben eine schnellere Anzeige als andere Werte.

	`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 Glühen und dem Hintergrund. Die zulässigen Werte liegen zwischen 0 und 255. Je höher der Wert, desto mehr Farbe wird aufgedruckt. Der Wert 0 bedeutet, dass der Filter nicht angewendet wird.

	`quality:int` (default = `1`) — Gibt an, wie oft der Filter angewendet werden soll. Verwenden Sie die flash.filters.BitmapFilterQuality-Konstanten: `BitmapFilterQuality.LOW` `BitmapFilterQuality.MEDIUM` `BitmapFilterQuality.HIGH` Weitere Informationen finden Sie in der Beschreibung der `quality`-Eigenschaft.

	`type:String` (default = "`outer`") — Die Platzierung des Filtereffekts. Mögliche Werte sind die flash.filters.BitmapFilterType-Konstanten: `BitmapFilterType.OUTER` – Glühen-Effekt am äußeren Rand des Objekts; Standardeinstellung. `BitmapFilterType.INNER` — Glühen-Effekt am inneren Rand des Objekts `BitmapFilterType.FULL` – Glühen-Effekt über dem Objekt

	`knockout:Boolean` (default = `false`) — Gibt an, ob für das Objekt ein Aussparungseffekt definiert wurde. Mit einem Aussparungseffekt wird eine transparente Füllung des Objekts definiert, die Hintergrundfarbe des Dokuments wird sichtbar. Der Wert `true` gibt an, dass ein Aussparungseffekt angewendet werden soll. Der Standardwert lautet `false` (kein Aussparungseffekt).

Methodendetails

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ückgabewerte

BitmapFilter — Eine neue GradientGlowFilter-Instanz mit allen Eigenschaften der ursprünglichen GradientGlowFilter-Instanz.

Beispiele Verwendung dieses Beispiels

GradientGlowFilterExample.mxml

<?xml version="1.0"?>
<!-- filters/examples/GradientGlowFilterExample .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 myGradientGlowFilter:GradientGlowFilter;  
     private var colors:Array = [0xFFFFFF, 0xFF0000, 0xFFFF00, 0x00CCFF];
     private var alphas:Array = [0, 1, 1, 1];  
     private var ratios:Array = [0, 63, 126, 255];
             
     public function createFilters():void {        
        myGradientGlowFilter = new GradientGlowFilter(0, 45, colors, alphas,
            ratios, 50, 50, 2.5, BitmapFilterQuality.HIGH, BitmapFilterType.OUTER, false);
        b1.filters = [myGradientGlowFilter];
     }
  
  ]]></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:GradientGlowFilter 
                    distance="10"
                    angle="45"
                    blurX="50" 
                    blurY="50" 
                    strength="2.5" 
                    quality="{BitmapFilterQuality.HIGH}"
                    type="{BitmapFilterType.OUTER}" 
                    knockout="false">
                        <s:entries>
                            <s:GradientEntry alpha="0" color="0xFFFFFF" ratio="0"/>
                            <s:GradientEntry alpha="1" color="0xFF0000" ratio="63"/>
                            <s:GradientEntry alpha="1" color="0xFFFF00" ratio="126"/>
                            <s:GradientEntry alpha="1" color="0x00CCFF" ratio="255"/>
                        </s:entries>
                 </s:GradientGlowFilter>
            </s:filters>
        </s:Button>
    </s:VGroup>        
</s:Application>

Rechtliche Hinweise | Onlinedatenschutzerklärung

GradientGlowFilter - AS3 Flex

Klassen x

GradientGlowFilter

clone