ShaderInput

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

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

Une occurrence de ShaderInput représente une unique image d’entrée pour un noyau de shader. Un noyau peut être défini de manière à accepter aucune, une ou plusieurs images source utilisées dans l’exécution du noyau. Une occurrence de ShaderInput fournit un mécanisme qui permet de spécifier l’image d’entrée utilisée lorsque le shader s’exécute. Pour spécifier une valeur pour l’entrée, créez une occurrence de BitmapData, de ByteArray ou de Vector.<Number> contenant les données d’image et affectez-la à la propriété input.

L’occurrence de ShaderInput représentant l’image d’entrée d’une occurrence de Shader est accédée en tant que propriété de la propriété data de l’occurrence Shader. La propriété ShaderInput a le même nom que l’entrée dans le code du shader. Par exemple, si un shader définit une entrée nommée src, l’occurrence ShaderInput représentant l’entrée src est disponible en tant que propriété src, comme le montre cet exemple :

myShader.data.src.input = new BitmapData(50, 50, true, 0xFF990000);

Pour certaines utilisations d’une occurrence Shader, il n’est pas nécessaire de spécifier une image d’entrée car elle est automatiquement désignée par l’opération. Une entrée doit être spécifiée lorsqu’un Shader est utilisé dans les cas suivants :

Remplissage du shader
ShaderFilter, uniquement pour la seconde entrée ou pour les entrées supplémentaires si le shader est défini pour utiliser plusieurs entrées (l’objet auquel le filtre est appliqué est automatiquement utilisé comme première entrée).
Mode de fondu du shader, uniquement pour la troisième entrée ou pour les entrées supplémentaires si le shader est défini pour utiliser plus de deux entrées (les objets auxquels s’applique le fondu sont automatiquement utilisés comme première et seconde entrées).
Exécution en arrière-plan de ShaderJob

Si le shader est exécuté par le biais d’une occurrence ShaderJob pour traiter un ByteArray contenant un tableau de données linéaire, définissez la propriété height de l’occurrence ShaderInput sur 1 et la propriété width sur les valeurs en virgule flottante 32 bits du ByteArray. Dans ce cas, l’entrée dans le shader doit être définie avec le type de données image1.

En général, le code du développeur ne crée pas directement d’occurrence ShaderInput. Une occurrence ShaderInput est créée pour chacune des entrées d’un shader lors de la création de l’occurrence Shader.

Plus d’exemples

Spécification des valeurs d’entrée d’un shader

Eléments de l’API associés

flash.display.ShaderData
flash.display.Shader.data
flash.display.ShaderJob

Propriétés publiques

Masquer les propriétés publiques héritées

Afficher les propriétés publiques héritées

	Propriété		Défini par
		channels : int [lecture seule] Nombre de canaux attendus par une entrée de shader.	ShaderInput
		constructor : Object Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.	Object
		height : int Hauteur de l’entrée du shader.	ShaderInput
		index : int [lecture seule] Index de base zéro de l’entrée dans le shader, indiquant l’ordre des définitions d’entrée dans le shader.	ShaderInput
		input : Object Données d’entrée qui sont utilisées lorsque le shader s’exécute.	ShaderInput
		width : int Largeur de l’entrée du shader.	ShaderInput

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		ShaderInput() Crée une occurrence ShaderInput.	ShaderInput
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d’un objet est définie.	Object
		isPrototypeOf(theClass:Object):Boolean Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre.	Object
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		toLocaleString():String Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.	Object
		toString():String Renvoie la représentation sous forme de chaîne de l’objet spécifié.	Object
		valueOf():Object Renvoie la valeur primitive de l’objet spécifié.	Object

Détails de la propriété

channels

propriété

channels:int [lecture seule]

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

Nombre de canaux attendus par une entrée de shader. Cette propriété doit être prise en compte lorsque les données d’entrée sont une occurrence ByteArray ou de Vector.<Number>.

Implémentation
public function get channels():int

height

propriété

height:int

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

Hauteur de l’entrée du shader. Cette propriété est utilisée uniquement lorsque les données d’entrée sont une occurrence de ByteArray ou de Vector.<Number>. Lorsque l’entrée est une occurrence BitmapData, la hauteur est déterminée automatiquement.

Implémentation
public function get height():int
public function set height(value:int):void

index

propriété

index:int [lecture seule]

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

Index de base zéro de l’entrée dans le shader, indiquant l’ordre des définitions d’entrée dans le shader.

Implémentation
public function get index():int

input

propriété

input:Object

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

Données d’entrée qui sont utilisées lorsque le shader s’exécute. Cette propriété peut être une occurrence de BitmapData, une occurrence de ByteArray ou une occurrence de Vector.<Number>.

Lorsqu’une valeur ByteArray est affectée à la propriété input, les conditions suivantes doivent être satisfaites :

Les propriétés height et width doivent être définies.
Le tableau d’octets ne doit contenir que des valeurs en virgule flottante 32 bits. Ces valeurs peuvent être écrites à l’aide de la méthode ByteArray.writeFloat().
La longueur totale des octets dans le ByteArray doit être exactement width fois height fois channels fois 4.
La propriété endian du tableau d’octets doit être Endian.LITTLE_ENDIAN.

Si une occurrence de Vector.<Number> est affectée à la propriété input, la longueur du Vector doit être égale à width fois height fois channels.

Implémentation
public function get input():Object
public function set input(value:Object):void

width

propriété

width:int

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

Largeur de l’entrée du shader. Cette propriété est utilisée uniquement lorsque les données d’entrée sont une occurrence de ByteArray ou de Vector.<Number>. Lorsque l’entrée est une occurrence BitmapData, la largeur est déterminée automatiquement.

Implémentation
public function get width():int
public function set width(value:int):void

Détails du constructeur

()

Constructeur

public function ShaderInput()

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

Crée une occurrence ShaderInput. Le code du développeur n’appelle pas directement le constructeur ShaderInput. Une occurrence ShaderInput est créée pour chacune des entrées d’un shader lors de la création de l’occurrence Shader.

Informations juridiques | Politique de confidentialité en ligne

ShaderInput - AS3

Package flash.display

channels

height

index

input

width

ShaderInput