spark.filtersGradientBevelFilter Mit der GradientBevelFilter-Klasse können Sie einen Farbverlaufseffekt und eine Abschrägung auf Anzeigeobjekte anwenden.The <s:GradientBevelFilter> tag inherits all of the tag attributes of its superclass and adds no tag attributes:

  <s:GradientBevelFilter/>
  
]]>
mx.filters:IBitmapFilterspark.filters:GradientFilter Mit der GradientBevelFilter-Klasse können Sie einen Farbverlaufseffekt und eine Abschrägung auf Anzeigeobjekte anwenden. Bei einem Farbverlauf mit Abschrägung handelt es sich um eine abgeflachte Kante, bei der die Außen-, Innen- oder Oberseite eines Objekts einen Farbverlauf erhielten. Abgeflachte Kanten lassen ein Objekt dreidimensional erscheinen. 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.

spark.filters.BevelFilterflash.filters.GradientBevelFilterGradientBevelFilter.ratiosflash.display.BitmapData.applyFilter()flash.display.DisplayObject.filtersflash.display.DisplayObject.cacheAsBitmapGradientBevelFilter Konstruktor.distance4.0Der Offset-Abstand. Die zulässigen Werte liegen zwischen 0 und 8. angle45Der Winkel in Grad. Die zulässigen Werte liegen zwischen 0 und 360. colorsnullEin Array mit den im Farbverlauf zu verwendenden RGB-Hexadezimalfarbwerten. Rot beispielsweise hat den Wert 0xFF0000, Blau den Wert 0x0000FF usw. alphasnullEin 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 beispielsweise ein Transparenzwert von 25 % festgelegt. ratiosnullEin Array mit Farbverteilungsverhältnissen. Die zulässigen Werte liegen zwischen 0 und 255. blurX4.0Der 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. blurY4.0Der 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. strength1Die Stärke des Abdrucks oder Auftragens. Je höher der Wert, desto mehr Farbe wird aufgetragen und desto stärker ist der Kontrast zwischen der Abschrägung und dem Hintergrund. Die zulässigen Werte liegen zwischen 0 und 255. Der Wert 0 bedeutet, dass der Filter nicht angewendet wird. quality1Die Qualität des Filters. Verwenden Sie die BitmapFilterQuality-Konstanten:
  • BitmapFilterQuality.LOW
  • BitmapFilterQuality.MEDIUM
  • BitmapFilterQuality.HIGH

Weitere Informationen finden Sie in der Beschreibung der quality-Eigenschaft.

typeinnerDie Platzierung des Abschrägungseffekts. Zulässige Werte sind die BitmapFilterType-Konstanten:
  • BitmapFilterType.OUTER – Abschrägung an der Außenkante des Objekts
  • BitmapFilterType.INNER – Abschrägung an der Innenkante des Objekts
  • BitmapFilterType.FULL – Abschrägung auf dem Objekt
knockoutfalseGibt an, ob ein Aussparungseffekt angewendet wird. Mit true wird eine transparente Füllung des Objekts definiert, die Hintergrundfarbe des Dokuments wird sichtbar.
Konstruktor.
clone Gibt eine Kopie dieses Filterobjekts zurück.Eine neue GradientBevelFilter-Instanz mit allen Eigenschaften der ursprünglichen GradientBevelFilter-Instanz. Gibt eine Kopie dieses Filterobjekts zurück.
DropShadowFilter Mit der DropShadowFilter-Klasse können Sie einem Anzeigeobjekt einen Schlagschatten hinzufügen.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"
  />
  
]]>
mx.filters:IBitmapFiltermx.filters:BaseDimensionFilter Mit der DropShadowFilter-Klasse können Sie einem Anzeigeobjekt einen Schlagschatten hinzufügen. Der Schattenalgorithmus beruht auf dem gleichen Box-Filter, der auch beim Weichzeichnen-Filter verwendet wird. Für den Stil eines Schlagschattens stehen verschiedene Optionen zur Verfügung, z. B. innere und äußere Schatten oder der Aussparungsmodus. 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 (von DisplayObject übernommen). 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 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.

flash.filters.DropShadowFilterDropShadowFilter Konstruktor.distance4.0Der Offset des Schattens in Pixeln. angle45Der Winkel des Schattens von 0 bis 360 Grad (Gleitkommazahl). color0Die Farbe des Schattens im Hexadezimalformat 0xRRGGBB. Der Standardwert lautet 0x000000. alpha1.0Der 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. blurX4.0Der Grad der horizontalen Weichzeichnung. Die zulässigen Werte liegen zwischen 0 und 255.0 (Gleitkomma). blurY4.0Der Grad der vertikalen Weichzeichnung. Die zulässigen Werte liegen zwischen 0 und 255.0 (Gleitkomma). strength1.0Die 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. quality1Gibt an, wie oft der Filter angewendet werden soll. Verwenden Sie die BitmapFilterQuality-Konstanten:
  • BitmapFilterQuality.LOW
  • BitmapFilterQuality.MEDIUM
  • BitmapFilterQuality.HIGH

Weitere Informationen zu diesem Parameter finden Sie in der Beschreibung der quality-Eigenschaft.

innerfalseGibt 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. knockoutfalseWendet einen Aussparungseffekt (true) an, der die Objektfüllung transparent macht und die Hintergrundfarbe des Dokuments zum Vorschein bringt. hideObjectfalseGibt an, ob das Objekt ausgeblendet wird oder nicht. Der Wert true gibt an, dass nicht das Objekt selbst sondern nur sein Schatten sichtbar ist.
Konstruktor.
flash.filters.BitmapFilterQuality
clone Gibt eine Kopie dieses Filterobjekts zurück.Eine neue DropShadowFilter-Instanz mit allen Eigenschaften der ursprünglichen Instanz. Gibt eine Kopie dieses Filterobjekts zurück. alpha Der Alphatransparenzwert der Farbe.1 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. angle Der Winkel der Abschrägung.45 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. color Die Farbe des Glühen-Effekts.0xFF0000 Die Farbe des Glühen-Effekts. Die zulässigen Werte werden im Hexadezimalformat 0xRRGGBB angegeben. distance Der Offset der Abschrägung.4 Der Offset der Abschrägung. Die zulässigen Werte sind in Pixeln angegeben (Gleitkommazahl). hideObject Gibt an, ob das Objekt ausgeblendet wird oder nicht.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. Der Standardwert lautet false, d. h. das Objekt wird angezeigt. inner Gibt an, ob es sich um ein inneres Glühen handelt.false 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.
ConvolutionFilter Die ConvolutionFilter-Klasse wendet einen Matrix-Convolution-Filtereffekt an.The <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"
 />
 
]]>
mx.filters:IBitmapFiltermx.filters:BaseFilter Die ConvolutionFilter-Klasse wendet einen Matrix-Convolution-Filtereffekt an. Bei einem Convolution-Filter wird durch Kombination der Pixel im Eingabebild mit den benachbarten Pixel ein neues Bild erstellt. Mithilfe von Convolution-Filtern können zahlreiche Bildeffekte erzielt werden, darunter Weich- oder Scharfzeichnung, Kantenerkennung, Prägung und Schliff. 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 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 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 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.

ConvolutionFilter Konstruktor.matrixX0Die x-Dimension der Matrix (die Anzahl der Spalten in der Matrix). Der Standardwert ist 0. matrixY0Die y-Dimension der Matrix (die Anzahl der Zeilen in der Matrix). Der Standardwert ist 0. matrixnullDas Array von für die Matrixtransformation verwendeten Werten. Die Anzahl der Elemente in diesem Array muss matrixX ~~ matrixY entsprechen. divisor1.0Der 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. bias0.0Der Ausgleichswert, der dem Ergebnis der Matrixtransformation hinzugefügt wird. Der Standardwert ist 0. preserveAlphatrueDer Wert 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. clamptrueFür Pixel außerhalb des Quellbilds gibt 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. color0Der Hexadezimalwert der Farbe, durch die die Pixel außerhalb des Quellbilds ersetzt werden. alpha0.0Der Alphawert der Ersatzfarbe. Konstruktor. clone Gibt eine Kopie dieses Filterobjekts zurück.BitmapFilter, eine neue ConvolutionFilter-Instanz mit allen Eigenschaften der ursprünglichen ConvolutionMatrixFilter-Instanz. Gibt eine Kopie dieses Filterobjekts zurück. alpha Der Alphatransparenzwert der Farbe.1 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. bias Der Ausgleichswert, der dem Ergebnis der Matrixtransformation hinzugefügt wird.0 Der Ausgleichswert, der dem Ergebnis der Matrixtransformation hinzugefügt wird. Der Ausgleichswert erhöht den Farbwert jedes Kanals, sodass dunkle Farben heller erscheinen. clamp Gibt an, ob das Bild an einer bestimmten Position festgesetzt werden soll.true 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. color Die Farbe des Glühen-Effekts.0xFF0000 Die Farbe des Glühen-Effekts. Die zulässigen Werte werden im Hexadezimalformat 0xRRGGBB angegeben. divisor Der während der Matrixtransformation verwendete Nenner.1.0 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. matrixX Die x-Dimension der Matrix (die Anzahl der Zeilen in der Matrix).0 Die x-Dimension der Matrix (die Anzahl der Zeilen in der Matrix). matrixY Die y-Dimension der Matrix (die Anzahl an Spalten in der Matrix).0 Die y-Dimension der Matrix (die Anzahl an Spalten in der Matrix). matrix Der Grad der horizontalen Weichzeichnung.[] 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. preserveAlpha 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.true 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.
BlurFilter Mit der BlurFilter-Klasse können Sie einen Weichzeichnungseffekt auf Anzeigeobjekte anwenden.The <s:BlurFilter> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:BlurFilter
    Properties
    blurX="4.0"
    blurY="4.0"
    quality="low"
  />
  
]]>
mx.filters:IBitmapFiltermx.filters:BaseFilter Mit der BlurFilter-Klasse können Sie einen Weichzeichnungseffekt auf Anzeigeobjekte anwenden. Die Weichzeichnung verwischt die Einzelheiten eines Bilds. Dabei können Sie Weichzeichnungen erstellen, die von einer geringfügig unscharfen Anzeige bis zu einer Gauß-Weichzeichnung reichen, einer verschwommenen Sicht, etwa wie durch eine Milchglasscheibe. Wird die quality-Eigenschaft dieses Filter dabei auf „Niedrig“ gesetzt, führt dies zu einem geringfügig unscharfen Erscheinungsbild generiert. Wird die quality-Eigenschaft dagegen auf „Hoch“ eingestellt, ergibt dies in etwa ein Gauß-Verwischen. 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 newBlurFilter()-Konstruktor. 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 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 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 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.

flash.filters.BlurFilterflash.display.DisplayObject.filtersflash.display.DisplayObject.cacheAsBitmapflash.display.BitmapData.applyFilter()BlurFilter Konstruktor.blurX4.0Der Grad der horizontalen Weichzeichnung. Die zulässigen Werte liegen zwischen 0 und 255,0 (Gleitkommazahl). blurY4.0Der Grad der vertikalen Weichzeichnung. Die zulässigen Werte liegen zwischen 0 und 255,0 (Gleitkommazahl). quality1Gibt an, wie oft der Filter angewendet werden soll. Sie können die Qualität angeben, indem Sie die flash.filters.BitmapFilterQuality-Konstanten verwenden:
  • flash.filters.BitmapFilterQuality.LOW
  • flash.filters.BitmapFilterQuality.MEDIUM
  • flash.filters.BitmapFilterQuality.HIGH

Hohe Qualität entspricht etwa einer Gauß-Weichzeichnung. Für die meisten Anwendungen sind diese drei Werte ausreichend. Sie können zwar weitere Zahlenwerte bis 15 angeben, um unterschiedliche Effekte zu erzielen, beachten Sie jedoch, dass höhere Werte auch zu einer langsameren Wiedergabe führen.

Initialisiert den Filter.
Konstruktor. Mit den Standardwerten wird ein weiches unscharfes Bild erstellt.
clone Gibt eine Kopie dieses Filterobjekts zurück.Eine neue „BlurFilter“-Instanz mit allen Eigenschaften der ursprünglichen „BlurFilter“-Instanz. Gibt eine Kopie dieses Filterobjekts zurück. blurX Der Grad der horizontalen Weichzeichnung.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. Der Standardwert ist 4. Zweierpotenzen (z. B. 2, 4, 8, 16 und 32) sind optimiert und ergeben eine schnellere Anzeige als andere Werte. blurY Der Grad der vertikalen Weichzeichnung.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. Der Standardwert ist 4. Zweierpotenzen (z. B. 2, 4, 8, 16 und 32) sind optimiert und ergeben eine schnellere Anzeige als andere Werte. quality Gibt an, wie oft der Filter angewendet werden soll."low" 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.

ColorMatrixFilter Mithilfe der ColorMatrixFilter-Klasse können Sie eine 4 x 5-Matrixtransformation auf den RGBA-Farb- und Alphawert jedes Pixels eines Eingabebilds anwenden, um ein neues RGBA-Farb- und Alphamuster zu erhalten.The <s:ColorMatrixFilter> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:ColorMatrixFilter
    Properties
    matrix="[1,0,0,0,0,0,1,0,0,0,0,0,1,0,0,0,0,0,1,0]"
  />
  
]]>
mx.filters:IBitmapFiltermx.filters:BaseFilter Mithilfe der ColorMatrixFilter-Klasse können Sie eine 4 x 5-Matrixtransformation auf den RGBA-Farb- und Alphawert jedes Pixels eines Eingabebilds anwenden, um ein neues RGBA-Farb- und Alphamuster zu erhalten. Dies ermöglicht Änderungen der Sättigung, des Farbtons und der Luminanz sowie viele andere Effekte. 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. flash.filters.ColorMatrixFilterColorMatrixFilter Konstruktor.matrixnullEin Array von 20 Elementen, die als 4 x 5-Matrix angeordnet sind. Initialisiert eine neue ColorMatrixFilter-Instanz. Konstruktor. clone Gibt eine Kopie dieses Filterobjekts zurück.Eine neue ColorMatrixFilter-Instanz mit allen Eigenschaften der ursprünglichen Instanz. Gibt eine Kopie dieses Filterobjekts zurück. matrix Eine kommagetrennte Liste mit 20 Verdopplungen, die eine 4x5-Matrix umfasst, die auf das gerenderte Element angewendet wird.[1,0,0,0,0,0,1,0,0,0,0,0,1,0,0,0,0,0,1,0] Eine kommagetrennte Liste mit 20 Verdopplungen, die eine 4x5-Matrix umfasst, die auf das gerenderte Element angewendet wird. Die Matrix befindet sich in der row major-Reihenfolge. Dies bedeutet, dass die ersten fünf Elemente mit dem Vektor [srcR,srcG,srcB,srcA,1] multipliziert werden, um den Rotwert der Ausgabe zu bestimmen, mit den zweiten fünf Elementen Grünwert der Ausgabe bestimmt wird usw.

Bei dem Wert muss es sich entweder um ein Array oder um einen kommagetrennten String mit 20 Ziffern handeln.

GradientFilter Die Basisklasse für Filter, die Effekte mit Farbverlauf bieten.The <s:GradientFilter> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:GradientFilter
    Properties
    angle="45"
    distance="4.0"
    entries="[]"
    type="inner"
  />
  
]]>
mx.filters:BaseDimensionFilter Die Basisklasse für Filter, die Effekte mit Farbverlauf bieten. spark.filters.GradientGlowFilterspark.filters.GradientBevelFilterGradientFilter Konstruktor.colorsnullEin Array mit den im Farbverlauf zu verwendenden RGB-Hexadezimalfarbwerten. Rot beispielsweise hat den Wert 0xFF0000, Blau den Wert 0x0000FF usw. alphasnullEin 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 beispielsweise ein Transparenzwert von 25 % festgelegt. ratiosnullEin Array mit Farbverteilungsverhältnissen. Die zulässigen Werte liegen zwischen 0 und 255. Konstruktor. angle Der Winkel in Grad.45 Der Winkel in Grad. Die zulässigen Werte liegen zwischen 0 und 360. Dieser Wert stellt den Winkel einer imaginären, das Objekt beleuchtenden Lichtquelle dar und bestimmt die Position des Effekts relativ zu diesem Objekt. Falls distance auf 0 (null) gesetzt wird, ist der Offset des Effekts gleich null und die angle-Eigenschaft hat keine Auswirkungen. distance Der Offset des Glühen-Effekts.4.0 Der Offset des Glühen-Effekts. entries Ein Array von GradientEntry-Objekten, die die Füllungsmuster für die Verlaufsfläche definieren.[] Ein Array von GradientEntry-Objekten, die die Füllungsmuster für die Verlaufsfläche definieren. type Die Platzierung des Filtereffekts.BitmapFilterType.INNER Die Platzierung des Filtereffekts. Mögliche Werte sind die „flash.filters.BitmapFilterType“-Konstanten:
  • BitmapFilterType.OUTER – Glühen-Effekt am äußeren Rand des Objekts.
  • BitmapFilterType.INNER – Glühen-Effekt an der Innenkante des Objekts.
  • BitmapFilterType.FULL – Glühen-Effekt über dem Objekt.
flash.filters.BitmapFilterType
BevelFilter Mit der BevelFilter-Klasse können Sie einen Abschrägungseffekt auf Anzeigeobjekte anwenden.The <s:BevelFilter> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:BevelFilter 
    Properties
    angle="45"
    distance="4"
    highlightAlpha="1"
    highlightColor="0xFFFFFF"
    shadowAlpha="1"
    shadowColor="0x000000"
    type="inner"
  />
  
]]>
mx.filters:IBitmapFiltermx.filters:BaseDimensionFilter Mit der BevelFilter-Klasse können Sie einen Abschrägungseffekt auf Anzeigeobjekte anwenden. Durch diesen Abschrägungseffekt erhalten Objekte, beispielsweise Schaltflächen, ein dreidimensionales Aussehen mit abgeflachten Kanten. 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 abgeflachten 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:

  • Um Filter auf Movieclips, Textfelder, Schaltflächen und Videosequenzen anzuwenden, verwenden Sie die Eigenschaft filters (von DisplayObject übernommen). 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 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 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.

flash.filters.BevelFilterflash.display.DisplayObject.filtersflash.display.DisplayObject.cacheAsBitmapflash.display.BitmapData.applyFilter()BevelFilter Konstruktor.distance4.0Der Offset der Abschrägung in Pixeln (Gleitkommazahl). angle45Der Winkel der Abschrägung von 0 bis 360 Grad. highlightColor0xFFFFFFDie Glanzlichtfarbe der Abschrägung im Format 0xRRGGBB. highlightAlpha1.0Der 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. shadowColor0x000000Die Schattenfarbe der Abschrägung im Format 0xRRGGBB. shadowAlpha1.0Der 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. blurX4.0Der Grad der horizontalen Weichzeichnung in Pixeln. Die zulässigen Werte liegen zwischen 0 und 255.0 (Gleitkomma). blurY4.0Der Grad der vertikalen Weichzeichnung in Pixeln. Die zulässigen Werte liegen zwischen 0 und 255.0 (Gleitkomma). strength1Die Stärke des Abdrucks oder Auftragens. Je höher der Wert, desto mehr Farbe wird aufgetragen und desto stärker ist der Kontrast zwischen der Abschrägung und dem Hintergrund. Die zulässigen Werte liegen zwischen 0 und 255.0. quality1Die Qualität der Abschrägung. Gültige Werte liegen zwischen 0 und 15, aber bei den meisten Anwendungen können Sie flash.filters.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.

typeinnerDer Typ der Abschrägung. Gültige Werte sind flash.filters.BitmapFilterType-Konstanten: BitmapFilterType.INNER, BitmapFilterType.OUTER oder BitmapFilterType.FULL. knockoutfalseWendet einen Aussparungseffekt (true) an, der die Objektfüllung transparent macht und die Hintergrundfarbe des Dokuments zum Vorschein bringt.
Konstruktor.
flash.filters.BitmapFilterQualityflash.filters.BitmapFilterType
clone Gibt eine Kopie dieses Filterobjekts zurück.Eine neue BevelFilter-Instanz mit allen Eigenschaften der ursprünglichen BevelFilter-Instanz. Gibt eine Kopie dieses Filterobjekts zurück. angle Der Winkel der Abschrägung in Grad.45 Der Winkel der Abschrägung in Grad. Die zulässigen Werte liegen zwischen 0 und 360. 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. distance Der Offset der Abschrägung.4 Der Offset der Abschrägung. Die zulässigen Werte sind in Pixeln angegeben (Gleitkommazahl). highlightAlpha Der Alphatransparenzwert der Glanzlichtfarbe.1 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. highlightColor Die Glanzlichtfarbe der Abschrägung.0xFFFFFF Die Glanzlichtfarbe der Abschrägung. Die zulässigen Werte werden im Hexadezimalformat 0xRRGGBB angegeben. shadowAlpha Der Alphatransparenzwert der Schattenfarbe.1 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. shadowColor Die Schattenfarbe der Abschrägung.0x000000 Die Schattenfarbe der Abschrägung. Die zulässigen Werte werden im Hexadezimalformat 0xRRGGBB angegeben. type Die Platzierung des Filtereffekts.BitmapFilterType.INNER Die Platzierung des Filtereffekts. Mögliche Werte sind die „flash.filters.BitmapFilterType“-Konstanten:
  • BitmapFilterType.OUTER – Glühen-Effekt am äußeren Rand des Objekts.
  • BitmapFilterType.INNER – Glühen-Effekt an der Innenkante des Objekts (die Standardeinstellung)
  • BitmapFilterType.FULL – Glühen-Effekt über dem Objekt.
flash.filters.BitmapFilterType
GradientGlowFilter Mit der GradientGlowFilter-Klasse können Sie einen Glühen-Effekt mit Farbverlauf auf Anzeigeobjekte anwenden.The <s:GradientGlowFilter> tag inherits all of the tag attributes of its superclass and adds no tag attributes:

  <s:GradientGlowFilter/>
  
]]>
mx.filters:IBitmapFilterspark.filters:GradientFilter 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.

spark.filters.GlowFilterflash.filters.GradientGlowFilterflash.display.BitmapData.applyFilter()flash.display.DisplayObject.cacheAsBitmapflash.display.DisplayObject.filtersGradientGlowFilter Konstruktor.distance4.0Der Offset des Glühen-Effekts. angle45Der Winkel in Grad. Die zulässigen Werte liegen zwischen 0 und 360. colorsnullEin Array von Farben, das einen Farbverlauf definiert. Rot beispielsweise hat den Wert 0xFF0000, Blau den Wert 0x0000FF usw. alphasnullEin 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. ratiosnullEin 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. blurX4.0Der 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. blurY4.0Der 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. strength1Die 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. quality1Gibt 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.

typeouterDie 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
knockoutfalseGibt 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).
Konstruktor.
clone Gibt eine Kopie dieses Filterobjekts zurück.Eine neue GradientGlowFilter-Instanz mit allen Eigenschaften der ursprünglichen GradientGlowFilter-Instanz. Gibt eine Kopie dieses Filterobjekts zurück.
DisplacementMapFilter Die DisplacementMapFilter-Klasse führt mithilfe der Pixelwerte bestimmter als „Verschiebungsmatrix“ bezeichneter BitmapData-Objekte Verschiebungen von Objekten aus.The <s:DisplacementMapFilter> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

 <s:DisplacementMapFilter 
   Properties
   alpha="0"
   color="0x000000"
   componentX="0"
   componentY="0"
   mapBitmap="null"
   mapPoint="null"
   mode="wrap"
   scaleX="0"
   scaleY="0"
 />
 
]]>
mx.filters:IBitmapFiltermx.filters:BaseFilter Die DisplacementMapFilter-Klasse führt mithilfe der Pixelwerte bestimmter als Verschiebungsmatrix bezeichneter BitmapData-Objekte Verschiebungen von Objekten aus. Sie können den Filter auf jedes Anzeigeobjekt anwenden (d. h. Objekte, die von der DisplayObject-Klasse erben), z. B. auf MovieClip-, SimpleButton-, TextField- und Video- sowie BitmapData-Objekte.

Die Verwendung von Filtern hängt davon ab, auf welches Objekt sie jeweils angewendet werden:

  • Um Filter auf ein Anzeigeobjekt anzuwenden, verwenden Sie die filters-Eigenschaft des Anzeigeobjekts. 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. Beim Aufrufen von applyFilter() für ein BitmapData-Objekt wird das gefilterte Bild aus dem BitmapData-Quellobjekt und dem Filterobjekt kombiniert.

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.

Der Filter verwendet die folgende Formel:

dstPixel[x, y] = srcPixel[x + ((componentX(x, y) - 128) ~~ scaleX) / 256, y + ((componentY(x, y) - 128) ~~scaleY) / 256)

Dabei erhält componentX(x, y) den componentX-Farbwert der mapBitmap-Eigenschaft an der Position (x - mapPoint.x ,y - mapPoint.y).

Das mit dem Filter verwendete Matrixbild wird so skaliert, dass es an die Größe der Bühne angepasst wird. Wenn das Objekt selbst skaliert wird, wird das Matrixbild nicht skaliert.

Dieser Filter unterstützt Bühnenskalierung. Allgemeine Skalierung, Drehung und Neigung werden jedoch 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.

flash.display.BitmapData.applyFilter()flash.display.DisplayObject.filtersflash.display.DisplayObject.cacheAsBitmapDisplacementMapFilter Konstruktor.mapBitmapnullEin BitmapData-Objekt mit den Daten der Verschiebungsmatrix. mapPointnullEin Wert mit dem Offset der linken oberen Ecke des Zielanzeigeobjekts zur linken oberen Ecke des Matrixbilds. componentX0Gibt den Farbkanal im Matrixbild an, mit dem das x-Ergebnis verschoben wird. Zulässige Werte sind die BitmapDataChannel-Konstanten. componentY0Gibt den Farbkanal im Matrixbild an, mit dem das y-Ergebnis verschoben wird. Zulässige Werte sind die BitmapDataChannel-Konstanten. scaleX0.0Der Multiplikator, anhand dessen das auf der Matrixberechnung beruhende Ergebnis der x-Verschiebung skaliert wird. scaleY0.0Der Multiplikator, mit dem das auf der Matrixberechnung beruhende Ergebnis der y-Verschiebung skaliert wird. modewrapDer Filtermodus. Zulässige Werte sind die DisplacementMapFilterMode-Konstanten. color0Gibt an, welche Farbe für Verschiebungen außerhalb des gültigen Bereichs verwendet werden soll. Der zulässige Bereich für Verschiebungen liegt zwischen 0,0 und 1,0. Verwenden Sie diesen Parameter, wenn mode auf DisplacementMapFilterMode.COLOR gesetzt wurde. alpha0.0Gibt an, welcher Alphawert für Verschiebungen außerhalb des gültigen Bereichs verwendet werden soll. Wird als normalisierter Wert zwischen 0,0 und 1,0 angegeben. Mit dem Wert 0,25 wird beispielsweise ein Transparenzwert von 25 % festgelegt. Verwenden Sie diesen Parameter, wenn mode auf DisplacementMapFilterMode.COLOR gesetzt wurde. Konstruktor. flash.display.BitmapDataChannelflash.filters.DisplacementMapFilterModeclone Gibt eine Kopie dieses Filterobjekts zurück.Eine neue DisplacementMapFilter-Instanz mit allen Eigenschaften der ursprünglichen Instanz. Gibt eine Kopie dieses Filterobjekts zurück. alpha Gibt an, welcher Alphatransparenzwert für Verschiebungen außerhalb des gültigen Bereichs verwendet werden soll.0 Gibt an, welcher Alphatransparenzwert für Verschiebungen außerhalb des gültigen Bereichs verwendet werden soll. Wird als normalisierter Wert zwischen 0,0 und 1,0 angegeben. Mit dem Wert 0,25 wird beispielsweise ein Transparenzwert von 25 % festgelegt. Der Standardwert ist 0. Verwenden Sie diese Eigenschaft, wenn die Eigenschaft mode auf DisplacementMapFilterMode.COLOR gesetzt wurde. color Gibt an, welche Farbe für Verschiebungen außerhalb des gültigen Bereichs verwendet werden soll.0x000000 Gibt an, welche Farbe für Verschiebungen außerhalb des gültigen Bereichs verwendet werden soll. Der zulässige Bereich für Verschiebungen liegt zwischen 0,0 und 1,0. Die Werte liegen im hexadezimalen Format vor. Der Standardwert für color lautet 0. Verwenden Sie diese Eigenschaft, wenn die Eigenschaft mode auf DisplacementMapFilterMode.COLOR gesetzt wurde. componentX Gibt den Farbkanal im Matrixbild an, mit dem das x-Ergebnis verschoben wird.0, meaning no channel. Gibt den Farbkanal im Matrixbild an, mit dem das x-Ergebnis verschoben wird. Zulässige Werte sind die BitmapDataChannel-Konstanten:
  • BitmapDataChannel.ALPHA
  • BitmapDataChannel.BLUE
  • BitmapDataChannel.GREEN
  • BitmapDataChannel.RED
flash.display.BitmapDataChannel
componentY Gibt den Farbkanal im Matrixbild an, mit dem das y-Ergebnis verschoben wird.0, meaning no channel. Gibt den Farbkanal im Matrixbild an, mit dem das y-Ergebnis verschoben wird. Zulässige Werte sind die BitmapDataChannel-Konstanten:
  • BitmapDataChannel.ALPHA
  • BitmapDataChannel.BLUE
  • BitmapDataChannel.GREEN
  • BitmapDataChannel.RED
mapBitmap Ein BitmapData-Objekt mit den Daten der Verschiebungsmatrix.null Ein BitmapData-Objekt mit den Daten der Verschiebungsmatrix. mapPoint Ein Wert mit dem Offset der linken oberen Ecke des Zielanzeigeobjekts zur linken oberen Ecke des Matrixbilds.null Ein Wert mit dem Offset der linken oberen Ecke des Zielanzeigeobjekts zur linken oberen Ecke des Matrixbilds. mode Der Filtermodus.DisplacementMapFilterMode.WRAP Der Filtermodus. Zulässige Werte sind die DisplacementMapFilterMode-Konstanten:
  • DisplacementMapFilterMode.WRAP - Verlegt den Verschiebungswert auf die andere Seite des Quellbilds.
  • DisplacementMapFilterMode.CLAMP - Setzt den Verschiebungswert auf die Kante des Quellbilds.
  • DisplacementMapFilterMode.IGNORE - Liegt der Verschiebungswert außerhalb des gültigen Bereichs, wird die Verschiebung ignoriert, und es werden die Quellpixel verwendet.
  • DisplacementMapFilterMode.COLOR - Liegt der Verschiebungswert außerhalb des Bildes, werden die Werte der color- und alpha-Eigenschaften ersetzt.
scaleX Der Multiplikator, anhand dessen das auf der Matrixberechnung beruhende Ergebnis der x-Verschiebung skaliert wird.0 Der Multiplikator, anhand dessen das auf der Matrixberechnung beruhende Ergebnis der x-Verschiebung skaliert wird. scaleY Der Multiplikator, anhand dessen das auf der Matrixberechnung beruhende Ergebnis der y-Verschiebung skaliert wird.0 Der Multiplikator, anhand dessen das auf der Matrixberechnung beruhende Ergebnis der y-Verschiebung skaliert wird.
ShaderFilter Die Flex ShaderFilter-Klasse abstrahiert viele der Details der ShaderFilter-, Shader- und ShaderData-Klassen von Flash, um einen Pixel Bender-Shader als Filter anzuwenden.The <s:ShaderFilter> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:ShaderFilter
    Properties
    bottomExtension="0"
    leftExtension="0"
    precisionHint="full"
    rightExtension="0"
    shader="[]"
    topExtension="0"
  />
  
]]>
mx.filters:IBitmapFilterflash.events:IEventDispatcherflash.utils:Proxy Die Flex ShaderFilter-Klasse abstrahiert viele der Details der ShaderFilter-, Shader- und ShaderData-Klassen von Flash, um einen Pixel Bender-Shader als Filter anzuwenden.

Die ShaderFilter-Klasse muss entweder mit einer Instanz eines Shader-Objekts oder mit einem Class-Repräsentanten eines Shaders (wie bei einer Einbettung) initialisiert werden. Die ShaderFilter-Klasse dient dann als Proxy für den zugrunde liegenden Shader und bietet einen bequemen direkten Zugriff auf skalare und mehrdimensionale Shader-Eingabeparameter in Form von einfach benannten Eigenschaften.

Sie können einen einfachen Skalar-Shader-Eingabeparameter wie FLOAT oder INT festlegen, indem Sie direkt auf die Eigenschaft verweisen (z. B. myFilter.radius).

Sie können eine einzelne Komponente eines mehrdimensionalen Shader-Eingabeparameters wie FLOAT2 festlegen oder animieren, indem Sie eine Eigenschaftssuffixkonvention für den direkten Zugriff auf den einzelnen Wert verwenden. Der folgende Code zeigt zwei Arten zum Festlegen der ersten und zweiten Komponente der FLOAT2-Eigenschaft center:

     // 'center' is an input parameter of type FLOAT2.
     shader.center = [10,20];
 
     // Use property suffix convention to access the first and second component of 'center'. 
     shader.center_x = 10;
     shader.center_y = 20;
 

Im Folgenden ist der gesamte Satz von unterstützten Eigenschaftssuffixen aufgeführt:

  • Für Shader-Eingabeparameter des Typs BOOL2, BOOL3, BOOL4, FLOAT2, FLOAT3, FLOAT4, INT2, INT3 oder INT4 können Sie „r g b a“, „x y z w“ oder „s t p q“ verwenden, um jeweils auf die erste, zweite, dritte und vierte Komponente zuzugreifen.
  • Für Shader-Eingabeparameter des Typs MATRIX2x2, MATRIX3x3 oder MATRIX4x4 können Sie „a b c d e f g h i j k l m n o p“ verwenden, um jeweils auf die 1. bis 16. Komponente einer angegebenen Matrix zuzugreifen.

Da sich die Eigenschaften im ShaderFilter ändern (z. B. während der Animation), wird der ShaderFilter automatisch auf das Filter-Array der visuellen Komponente, auf die er angewendet ist, erneut angewendet.

Beispiel für einen einfachen ShaderFilter: <?xml version="1.0"?> <s:Application xmlns:s="library://ns.adobe.com/flex/spark" xmlns:fx="http://ns.adobe.com/mxml/2009"> <!-- The hypothetical 'spherize' shader applied below has two input parameters, 'center' and 'radius' with the following attributes: parameter 'center' ==< type: float2 minValue: float2(-200,-200) maxValue: float2(800,500) defaultValue: float2(400,250) description: "displacement center" parameter 'radius' ==< type: float minValue: float(.1) maxValue: float(400) defaultValue: float(200) description: "radius" --> <s:Label text="ABCDEF"> <s:filters> <s:ShaderFilter shader="@Embed(source='shaders/spherize.pbj')" radius="25" center_x="50" center_y="15" /> </s:filters> </s:Label> </s:Application>
spark.effects.AnimateFilterShaderFilter Konstruktor.shadernullVollständig realisierte flash.display.Shader-Instanz oder Klasse, die einen Shader darstellt (wie bei einer Einbettung). Konstruktor. bottomExtension 0 leftExtension 0 precisionHint Die Genauigkeit der mathematischen Operationen, die vom zugrunde liegenden Shader ausgeführt werden. ShaderPrecision.FULL Die Genauigkeit der mathematischen Operationen, die vom zugrunde liegenden Shader ausgeführt werden. Die zulässigen Werte für die precisionHint-Eigenschaft werden durch die Konstanten in der ShaderPrecision-Klasse definiert. flash.display.Shaderflash.display.ShaderPrecisionrightExtension 0 shader Eine flash.display.Shader-Instanz. Eine flash.display.Shader-Instanz. flash.display.ShadertopExtension 0
GlowFilter Mit der GlowFilter-Klasse können Sie einen Glühen-Effekt auf Anzeigeobjekte anwenden.The <s:GlowFilter> tag inherits all of the tag attributes of its superclass and adds the following tag attributes:

  <s:GlowFilter
    Properties
    alpha="1"
    color="0xFF0000"
    inner="false"
  />
  
]]>
mx.filters:IBitmapFiltermx.filters:BaseDimensionFilter Mit der GlowFilter-Klasse können Sie einen Glühen-Effekt auf Anzeigeobjekte anwenden. Sie haben verschiedene Möglichkeiten für den beim Glühen verwendeten Stil, z. B. inneres oder äußeres Glühen oder den Aussparungsmodus. Der Glühen-Filter ähnelt einem Schlagschatten-Filter, dessen Eigenschaften distance und angle auf 0 (null) gesetzt sind. 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 (von DisplayObject übernommen). 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 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.

flash.filters.GlowFilterflash.display.BitmapData.applyFilter()flash.display.DisplayObject.filtersflash.display.DisplayObject.cacheAsBitmapflash.display.DisplayObject.scaleXflash.display.DisplayObject.scaleYflash.filters.DropShadowFilter.distanceflash.filters.DropShadowFilter.angleGlowFilter Konstruktor.color0xFF0000Die Farbe des Glühen-Effekts im hexadezimalen Format 0xRRGGBB. Der Standardwert lautet 0xFF0000. alpha1.0Der Alphatransparenzwert der Farbe. Die zulässigen Werte liegen zwischen 0 und 1. Mit dem Wert 0,25 wird beispielsweise ein Transparenzwert von 25 % festgelegt. blurX4.0Der Grad der horizontalen Weichzeichnung. Die zulässigen Werte liegen zwischen 0 und 255 (Gleitkomma). Zweierpotenzen (z. B. 2, 4, 8, 16 und 32) sind optimiert und ergeben eine schnellere Anzeige als andere Werte. blurY4.0Der Grad der vertikalen Weichzeichnung. Die zulässigen Werte liegen zwischen 0 und 255 (Gleitkomma). Zweierpotenzen (z. B. 2, 4, 8, 16 und 32) sind optimiert und ergeben eine schnellere Anzeige als andere Werte. strength1Die 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. quality1Gibt an, wie oft der Filter angewendet werden soll. Verwenden Sie die BitmapFilterQuality-Konstanten:
  • BitmapFilterQuality.LOW
  • BitmapFilterQuality.MEDIUM
  • BitmapFilterQuality.HIGH

Weitere Informationen finden Sie in der Beschreibung der quality-Eigenschaft.

innerfalseGibt an, ob es sich um ein inneres Glühen handelt. Der Wert true gibt ein inneres Glühen an. Der Wert false gibt ein äußeres Glühen an, d. h. ein Glühen um die äußeren Ränder des Objekts. knockoutfalseGibt an, ob für das Objekt ein Aussparungseffekt definiert wurde. Mit true wird eine transparente Füllung des Objekts definiert, die Hintergrundfarbe des Dokuments wird sichtbar.
Konstruktor.
BitmapFilterQuality
clone Gibt eine Kopie dieses Filterobjekts zurück.Eine neue GlowFilter-Instanz mit allen Eigenschaften der ursprünglichen GlowFilter-Instanz. Gibt eine Kopie dieses Filterobjekts zurück. alpha Der Alphatransparenzwert der Farbe.1 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. color Die Farbe des Glühen-Effekts.0xFF0000 Die Farbe des Glühen-Effekts. Die zulässigen Werte werden im Hexadezimalformat 0xRRGGBB angegeben. inner Gibt an, ob es sich um ein inneres Glühen handelt.false Gibt an, ob es sich um ein inneres Glühen handelt. Der Wert true gibt ein inneres Glühen an. Der Standardwert lautet false, gibt also ein äußeres Glühen an, d. h. ein Glühen um die Außenkanten des Objekts.