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 |
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
Eléments de l’API associés
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éthode | Défini par | ||
---|---|---|---|
Crée une occurrence ShaderInput. | ShaderInput | ||
Indique si la propriété spécifiée d’un objet est définie. | Object | ||
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 | ||
Indique si la propriété spécifiée existe et est énumérable. | Object | ||
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | ||
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | ||
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | ||
Renvoie la valeur primitive de l’objet spécifié. | Object |
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é |
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
etwidth
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
foisheight
foischannels
fois 4. - La propriété
endian
du tableau d’octets doit êtreEndian.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
ShaderInput | () | 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.
Tue Jun 12 2018, 09:30 AM Z