Actionscript 3 Entwicklerhandbuch

ACTIONSCRIPT 3.0 ENTWICKLERHANDBUCH
Anwenden von Filtern auf Anzeigeobjekte
Filter und Bitmap-Zwischenspeicherung
Um einen Filter auf ein Anzeigeobjekt anwenden zu können, muss die Bitmap-Zwischenspeicherung für das Objekt
aktiviert sein. Wenn Sie einen Filter auf ein Anzeigeobjekt anwenden, dessen cacheAsBitmap-Eigenschaft auf false
gesetzt ist, wird die cacheAsBitmap-Eigenschaft des Objekts automatisch auf true gesetzt. Wenn Sie später sämtliche
Filter eines Anzeigeobjekts entfernen, wird die cacheAsBitmap-Eigenschaft auf den Wert zurückgesetzt, der zuletzt
eingestellt war.
Ändern von Filtern zur Laufzeit
Wenn einem Anzeigeobjekt bereits ein oder mehrere Filter zugewiesen wurden, können Sie diesen Filtersatz nicht
ändern, indem Sie zusätzliche Filter hinzufügen oder Filter aus dem Array der filters-Eigenschaft entfernen. Um
den bereits angewendeten Filtersatz zu erweitern oder zu ändern, müssen Sie die Änderungen an einem separaten
Array vornehmen und dieses Array dann der filters-Eigenschaft des Anzeigeobjekts für die auf das Objekt
anzuwendenden Filter zuweisen. Die einfachste Methode dafür ist das Einlesen des Arrays der filters-Eigenschaft
in eine Array-Variable und das Vornehmen von Änderungen in diesem temporären Array. Anschließend weisen Sie
das Array wieder der filters-Eigenschaft des Anzeigeobjekts zu. In komplexeren Fällen müssen Sie unter
Umständen ein separates Master-Filter-Array verwenden. Sie nehmen dann alle Änderungen an diesem Master-
Filter-Array vor und weisen das Master-Array der filters-Eigenschaft des Anzeigeobjekts nach jeder Änderung
erneut zu.
Hinzufügen eines zusätzlichen Filters
Der folgende Code zeigt das Hinzufügen eines zusätzlichen Filters zu einem Anzeigeobjekt, das schon einen oder
mehrere Filter aufweist. Zunächst wurde ein Glühen-Filter auf ein Anzeigeobjekt namens myDisplayObject
angewendet. Beim Klicken auf das Anzeigeobjekt wird dann die Funktion addFilters() aufgerufen. In dieser
Funktion werden zwei zusätzliche Filter auf myDisplayObject angewendet:
import flash.events.MouseEvent;
import flash.filters.*;
myDisplayObject.filters = [new GlowFilter()];
function addFilters(event:MouseEvent):void
{
// Make a copy of the filters array.
var filtersCopy:Array = myDisplayObject.filters;
}
// Make desired changes to the filters (in this case, adding filters).
filtersCopy.push(new BlurFilter());
filtersCopy.push(new DropShadowFilter());
// Apply the changes by reassigning the array to the filters property.
myDisplayObject.filters = filtersCopy;
myDisplayObject.addEventListener(MouseEvent.CLICK, addFilters);
Entfernen eines Filters aus einem Filtersatz
Wenn mehrere Filter auf ein Anzeigeobjekt angewendet wurden und Sie einen der Filter entfernen möchten, während
die anderen Filter weiter auf das Objekt angewendet sind, können Sie die Filter in ein temporäres Array kopieren, den
unerwünschten Filter aus diesem Array entfernen und das temporäre Array der filters-Eigenschaft des
Anzeigeobjekts neu zuweisen. Verschiedene Möglichkeiten zum Entfernen eines oder mehrerer Elemente aus einem
Array werden im Abschnitt „Abrufen von Werten und Entfernen von Array-Elementen“ auf Seite 32 beschrieben.
Letzte Aktualisierung 27.6.2012
288