ShaderParameter  - AS3

Paket	flash.display
Klasse	public final dynamic class ShaderParameter
Vererbung	ShaderParameter Object

Auf eine ShaderParameter-Instanz, die einen Parameter für eine Shader-Instanz darstellt, wird als Eigenschaft der data-Eigenschaft der Shader-Instanz zugegriffen. Der Name der ShaderParameter-Eigenschaft ist derselbe wie der Parametername im Shadercode. Wenn beispielsweise in einem Shader ein Parameter namens radius definiert ist, ist die ShaderParameter-Instanz, die den radius-Parameter darstellt, als radius-Eigenschaft verfügbar, wie hier zu sehen ist:

var radiusParam:ShaderParameter = myShader.data.radius;

Zusätzlich zu den definierten Eigenschaften der ShaderParameter-Klasse hat jede ShaderParameter-Instanz weitere Eigenschaften, die den für den Parameter festgelegten Metadaten entsprechen. Diese Eigenschaften werden dem ShaderParameter-Objekt bei der Erstellung hinzugefügt. Die Namen der Eigenschaften stimmen mit den im Shaderquellcode festgelegten Metadatennamen überein. Der Datentyp der Eigenschaft hängt vom Datentyp der jeweils entsprechenden Metadaten ab. Ein Textmetadatenwert wie etwa „description“ ist eine String-Instanz. Eine Metadateneigenschaft mit einem Wert, der kein String ist (wie z. B. minValue oder defaultValue) wird als Array-Instanz dargestellt. Die Anzahl an Elementen und Elementdatentypen entspricht den Metadatenwerten.

Gehen Sie etwa von einem Shader mit den folgenden beiden Parameterdeklarationen aus:

     parameter float2 size
     <
         description: "The size of the image to which the kernel is applied";
         minValue: float2(0.0, 0.0);
         maxValue: float2(100.0, 100.0);
         defaultValue: float2(50.0, 50.0);
     >;
     
     parameter float radius
     <
         description: "The radius of the effect";
         minValue: 0.0;
         maxValue: 50.0;
         defaultValue: 25.0;
     >;
     

Die dem size-Parameter entsprechende ShaderParameter-Instanz verfügt zusätzlich zu ihren integrierten Eigenschaften über die folgenden Metadateneigenschaften:

Der dem radius-Parameter entsprechende ShaderParameter hat die folgenden zusätzlichen Eigenschaften:

Im Allgemeinen wird eine ShaderParameter-Instanz nicht direkt durch Entwicklercode erstellt. Bei der Erstellung der Shader-Instanz wird für jeden Shaderparameter eine ShaderParameter-Instanz erstellt.

Verwandte API-Elemente