Shader  - AS3

Pakiet	flash.display
Klasa	public class Shader
Dziedziczenie	Shader Object
Podklasy	ColorBurnShader, ColorDodgeShader, ColorShader, ExclusionShader, HueShader, LuminosityMaskShader, LuminosityShader, SaturationShader, SoftLightShader

Moduł cieniujący definiuje funkcję, która jest wykonywana na wszystkich pikselach w obrazie, po jednym pikselu jednocześnie. Wynik każdego wywołania funkcji to kolor wyjściowy we współrzędnych pikselowych obrazu. Moduł cieniujący może określać jeden lub większą liczbę obrazów wejściowych — są to obrazy, których zawartość może być używana podczas określania wyniku działania funkcji. Moduł cieniujący może również określać jeden lub większą liczbę parametrów — są to wartości wejściowe, które mogą być używane podczas obliczania wyniku działania funkcji. Podczas pojedynczego wykonania instrukcji modułu cieniującego dane wejściowe i parametry są stałe. Zmieniają się tylko współrzędne piksela, którego kolor jest wynikiem działania funkcji. Wywołania funkcji modułu cieniującego dotyczące współrzędnych wielu pikseli wyjściowych są wykonywane równocześnie, co poprawia wydajność wykonywania instrukcji modułu cieniującego.

Kod bajtowy modułu cieniującego może być ładowany w za pomocą instancji URLLoader w trakcie wykonywania. Poniższy przykład przedstawia ładowanie pliku kodu bajtowego modułu cieniującego w trakcie wykonywania oraz połączenie pliku z instancją modułu cieniującego.

     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
     }
     

Moduł cieniujący można również osadzić do pliku SWF w czasie kompilacji — w tym celu należy użyć znacznika metadanych [Embed]. Znacznik metadanych [Embed] jest dostępny tylko wówczas, jeśli do kompilowania pliku SWF używane jest narzędzie Flex SDK. Parametr source znacznika [Embed] wskazuje plik modułu cieniującego, a jego parametr mimeType ma wartość "application/octet-stream", jak w przykładzie:

     [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
     

W każdym przypadku należy połączyć nieprzetworzony moduł cieniujący (właściwość URLLoader.data lub instancja klasy danych [Embed]) z instancją modułu cieniującego. Zgodnie z tym, co przedstawiają poprzednie przykłady, można to zrobić na dwa sposoby. Kod bajtowy modułu cieniującego można wprowadzić jako argument do konstruktora Shader(). Lub można ustawić go jako właściwość byteCode instancji modułu cieniującego.

Po utworzeniu instancji modułu cieniującego można jej użyć na jeden z następujących sposobów:

• Wypełnienie cieniowane: wynik działania modułu cieniującego jest używany jako wypełnienie zawartości narysowanej za pomocą API rysunków. Należy wprowadzić instancję modułu cieniującego jako argument do metody Graphics.beginShaderFill().
• Filtr cieniowania: wynik działania modułu cieniującego jest używany jako filtr graficzny stosowany dla obiektu wyświetlanego. Należy przypisać instancję modułu cieniującego do właściwości shader instancji ShaderFilter.
• Tryb mieszania: wynik działania modułu cieniującego jest renderowany jako mieszanie między dwoma nachodzącymi na siebie obiektami wyświetlanymi. Należy przypisać instancję modułu cieniującego do właściwości blendShader górnego z dwóch wyświetlanych obiektów.
• Przetwarzanie modułu cieniującego w tle: instrukcje modułu cieniującego są wykonywane w tle, dzięki czemu nie dochodzi do zamrożenia ekranu — po zakończeniu przetwarzania wywoływane jest zdarzenie. Należy przypisać instancję modułu cieniującego do właściwości shader instancji ShaderJob.

W przypadku renderowania GPU nie jest obsługiwane wypełnianie, filtrowanie i mieszanie przy użyciu modułów cieniujących.

Obsługa w przeglądarkach na urządzeniach przenośnych: Ta funkcja nie jest obsługiwana w przeglądarkach na urządzeniach przenośnych.

Obsługa profilów AIR: Ta funkcja jest obsługiwana we wszystkich systemach operacyjnych dla komputerów stacjonarnych, ale nie jest obsługiwana na niektórych urządzeniach przenośnych. Nie jest też obsługiwana na urządzeniach telewizyjnych ze środowiskiem AIR. Więcej informacji o obsłudze elementów interfejsu API w różnych profilach można znaleźć w sekcji Obsługa profilów aplikacji AIR.

Wyświetl przykłady

Powiązane elementy interfejsu API