Texture - Adobe ActionScript® 3 (AS3 )

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

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

Определяет текстуру 2D для использования во время визуализации.

Экземпляр Texture не может быть создан напрямую. Создать экземпляры с помощью метода createTexture() Context3D.

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

flash.display3D.Context3D.createTexture()
flash.display3D.Context3D.setTextureAt()

Общедоступные свойства

Скрыть унаследованные общедоступные свойства

Показать унаследованные общедоступные свойства

	Свойство		Определено
		constructor : Object Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.	Object

Общедоступные методы

Скрыть унаследованные общедоступные методы

Показать унаследованные общедоступные методы

	Метод		Определено
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.	EventDispatcher
		dispatchEvent(event:Event):Boolean Посылает событие в поток событий.	EventDispatcher
		dispose():void Освобождает все ресурсы графического процессора, связанные с этой текстурой.	TextureBase
		hasEventListener(type:String):Boolean Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.	EventDispatcher
		hasOwnProperty(name:String):Boolean Показывает, определено ли заданное свойство для объекта.	Object
		isPrototypeOf(theClass:Object):Boolean Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.	Object
		propertyIsEnumerable(name:String):Boolean Показывает наличие заданного свойства и его перечисляемость.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Удаляет прослушиватель из объекта EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Задает доступность динамического свойства для операций цикла.	Object
		toLocaleString():String Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.	Object
		toString():String Возвращает строковое представление заданного объекта.	Object
		uploadCompressedTextureFromByteArray(data:ByteArray, byteArrayOffset:uint, async:Boolean = false):void Загружает сжатую текстуру в формат Adobe Texture Format (ATF) из объекта ByteArray.	Texture
		uploadFromBitmapData(source:BitmapData, miplevel:uint = 0):void Загружает текстуру из объекта BitmapData.	Texture
		uploadFromBitmapDataAsync(source:BitmapData, miplevel:uint = 0):void Асинхронно загружает mip-уровень 0 для текстуры из объекта BitmapData.	Texture
		uploadFromByteArray(data:ByteArray, byteArrayOffset:uint, miplevel:uint = 0):void Загружает текстуру из объекта ByteArray.	Texture
		uploadFromByteArrayAsync(data:ByteArray, byteArrayOffset:uint, miplevel:uint = 0):void Асинхронного загружает mip-уровень 0 для текстуры из объекта ByteArray.	Texture
		valueOf():Object Возвращает элементарное значение заданного объекта.	Object
		willTrigger(type:String):Boolean Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.	EventDispatcher

События

Дополнительные сведения о событиях

Скрыть унаследованные события

Показать унаследованные события

	Событие		Сводка	Определено
		activate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.	EventDispatcher
		deactivate	[многоадресное событие] Отправляется, когда проигрыватель 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) из объекта 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

flash.events.Event.TEXTURE_READY

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

flash.events.Event.TEXTURE_READY

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

flash.events.Event.TEXTURE_READY

Юридическая информация | Политика конфиденциальности онлайн

Texture - AS3

Классы x

uploadCompressedTextureFromByteArray

uploadFromBitmapData

uploadFromBitmapDataAsync

uploadFromByteArray

uploadFromByteArrayAsync