Pakiet | flash.display3D |
Klasa | public final class Program3D |
Dziedziczenie | Program3D Object |
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 11, AIR 2 |
Programy zarządzane przez obiekt Program3D sterują procesem renderowania trójkątów podczas wywołania metody drawTriangles
klasy Context3D. Metoda upload
pozwala wysłać binarny kod bajtowy do kontekstu renderowania. (Po wysłaniu program nie odnosi się już do danych w oryginalnej tablicy bajtów. Zmiany lub usunięcie źródłowej tablicy bajtowej nie mają wpływu na program).
Program zawsze składa się z dwóch połączonych części: programu wierzchołków i programu fragmentów.
- Program wierzchołków działa na danych zdefiniowanych w obiektach VertexBuffer3D i odpowiada za rzutowanie wierzchołków na przestrzeń klipu oraz przekazywanie wymaganych danych wierzchołków (na przykład kolorów) do modułu cieniującego fragmentów.
- Moduł cieniujący fragmentów działa na atrybutach przekazanych do niego przez program wierzchołków. Oblicza kolor dla każdego rasteryzowanego fragmentu trójkąta, co przekłada się na kolory pikseli. Programy fragmentów mają wiele nazw w literaturze dotyczącej programowania 3D. Są między innymi określane jako moduły cieniujące fragmentów i moduły cieniujące pikseli.
Aby określić parę programów do używania w dalszych operacjach renderowania, należy przekazać odpowiednie wystąpienie klasy Program3D do metody setProgram()
klasy Context3D.
Obiektu Program3D nie można utworzyć bezpośrednio. Należy zamiast tego użyć metody createProgram()
klasy Context3D.
Powiązane elementy interfejsu API
Metoda | Zdefiniowane przez | ||
---|---|---|---|
Zwalnia wszystkie zasoby skojarzone z tym obiektem. | Program3D | ||
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | ||
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | ||
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | ||
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | ||
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | ||
Zwraca ciąg reprezentujący określony obiekt. | Object | ||
Wysyła parę programów renderujących opisanych w kodzie bajtowym języka AGAL (Adobe Graphics Assembly Language). | Program3D | ||
Zwraca pierwotną wartość dla określonego obiektu. | Object |
dispose | () | metoda |
public function dispose():void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 11, AIR 3 |
Zwalnia wszystkie zasoby skojarzone z tym obiektem. Po zwolnieniu obiektu Program3D wywołanie metody upload() i renderowanie za pomocą tego obiektu nie powiedzie się.
upload | () | metoda |
public function upload(vertexProgram:ByteArray, fragmentProgram:ByteArray):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 11, AIR 3 |
Wysyła parę programów renderujących opisanych w kodzie bajtowym języka AGAL (Adobe Graphics Assembly Language).
Kod bajtowy programu można utworzyć za pomocą narzędzi offline Pixel Blender 3D. Można go również utworzyć dynamicznie. Klasa AGALMiniAssembler jest klasą narzędziową, która kompiluje programy w języku maszynowym AGAL do kodu bajtowego AGAL. Ta klasa nie należy do środowiska wykonawczego. Gdy jest wysyłany program modułu cieniującego, kod bajtowy jest kompilowany do natywnego języka modułów cieniujących danego urządzenia (na przykład do języka OpenGL lub Direct3D). Środowisko wykonawcze sprawdza poprawność kodu bajtowego podczas wysyłania.
Programy są uruchamiane przy każdym wywołaniu metody drawTriangles()
klasy Context3D. Program wierzchołków jest wykonywany raz dla każdego wierzchołka z listy trójkątów do narysowania. Program fragmentów jest wykonywany raz dla każdego piksela na powierzchni trójkąta.
Zmienne używane w programie wierzchołków są określane jako rejestry. Są zdefiniowane następujące rejestry:
Nazwa | Liczba na program fragmentów | Liczba na program wierzchołków | Przeznaczenie |
---|---|---|---|
Atrybutów | n/d | 8 | Dane wejściowe modułu cieniującego wierzchołków. Odczytywany z bufora wierzchołków określonego przy użyciu metody Context3D.setVertexBufferAt(). |
Stałych | 28 | 128 | Dane wejściowe modułu cieniującego. Ustawiany przy użyciu rodziny funkcji Context3D.setProgramConstants(). |
Tymczasowy | 8 | 8 | Tymczasowy rejestr na potrzeby obliczeń, niedostępny spoza programu. |
Wyjściowy | 1 | 1 | Produkt modułu cieniującego: W programie wierzchołków produktem jest położenie w przestrzeni klipu. W programie fragmentów produktem jest kolor. |
Zmienny | 8 | 8 | Służy do przesyłania interpolowanych danych między modułami cieniującymi wierzchołków i fragmentów. Rejestry zmienne pochodzące z programu wierzchołków są stosowane jako dane wejściowe w programie fragmentów. Wartości są interpolowane według odległości od wierzchołków trójkątów. |
Próbnika | 8 | n/d | Dane wejściowe modułu cieniującego fragmentów. Odczytywany z tekstury określonej przy użyciu metody Context3D.setTextureAt(). |
Program wierzchołków uzyskuje dane wejściowe z dwóch źródeł: buforów wierzchołków i rejestrów stałych. Aby określić, które dane wierzchołków mają być używane w konkretnym rejestrze atrybutów, należy użyć metody setVertexBufferAt()
klasy Context3D. Można zdefiniować maksymalnie osiem rejestrów wejściowych na potrzeby atrybutów wierzchołków. Wartości atrybutów wierzchołków są odczytywane z bufora wierzchołków każdego wierzchołka z listy trójkątów i umieszczane w rejestrze atrybutów. Do określania rejestrów stałych służą metody setProgramConstantsFromMatrix()
i setProgramConstantsFromVector()
klasy Context3D. Rejestry stałych zachowują takie same wartości dla wszystkich wierzchołków z listy trójkątów. Wartości stałych można zmieniać tylko między wywołaniami metody drawTriangles()
.
Program wierzchołków odpowiada za rzutowanie wierzchołków trójkątów na przestrzeń klipu (kanoniczny obszar widoczny określany przez współrzędne na od –1 do 1 na osiach x i y oraz od 0 do 1 na osi z) i umieszczanie przekształconych współrzędnych w rejestrze wyjściowym. (Zazwyczaj do modułu cieniującego jest przekazywana odpowiednia macierz rzutowania w formie zestawu rejestrów stałych). Program wierzchołków musi też skopiować wszystkie atrybuty wierzchołków i obliczone wartości wymagane przez program fragmentów do specjalnego zestawu zmiennych określanych jako rejestry zmienne. Po uruchomieniu programu fragmentów wartość podana w rejestrze zmiennym jest interpolowana liniowo zgodnie z odległością bieżącego fragmentu od każdego z wierzchołków trójkąta.
Program fragmentów otrzymuje dane wejściowe z rejestrów zmiennych i z oddzielnego zestawu rejestrów stałych (ustawianych przy użyciu metod setProgramConstantsFromMatrix()
i setProgramConstantsFromVector()
). Można również odczytać dane tekstur z tekstur wysłanych do kontekstu renderowania przy użyciu rejestrów próbników. Do określania, która tekstura umożliwia dostęp do konkretnego rejestru próbnika, służy metoda setTextureAt()
klasy Context3D. Program fragmentów odpowiada za ustawienie wartości koloru w swoim rejestrze wyjściowym.
Parametry
vertexProgram:ByteArray — Kod bajtowy AGAL programu wierzchołków. Obiekt ByteArray musi korzystać z formatu little endian.
| |
fragmentProgram:ByteArray — Kod bajtowy AGAL programu fragmentów. Obiekt ByteArray musi korzystać z formatu little endian.
|
Zgłasza
TypeError — Błąd wskaźnika null: jeśli parametr vertexProgram lub fragmentProgram ma wartość null.
| |
Error — Obiekt zwolniony: jeśli obiekt Program3D został zwolniony bezpośrednio przez wywołanie metody dispose() , pośrednio przez wywołanie metody dispose() obiektu Context3D lub w efekcie zwolnienia kontekstu renderowania z powodu utraty urządzenia.
| |
ArgumentError — Zbyt mały program AGAL: Gdy którakolwiek tablica kodu programu ma długość mniejszą niż 31 bajtów. Jest to rozmiar kodu bajtowego programu modułu cieniującego zawierającego jedną instrukcję.
| |
ArgumentError — Program musi być w formacie little endian: jeśli którakolwiek tablica kodu bajtowego programu nie jest w formacie little endian.
| |
Error — Niepowodzenie kompilacji natywnego modułu cieniującego: Jeśli dane wyjściowe translatora AGAL nie są zgodnym programem w natywnym języku modułów cieniujących. Ten błąd jest generowany tylko przy zwalnianiu odtwarzaczy.
| |
Error — Niepowodzenie kompilacji natywnego modułu cieniującego OpenGL: Jeśli dane wyjściowe translatora AGAL nie są zgodnym programem w języku modułów cieniujących OpenGL i zawierają diagnostykę kompilacji. Ten błąd jest generowany tylko przy zwalnianiu odtwarzaczy z włączonym debugowaniem.
| |
Error — Niepowodzenie kompilacji natywnego modułu cieniującego D3D9: Jeśli dane wyjściowe translatora AGAL nie są zgodnym programem w języku modułów cieniujących Direct3D i zawierają diagnostykę kompilacji. Ten błąd jest generowany tylko przy zwalnianiu odtwarzaczy z włączonym debugowaniem.
Jeśli sprawdzenie poprawności kodu bajtowego AGAL nie powiedzie się, są generowane następujące błędy: | |
Error — Program nie w formacie AGAL: Jeśli magiczny bajt w nagłówku jest nieprawidłowy. Pierwszy bajt w kodzie bajtowym musi mieć wartość 0xa0. Ten błąd może oznaczać, że w tablicy bajtów ustawiono nieprawidłową kolejność bajtów endian.
| |
Error — Nieprawidłowa wersja formatu AGAL: Jeśli wersja kodu AGAL nie jest obsługiwana w bieżącej wersji formatu SWF. W przypadku plików SWF w wersji 13 należy ustawić wersję 1 formatu AGAL.
| |
Error — Nieprawidłowy typ programu AGAL: Jeśli identyfikator typu programu AGAL nie jest prawidłowy. Trzeci bajt w kodzie bajtowym musi mieć wartość 0xa1. Ten błąd może oznaczać, że w tablicy bajtów ustawiono nieprawidłową kolejność bajtów endian.
| |
Error — Nieprawidłowy typ modułu cieniującego AGAL: jeśli kod typu modułu cieniującego nie wskazuje programu fragmentów ani programu wierzchołków (nie ma wartości 1 lub 0).
| |
Error — Nieprawidłowy kod operacji AGAL — poza zakresem: w przypadku wystąpienia nieprawidłowego kodu operacji w strumieniu znaczników.
| |
Error — Nieprawidłowy kod operacji AGAL — brak implementacji: w przypadku wystąpienia nieprawidłowego kodu operacji w strumieniu znaczników.
| |
Error — Kod operacji AGAL dozwolony tylko w programie fragmentów: jeśli w strumieniu znaczników programu wierzchołków napotkano kod operacji, który jest dozwolony tylko w programach fragmentów, takich jak KIL lub TEX.
| |
Error — Nieprawidłowe argumenty źródłowe kodu AGAL: Jeśli oba argumenty źródłowe są rejestrami stałych. Należy obliczyć wynik poza programem modułu cieniującego i przekazać go przy użyciu pojedynczego rejestru stałych.
| |
Error — Oba argumenty są odczytywane pośrednio: jeśli oba argumenty są odczytywane pośrednio.
| |
Error — Wszystkie miejsca docelowe kodów operacji muszą być zerowe: jeśli znacznik z kodem operacje (takim jak KIL) bez miejsca docelowego ustawi wartość niezerową rejestru miejsca docelowego.
| |
Error — Miejsce docelowe kodu operacji musi używać maski: jeśli kod operacji generującej wynik z tylko trzema składnikami zostanie użyty bez maskowania.
| |
Error — Zbyt wiele znaczników: jeśli w programie AGAL występuje zbyt wiele znaczników (więcej niż 200).
| |
Error — Typ modułu cieniującego fragmentów: jeśli typ programu fragmentów (szósty bajt parametru fragmentProgram) ma wartość inną niż 1.
| |
Error — Typ modułu cieniującego wierzchołków: jeśli typ programu wierzchołków (szósty bajt parametru vertexProgram) ma wartość inną niż 1.
| |
Error — Zmienny odczytany, ale nie zapisany: jeśli moduł cieniujący fragmentów odczytuje rejestr zmienny, do którego nigdy nic nie zapisał moduł cieniujący wierzchołków.
| |
Error — Częściowy zapis zmiennego: Jeśli zapis w rejestrze zmiennym będzie tylko częściowy. Informacje muszą zostać zapisane we wszystkich składnikach rejestru zmiennego.
| |
Error — Zapisz wszystkie składniki fragmentów: Jeśli produkt koloru fragmentów został tylko częściowo zapisany. Informacje muszą zostać zapisane we wszystkich czterech składnikach produktu koloru.
| |
Error — Zapisz wszystkie składniki wierzchołków: Jeśli produkt wierzchołków w przestrzeni klipu został zapisany tylko częściowo. Informacje muszą zostać zapisane we wszystkich składnikach produktu wierzchołka przestrzeni klipu.
| |
Error — Nieużywany argument: jeśli nie wszystkie parametry nieużywanego argumentu w znaczniku przyjmują wartość 0.
| |
Error — Rejestr próbnika tylko w programie fragmentów: jeśli w programie wierzchołków użyto rejestru próbnika.
| |
Error — Rejestr próbnika to drugi argument: jeśli rejestr próbnika został użyty jako element docelowy lub pierwszy argument znacznika AGAL.
| |
Error — Pośrednie dozwolone tylko w programie wierzchołków: jeśli w programie fragmentów jest używane adresowanie pośrednie.
| |
Error — Pośrednie tylko w rejestrach stałych: jeśli adresowanie pośrednie zostanie użyte dla rejestru zmiennego.
| |
Error — Typ źródła pośredniego: jeśli typem źródła adresowania pośredniego nie jest atrybut, stała lub rejestr tymczasowy.
| |
Error — Pola adresowania pośredniego muszą być zerowe: jeśli nie wszystkie pola adresowania pośredniego mają wartość zero w przypadku adresowania bezpośredniego.
| |
Error — Rejestry zmienne odczytywane tylko w programie fragmentów: Jeśli rejestr zmienny jest odczytywany w programie wierzchołków. Rejestry zmienne mogą być zapisywane tylko w programach wierzchołków, a odczytywane tylko w programach fragmentów.
| |
Error — Rejestry atrybutów odczytywane tylko w programie wierzchołków: Jeśli nastąpi odczytanie rejestru atrybutów w programie fragmentów. Rejestry atrybutów mogą być odczytywane tylko w programach wierzchołków.
| |
Error — Nie można odczytać rejestru wyjściowego: Jeśli nastąpi próba odczytania rejestru wyjściowego (położenia lub koloru). W rejestrach wyjściowych można tylko zapisywać dane. Nie można z nich odczytywać.
| |
Error — Odczyt rejestru tymczasowego bez zapisu: jeśli rejestr tymczasowy jest odczytywany w sytuacji, gdy nic w nim wcześniej nie zapisano.
| |
Error — Odczyt składnika rejestru tymczasowego bez zapisu: jeśli składnik rejestru tymczasowego jest odczytywany w sytuacji, gdy nic w nim wcześniej nie zapisano.
| |
Error — Nie można zapisywać w rejestrze próbnika: Jeśli nastąpi zapis do rejestru próbnika. Rejestry próbników można tylko odczytywać. Nie można w nich zapisywać.
| |
Error — Zapis w rejestrze zmiennym: Jeśli w programie fragmentów informacje są zapisywane w rejestrze zmiennym. Rejestry zmienne mogą być zapisywane tylko w programach wierzchołków, a odczytywane tylko w programach fragmentów.
| |
Error — Nie można zapisywać w rejestrze atrybutu: Jeśli nastąpi zapis do rejestru atrybutu. Rejestry atrybutów są dostępne tylko do odczytu.
| |
Error — Nie można zapisać w rejestrze stałych: jeśli w programie modułu cieniującego nastąpi zapis do rejestru stałych.
| |
Error — Zerowa docelowa maska zapisu: Jeśli docelowa maska zapisu jest równa zero. Muszą być ustawione wszystkie składniki rejestru wyjściowego.
| |
Error — Zarezerwowane bity AGAL powinny być zerowe: Jeśli którykolwiek zarezerwowany bit w znaczniku nie ma wartości zero. Wskazuje to na błąd podczas tworzenia kodu bajtowego (lub uszkodzony kod bajtowy).
| |
Error — Nieznany typ rejestru: jeśli zostanie użyty nieprawidłowy indeks typu rejestru.
| |
Error — Rejestr próbnika poza zakresem: jeśli zostanie użyty nieprawidłowy indeks rejestru próbnika.
| |
Error — Rejestr zmiennym poza zakresem: jeśli zostanie użyty nieprawidłowy indeks rejestru zmiennego.
| |
Error — Rejestr atrybutów poza zakresem: jeśli zostanie użyty nieprawidłowy indeks rejestru atrybutów.
| |
Error — Rejestr stałych poza zakresem: jeśli zostanie użyty nieprawidłowy indeks rejestru stałych.
| |
Error — Rejestr wyjściowy poza zakresem: jeśli zostanie użyty nieprawidłowy indeks rejestru wyjściowego.
| |
Error — Rejestr tymczasowy poza zakresem: jeśli zostanie użyty nieprawidłowy indeks rejestru tymczasowego.
| |
Error — Próbnik mapy sześcianu musi stosować ściskanie: jeśli próbnik mapy sześcianu nie ustawił typu opakowywania na ściskanie.
| |
Error — Nieznany wymiar próbnika: Jeśli próbka używa nieznanego wymiaru próbnika. (Są obsługiwane tylko tekstury 2D i sześcienne).
| |
Error — Nieznany tryb filtrowania: Jeśli próbnik używa nieznanego trybu filtrowania. (Jest obsługiwane tylko filtrowanie typu najbliższy sąsiad oraz liniowe).
| |
Error — Nieznany tryb mipmappingu: Jeśli próbnik używa nieznanego trybu mipmappingu. (Są obsługiwane tylko następujące tryby mipmappingu: brak, najbliższy sąsiad i liniowy).
| |
Error — Nieznany tryb opakowywania: Jeśli próbnik używa nieznanego trybu opakowywania. (Są obsługiwane tylko następujące tryby opakowywania: ściskanie i powtarzanie).
| |
Error — Nieznana flaga specjalna: jeśli próbnik używa nieznanej flagi specjalnej.
| |
Error — Nie można maskować koloru wyjściowego: Nie można zamaskować rejestru wyjściowego koloru w programie fragmentów. Muszą być ustawione wszystkie składniki rejestru koloru.
| |
Error — Drugim argumentem musi być rejestr próbnika: kod operacji TEX w języku AGAL musi zawierać próbnik jako drugi atrybut źródła.
| |
Error — Niedozwolone adresowanie pośrednie: użyto adresowania pośredniego w miejscu, gdzie jest niedozwolone.
| |
Error — Przekładanie musi być skalarne: błąd przekładania.
| |
Error — Nie można przełożyć drugiego źródła: błąd przekładania.
| |
Error — Drugie użycie próbnika musi mieć te same parametry: wszystkie próbniki uzyskujące dostęp do tej samej tekstury muszą używać tych samych ustawień wymiarów, zawijania, filtrowania, specjalnych i mipmappingu.
| |
Error — Interfejs API Stage3D nie może być używany podczas wykonywania tła.
|
Więcej informacji
Powiązane elementy interfejsu API
Tue Jun 12 2018, 12:06 PM Z