Packageflash.display
Classpublic final dynamic class ShaderInput
InheritanceShaderInput Inheritance Object

Language version: ActionScript 3.0
Runtime version: AIR 1.5

A ShaderInput instance represents a single input image for a shader kernel. A kernel can be defined to accept zero, one, or more source images that are used in the kernel execution. A ShaderInput instance provides a mechanism for specifying the input image that is used when the shader executes. To specify a value for the input, create a BitmapData, ByteArray, or Vector.<Number> instance containing the image data and assign it to the input property.

The ShaderInput instance representing a Shader instance's input image is accessed as a property of the Shader instance's data property. The ShaderInput property has the same name as the input's name in the shader code. For example, if a shader defines an input named src, the ShaderInput instance representing the src input is available as the src property, as this example shows:

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

For some uses of a Shader instance, you do not need to specify an input image, because it is automatically specified by the operation. You only need to specify an input when a Shader is used for the following:

If the shader is being executed using a ShaderJob instance to process a ByteArray containing a linear array of data, set the ShaderInput instance's height to 1 and width to the number of 32-bit floating point values in the ByteArray. In that case, the input in the shader must be defined with the image1 data type.

Generally, developer code does not create a ShaderInput instance directly. A ShaderInput instance is created for each of a shader's inputs when the Shader instance is created.

See also

flash.display.ShaderData
flash.display.Shader.data
flash.display.ShaderJob


Public Properties
 PropertyDefined by
  channels : int
[read-only] The number of channels that a shader input expects.
ShaderInput
 Inheritedconstructor : Object
A reference to the class object or constructor function for a given object instance.
Object
  height : int
The height of the shader input.
ShaderInput
  index : int
[read-only] The zero-based index of the input in the shader, indicating the order of the input definitions in the shader.
ShaderInput
  input : Object
The input data that is used when the shader executes.
ShaderInput
 Inheritedprototype : Object
[static] A reference to the prototype object of a class or function object.
Object
  width : int
The width of the shader input.
ShaderInput
Public Methods
 MethodDefined by
  
Creates a ShaderInput instance.
ShaderInput
 Inherited
Indicates whether an object has a specified property defined.
Object
 Inherited
Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.
Object
 Inherited
Indicates whether the specified property exists and is enumerable.
Object
 Inherited
Sets the availability of a dynamic property for loop operations.
Object
 Inherited
Returns the string representation of this object, formatted according to locale-specific conventions.
Object
 Inherited
Returns the string representation of the specified object.
Object
 Inherited
Returns the primitive value of the specified object.
Object
Property detail
channelsproperty
channels:int  [read-only]

Language version: ActionScript 3.0
Runtime version: AIR 1.5

The number of channels that a shader input expects. This property must be accounted for when the input data is a ByteArray or Vector.<Number> instance.

Implementation
    public function get channels():int
heightproperty 
height:int  [read-write]

Language version: ActionScript 3.0
Runtime version: AIR 1.5

The height of the shader input. This property is only used when the input data is a ByteArray or Vector.<Number> instance. When the input is a BitmapData instance the height is automatically determined.

Implementation
    public function get height():int
    public function set height(value:int):void
indexproperty 
index:int  [read-only]

Language version: ActionScript 3.0
Runtime version: AIR 1.5

The zero-based index of the input in the shader, indicating the order of the input definitions in the shader.

Implementation
    public function get index():int
inputproperty 
input:Object  [read-write]

Language version: ActionScript 3.0
Runtime version: AIR 1.5

The input data that is used when the shader executes. This property can be a BitmapData instance, a ByteArray instance, or a Vector.<Number> instance.

If a ByteArray value is assigned to the input property, the following conditions must be met:

If a Vector.<Number> instance is assigned to the input property, the length of the Vector must be equal to width times height times channels.

Implementation
    public function get input():Object
    public function set input(value:Object):void
widthproperty 
width:int  [read-write]

Language version: ActionScript 3.0
Runtime version: AIR 1.5

The width of the shader input. This property is only used when the input data is a ByteArray or Vector.<Number> instance. When the input is a BitmapData instance the width is automatically determined.

Implementation
    public function get width():int
    public function set width(value:int):void
Constructor detail
ShaderInput()constructor
public function ShaderInput()

Language version: ActionScript 3.0
Runtime version: AIR 1.5

Creates a ShaderInput instance. Developer code does not call the ShaderInput constructor directly. A ShaderInput instance is created for each of a shader's inputs when the Shader instance is created.