Shader  - AS3

Pacchetto	flash.display
Classe	public class Shader
Ereditarietà	Shader Object
Sottoclassi	ColorBurnShader, ColorDodgeShader, ColorShader, ExclusionShader, HueShader, LuminosityMaskShader, LuminosityShader, SaturationShader, SoftLightShader

Uno shader definisce una funzione che viene eseguita su tutti i pixel di un'immagine, un pixel alla volta. Il risultato di ogni chiamata alla funzione è il colore di output in corrispondenza di tale coordinata di pixel nell'immagine. Uno shader consente di specificare una o più immagini di input, ovvero immagini il cui contenuto possa essere utilizzato per determinare l'output della funzione. Uno shader consente inoltre di specificare uno o più parametri, che corrispondono ai valori di input che è possibile utilizzare per calcolare l'output della funzione. In una singola esecuzione dello shader, i valori di input e parametri sono costanti. L'unico elemento che varia sono le coordinate dei pixel i cui colori sono il risultato della funzione. Le chiamate alla funzione shader per più coordinate dei pixel di output vengono eseguite in parallelo per migliorare le prestazioni di esecuzione dello shader.

Potete caricare il codice byte dello shader in fase di runtime utilizzando un'istanza URLLoader. Nell'esempio seguente viene mostrato il caricamento di un file di codice byte dello shader in fase di runtime e il relativo collegamento a un'istanza 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
     }
     

Potete inoltre incorporare lo shader nel file SWF in fase di compilazione utilizzando il tag per metadati [Embed]. Il tag per metadati [Embed] è disponibile solo se per la compilazione del file SWF utilizzate Flex SDK. Nel tag [Embed], il parametro source fa riferimento al file dello shader e il relativo parametro mimeType è "application/octet-stream", come in questo esempio:

     [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
     

In entrambi i casi dovete collegare lo shader originario (la proprietà URLLoader.data o un'istanza della classe di dati [Embed]) all'istanza Shader. Come illustrato nell'esempio precedente, potete effettuare questa operazione in due modi. Potete passare il codice byte dello shader come argomento alla funzione di costruzione Shader(). In alternativa, potete impostarlo come proprietà byteCode dell'istanza Shader.

Una volta creata un'istanza Shader, potete utilizzarla in diversi modi:

• Come riempimento: l'output dello shader viene utilizzato come riempimento per il contenuto disegnato con l'API di disegno. Passate l'istanza Shader come argomento al metodo Graphics.beginShaderFill().
• Come filtro: l'output dello shader viene utilizzato come filtro grafico applicato a un oggetto di visualizzazione. Assegnate l'istanza Shader alla proprietà shader di un'istanza ShaderFilter.
• Come metodo di fusione: il rendering dell'output viene eseguito come fusione tra due oggetti di visualizzazione sovrapposti. Assegnate l'istanza Shader alla proprietà blendShader di quello superiore dei due oggetti di visualizzazione.
• Elaborazione in background: lo shader viene eseguito in background, evitando il possibile blocco dello schermo, e invia un evento al termine dell'elaborazione. Assegnate l'istanza Shader alla proprietà shader di un'istanza ShaderJob.

I riempimenti shader, i filtri e le fusioni non sono supportati nel rendering GPU.

Supporto browser per dispositivi mobili: questa caratteristica non è supportata nei browser per dispositivi mobili.

Supporto profili AIR: questa funzionalità è supportata in tutti i sistemi operativi desktop ma non in tutti i dispositivi mobili. Inoltre, non è supportato nei dispositivi AIR per TV. Per ulteriori informazioni sul supporto delle API tra più profili, vedete Supporto dei profili AIR.

Vedere gli esempi

Altri esempi

Elementi API correlati