| Paket | spark.filters |
| Klasse | public class ConvolutionFilter |
| Vererbung | ConvolutionFilter  BaseFilter EventDispatcher Object |
| Implementiert | IBitmapFilter |
| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Verwenden Sie zum Erstellen eines Convolution-Filters die Syntax new ConvolutionFilter(). Die Verwendung von Filtern hängt davon ab, auf welches Objekt sie jeweils angewendet werden:
- Um Filter auf Movieclips, Textfelder, Schaltflächen und Videosequenzen anzuwenden, verwenden Sie die Eigenschaft
filters(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 Objekts auf true gesetzt. Wenn Sie alle Filter entfernen, wird der ursprüngliche Wert von cacheAsBitmap wiederhergestellt.
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
MXML-Syntax anzeigen
MXML-Syntax ausblendenThe <s:ConvolutionFilter> tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:
<s:ConvolutionFilter Properties alpha="1" clamp="true" color="0xFF0000" divisor="1.0" matrix="[]" matrixX="0" matrixY="0" preserveAlpha="true" />
| Eigenschaft | Definiert von | ||
|---|---|---|---|
| alpha : Number
Der Alphatransparenzwert der Farbe. | ConvolutionFilter | ||
| bias : Number
Der Ausgleichswert, der dem Ergebnis der Matrixtransformation hinzugefügt wird. | ConvolutionFilter | ||
| clamp : Boolean
Gibt an, ob das Bild an einer bestimmten Position festgesetzt werden soll. | ConvolutionFilter | ||
| color : uint
Die Farbe des Glühen-Effekts. | ConvolutionFilter | ||
 | constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| divisor : Number
Der während der Matrixtransformation verwendete Nenner. | ConvolutionFilter | ||
| matrix : Array
Der Grad der horizontalen Weichzeichnung. | ConvolutionFilter | ||
| matrixX : Number
Die x-Dimension der Matrix (die Anzahl der Zeilen in der Matrix). | ConvolutionFilter | ||
| matrixY : Number
Die y-Dimension der Matrix (die Anzahl an Spalten in der Matrix). | ConvolutionFilter | ||
| preserveAlpha : Boolean
Gibt an, ob der Alphakanal ohne Anwendung des Filtereffekts beibehalten wird oder ob der Convolution-Filter neben den Farbkanälen auch auf den Alphakanal angewendet wird. | ConvolutionFilter | ||
| Methode | Definiert von | ||
|---|---|---|---|
ConvolutionFilter(matrixX:Number = 0, matrixY:Number = 0, matrix:Array = null, divisor:Number = 1.0, bias:Number = 0.0, preserveAlpha:Boolean = true, clamp:Boolean = true, color:uint = 0, alpha:Number = 0.0)
Konstruktor. | ConvolutionFilter | ||
| 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. | ConvolutionFilter | ||
|
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):voidbias | Eigenschaft |
bias:Number| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Der Ausgleichswert, der dem Ergebnis der Matrixtransformation hinzugefügt wird. Der Ausgleichswert erhöht den Farbwert jedes Kanals, sodass dunkle Farben heller erscheinen.
Der Standardwert ist 0.
Implementierung
public function get bias():Number public function set bias(value:Number):voidclamp | Eigenschaft |
clamp:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Gibt an, ob das Bild an einer bestimmten Position festgesetzt werden soll. Für Pixel außerhalb des Quellbilds gibt true an, dass das Eingabebild wie erforderlich durch Duplizierung der Farbwerte an seinem bestehenden Rand über seine Begrenzungen hinaus erweitert wird. Der Wert false gibt dagegen an, dass entsprechend den Eigenschaften color und alpha eine andere Farbe verwendet werden soll.
Der Standardwert ist true.
Implementierung
public function get clamp():Boolean public function set clamp(value:Boolean):voidcolor | 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):voiddivisor | Eigenschaft |
divisor:Number| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Der während der Matrixtransformation verwendete Nenner. Der Standardwert ist 1. Ein Nenner in der Höhe der Summe aller Matrixwerte gleicht die allgemeine Farbintensität des Ergebnisses aus. Der Wert 0 wird ignoriert, stattdessen wird der Standardwert verwendet.
Der Standardwert ist 1.0.
Implementierung
public function get divisor():Number public function set divisor(value:Number):voidmatrix | Eigenschaft |
matrix:Array| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
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. Der Standardwert ist 4. Zweierpotenzen (z. B. 2, 4, 8, 16 und 32) sind optimiert und ergeben eine schnellere Anzeige als andere Werte.
Der Standardwert ist [].
Implementierung
public function get matrix():Array public function set matrix(value:Array):voidmatrixX | Eigenschaft |
matrixX:Number| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Die x-Dimension der Matrix (die Anzahl der Zeilen in der Matrix).
Der Standardwert ist 0.
Implementierung
public function get matrixX():Number public function set matrixX(value:Number):voidmatrixY | Eigenschaft |
matrixY:Number| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Die y-Dimension der Matrix (die Anzahl an Spalten in der Matrix).
Der Standardwert ist 0.
Implementierung
public function get matrixY():Number public function set matrixY(value:Number):voidpreserveAlpha | Eigenschaft |
preserveAlpha:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Gibt an, ob der Alphakanal ohne Anwendung des Filtereffekts beibehalten wird oder ob der Convolution-Filter neben den Farbkanälen auch auf den Alphakanal angewendet wird. Der Wert false gibt an, dass die Convolution auf alle Kanäle angewendet werden soll, auch auf den Alphakanal. Bei true gilt die Convolution nur für die Farbkanäle.
Der Standardwert ist true.
Implementierung
public function get preserveAlpha():Boolean public function set preserveAlpha(value:Boolean):voidConvolutionFilter | () | Konstruktor |
public function ConvolutionFilter(matrixX:Number = 0, matrixY:Number = 0, matrix:Array = null, divisor:Number = 1.0, bias:Number = 0.0, preserveAlpha:Boolean = true, clamp:Boolean = true, color:uint = 0, alpha:Number = 0.0)| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 4 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Konstruktor.
ParametermatrixX:Number (default = 0) | |
matrixY:Number (default = 0) | |
matrix:Array (default = null)matrixX * matrixY entsprechen.
| |
divisor:Number (default = 1.0) | |
bias:Number (default = 0.0) | |
preserveAlpha:Boolean (default = true)false gibt an, dass der Alphawert nicht übernommen wird, sondern dass der Convolution-Filter auf alle Kanäle, einschließlich des Alphakanals, angewendet wird. Bei true gilt die Convolution nur für die Farbkanäle. Der Standardwert ist true.
| |
clamp:Boolean (default = true)true an, dass das Eingabebild durch Duplizierung der Farbwerte an einem bestimmten Rand soweit wie nötig über seine Begrenzungen hinaus erweitert wird. Der Wert false gibt dagegen an, dass entsprechend den Eigenschaften color und alpha eine andere Farbe verwendet werden soll. Der Standardwert lautet true.
| |
color:uint (default = 0) | |
alpha:Number (default = 0.0) |
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 — BitmapFilter, eine neue ConvolutionFilter-Instanz mit allen Eigenschaften der ursprünglichen ConvolutionMatrixFilter-Instanz.
|
<?xml version="1.0"?>
<!-- filters/examples/ConvolutionGlowFilterExample .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 myOutlineConvolutionFilter:ConvolutionFilter;
private var mySharpnessConvolutionFilter:ConvolutionFilter;
private var myBrightnessConvolutionFilter:ConvolutionFilter;
private var outlineMatrix:Array = [ -30, 30, 0,
-30, 30, 0,
-30, 30, 0 ];
private var sharpnessMatrix:Array = [0, -1, 0,
-1, 20, -1,
0, -1, 0];
private var brightnessMatrix:Array = [2, 2, 2,
2, 0, 2,
2, 2, 2];
public function createFilters():void {
myOutlineConvolutionFilter = new ConvolutionFilter(3, 3, outlineMatrix, 9, 0, true, true, 0x00CC99, 0);
mySharpnessConvolutionFilter = new ConvolutionFilter(3, 3, sharpnessMatrix, 9, 0, true, true, 0x00CC99, 0);
myBrightnessConvolutionFilter = new ConvolutionFilter(3, 3, brightnessMatrix, 3, 0, true, true, 0x00CC99, 0);
outlineImage.filters = [myOutlineConvolutionFilter];
sharpnessImage.filters = [mySharpnessConvolutionFilter];
brightnessImage.filters = [myBrightnessConvolutionFilter];
}
]]></fx:Script>
<s:VGroup>
<s:VGroup>
<s:Label text="Original Image"/>
<mx:Image id="originalImage" source="@Embed(source='assets/Nokia_6630.png')"/>
</s:VGroup>
<s:VGroup>
<s:Label text="Outline Matrix Image"/>
<mx:Image id="outlineImage" source="@Embed(source='assets/Nokia_6630.png')"/>
</s:VGroup>
<s:VGroup>
<s:Label text="Sharpness Matrix Image"/>
<mx:Image id="sharpnessImage" source="@Embed(source='assets/Nokia_6630.png')"/>
</s:VGroup>
<s:VGroup>
<s:Label text="Brightness Matrix Image"/>
<mx:Image id="brightnessImage" source="@Embed(source='assets/Nokia_6630.png')"/>
</s:VGroup>
</s:VGroup>
</s:Application>
Tue Jun 12 2018, 10:04 AM Z