Shader  - AS3

Paquete	flash.display
Clase	public class Shader
Herencia	Shader Object
Subclases	ColorBurnShader, ColorDodgeShader, ColorShader, ExclusionShader, HueShader, LuminosityMaskShader, LuminosityShader, SaturationShader, SoftLightShader

Un sombreado define una función que se ejecuta en todos los píxeles de la imagen, de uno en uno. El resultado de cada llamada a la función es el color de salida en las coordenadas del píxel de la imagen. Un sombreado puede especificar una o varias imágenes de entrada, que son imágenes cuyo contenido se puede utilizar para determinar la salida de la función. Un sombreado también puede especificar uno o varios parámetros, que son valores de entrada que se pueden utilizar para calcular la salida de la función. En una ejecución de sombreado sencilla, los valores de los parámetros de entrada son constantes. Lo único que varía son las coordenadas del píxel cuyo color es el resultado de la función. Las llamadas a la función Shader para varias coordenadas de píxeles de salida se ejecutan en paralelo para mejorar el rendimiento de ejecución del sombreado.

El código de bytes de sombreado se puede cargar en tiempo de ejecución mediante una instancia de URLLoader. En el siguiente ejemplo se muestra la carga de un archivo de código de bytes de sombreado en tiempo de ejecución y su vinculación a una instancia de Shader.

     var loader:URLLoader = new URLLoader();
     loader.dataFormat = URLLoaderDataFormat.BINARY;
     loader.addEventListener(Event.COMPLETE, onLoadComplete);
     loader.load(new URLRequest("myShader.pbj"));
      
     var shader:Shader;
      
     function onLoadComplete(event:Event):void {
         // Create a new shader and set the loaded data as its bytecode
         shader = new Shader();
         shader.byteCode = loader.data;
         
         // You can also pass the bytecode to the Shader() constructor like this:
         // shader = new Shader(loader.data);
         
         // do something with the shader
     }
     

También puede incorporar el sombreado en el archivo SWF en tiempo de compilación mediante la etiqueta de metadatos [Embed]. La etiqueta de metadatos [Embed] sólo está disponible si utiliza el SDK de Flex para compilar el archivo SWF. El parámetro source de la etiqueta [Embed] apunta al archivo de sombreado, y su parámetro mimeType es "application/octet-stream", como se muestra en este ejemplo:

     [Embed(source="myShader.pbj", mimeType="application/octet-stream)]
     var MyShaderClass:Class;
      
     // ...
     
     // create a new shader and set the embedded shader as its bytecode
     var shaderShader = new Shader();
     shader.byteCode = new MyShaderClass();
      
     // You can also pass the bytecode to the Shader() constructor like this:
     // var shader:Shader = new Shader(new MyShaderClass());
      
     // do something with the shader
     

En cualquier caso, se vincula el sombreado sin procesar (la propiedad URLLoader.data o una instancia de la clase de datos [Embed]) a la instancia de Shader. Como se mostraba en los ejemplos anteriores, esto se puede realizar de dos formas. Puede transferir el código de bytes de sombreado como un argumento al constructor Shader(). También puede establecerlo como la propiedad byteCode de la instancia de Shader.

Una vez creada la instancia de Shader, se puede utilizar de diversos modos:

• Un relleno de sombreado: la salida del sombreado se utiliza como relleno del contenido dibujado con la API de dibujo. Transfiera la instancia de Shader como un argumento al método Graphics.beginShaderFill().
• Un filtro de sombreado: la salida del sombreado se utiliza como filtro gráfico aplicado al objeto de visualización. Asigne la instancia de Shader a la propiedad shader de una instancia de ShaderFilter.
• Un modo de mezcla: la salida del sombreado se representa como la mezcla entre dos objetos de visualización superpuestos. Asigne la instancia de Shader a la propiedad blendShader del objeto de visualización superior.
• Procesamiento de sombreado en segundo plano: el sombreado se ejecuta en segundo plano, evitando así que la pantalla se bloquee. Distribuye un evento cuando finaliza el procesamiento. Asigne la instancia de Shader a la propiedad shader de una instancia de ShaderJob.

Los rellenos de sombreado, los filtros y las combinaciones no son compatibles en procesamiento de GPU.

Soporte con navegador móvil: esta función no se admite en navegadores móviles.

Compatibilidad con perfil de AIR: esta característica se admite en todos los sistemas operativos de escritorio, pero no en todos los dispositivos móviles. No se admite en dispositivos de AIR para TV. Consulte Compatibilidad con perfil de AIR para obtener información sobre la compatibilidad de la API con varios perfiles.

Ver los ejemplos

Elementos de API relacionados