| 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 diesesTexture-ObjektEvent.TEXTURE_READYab. Standardwert: false. | 
Auslöser
| TypeError — Nullzeigerfehler: wenndataden Wert null hat. | |
| ArgumentError — Textur konnte nicht dekodiert werden: wenn das Komprimierungsformat dieses Objekts nicht aus dem Format der komprimierten Daten indataabgeleitet 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: DasStage3D-API darf nicht bei der Ausführung im Hintergrund verwendet werden. | |
| RangeError — Fehlerhafte Eingabegröße: Wenn es Ganzzahlüberlauf vonbyteArrayOffsetgibt oder wennbyteArrayOffset+ 6 größer als die Länge vondataist oder wenn die Anzahl der Bytes, die vombyteArrayOffsetbis zum Ende desdata-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: wennsourceden Wertnullhat. | |
| ArgumentError — Mip-Level zu groß: wenn das angegebene Mip-Level größer als das von den Texturabmessungen implizierte ist. | |
| ArgumentError — Ungültige Würfelseite: wennsidegrößer als 5 ist. | |
| ArgumentError — Ungültiger BitmapData-Fehler:sourcewenn 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: DasStage3D-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: wenndataden 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 vombyteArrayOffsetbis zum Ende desdata-Byte-Arrays verfügbar sind, kleiner als die für eine Textur erforderliche Datenmenge dieses Mip-Level ist, oder wennbyteArrayOffsetgrößer als die Länge vondataist. | |
| 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
 Vererbte öffentliche Eigenschaften ausblenden
 Vererbte öffentliche Eigenschaften ausblenden Vererbte öffentliche Eigenschaften anzeigen
 Vererbte öffentliche Eigenschaften anzeigen