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.display3D.textures 

RectangleTexture  - AS3

Paketflash.display3D.textures
Klassepublic final class RectangleTexture
VererbungRectangleTexture Inheritance TextureBase Inheritance EventDispatcher Inheritance Object

Die RectangleTexture-Klasse stellt eine zweidimensionale Textur dar, die in einen Renderkontext hochgeladen wurde.

Definiert eine 2D-Textur zur Verwendung während der Darstellung.

Texture kann nicht direkt instanziiert werden. Erstellen Sie Instanzen mithilfe der Context3D-Methode createRectangleTexture().

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
Öffentliche Methoden
 MethodeDefiniert von
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.
EventDispatcher
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
 Inherited
Gibt alle GPU-Ressourcen frei, die dieser Textur zugeordnet sind.
TextureBase
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 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
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
EventDispatcher
 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
  
Lädt eine Textur aus einem BitmapData-Objekt hoch.
RectangleTexture
  
Lädt eine Textur aus einem BitmapData-Objekt hoch.
RectangleTexture
  
uploadFromByteArray(data:ByteArray, byteArrayOffset:uint):void
Lädt eine Textur aus einem ByteArray hoch.
RectangleTexture
  
    uploadFromByteArrayAsync(data:ByteArray, byteArrayOffset:uint):void
Lädt eine Textur aus einem ByteArray hoch.
RectangleTexture
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.
EventDispatcher
Ereignisse
 Ereignis Übersicht Definiert von
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.EventDispatcher
Methodendetails

uploadFromBitmapData

()Methode
public function uploadFromBitmapData(source:BitmapData):void

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 11.8, AIR 3.8

Lädt eine Textur aus einem BitmapData-Objekt hoch.

Parameter

source:BitmapData — eine Bitmap.


Auslöser
TypeError — Nullzeigerfehler: wenn source den Wert null hat.
 
ArgumentError — Ungültiger BitmapData-Fehler: wenn source keine gültige Textur enthält. Die maximal zulässige Größe in einer Abmessung ist 4096 oder die Größe des Backbuffer, je nachdem, was größer ist.
 
Error — 3768: DasStage3D -API darf nicht bei der Ausführung im Hintergrund verwendet werden.

    uploadFromBitmapDataAsync

()Methode 
public function uploadFromBitmapDataAsync(source:BitmapData):void

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 24

Lädt eine Textur aus einem BitmapData-Objekt hoch.

Parameter

source:BitmapData — eine Bitmap. Diese Funktion lädt Texturdaten asynchron hoch. Jede draw-Methode, die versucht, die Textur zu verwenden, schlägt fehl, bis der Upload erfolgreich abgeschlossen wurde. Nach dem erfolgreichen Upload setzt dieses Textur-Objekt Event.TEXTURE_UPLOADED ab. Event.TEXTURE_READY ist ein Rückruf zur Angabe, dass der für das Textur-Objekt eingegangene asynchrone Aufruf erfolgreich ausgeführt wurde. Nach jedem Fehler beim Hintergrund-Upload löst dieses Textur-Objekt Event.ERROREVENT aus.


Auslöser
TypeError — Nullzeigerfehler: wenn source den Wert null hat.
 
ArgumentError — Ungültiger BitmapData-Fehler: wenn source keine gültige Textur enthält. Die maximal zulässige Größe in einer Abmessung ist 4096 oder die Größe des Backbuffer, je nachdem, was größer ist.
 
Error — 3768: DasStage3D -API darf nicht bei der Ausführung im Hintergrund verwendet werden.

Verwandte API-Elemente

uploadFromByteArray

()Methode 
public function uploadFromByteArray(data:ByteArray, byteArrayOffset:uint):void

Sprachversion: ActionScript 3.0
Laufzeitversionen: Flash Player 11.8, AIR 3.8

Lädt eine Textur aus einem ByteArray hoch.

Parameter

data:ByteArray — ein Bytearray, das genügend Bytes im internen Format der Textur enthält, um die Textur zu füllen. rgba-Texturen werden als Bytes pro Texel-Komponente gelesen (1 oder 4). Float-Texturen werden als Floats pro Texel-Komponente gelesen (1 oder 4). Das ByteArray-Objekt muss das Little-Endian-Format verwenden.
 
byteArrayOffset:uint — die Position im Bytearrayobjekt, ab der die Texturdaten gelesen werden.


Auslöser
TypeError — Nullzeigerfehler: wenn data den Wert null hat.
 
RangeError — Fehlerhafte Eingabegröße: Wenn die Anzahl der Bytes, die vom byteArrayOffset bis zum Ende des data-Byte-Arrays verfügbar sind, kleiner als die für eine Textur erforderliche Datenmenge ist, oder wenn byteArrayOffset größer als die Länge von data ist.
 
Error — 3768: DasStage3D -API darf nicht bei der Ausführung im Hintergrund verwendet werden.

    uploadFromByteArrayAsync

()Methode 
public function uploadFromByteArrayAsync(data:ByteArray, byteArrayOffset:uint):void

Sprachversion: ActionScript 3.0
Laufzeitversionen: AIR 24

Lädt eine Textur aus einem ByteArray hoch.

Parameter

data:ByteArray — ein Bytearray, das genügend Bytes im internen Format der Textur enthält, um die Textur zu füllen. rgba-Texturen werden als Bytes pro Texel-Komponente gelesen (1 oder 4). Float-Texturen werden als Floats pro Texel-Komponente gelesen (1 oder 4). Das ByteArray-Objekt muss das Little-Endian-Format verwenden.
 
byteArrayOffset:uint — die Position im Bytearrayobjekt, ab der die Texturdaten gelesen werden. Diese Funktion lädt Texturdaten asynchron hoch. Jede draw-Methode, die versucht, die Textur zu verwenden, schlägt fehl, bis der Upload erfolgreich abgeschlossen wurde. Nach dem erfolgreichen Upload setzt dieses Textur-Objekt Event.TEXTURE_UPLOADED ab. Event.TEXTURE_READY ist ein Rückruf zur Angabe, dass der für das Textur-Objekt eingegangene asynchrone Aufruf erfolgreich ausgeführt wurde. Nach jedem Fehler beim Hintergrund-Upload löst dieses Textur-Objekt Event.ERROREVENT aus.


Auslöser
TypeError — Nullzeigerfehler: wenn data den Wert null hat.
 
RangeError — Fehlerhafte Eingabegröße: Wenn die Anzahl der Bytes, die vom byteArrayOffset bis zum Ende des data-Byte-Arrays verfügbar sind, kleiner als die für eine Textur erforderliche Datenmenge ist, oder wenn byteArrayOffset größer als die Länge von data ist.
 
Error — 3768: DasStage3D -API darf nicht bei der Ausführung im Hintergrund verwendet werden.




[ 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.