Shader  - AS3

Paket	flash.display
Klass	public class Shader
Arv	Shader Object
Underklasser	ColorBurnShader, ColorDodgeShader, ColorShader, ExclusionShader, HueShader, LuminosityMaskShader, LuminosityShader, SaturationShader, SoftLightShader

En skuggning definierar en funktion som körs på alla pixlar i en bild, en pixel åt gången. Resultatet för varje anrop till funktionen är den utdatafärg som finns vid pixelkoordinaten i bilden. En skuggning kan ange en eller flera inmatningsbilder. Det är bilder vilkas innehåll kan användas när funktionens utdata bestäms. En skuggning kan också ange en eller flera parametrar som är inmatningsvärden som kan användas vid beräkning av funktionens utdata. I en enda skuggningskörning är inmatnings- och parametervärdena konstanta. Det enda som varierar är koordinaten för den pixel vars färg är funktionens utdata. Skuggningsfunktionsanrop för flera utdatapixelkoordinater körs parallellt för att förbättra körningens prestanda.

Skuggningsbytekoden kan läsas in vid körningen med hjälp av en URLLoader-instans. Följande exempel visar hur en skuggningsbytekodfil läses in vid körning och länkas till en Shader-instans.

     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
     }
     

Du kan också bädda in skuggningen i SWF-filen vid kompileringen med hjälp av taggen för [Embed]-metadata. Taggen för [Embed]-metadata är bara tillgänglig om du använder Flex SDK för att kompilera SWF-filen. [Embed]-taggens source-parameter pekar på skuggningsfilen och dess mimeType-parameter är "application/octet-stream". Visas i det här exemplet:

     [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
     

I båda fallen länkar du rådataskuggningen (URLLoader.data-egenskapen eller en instans av [Embed]-dataklassen) till Shader-instansen. Som föregående exempel visar kan du göra det här på två sätt. Du kan skicka skuggningsbytekoden som ett argument till Shader()-konstruktorn. Du kan också ange den som byteCode-egenskap för Shader-instansen.

När Shader-instansen har skapats kan den användas på något av följande sätt:

• En skuggningsfyllning: Skuggningens utdata används som fyllning för innehåll som ritas med ritgränssnittet. Skicka Shader-instansen som ett argument till metoden Graphics.beginShaderFill().
• Ett skuggningsfilter: Skuggningens utdata används som ett grafikfilter som används i ett visningsobjekt. Tilldela Shader-instansen till shader-egenskapen i en ShaderFilter-instans.
• Ett blandningsläge: Skuggningens utdata återges som blandningen mellan två överlappande visningsobjekt. Tilldela Shader-instansen till blendShader-egenskapen i det övre visningsobjektet.
• Bearbetning av skuggning i bakgrunden: Skuggningen körs i bakgrunden vilket minskar risken för att visningen blir fryst. En händelse skickas när bearbetningen är slutförd. Tilldela Shader-instansen till shader-egenskapen i en ShaderJob-instans.

Skuggningsfyllningar, filter och blandningar stöds inte vid GPU-återgivning.

Stöd för mobilwebbläsare: Den här funktionen stöds inte i mobilwebbläsare.

Stöd för AIR-profiler: Den här funktionen stöds på alla operativsystem för datorer, men inte på alla mobilenheter. Den stöds inte på enheter med AIR for TV. På sidan om stöd för AIR-profiler hittar du mer information om API-stöd för flera profiler.

Visa exemplen

Relaterade API-element