Paket | flash.display3D.textures |
Klasse | public final class CubeTexture |
Vererbung | CubeTexture TextureBase EventDispatcher Object |
Definiert eine Cubemap-Textur für die Verwendung während der Darstellung. Cubemapping wird für zahlreiche Rendertechniken verwendet, zum Beispiel Environment Maps, Skyboxen und Skylight Illumination.
Sie können ein CubeTexture-Objekt nicht direkt erstellen; verwenden Sie stattdessen Context3D createCubeTexture()
.
Weitere Informationen
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 Würfeltextur im Adobe Texture Format (ATF) aus einem Bytearray hoch. | CubeTexture | ||
Lädt eine Komponente einer Cubemaptextur aus einem BitmapData-Objekt hoch. | CubeTexture | ||
Lädt eine Komponente einer Cubemaptextur aus einem ByteArray-Objekt hoch. | CubeTexture | ||
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 Würfeltextur im Adobe Texture Format (ATF) aus einem Bytearray hoch.
Das Bytearray muss alle Flächen und Mipmaps für die Textur enthalten.
Parameter
data:ByteArray — ein Bytearray, das eine komprimierte Würfeltextur einschließlich Mipmaps enthält. Das ByteArray-Objekt muss das Little-Endian-Format verwenden.
| |
byteArrayOffset:uint — ein optionales Offset, ab dem 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 Texture -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 kann.
| |
ArgumentError — Textur muss quadratisch sein: wenn Breite und Höhe bei der dekomprimierten Textur nicht gleich sind.
| |
ArgumentError — Texturgrößen stimmen nicht überein: wenn die Breite und Höhe der dekomprimierten Textur nicht der Länge der Texturkante entsprechen.
| |
ArgumentError — Mip-Level zu groß: wenn das Mip-Level der dekomprimierten Textur größer als das von der Länge der Texturkante implizierte ist.
| |
ArgumentError — Texturformate stimmen nicht überein: wenn die dekodierten ATF-Bytes keine Textur enthalten, die mit dem Format dieser Textur kompatibel oder eine Würfeltextur ist.
| |
Error — 3768: Das Stage3D -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, side:uint, miplevel:uint = 0):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 11, AIR 3 |
Lädt eine Komponente einer Cubemaptextur aus einem BitmapData-Objekt hoch.
Diese Funktion lädt ein Mip-Level einer Seite der Cubemap hoch. Rufen Sie uploadFromBitmapData()
entsprechend oft auf, um jedes Mip-Level und jede Seite der Cubemap hochzuladen.
Parameter
source:BitmapData — eine Bitmap.
| |
side:uint — Code, der angibt, welche Seite des Würfels hochgeladen werden soll:
| |
miplevel:uint (default = 0 ) — das zu ladende Mip-Level, wobei Level null das Bild mit voller Auflösung auf oberster Ebene ist. Der Standardwert ist 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 den Texturabmessungen implizierte ist.
| |
ArgumentError — Ungültige Würfelseite: wenn side größer als 5 ist.
| |
ArgumentError — Ungültiger BitmapData-Fehler: source wenn das BitmapData-Objekt keine gültige Würfeltexturfläche enthält. Das Bild muss quadratisch sein, wobei die Seiten einer Zweierpotenz entsprechen müssen, 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.
|
uploadFromByteArray | () | Methode |
public function uploadFromByteArray(data:ByteArray, byteArrayOffset:uint, side:uint, miplevel:uint = 0):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 11, AIR 3 |
Lädt eine Komponente einer Cubemaptextur aus einem ByteArray-Objekt hoch.
Diese Funktion lädt ein Mip-Level einer Seite der Cubemap hoch. Rufen Sie uploadFromByteArray()
entsprechend oft auf, um jedes Mip-Level und jede Seite der Cubemap hochzuladen.
Parameter
data:ByteArray — Ein Bytearray, das das Bild in dem Format enthält, dass beim Erstellen dieses CubeTexture-Objekts festgelegt wurde. Das ByteArray-Objekt muss das Little-Endian-Format verwenden.
| |
byteArrayOffset:uint — das Lesen des Bytearrays beginnt hier.
| |
side:uint — Code, der angibt, welche Seite des Würfels hochgeladen werden soll:
| |
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 den 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.
|
Tue Jun 12 2018, 10:04 AM Z