Pakiet | flash.display3D.textures |
Klasa | public final class CubeTexture |
Dziedziczenie | CubeTexture TextureBase EventDispatcher Object |
Definiuje teksturę mapy sześciennej do użytku podczas renderowania. Odwzorowanie sześcienne jest używane w wielu technikach renderowania, takich jak mapy środowiska, techniki typu skybox czy oświetlenie z nieba.
Obiektu CubeTexture nie można utworzyć bezpośrednio — zamiast tego należy użyć metody createCubeTexture()
klasy Context3D.
Więcej informacji
Powiązane elementy interfejsu API
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 teksturę sześcienną z tablicy bajtów w formacie ATF (Adobe Texture Format). | CubeTexture | ||
Wysyła składnik tekstury mapy sześciennej z obiektu BitmapData. | CubeTexture | ||
Wysyła składnik tekstury mapy sześciennej z obiektu ByteArray. | CubeTexture | ||
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 |
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 teksturę sześcienną z tablicy bajtów w formacie ATF (Adobe Texture Format).
Tablica bajtów musi zawierać wszystkie powierzchnie i mipmapy tekstury.
Parametry
data:ByteArray — Tablica bajtów zawierająca skompresowaną teksturę sześcienną z bitmapami. Obiekt ByteArray musi korzystać z formatu little endian.
| |
byteArrayOffset:uint — Opcjonalne przesunięcie określające punkt początkowy odczytu danych tekstury.
| |
async:Boolean (default = false ) — W przypadku wartości true ta funkcja natychmiast kończy działanie i zwraca wartość. 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 . 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 .
| |
ArgumentError — Tekstura musi być kwadratowa: gdy zdekompresowana tekstura ma szerokość inną niż wysokość.
| |
ArgumentError — Niezgodny rozmiar tekstury: gdy szerokość lub wysokość zdekompresowanej tekstury nie odpowiada długości krawędzi tekstury.
| |
ArgumentError — Zbyt wysoki poziom mipmapy: jeśli określony poziom mipmapy dla zdekompresowanej tekstury jest większy, niż wynikałoby to z długości krawędzi tekstury.
| |
ArgumentError — Niezgodne formaty tekstur: Jeśli odkodowane bajty ATF nie zawierają tekstury zgodnej z tym formatem tekstury lub nie jest to tekstura sześcienna.
| |
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, side:uint, miplevel:uint = 0):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 11, AIR 3 |
Wysyła składnik tekstury mapy sześciennej z obiektu BitmapData.
Ta funkcja wysyła jeden poziom mipmapy jednego boku mapy sześciennej. W razie konieczności wywołanie metody uploadFromBitmapData()
pozwala wysłać każdy poziom mipmapy i każdy bok mapy sześciennej.
Parametry
source:BitmapData — Bitmapa.
| |
side:uint — Kod określający bok sześcianu, który ma zostać wysłany:
| |
miplevel:uint (default = 0 ) — Poziom mipmapy do wczytania. Poziom zero oznacza najwyższy poziom obrazu w pełnej rozdzielczości. Wartością domyślną jest zero.
|
Zgłasza
TypeError — Błąd wskaźnika null: jeśli 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 wymiarów tekstury.
| |
ArgumentError — Nieprawidłowy bok sześcianu: jeśli właściwość side ma wartość większą niż 5.
| |
ArgumentError — Błąd nieprawidłowych danych bitmapy: Jeśli właściwość source obiektu BitmapData nie zawiera prawidłowej powierzchni tekstury sześciennej. Obraz musi być kwadratowy. Boki 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.
|
uploadFromByteArray | () | metoda |
public function uploadFromByteArray(data:ByteArray, byteArrayOffset:uint, side:uint, miplevel:uint = 0):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | Flash Player 11, AIR 3 |
Wysyła składnik tekstury mapy sześciennej z obiektu ByteArray.
Ta funkcja wysyła jeden poziom mipmapy jednego boku mapy sześciennej. W razie konieczności wywołanie metody uploadFromByteArray()
pozwala wysłać każdy poziom mipmapy i każdy bok mapy sześciennej.
Parametry
data:ByteArray — Tablica bajtów zawierająca obraz w formacie określonym podczas tworzenia tego obiektu CubeTexture. Obiekt ByteArray musi korzystać z formatu little endian.
| |
byteArrayOffset:uint — Tu rozpoczyna się odczyt tablicy bajtów.
| |
side:uint — Kod określający bok sześcianu, który ma zostać wysłany:
| |
miplevel:uint (default = 0 ) — Poziom mipmapy do wczytania. Poziom zero oznacza najwyższy poziom obrazu w pełnej rozdzielczości.
|
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 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.
|
Tue Jun 12 2018, 12:06 PM Z