Shader  - AS3

Pacote	flash.display
Classe	public class Shader
Herança	Shader Object
Subclasses	ColorBurnShader, ColorDodgeShader, ColorShader, ExclusionShader, HueShader, LuminosityMaskShader, LuminosityShader, SaturationShader, SoftLightShader

Um shader define uma função executada em todos os pixels de uma imagem, um pixel por vez. O resultado de cada chamada para a função é a cor de saída nessa coordenada de pixel da imagem. Um shader pode especificar uma ou mais imagens de entrada cujo conteúdo pode ser usado para determinar a saída da função. Um shader também pode especificar um ou mais parâmetros, que são valores de entrada que você pode usar no cálculo da saída da função. Em uma execução de shader exclusiva, os valores de entrada e parâmetro são constantes. A única coisa variável é a coordenada do pixel cuja cor é o resultado da função. A função Shader chama várias coordenadas de pixel de saída executadas paralelamente para melhorar o desempenho da execução do shader.

O código de bytes do shader pode ser carregado durante o runtime usando uma ocorrência de URLLoader. O exemplo a seguir demonstra o carregamento de um arquivo de código de bytes do shader durante o runtime e sua vinculação a uma ocorrência 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
     }
     

Você também pode incorporar o shader ao SWF durante a compilação usando a tag de metadados [Embed]. A tag de metadados [Embed] só permanece disponível caso você use o SDK do Flex para compilar o SWF. A tag [Embed] com seu parâmetrosource aponta para o arquivo do shader, e o parâmetro mimeType é "application/octet-stream", como neste exemplo:

     [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
     

Qualquer que seja o caso, você vincula o shader bruto (a propriedade URLLoader.data ou uma ocorrência da classe de dados [Embed]) à ocorrência de Shader. Como demonstraram os exemplos anteriores, é possível fazer isso de duas formas. Você pode passar o código de bytes do shader como um argumento para o construtor Shader(). Você também pode defini-lo como a propriedade byteCode da ocorrência de Shader.

Depois de criada, uma ocorrência de Shader pode ser usada de várias formas:

• Um preenchimento de shader: A saída do shader é usada como um preenchimento do conteúdo desenhado com a API de desenho. Passe a ocorrência de Shader como um argumento para o método Graphics.beginShaderFill().
• Um filtro de shader: A saída do shader é usada como um filtro gráfico aplicado a um objeto de exibição. Atribua a ocorrência de Shader à propriedade shader de uma ocorrência de ShaderFilter.
• Um modo de mesclagem: A saída do shader é processada como sendo a mesclagem entre dois objetos de exibição sobrepostos. Atribua a ocorrência de Shader à propriedade blendShader do objeto de exibição superior.
• Processamento do shader no segundo plano: O shader é executado em segundo plano, o que evita a possibilidade de congelamento da exibição e despacha um evento quando o processamento é concluído. Atribua a ocorrência de Shader à propriedade shader de uma ocorrência de ShaderJob.

Os preenchimentos com sombreamento, os filtros, e as misturas não são compatíveis com a renderização pela GPU.

Suporte a navegador móvel: não há suporte para este recurso em navegadores móveis.

Suporte a perfil do AIR: este recurso conta com o suporte de todos os sistemas operacionais para desktop, mas nenhum dispositivo móvel oferece suporte para ele. Não é compatível com dispositivos AIR for TV. Consulte Suporte a perfil do AIR para obter mais informações sobre o suporte de API através de múltiplos perfis.

Veja os exemplos

Elementos da API relacionados