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

ShaderInput  - AS3

Пакетflash.display
Классpublic final dynamic class ShaderInput
НаследованиеShaderInput Inheritance Object

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10, AIR 1.5

Экземпляр ShaderInput представляет единственное изображение ввода для ядра затенения. При выполнении ядра можно заставить его работать с нулем, одним или несколькими исходными изображениями, используемыми при выполнении ядра. В экземпляре ShaderInput заложен механизм, позволяющий указывать изображение ввода для использования при выполнении операции затенения. Чтобы задать значение ввода, создайте экземпляр BitmapData, ByteArray или Vector.<Number>, содержащий данные изображения, и назначьте его свойству input.

Доступ к экземпляру ShaderInput, представляющему изображение ввода экземпляра Shader, осуществляется в качестве свойства data экземпляра Shader. В коде затенения имя свойства ShaderInput совпадает с именем ввода. Например, если затенение задает ввод с именем src, то экземпляр ShaderInput, представляющий ввод src, будет доступен в качестве свойства src. Пример:

myShader.data.src.input = new BitmapData(50, 50, true, 0xFF990000);

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

  • Заливка затенением
  • ShaderFilter используется только для вторых или дополнительных вводов, при условии что затенение настроено на использование нескольких вводов. (Объект, к которому применяется фильтр, автоматически используется в качестве первичного ввода.)
  • Режим наложения затенения используется только для третьих или дополнительных вводов, при условии что затенение настроено на использование более двух вводов. (Накладываемые объекты автоматически используются в качестве первого и второго ввода.)
  • Выполнение ShaderJob в фоне

Если операция затенения запускается с использованием экземпляра ShaderJob для обработки массива ByteArray, данные в котором расположены линейно, настройте параметры экземпляра ShaderInput следующим образом: установите для height значение 1, для width — значение числа 32-разрядных значений с плавающей запятой в массиве ByteArray. В этом случае значение ввода затенения должно принадлежать типу данных image1.

Обычно, в коде разработчика создание экземпляра ShaderInput не заложено. При создании экземпляра Shader экземпляр ShaderInput создается автоматически для каждого ввода затенения.

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



Общедоступные свойства
 СвойствоОпределено
  channels : int
[только для чтения] Число каналов во вводе затенения.
ShaderInput
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
  height : int
Высота ввода затенения.
ShaderInput
  index : int
[только для чтения] Отсчитываемое от нуля значение индекса для ввода затенения отражает порядок определений вводов в затенении.
ShaderInput
  input : Object
Данные ввода, используемые при выполнении операции затенения.
ShaderInput
  width : int
Ширина ввода затенения.
ShaderInput
Общедоступные методы
 МетодОпределено
  
Создает экземпляр ShaderInput.
ShaderInput
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Возвращает элементарное значение заданного объекта.
Object
Сведения о свойстве

channels

свойство
channels:int  [только для чтения]

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10, AIR 1.5

Число каналов во вводе затенения. Данное свойство принимается во внимание только если данными ввода являются экземпляр ByteArray или Vector.<Number>.



Реализация
    public function get channels():int

height

свойство 
height:int

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10, AIR 1.5

Высота ввода затенения. Данное свойство используется только если данными ввода является экземпляр ByteArray или Vector.<Number>. Если вводом является экземпляр BitmapData, высота определяется автоматически.



Реализация
    public function get height():int
    public function set height(value:int):void

index

свойство 
index:int  [только для чтения]

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10, AIR 1.5

Отсчитываемое от нуля значение индекса для ввода затенения отражает порядок определений вводов в затенении.



Реализация
    public function get index():int

input

свойство 
input:Object

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10, AIR 1.5

Данные ввода, используемые при выполнении операции затенения. Это свойство может быть экземпляром BitmapData, ByteArray или Vector.<Number>.

При присвоении значения ByteArray свойству input необходимо выполнить следующие условия:

  • Необходимо настроить свойства height и width.
  • Массив байтов должен состоять только из 32-разрядных значений с плавающей запятой. Эти значения должны быть записаны с помощью метода ByteArray.writeFloat().
  • Общая длина ByteArray в байтах должна равняться произведению width х height х channels х 4.
  • Свойство endian байтов массива должно быть Endian.LITTLE_ENDIAN.

Если экземпляр Vector.<Number> присваивается свойству input, длина Vector должна равняться произведению width х height х channels.



Реализация
    public function get input():Object
    public function set input(value:Object):void

width

свойство 
width:int

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10, AIR 1.5

Ширина ввода затенения. Данное свойство используется только если данными ввода является экземпляр ByteArray или Vector.<Number>. Если вводом является экземпляр BitmapData, ширина определяется автоматически.



Реализация
    public function get width():int
    public function set width(value:int):void
Сведения о конструкторе

ShaderInput

()Конструктор
public function ShaderInput()

Язык версии: ActionScript 3.0
Версии среды выполнения: Flash Player 10, AIR 1.5

Создает экземпляр ShaderInput. Обычно, в коде разработчика прямой вызов конструктора ShaderInput не производится. При создании экземпляра Shader экземпляр ShaderInput создается автоматически для каждого ввода затенения.





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

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