Shader  - AS3

Pakket	flash.display
Klasse	public class Shader
Overerving	Shader Object
Subklassen	ColorBurnShader, ColorDodgeShader, ColorShader, ExclusionShader, HueShader, LuminosityMaskShader, LuminosityShader, SaturationShader, SoftLightShader

Een arcering definieert een functie die met één pixel tegelijk wordt uitgevoerd op alle pixels in een afbeelding. Het resultaat van elke aanroep van de functie is de uitvoerkleur bij de desbetreffende pixelcoördinaat in de afbeelding. Een arcering kan één of meer invoerafbeeldingen opgeven. Dit zijn afbeeldingen waarvan de inhoud kan worden gebruikt bij het bepalen van de uitvoer van de functie. Een arcering kan ook één of meer parameters opgeven. Dit zijn invoerwaarden die kunnen worden gebruikt bij het berekenen van de uitvoer van de functie. Binnen een arceringsuitvoering zijn de invoer- en parameterwaarden constant. Het enige dat varieert is de coördinaat van de pixel waarvan de kleur het resultaat van de functie is. Aanroepen van de arceringsfunctie voor meerdere uitvoerpixelcoördinaten worden parallel uitgevoerd, zodat de prestaties van het uitvoeren van de arcering hoger zijn.

De bytecode van de arcering kan in runtime worden geladen met een URLLoader-instantie. In het volgende voorbeeld wordt een bytecodebestand voor een arcering in runtime geladen en gekoppeld aan een Shader-instantie.

     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
     }
     

U kunt de arcering ook tijdens het compileren insluiten in de SWF met de metagegevenstag [Embed]. De metagegevenstag [Embed] is alleen beschikbaar als u de SWF compileert met de Flex SDK. Voor de tag [Embed] geldt dat de parameter source verwijst naar het arceringsbestand en dat de parameter mimeType "application/octet-stream" is, zoals in dit voorbeeld:

     [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 bedie gevallen koppelt u de ruwe arcering (de eigenschap URLLoader.data of een instantie van de gegevensklasse [Embed]) aan de Shader-instantie. Zoals u in door voorgaande voorbeelden ziet, kunt u dit op twee manieren doen: U kunt de bytecode van de arcering als een argument doorgeven aan de constructor Shader(). U kunt deze ook instellen als de eigenschap byteCode van de Shader-instantie.

Als er eenmaal een Shader-instantie is gemaakt, kan deze op verschillende manieren worden gebruikt:

• Een vulling met arcering: De uitvoer van de arcering wordt gebruikt als een vulling voor inhoud die is getekend met de teken-API. Geef de Shader-instantie als een argument door aan de methode Graphics.beginShaderFill().
• Een arceringsfilter: De uitvoer van de arcering wordt gebruikt als een grafische filter die wordt toegepast op een weergaveobject. Wijs de Shader-instantie toe aan de eigenschap shader van een ShaderFilter-instantie.
• Een overvloeimodus: De uitvoer van de arcering wordt weergegeven als de overvloeiing tussen twee overlappende weergaveobjecten. Wijs de Shader-instantie toe aan de eigenschap blendShader van de bovenste van de twee weergaveobjecten.
• Op de achtergrond verwerken van arcering: De arcering wordt op de achtergrond uitgevoerd, waardoor wordt voorkomen dat het beeldscherm blijft hangen. Er wordt een gebeurtenis verzonden als het verwerken is voltooid. Wijs de Shader-instantie toe aan de eigenschap shader van een ShaderJob-instantie.

Arceringsvullingen, filters en vloeiende overgangen worden niet ondersteund bij GPU-rendering.

Ondersteuning op mobiele browsers: mobiele browsers bieden geen ondersteuning voor deze functie.

AIR-profielondersteuning: deze functie wordt ondersteund op alle desktopbesturingssystemen, maar niet op alle mobiele apparaten. Deze functie wordt niet ondersteund op AIR for TV-apparaten. Zie AIR-profielondersteuning voor meer informatie over API-ondersteuning voor meerdere profielen.

Bekijk de voorbeelden

Verwante API-elementen