Пакет | flash.display3D.textures |
Класс | public final class Texture |
Наследование | Texture TextureBase EventDispatcher Object |
Определяет текстуру 2D для использования во время визуализации.
Экземпляр Texture не может быть создан напрямую. Создать экземпляры с помощью метода createTexture()
Context3D.
Связанные элементы API
Метод | Определено | ||
---|---|---|---|
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | ||
Посылает событие в поток событий. | EventDispatcher | ||
Освобождает все ресурсы графического процессора, связанные с этой текстурой. | TextureBase | ||
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | ||
Показывает, определено ли заданное свойство для объекта. | Object | ||
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | ||
Показывает наличие заданного свойства и его перечисляемость. | Object | ||
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | ||
Задает доступность динамического свойства для операций цикла. | Object | ||
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | ||
Возвращает строковое представление заданного объекта. | Object | ||
uploadCompressedTextureFromByteArray(data:ByteArray, byteArrayOffset:uint, async:Boolean = false):void
Загружает сжатую текстуру в формат Adobe Texture Format (ATF) из объекта ByteArray. | Texture | ||
Загружает текстуру из объекта BitmapData. | Texture | ||
Асинхронно загружает mip-уровень 0 для текстуры из объекта BitmapData. | Texture | ||
Загружает текстуру из объекта ByteArray. | Texture | ||
Асинхронного загружает mip-уровень 0 для текстуры из объекта ByteArray. | Texture | ||
Возвращает элементарное значение заданного объекта. | Object | ||
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher |
uploadCompressedTextureFromByteArray | () | метод |
public function uploadCompressedTextureFromByteArray(data:ByteArray, byteArrayOffset:uint, async:Boolean = false):void
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 11, AIR 3 |
Загружает сжатую текстуру в формат Adobe Texture Format (ATF) из объекта ByteArray. Для файла ATF версии 2 требуется SWF версии 21 или более поздней, а для файла ATF версии 3 требуется SWF версии 29 или более поздней. Для файлов ATF, созданных с использованием изображения png без альфа-канала, строка format
, переданная во время Context3DObject::createTexture
, должна иметь значение COMPRESSED, а для файлов ATF, созданных с использованием изображения png с альфа-каналом, строка format
, переданная во время Context3DObject::createTexture
, должна иметь значение COMPRESSED_ALPHA.
Параметры
data:ByteArray — байтовый массив, содержащий сжатую текстуру, включая множественные отображения. Для объекта ByteArray необходимо использовать формат с прямым порядком байтов.
| |
byteArrayOffset:uint — место в байтовом массиве, с которого необходимо начать чтение данных текстуры.
| |
async:Boolean (default = false ) — При установке для этого объекта значения true возврат функции происходит немедленно. До успешного окончания загрузки использовать структуру с помощью какого-либо метода считывания невозможно. После успешного завершения загрузки объект CubeTexture отправляет событие Event.TEXTURE_READY . Значение по умолчанию: false.
|
Выдает
TypeError — Ошибка пустого указателя: когда data имеет значение null.
| |
ArgumentError — Сбой декодирования текстуры: если формат сжатия этого объекта не может быть получен из формата сжатых данных в data или если версия SWF несовместима с версией файла ATF.
| |
ArgumentError — Размер текстуры не совпадает: когда ширина и высота распакованной текстуры не равны размерам данного объекта Texture.
| |
ArgumentError — Слишком большой mip-уровень: если mip-уровень распакованной текстуры больше, чем определено размером текстуры.
| |
ArgumentError — Несоответствие формата текстуры: если декодированные байты ATF не содержат текстуру, совместимую с форматом данной текстуры.
| |
Error — 3768: API-интерфейс Stage3D не может использоваться во время выполнения в фоновом режиме.
| |
RangeError — Неверный размер ввода: если возникает проблема целочисленного переполнения byteArrayOffset , если byteArrayOffset + 6 превышает длину массива data или если число байтов, доступных со смещением byteArrayOffset в конец массива байтов data , меньше объема данных, необходимых для текстуры ATF.
|
Связанные элементы API
uploadFromBitmapData | () | метод |
public function uploadFromBitmapData(source:BitmapData, miplevel:uint = 0):void
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 11, AIR 3 |
Загружает текстуру из объекта BitmapData.
Параметры
source:BitmapData — растровое изображение.
| |
miplevel:uint (default = 0 ) — mip-уровень, который должен быть загружен, уровень нуля является высокоуровневым изображением в полном разрешении.
|
Выдает
TypeError — Ошибка пустого указателя: когда source имеет нулевое значение.
| |
ArgumentError — Слишком большой mip-уровень: если указанный mip-больше, чем определено большими размерами объекта Texture.
| |
ArgumentError — Недопустимая ошибка BitmapData: если source объекта BitmapData не содержит допустимую грань кубической текстуры. Изображение должно иметь стороны, равные степени двойки, и подходящий размер для указанного mip-уровня.
| |
ArgumentError — Несоответствие формата текстуры: если формат текстуры — Context3DTextureFormat.COMPRESSED или Context3DTextureFormat.COMPRESSED_ALPHA, но код выполняется на мобильной платформе, где сжатие текстур во время выполнения не поддерживается.
| |
Error — 3768: API-интерфейс Stage3D не может использоваться во время выполнения в фоновом режиме.
|
uploadFromBitmapDataAsync | () | метод |
public function uploadFromBitmapDataAsync(source:BitmapData, miplevel:uint = 0):void
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 24 |
Асинхронного загружает mip-уровень 0 для текстуры из объекта BitmapData. До успешного окончания загрузки использовать структуру с помощью какого-либо метода считывания невозможно. После успешного завершения загрузки объект Texture
отправляет событие Event.TEXTURE_READY
. Event.TEXTURE_READY — это обратный вызов, указывающий на то, что асинхронный вызов, полученный для объекта текстуры, выполнен успешно. В случае ошибок во время фоновой отправки этот объект Texture
отправляет событие Event.ERROREVENT
.
Параметры
source:BitmapData — растровое изображение
| |
miplevel:uint (default = 0 )
|
Выдает
TypeError — Ошибка пустого указателя: когда source имеет нулевое значение.
| |
ArgumentError — Недопустимая ошибка BitmapData: если source объекта BitmapData не содержит допустимую текстуру. Изображение должно иметь равные стороны и правильный размер для указанного mip-уровня.
| |
ArgumentError — Несоответствие формата текстуры: если формат текстуры — Context3DTextureFormat.COMPRESSED или Context3DTextureFormat.COMPRESSED_ALPHA, но код выполняется на мобильной платформе, где сжатие текстур во время выполнения не поддерживается.
| |
ArgumentError — Асинхронная загрузка поддерживается только для mip-уровня 0.
| |
Error — 3768: API-интерфейс Stage3D не может использоваться во время выполнения в фоновом режиме.
|
Связанные элементы API
uploadFromByteArray | () | метод |
public function uploadFromByteArray(data:ByteArray, byteArrayOffset:uint, miplevel:uint = 0):void
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 11, AIR 3 |
Загружает текстуру из объекта ByteArray.
Параметры
data:ByteArray — массив байтов, содержащий достаточно байтов во внутреннем формате текстур для заполнения текстуры. текстуры rgba считываются как байты для компонента текстового пикселя (1 или 4). текстуры float считываются как значения с плавающей запятой для компонента текстового пикселя (1 или 4). Для объекта ByteArray необходимо использовать формат с прямым порядком байтов.
| |
byteArrayOffset:uint — место в объекте байтового массива, с которого необходимо начать чтение данных текстуры.
| |
miplevel:uint (default = 0 ) — mip-уровень, который должен быть загружен, уровень нуля является высокоуровневым изображением в полном разрешении.
|
Выдает
TypeError — Ошибка пустого указателя: когда data имеет значение null.
| |
ArgumentError — Слишком большой mip-уровень: если указанный mip-больше, чем определено большими размерами объекта Texture.
| |
RangeError — Неверный размер ввода: если число байтов, доступных со смещением byteArrayOffset в конец массива байтов data , меньше количества данных, требуемых для текстуры данного mip-уровня, или если значение byteArrayOffset больше или равно длине массива data .
| |
ArgumentError — Несоответствие формата текстуры: если формат текстуры — Context3DTextureFormat.COMPRESSED или Context3DTextureFormat.COMPRESSED_ALPHA, но код выполняется на мобильной платформе, где сжатие текстур во время выполнения не поддерживается.
| |
Error — 3768: API-интерфейс Stage3D не может использоваться во время выполнения в фоновом режиме.
|
uploadFromByteArrayAsync | () | метод |
public function uploadFromByteArrayAsync(data:ByteArray, byteArrayOffset:uint, miplevel:uint = 0):void
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 24 |
Асинхронно загружает mip-уровень 0 для текстуры из объекта ByteArray. До успешного окончания загрузки использовать структуру с помощью какого-либо метода считывания невозможно. После успешного завершения загрузки объект Texture
отправляет событие Event.TEXTURE_READY
. Event.TEXTURE_READY — это обратный вызов, указывающий на то, что асинхронные вызовы, полученные для объекта текстуры, выполнены успешно. В случае ошибок во время фоновой отправки этот объект Texture
отправляет событие Event.ERROREVENT
.
Параметры
data:ByteArray — массив байтов, содержащий достаточно байтов во внутреннем формате текстур для заполнения текстуры. текстуры rgba считываются как байты для компонента текстового пиксела (1 или 4). текстуры float считываются как значения с плавающей запятой для компонента текстового пикселя (1 или 4). Для объекта ByteArray необходимо использовать формат с прямым порядком байтов.
| |
byteArrayOffset:uint — место в объекте байтового массива, с которого необходимо начать чтение данных текстуры.
| |
miplevel:uint (default = 0 )
|
Выдает
TypeError — Ошибка пустого указателя: когда data имеет значение null.
| |
RangeError — Неверный размер ввода: если число байтов, доступных со смещением byteArrayOffset в конец массива байтов data , меньше количества данных, требуемых для текстуры mip-уровня 0, или если значение byteArrayOffset больше или равно длине массива data .
| |
ArgumentError — Несоответствие формата текстуры: если формат текстуры — Context3DTextureFormat.COMPRESSED или Context3DTextureFormat.COMPRESSED_ALPHA, но код выполняется на мобильной платформе, где сжатие текстур во время выполнения не поддерживается.
| |
ArgumentError — Асинхронная загрузка поддерживается только для mip-уровня 0.
| |
Error — 3768: API-интерфейс Stage3D не может использоваться во время выполнения в фоновом режиме.
| |
Error — если инициирована асинхронная отправка объекта текстуры и имеется еще один вызов асинхронной отправки для того же объекта текстуры.
|
Связанные элементы API
Tue Jun 12 2018, 11:34 AM Z