ShaderParameter  - AS3

Package	flash.display
Classe	public final dynamic class ShaderParameter
Héritage	ShaderParameter Object

Une occurrence de ShaderParameter représentant un paramètre pour une occurrence de Shader est accédée en tant que propriété de la propriété data du Shader. La propriété ShaderParameter a le même nom que celui du paramètre dans le code du shader. Par exemple, si un shader définit un paramètre nommé radius, l’occurrence de ShaderParameter représentant le paramètre radius est disponible en tant que propriété radius, comme le montre cet exemple :

var radiusParam:ShaderParameter = myShader.data.radius;

En plus des propriétés définies pour la classe ShaderParameter, chaque occurrence de ShaderParameter possède des propriétés supplémentaires correspondant à toutes métadonnées définies pour le paramètre. Ces propriétés sont ajoutées à l’objet ShaderParameter lors de sa création. Le nom des propriétés correspond à celui des métadonnées spécifiées dans le code source du shader. Le type de données de chaque propriété dépend du type de données des métadonnées correspondantes. Une valeur de métadonnées texte telle que « description » est une occurrence String. Une propriété de métadonnées avec une valeur non chaîne (telle que minValue ou defaultValue) est représentée par une occurrence Array. Le nombre d’éléments et les types de données des éléments correspondent aux valeurs des métadonnées.

Supposons par exemple qu’un shader comprenne les deux déclarations de paramètres suivantes :

     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;
     >;
     

L’occurrence de ShaderParameter correspondant au paramètre size a les propriétés de métadonnées suivantes, en plus de ses propriétés intégrées :

Le ShaderParameter correspondant au paramètre radius a les propriétés supplémentaires suivantes :

En général, le code du développeur ne crée pas directement d’occurrence de ShaderParameter. Une occurrence de ShaderParameter est créée pour chacun des paramètres d’un shader lors de la création de l’occurrence de Shader.

Plus d’exemples

Eléments de l’API associés