Пакет | flash.display3D.textures |
Класс | public final class CubeTexture |
Наследование | CubeTexture TextureBase EventDispatcher Object |
Определяет текстуру отображения куба, которая будет использоваться во время визуализации. Кубическое текстурирование используется во многих приемах визуализации, например для карт окружающей среды, небесных кубов и верхнего освещения.
Нельзя создать объект CubeTexture напрямую; воспользуйтесь методом createCubeTexture()
объекта 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) из байтового массива. | CubeTexture | ||
Загружает компонент кубического текстурирования из объекта BitmapData. | CubeTexture | ||
Загружает компонент кубического текстурирования из объекта ByteArray. | CubeTexture | ||
Возвращает элементарное значение заданного объекта. | 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) из байтового массива.
Байтовый массив должен содержать все грани и множественные отображения для текстуры.
Параметры
data:ByteArray — байтовый массив, содержащий сжатую кубическую текстуру, включая множественные отображения. Для объекта ByteArray необходимо использовать формат с прямым порядком байтов.
| |
byteArrayOffset:uint — дополнительное смещение, с которым необходимо начинать чтение данных текстуры.
| |
async:Boolean (default = false ) — При установке для этого объекта значения true возврат функции происходит немедленно. До успешного окончания загрузки использовать структуру с помощью какого-либо метода считывания невозможно. После успешного завершения загрузки объект Texture отправляет событие Event.TEXTURE_READY . Значение по умолчанию: false.
|
Выдает
TypeError — Ошибка пустого указателя: когда data имеет значение null.
| |
ArgumentError — Сбой декодирования текстуры: если формат сжатия этого объекта не может быть получен из формата сжатых данных в data .
| |
ArgumentError — Текстура должна быть квадратной: когда распакованная текстура имеет неравные ширину и высоту.
| |
ArgumentError — Размер текстуры не совпадает: когда ширина и высота распакованной текстуры не равны длине края текстуры.
| |
ArgumentError — Слишком большой mip-уровень: если mip-уровень распакованной текстуры больше, чем определено длиной края текстуры.
| |
ArgumentError — Несоответствие формата текстуры: если декодированные байты ATF не содержат текстуру, совместимую с форматом данной текстуры, или не представляют собой кубическую текстуру.
| |
Error — 3768: API-интерфейс Stage3D не может использоваться во время выполнения в фоновом режиме.
| |
RangeError — Неверный размер ввода: если возникает проблема целочисленного переполнения byteArrayOffset , если byteArrayOffset + 6 превышает длину массива data или если число байтов, доступных со смещением byteArrayOffset в конец массива байтов data , меньше объема данных, необходимых для текстуры ATF.
|
Связанные элементы API
uploadFromBitmapData | () | метод |
public function uploadFromBitmapData(source:BitmapData, side:uint, miplevel:uint = 0):void
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 11, AIR 3 |
Загружает компонент кубического текстурирования из объекта BitmapData.
Эта функция загружает один mip-уровень одной стороны карты куба. Вызывайте метод uploadFromBitmapData ()
по мере необходимости, чтобы загрузить каждый mip-уровень и грань карты куба.
Параметры
source:BitmapData — растровое изображение.
| |
side:uint — Код, показывающий, какую сторону куба необходимо загрузить:
| |
miplevel:uint (default = 0 ) — mip-уровень, который должен быть загружен, уровень нуля является высокоуровневым изображением в полном разрешении. По умолчанию установлено значение 0.
|
Выдает
TypeError — Ошибка пустого указателя: если source имеет значение null .
| |
ArgumentError — Слишком большой mip-уровень: если указанный mip-больше, чем определено размерами текстуры.
| |
ArgumentError — Недопустимая сторона куба: если side больше 5.
| |
ArgumentError — Недопустимая ошибка BitmapData: если source объекта BitmapData не содержит допустимую грань кубической текстуры. Изображение должно быть квадратным, его стороны должны быть равны степени двойки, а его размер должен соответствовать указанному mip-уровню.
| |
ArgumentError — Несоответствие формата текстуры: если формат текстуры — Context3DTextureFormat.COMPRESSED или Context3DTextureFormat.COMPRESSED_ALPHA, но код выполняется на мобильной платформе, где сжатие текстур во время выполнения не поддерживается.
| |
Error — 3768: API-интерфейс Stage3D не может использоваться во время выполнения в фоновом режиме.
|
uploadFromByteArray | () | метод |
public function uploadFromByteArray(data:ByteArray, byteArrayOffset:uint, side:uint, miplevel:uint = 0):void
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | Flash Player 11, AIR 3 |
Загружает компонент кубического текстурирования из объекта ByteArray.
Эта функция загружает один mip-уровень одной стороны карты куба. Вызывайте метод uploadFromByteArray()
по мере необходимости, чтобы загрузить каждый mip-уровень и грань карты куба.
Параметры
data:ByteArray — массив байтов, содержащий изображение в формате, указанном при создании этого объекта CubeTexture. Для объекта ByteArray необходимо использовать формат с прямым порядком байтов.
| |
byteArrayOffset:uint — отсюда начинается чтение массива байтов.
| |
side: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 не может использоваться во время выполнения в фоновом режиме.
|
Tue Jun 12 2018, 11:34 AM Z