Справочник по ActionScript® 3.0 для платформы Adobe® Flash®
Домашняя страница  |  Скрыть список пакетов и классов |  Пакеты  |  Классы  |  Что нового  |  Указатель  |  Приложения  |  Почему по-английски?
Фильтры: Получение данных с сервера...
Получение данных с сервера...
flash.display3D.textures 

CubeTexture  - AS3

Пакетflash.display3D.textures
Классpublic final class CubeTexture
НаследованиеCubeTexture Inheritance TextureBase Inheritance EventDispatcher Inheritance Object

Класс CubeTexture представляет кубическую текстуру, загруженную в контекст визуализации.

Определяет текстуру отображения куба, которая будет использоваться во время визуализации. Кубическое текстурирование используется во многих приемах визуализации, например для карт окружающей среды, небесных кубов и верхнего освещения.

Нельзя создать объект CubeTexture напрямую; воспользуйтесь методом createCubeTexture() объекта Context3D.

Дополнительно

Связанные элементы API



Общедоступные свойства
 СвойствоОпределено
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
Общедоступные методы
 МетодОпределено
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.
EventDispatcher
 Inherited
Посылает событие в поток событий.
EventDispatcher
 Inherited
Освобождает все ресурсы графического процессора, связанные с этой текстурой.
TextureBase
 Inherited
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.
EventDispatcher
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
EventDispatcher
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
  
uploadCompressedTextureFromByteArray(data:ByteArray, byteArrayOffset:uint, async:Boolean = false):void
Загружает кубическую текстуру в формат Adobe Texture Format (ATF) из байтового массива.
CubeTexture
  
uploadFromBitmapData(source:BitmapData, side:uint, miplevel:uint = 0):void
Загружает компонент кубического текстурирования из объекта BitmapData.
CubeTexture
  
uploadFromByteArray(data:ByteArray, byteArrayOffset:uint, side:uint, miplevel:uint = 0):void
Загружает компонент кубического текстурирования из объекта ByteArray.
CubeTexture
 Inherited
Возвращает элементарное значение заданного объекта.
Object
 Inherited
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.
EventDispatcher
События
 Событие Сводка Определено
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.EventDispatcher
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.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 — Код, показывающий, какую сторону куба необходимо загрузить:

    положительное X: 0
    отрицательное X: 1
    положительное Y: 2
    отрицательное Y: 3
    положительное Z: 4
    отрицательное Z: 5

 
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 — Код, показывающий, какую сторону куба необходимо загрузить:

    положительное X: 0
    отрицательное X: 1
    положительное Y: 2
    отрицательное Y: 3
    положительное Z: 4
    отрицательное Z: 5

 
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 не может использоваться во время выполнения в фоновом режиме.




[ X ]Почему по-английски?
Содержимое Справочника ActionScript 3.0 отображается на английском языке

Не все части Справочника ActionScript 3.0 переводятся на все языки. Если какой-то текстовый элемент не переведен, он отображается на английском языке. Например, компонент ga.controls.HelpBox не переведен ни на один из языков. Это значит, что в русской версии справки компонент ga.controls.HelpBox будет отображаться на английском языке.