Actionscript 3 Entwicklerhandbuch

ACTIONSCRIPT 3.0 ENTWICKLERHANDBUCH
Arbeiten mit Pixel Bender-Shadern
Angeben von Shader-Eingaben und -Parameterwerten
Flash Player 10 und höher, Adobe AIR 1.5 und höher
Die Definition zahlreicher Pixel Bender-Shader sieht vor, dass ein oder mehrere Eingabebilder für die Shader-
Verarbeitung verwendet werden. Ein Shader kann beispielsweise ein Quellbild akzeptieren und dieses Bild mit einem
bestimmten Effekt ausgeben, der darauf angewendet wurde. Abhängig von der Verwendung des Shaders kann der
Eingabewert entweder automatisch festgelegt werden, oder Sie müssen einen Wert explizit angeben. Ebenso geben
zahlreiche Shader Parameter an, mit deren Hilfe die Ausgabe des Shaders angepasst wird. Sie müssen für jeden
Parameter explizit einen Wert festlegen, bevor Sie den Shader verwenden.
Verwenden Sie die data-Eigenschaft des Shader-Objekts, um Shader-Eingaben und -Parameter festzulegen und um
zu bestimmen, ob ein bestimmter Shader Eingaben oder Parameter voraussetzt. Die data-Eigenschaft ist eine
ShaderData-Instanz.
Identifizieren von Shader-Eingaben und -Parametern
Flash Player 10 und höher, Adobe AIR 1.5 und höher
Beim Angeben von Shader-Eingaben und -Parameterwerten müssen Sie zunächst ermitteln, ob der verwendete Shader
Eingabebilder oder Parameter voraussetzt. Jede Shader-Instanz verfügt über eine data-Eigenschaft, die ein
ShaderData-Objekt enthält. Wenn der Shader Eingaben oder Parameter definiert, erfolgt der Zugriff auf diese als
Eigenschaften des ShaderData-Objekts. Die Namen der Eigenschaften stimmen mit den Namen überein, die im
Shader-Quellcode für die Eingaben und Parameter angegeben sind. Wenn der Shader beispielsweise eine Eingabe mit
dem Namen src definiert, enthält das ShaderData-Objekt eine Eigenschaft mit dem Namen src für diese Eingabe.
Jede Eigenschaft, die eine Eingabe darstellt, ist eine ShaderInput-Instanz. Eigenschaften, die einen Parameter
darstellen, sind ShaderParameter-Instanzen.
Im Idealfall stellt der Ersteller des Shaders entsprechende Dokumentation bereit, in der angegeben wird, welche
Eingabebildwerte und Parameter der Shader voraussetzt, wofür diese stehen, wie die zulässigen Werte lauten usw.
Wenn keine Dokumentation zum Shader verfügbar ist (und Sie den Quellcode nicht haben), können Sie die Shader-
Daten analysieren, um die Eingaben und Parameter zu ermitteln. Die Eigenschaften, die Eingaben und Parameter
repräsentieren, werden dynamisch zum ShaderData-Objekt hinzugefügt. Sie können daher eine for..in-Schleife
nutzen, um das ShaderData-Objekt zu analysieren und zu ermitteln, ob der zugehörige Shader Eingaben oder
Parameter definiert. Wie bereits im Abschnitt „Zugreifen auf Shader-Metadaten“ auf Seite 323 erläutert wurde, wird
auf alle Metadatenwerte, die für einen Shader definiert sind, auch als dynamische Eigenschaft zugegriffen, die der
Shader.data-Eigenschaft hinzugefügt wird. Wenn Sie dieses Verfahren zum Identifizieren von Shader-Eingaben und
-Parametern verwenden, müssen Sie den Datentyp der dynamischen Eigenschaften überprüfen. Wenn eine
Eigenschaft eine ShaderInput-Instanz ist, stellt diese eine Eingabe dar. Handelt es sich um eine ShaderParameter-
Instanz, stellt sie einen Parameter dar. Andernfalls handelt es sich um einen Metadatenwert. Das folgende Beispiel
veranschaulicht, wie Sie mit der for..in-Schleife die dynamischen Eigenschaften der data-Eigenschaft eines Shaders
überprüfen. Jede Eingabe (ShaderInput-Objekt) wird einer Vector-Instanz mit dem Namen inputs hinzugefügt.
Jeder Parameter (ShaderParameter-Objekt) wird einer Vector-Instanz mit dem Namen parameters hinzugefügt.
Schließlich werden alle Metadateneigenschaften einer Vector-Instanz mit dem Namen metadata hinzugefügt.
Beachten Sie, dass für dieses Beispiel bereits eine Shader-Instanz mit dem Namen myShader erstellt sein muss.
Letzte Aktualisierung 27.6.2012
324