ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
flash.display 

ShaderInput  - AS3

Paketflash.display
Klassepublic final dynamic class ShaderInput
VererbungShaderInput Inheritance Object

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Eine ShaderInput-Instanz stellt ein einzelnes Eingabebild für ein Shaderkernel dar. Ein Kernel kann so definiert sein, dass es null, ein oder mehrere Quellbilder akzeptiert, die bei der Kernelausführung verwendet werden. Eine ShaderInput-Instanz stellt einen Mechanismus für das Festlegen des Eingabebilds, das bei der Shaderausführung verwendet wird, bereit. Zum Festlegen eines Eingabewerts erstellen Sie eine BitmapData-, ByteArray- oder Vector.<Number>-Instanz, die die Bilddaten enthält, und weisen sie der input-Eigenschaft zu.

Auf eine ShaderInput-Instanz, die ein Eingabebild für eine Shader-Instanz darstellt, wird als Eigenschaft der data-Eigenschaft der Shader-Instanz zugegriffen. Die ShaderInput-Eigenschaft hat denselben Namen wie die Eingabe im Shadercode. Wenn ein Shader z. B. eine Eingabe namens src festlegt, ist die ShaderInput-Instanz, die die src-Eingabe darstellt, als src-Eigenschaft verfügbar, wie im Beispiel zu sehen ist:

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

Bei manchen Verwendungen einer Shader-Instanz müssen Sie kein Eingabebild festlegen, weil es durch den Vorgang automatisch festgelegt wird. Sie müssen nur dann eine Eingabe festlegen, wenn der Shader wie folgt wird:

  • Shaderfüllung
  • ShaderFilter, nur für die zweite oder weitere Eingaben, wenn festgelegt ist, dass der Shader mehr als eine Eingabe verwendet. (Das Objekt, auf das der Filter angewendet wird, wird automatisch als erste Eingabe verwendet.)
  • Shadermischmodus, nur für die dritte oder weitere Eingaben, wenn festgelegt ist, dass der Shader mehr als zwei Eingaben verwendet. (Die Objekte, die gemischt werden, werden automatisch als erste und zweite Eingabe verwendet.)
  • Ausführung eines ShaderJobs im Hintergrund

Wenn der Shader bei der Ausführung eine ShaderJob-Instanz zur Verarbeitung eines ByteArrays verwendet, das eine lineare Anordnung von Daten enthält, setzen Sie height der ShaderInput-Instanz auf 1 und width auf die Anzahl der 32-Bit-Gleitkommawerte im ByteArray. In diesem Fall muss die Shadereingabe mithilfe des image1-Datentyps definiert werden.

Im Allgemeinen wird eine ShaderInput-Instanz nicht direkt durch Entwicklercode erstellt. Bei der Erstellung der Shader-Instanz wird für jede Shadereingabe eine ShaderInput-Instanz erstellt.

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
  channels : int
[schreibgeschützt] Die Anzahl der Kanäle, die eine Shadereingabe erwartet.
ShaderInput
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  height : int
Die Höhe der Shadereingabe.
ShaderInput
  index : int
[schreibgeschützt] Die auf null basierende Indexposition der Eingabe im Shader, die die Reihenfolge der Eingabedefinitionen im Shader angibt.
ShaderInput
  input : Object
Die Eingabedaten, die bei der Ausführung des Shaders verwendet werden.
ShaderInput
  width : int
Die Breite der Shadereingabe.
ShaderInput
Öffentliche Methoden
 MethodeDefiniert von
  
Erstellt eine ShaderInput-Instanz.
ShaderInput
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Eigenschaftendetails

channels

Eigenschaft
channels:int  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Die Anzahl der Kanäle, die eine Shadereingabe erwartet. Diese Eigenschaft muss berücksichtigt werden, wenn es sich bei den Eingabedaten um eine ByteArray- oder Vector.<Number>-Instanz handelt.



Implementierung
    public function get channels():int

height

Eigenschaft 
height:int

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Die Höhe der Shadereingabe. Diese Eigenschaft wird nur verwendet, wenn es sich bei den Eingabedaten eine ByteArray- oder Vector.<Number>-Instanz handelt. Wenn es sich bei der Eingabe um eine BitmapData-Instanz handelt, wird die Höhe automatisch festgelegt.



Implementierung
    public function get height():int
    public function set height(value:int):void

index

Eigenschaft 
index:int  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Die auf null basierende Indexposition der Eingabe im Shader, die die Reihenfolge der Eingabedefinitionen im Shader angibt.



Implementierung
    public function get index():int

input

Eigenschaft 
input:Object

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Die Eingabedaten, die bei der Ausführung des Shaders verwendet werden. Diese Eigenschaft kann eine BitmapData-Instanz, eine ByteArray-Instanz oder eine Vector.<Number>-Instanz sein.

Wenn der input-Eigenschaft ein ByteArray-Wert zugewiesen wird, müssen die folgenden Bedingungen erfüllt sein:

  • Die height- und width-Eigenschaft muss gesetzt sein.
  • Der Inhalt des Bytearrays darf nur aus 32-Bit-Gleitkommawerten bestehen. Diese Werte können mit der ByteArray.writeFloat()-Methode geschrieben werden.
  • Die Gesamtlänge des ByteArrays in Byte muss genau width x height x channels x 4 sein.
  • Die endian-Eigenschaft des Bytearrays muss Endian.LITTLE_ENDIAN sein.

Wenn der input-Eigenschaft eine Vector.<Number>-Instanz zugewiesen wird, muss die Länge des Vektors gleich width x height x channels sein.



Implementierung
    public function get input():Object
    public function set input(value:Object):void

width

Eigenschaft 
width:int

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Die Breite der Shadereingabe. Diese Eigenschaft wird nur verwendet, wenn es sich bei den Eingabedaten eine ByteArray- oder Vector.<Number>-Instanz handelt. Wenn es sich bei der Eingabe um eine BitmapData-Instanz handelt, wird die Breite automatisch festgelegt.



Implementierung
    public function get width():int
    public function set width(value:int):void
Konstruktordetails

ShaderInput

()Konstruktor
public function ShaderInput()

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 10, AIR 1.5

Erstellt eine ShaderInput-Instanz. Der ShaderInput-Konstruktor wird nicht direkt durch den Entwicklercode aufgerufen. Bei der Erstellung der Shader-Instanz wird für jede Shadereingabe eine ShaderInput-Instanz erstellt.





[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.