| Pakiet | flash.display3D.textures |
| Klasa | public final class Texture |
| Dziedziczenie | Texture  TextureBase EventDispatcher Object |
Definiuje teksturę 2D przeznaczoną do użytku podczas renderowania.
Nie można bezpośrednio tworzyć wystąpień klasy Texture. Wystąpienia należy tworzyć przy użyciu metody Context3D createTexture().
Powiązane elementy interfejsu API
Właściwości publiczne
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczneMetody publiczne
| Metoda | Zdefiniowane przez | ||
|---|---|---|---|
 | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Rejestruje obiekt detektora zdarzeń w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu. | EventDispatcher | |
|
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń. | EventDispatcher | |
|
Zwalnia wszystkie zasoby GPU związane z tą teksturą. | TextureBase | |
|
Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń. | EventDispatcher | |
|
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 | |
|
Usuwa detektor z obiektu EventDispatcher. | EventDispatcher | |
|
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 | |
uploadCompressedTextureFromByteArray(data:ByteArray, byteArrayOffset:uint, async:Boolean = false):void
Wysyła skompresowaną teksturę w formacie ATF (Adobe Texture Format) z obiektu ByteArray. | Texture | ||
Wysyła teksturę z obiektu BitmapData. | Texture | ||
Wysyła asynchronicznie poziom 0 mipmapy dla tekstury z obiektu BitmapData. | Texture | ||
Wysyła teksturę z obiektu ByteArray. | Texture | ||
Wysyła asynchronicznie poziom 0 mipmapy dla tekstury z obiektu ByteArray. | Texture | ||
|
Zwraca pierwotną wartość dla określonego obiektu. | Object | |
|
Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych. | EventDispatcher | |
Zdarzenia
Szczegół metody
uploadCompressedTextureFromByteArray | () | metoda |
public function uploadCompressedTextureFromByteArray(data:ByteArray, byteArrayOffset:uint, async:Boolean = false):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 11, AIR 3 |
Wysyła skompresowaną teksturę w formacie ATF (Adobe Texture Format) z obiektu ByteArray. Plik ATF w wersji 2 wymaga formatu SWF w wersji 21 lub nowszej. Plik ATF w wersji 3 wymaga formatu SWF w wersji 29 lub nowszej. W przypadku plików ATF utworzonych z obrazem PNG bez kanału alfa ciąg format podany w parametrze Context3DObject::createTexture powinien mieć wartość „COMPRESSED”. W przypadku plików ATF utworzonych z obrazem PNG z kanałem alfa ciąg format parametru Context3DObject::createTexture powinien mieć wartość „COMPRESSED_ALPHA”.
Parametry
data:ByteArray — Tablica bajtów zawierająca skompresowaną teksturę z bitmapami. Obiekt ByteArray musi korzystać z formatu little endian.
| |
byteArrayOffset:uint — Pozycja w tablicy bajtów, od której mają być odczytywane dane tekstury.
| |
async:Boolean (default = false)CubeTexture wywołuje zdarzenie Event.TEXTURE_READY. Wartość domyślna: false.
|
Zgłasza
TypeError — Błąd pustego wskaźnika: gdy właściwość data ma wartość null.
| |
ArgumentError — Niepowodzenie dekodowania tekstury: Gdy formatu kompresji tego obiektu nie można uzyskać na podstawie formatu danych skompresowanych w parametrze data lub wersja pliku SWF nie jest zgodna z wersją pliku ATF.
| |
ArgumentError — Niezgodny rozmiar tekstury: gdy szerokość lub wysokość zdekompresowanej tekstury nie odpowiada powiązanemu wymiarowi tego obiektu Texture.
| |
ArgumentError — Zbyt wysoki poziom mipmapy: jeśli określony poziom mipmapy dla zdekompresowanej tekstury jest większy, niż wynikałoby to z rozmiaru tekstury.
| |
ArgumentError — Niezgodne formaty tekstur: Jeśli odkodowane bajty ATF nie zawierają tekstury zgodnej z tym formatem tekstury.
| |
Error — Interfejs API Stage3D nie może być używany podczas wykonywania tła.
| |
RangeError — Nieprawidłowy rozmiar danych wejściowych: Gdy dla parametru byteArrayOffset występuje przepełnienie całkowitoliczbowe, wartość byteArrayOffset + 6 jest większa niż długość tablicy data lub liczba bajtów dostępnych od wartości byteArrayOffset do końca tablicy bajtowej data jest mniejsza niż ilość danych wymaganych dla tekstury ATF.
|
Powiązane elementy interfejsu API
uploadFromBitmapData | () | metoda |
public function uploadFromBitmapData(source:BitmapData, miplevel:uint = 0):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 11, AIR 3 |
Wysyła teksturę z obiektu BitmapData.
Parametry
source:BitmapData — Bitmapa.
| |
miplevel:uint (default = 0) |
Zgłasza
TypeError — Błąd wskaźnika null: gdy właściwość source ma wartość null.
| |
ArgumentError — Zbyt wysoki poziom mipmapy: jeśli określony poziom mipmapy jest większy, niż wynikałoby to z większego z wymiarów tekstury.
| |
ArgumentError — Błąd nieprawidłowych danych bitmapy: Jeśli właściwość source obiektu BitmapData nie zawiera prawidłowej powierzchni tekstury sześciennej. Boki obrazu muszą mieć wymiary równe potęgom liczby 2. Musi być określony właściwy poziom mipmapy.
| |
ArgumentError — Niezgodne formaty tekstur: Jeśli format tekstury to Context3DTextureFormat.COMPRESSED lub Context3DTextureFormat.COMPRESSED_ALPHA, a kod jest wykonywany na platformie przenośnej, na której nie jest obsługiwana kompresja tekstur w czasie wykonywania.
| |
Error — Interfejs API Stage3D nie może być używany podczas wykonywania tła.
|
uploadFromBitmapDataAsync | () | metoda |
public function uploadFromBitmapDataAsync(source:BitmapData, miplevel:uint = 0):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 24 |
Wysyła asynchronicznie poziom 0 mipmapy dla tekstury z obiektu BitmapData. Każda metoda rysowania próbująca użyć tekstury kończy działanie niepowodzeniem do momentu pomyślnego zakończenia wysyłania. Po pomyślnym wysłaniu danych ten obiekt Texture wywołuje zdarzenie Event.TEXTURE_READY. Zdarzenie Event.TEXTURE_READY jest wywołaniem zwrotnym, które wskazuje, że wywołania asynchroniczne odebrane dla obiektu tekstury zostały pomyślnie wykonane. W przypadku wystąpienia błędu podczas wysyłania w tle ten obiekt Texture wywołuje zdarzenie Event.ERROREVENT.
Parametry
source:BitmapData — Bitmapa
| |
miplevel:uint (default = 0) |
Zgłasza
TypeError — Błąd wskaźnika null: gdy właściwość source ma wartość null.
| |
ArgumentError — Błąd nieprawidłowych danych bitmapy: Jeśli właściwość source obiektu BitmapData nie zawiera prawidłowej tekstury. Obraz musi mieć wymiary równe potęgom liczby 2. Musi być określony właściwy poziom mipmapy.
| |
ArgumentError — Niezgodne formaty tekstur: Jeśli format tekstury to Context3DTextureFormat.COMPRESSED lub Context3DTextureFormat.COMPRESSED_ALPHA, a kod jest wykonywany na platformie przenośnej, na której nie jest obsługiwana kompresja tekstur w czasie wykonywania.
| |
ArgumentError — Wysyłanie asynchroniczne obsługiwane wyłącznie dla poziomu 0 mipmapy.
| |
Error — Interfejs API Stage3D nie może być używany podczas wykonywania tła.
|
Powiązane elementy interfejsu API
uploadFromByteArray | () | metoda |
public function uploadFromByteArray(data:ByteArray, byteArrayOffset:uint, miplevel:uint = 0):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 11, AIR 3 |
Wysyła teksturę z obiektu ByteArray.
Parametry
data:ByteArray — Tablica bajtów zawierająca liczbę bajtów w wewnętrznym formacie tekstury wystarczającą do wypełnienia tekstury. Tekstury rgba są odczytywane jako wartości bajtowe na składnik teksela (1 lub 4). Tekstury float są odczytywane jako liczby rzeczywiste na składnik teksela (1 lub 4). Obiekt ByteArray musi korzystać z formatu little endian.
| |
byteArrayOffset:uint — Pozycja w obiekcie tablicy bajtów, od której mają być odczytywane dane tekstury.
| |
miplevel:uint (default = 0) |
Zgłasza
TypeError — Błąd pustego wskaźnika: gdy właściwość data ma wartość null.
| |
ArgumentError — Zbyt wysoki poziom mipmapy: jeśli określony poziom mipmapy jest większy, niż wynikałoby to z większego z wymiarów tekstury.
| |
RangeError — Nieprawidłowy rozmiar danych wejściowych: Gdy liczba bajtów od wartości byteArrayOffset do końca tablicy bajtowej data jest mniejsza niż ilość danych wymaganych dla tekstury na tym poziomie mipmap lub wartość byteArrayOffset jest co najmniej równa długości tablicy data.
| |
ArgumentError — Niezgodne formaty tekstur: Jeśli format tekstury to Context3DTextureFormat.COMPRESSED lub Context3DTextureFormat.COMPRESSED_ALPHA, a kod jest wykonywany na platformie przenośnej, na której nie jest obsługiwana kompresja tekstur w czasie wykonywania.
| |
Error — Interfejs API Stage3D nie może być używany podczas wykonywania tła.
|
uploadFromByteArrayAsync | () | metoda |
public function uploadFromByteArrayAsync(data:ByteArray, byteArrayOffset:uint, miplevel:uint = 0):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 24 |
Wysyła asynchronicznie poziom 0 mipmapy dla tekstury z obiektu ByteArray. Każda metoda rysowania próbująca użyć tekstury kończy działanie niepowodzeniem do momentu pomyślnego zakończenia wysyłania. Po pomyślnym wysłaniu danych ten obiekt Texture wywołuje zdarzenie Event.TEXTURE_READY. Zdarzenie Event.TEXTURE_READY jest wywołaniem zwrotnym, które wskazuje, że wywołania asynchroniczne odebrane dla obiektu tekstury zostały pomyślnie wykonane. W przypadku wystąpienia błędu podczas wysyłania w tle ten obiekt Texture wywołuje zdarzenie Event.ERROREVENT.
Parametry
data:ByteArray — Tablica bajtów zawierająca liczbę bajtów w wewnętrznym formacie tekstury wystarczającą do wypełnienia tekstury. Tekstury rgba są odczytywane jako wartości bajtowe na składnik teksela (1 lub 4). Tekstury float są odczytywane jako liczby rzeczywiste na składnik teksela (1 lub 4). Obiekt ByteArray musi korzystać z formatu little endian.
| |
byteArrayOffset:uint — Pozycja w obiekcie tablicy bajtów, od której mają być odczytywane dane tekstury.
| |
miplevel:uint (default = 0) |
Zgłasza
TypeError — Błąd pustego wskaźnika: gdy właściwość data ma wartość null.
| |
RangeError — Nieprawidłowy rozmiar danych wejściowych: Gdy liczba bajtów od wartości byteArrayOffset do końca tablicy bajtowej data jest mniejsza niż ilość danych wymaganych dla tekstury na tym poziomie mipmap lub wartość byteArrayOffset jest co najmniej równa długości tablicy data.
| |
ArgumentError — Niezgodne formaty tekstur: Jeśli format tekstury to Context3DTextureFormat.COMPRESSED lub Context3DTextureFormat.COMPRESSED_ALPHA, a kod jest wykonywany na platformie przenośnej, na której nie jest obsługiwana kompresja tekstur w czasie wykonywania.
| |
ArgumentError — Wysyłanie asynchroniczne obsługiwane wyłącznie dla poziomu 0 mipmapy.
| |
Error — Interfejs API Stage3D nie może być używany podczas wykonywania tła.
| |
Error — Jeśli wysyłanie asynchroniczne zostało zainicjowane dla obiektu tekstury, a dla tego samego obiektu tekstury istnieje inne wywołanie wysyłania asynchronicznego.
|
Powiązane elementy interfejsu API
Tue Jun 12 2018, 12:06 PM Z