| Paket | flash.display3D.textures |
| Klasse | public final class Texture |
| Vererbung | Texture  TextureBase EventDispatcher Object |
Definiert eine 2D-Textur zur Verwendung während der Darstellung.
Texture kann nicht direkt instanziiert werden. Erstellen Sie Instanzen mithilfe der Context3D-Methode createTexture.
Verwandte API-Elemente
Öffentliche Eigenschaften
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigenÖffentliche Methoden
| Methode | Definiert von | ||
|---|---|---|---|
 | 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 | |
|
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | |
|
Gibt alle GPU-Ressourcen frei, die dieser Textur zugeordnet sind. | TextureBase | |
|
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | |
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
|
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | |
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
|
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | |
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
|
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | |
|
Gibt das angegebene Objekt als String zurück. | Object | |
uploadCompressedTextureFromByteArray(data:ByteArray, byteArrayOffset:uint, async:Boolean = false):void
Lädt eine komprimierte Würfeltextur im Adobe Texture Format (ATF) aus einem ByteArray-Objekt hoch. | Texture | ||
Lädt eine Textur aus einem BitmapData-Objekt hoch. | Texture | ||
Lädt asynchron Mip-Level 0 für eine Textur aus einem BitmapData-Objekt hoch. | Texture | ||
Lädt eine Textur aus einem ByteArray hoch. | Texture | ||
Lädt asynchron Mip-Level 0 für eine Textur aus einem ByteArray-Objekt hoch. | Texture | ||
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
|
Ü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
Methodendetails
uploadCompressedTextureFromByteArray | () | Methode |
public function uploadCompressedTextureFromByteArray(data:ByteArray, byteArrayOffset:uint, async:Boolean = false):void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 11, AIR 3 |
Lädt eine komprimierte Würfeltextur im Adobe Texture Format (ATF) aus einem ByteArray-Objekt hoch. ATF-Dateiversion 2 erfordert SWF-Version 21 oder höher und ATF-Dateiversion 3 erfordert SWF-Version 29 oder höher. Für ATF-Dateien, die mit einem PNG-Bild ohne Alphawert erstellt wurden, muss die format-Zeichenfolge, die während Context3DObject::createTexture „COMPRESSED“ sein und für ATF-Dateien, die mit PNG-Bild mit Alphawert erstellt wurden, muss die format-Zeichenfolge, die während Context3DObject::createTexture eingegeben wurde, „COMPRESSED_ALPHA“ sein.
Parameter
data:ByteArray — ein Bytearray, das eine komprimierte Textur einschließlich Mipmaps enthält. Das ByteArray-Objekt muss das Little-Endian-Format verwenden.
| |
byteArrayOffset:uint — die Position im Bytearray, ab der die Texturdaten gelesen werden.
| |
async:Boolean (default = false)CubeTexture-Objekt Event.TEXTURE_READY ab. Standardwert: false.
|
Auslöser
TypeError — Nullzeigerfehler: wenn data den Wert null hat.
| |
ArgumentError — Textur konnte nicht dekodiert werden: Wenn das Komprimierungsformat dieses Objekts nicht aus dem Format der komprimierten Daten in data abgeleitet werden, oder wenn die SWF-Version mit der ATF-Dateiversion nicht kompatibel ist.
| |
ArgumentError — Texturgrößen stimmen nicht überein: wenn die Breite und Höhe der dekomprimierten Textur nicht den Abmessungen dieses Texture-Objekts entsprechen.
| |
ArgumentError — Mip-Level zu groß: wenn das Mip-Level der dekomprimierten Textur größer als das von der Größe der Textur implizierte ist.
| |
ArgumentError — Texturformate stimmen nicht überein: wenn die dekodierten ATF-Bytes keine Textur enthalten, die mit dem Format dieser Textur kompatibel.
| |
Error — 3768: DasStage3D -API darf nicht bei der Ausführung im Hintergrund verwendet werden.
| |
RangeError — Fehlerhafte Eingabegröße: Wenn es Ganzzahlüberlauf von byteArrayOffset gibt oder wenn byteArrayOffset + 6 größer als die Länge von data ist oder wenn die Anzahl der Bytes, die vom byteArrayOffset bis zum Ende des data-Byte-Arrays verfügbar sind, kleiner als die Datenmenge ist, die für ATF-Textur erforderlich ist.
|
Verwandte API-Elemente
uploadFromBitmapData | () | Methode |
public function uploadFromBitmapData(source:BitmapData, miplevel:uint = 0):void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 11, AIR 3 |
Lädt eine Textur aus einem BitmapData-Objekt hoch.
Parameter
source:BitmapData — eine Bitmap.
| |
miplevel:uint (default = 0) |
Auslöser
TypeError — Nullzeigerfehler: wenn source den Wert null hat.
| |
ArgumentError — Mip-Level zu groß: wenn das angegebene Mip-Level größer als das von der größeren der Texturabmessungen implizierte ist.
| |
ArgumentError — Ungültiger BitmapData-Fehler: source wenn das BitmapData-Objekt keine gültige Würfeltexturfläche enthält. Die Seiten des Bildes müssen einer Zweierpotenz entsprechen, und es muss die richtige Größe für das Mip-Level angegeben werden.
| |
ArgumentError — Texturformate stimmen nicht überein: wenn das Texturformat Context3DTextureFormat.COMPRESSED oder Context3DTextureFormat.COMPRESSED_ALPHA lautet und der Code auf einer mobilen Plattform ausgeführt wird, auf der Laufzeittexturkomprimierung nicht unterstützt wird.
| |
Error — 3768: Das Stage3D-API darf nicht bei der Ausführung im Hintergrund verwendet werden.
|
uploadFromBitmapDataAsync | () | Methode |
public function uploadFromBitmapDataAsync(source:BitmapData, miplevel:uint = 0):void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 24 |
Lädt asynchron Mip-Level 0 für eine Textur aus einem BitmapData-Objekt 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 Texturobjekt Event.TEXTURE_READY 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.
Parameter
source:BitmapData — eine Bitmap
| |
miplevel:uint (default = 0) |
Auslöser
TypeError — Nullzeigerfehler: wenn source den Wert null hat.
| |
ArgumentError — Ungültiger BitmapData-Fehler: source, wenn das BitmapData-Objekt keine gültige Textur enthält. Die Seiten des Bildes müssen einer Zweierpotenz entsprechen und die richtige Größe für das Mip-Level muss angegeben werden.
| |
ArgumentError — Texturformate stimmen nicht überein: wenn das Texturformat Context3DTextureFormat.COMPRESSED oder Context3DTextureFormat.COMPRESSED_ALPHA lautet und der Code auf einer mobilen Plattform ausgeführt wird, auf der Laufzeittexturkomprimierung nicht unterstützt wird.
| |
ArgumentError — Es wird nur der asynchrone Upload für Mip-Level 0 unterstützt.
| |
Error — 3768: Die Stage3D-API darf nicht bei der Ausführung im Hintergrund verwendet werden.
|
Verwandte API-Elemente
uploadFromByteArray | () | Methode |
public function uploadFromByteArray(data:ByteArray, byteArrayOffset:uint, miplevel:uint = 0):void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | Flash Player 11, AIR 3 |
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.
| |
miplevel:uint (default = 0) |
Auslöser
TypeError — Nullzeigerfehler: wenn data den Wert null hat.
| |
ArgumentError — Mip-Level zu groß: wenn das angegebene Mip-Level größer als das von der größeren der Texturabmessungen implizierte ist.
| |
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 dieses Mip-Level ist, oder wenn byteArrayOffset größer als die Länge von data ist.
| |
ArgumentError — Texturformate stimmen nicht überein: wenn das Texturformat Context3DTextureFormat.COMPRESSED oder Context3DTextureFormat.COMPRESSED_ALPHA lautet und der Code auf einer mobilen Plattform ausgeführt wird, auf der Laufzeittexturkomprimierung nicht unterstützt wird.
| |
Error — 3768: DasStage3D -API darf nicht bei der Ausführung im Hintergrund verwendet werden.
|
uploadFromByteArrayAsync | () | Methode |
public function uploadFromByteArrayAsync(data:ByteArray, byteArrayOffset:uint, miplevel:uint = 0):void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 24 |
Lädt asynchron Mip-Level 0 für eine Textur aus einem ByteArray-Objekt 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 Texturobjekt Event.TEXTURE_READY ab. Event.TEXTURE_READY ist ein Rückruf, der die asynchronen Aufrufe für das Textur-Objekt anzeigt, die erfolgreich ausgeführt wurden. Nach jedem Fehler beim Hintergrund-Upload löst dieses Textur-Objekt Event.ERROREVENT aus.
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.
| |
miplevel:uint (default = 0) |
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 für Mip-Level 0 erforderliche Datenmenge ist oder wenn byteArrayOffset größer als die Länge von data ist.
| |
ArgumentError — Texturformate stimmen nicht überein: wenn das Texturformat Context3DTextureFormat.COMPRESSED oder Context3DTextureFormat.COMPRESSED_ALPHA lautet und der Code auf einer mobilen Plattform ausgeführt wird, auf der Laufzeittexturkomprimierung nicht unterstützt wird.
| |
ArgumentError — Es wird nur der asynchrone Upload für Mip-Level 0 unterstützt.
| |
Error — 3768: Die Stage3D-API darf nicht bei der Ausführung im Hintergrund verwendet werden.
| |
Error — wenn ein asynchroner Upload für ein Textur-Objekt gestartet wurde und ein anderer asynchroner Upload-Aufruf für dasselbe Textur-Objekt vorliegt.
|
Verwandte API-Elemente
Tue Jun 12 2018, 10:04 AM Z