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
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 |
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 ) — Bei der Einstellung „true“ gibt diese Funktion sofort einen Wert zurück. Jede draw-Methode, die versucht, die Textur zu verwenden, schlägt fehl, bis der Upload erfolgreich abgeschlossen wurde. Nach dem erfolgreichen Upload setzt dieses 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 ) — das zu ladende Mip-Level, wobei Level null das Bild mit voller Auflösung auf oberster Ebene ist.
|
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 ) — das zu ladende Mip-Level, wobei Level null das Bild mit voller Auflösung auf oberster Ebene ist.
|
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