CubeTexture - Adobe ActionScript® 3 (AS3 ) API-Referenz

Paket	flash.display3D.textures
Klasse	public final class CubeTexture
Vererbung	CubeTexture TextureBase EventDispatcher Object

Die CubeTexture-Klasse stellt eine Würfeltextur dar, die in einen Renderkontext hochgeladen wurde.

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

http://en.wikipedia.org/wiki/Cube_mapping

Verwandte API-Elemente

flash.display3D.Context3D.createCubeTexture()
flash.display3D.Context3D.setTextureAt()

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	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
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	EventDispatcher
		dispose():void Gibt alle GPU-Ressourcen frei, die dieser Textur zugeordnet sind.	TextureBase
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	EventDispatcher
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String 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
		uploadFromBitmapData(source:BitmapData, side:uint, miplevel:uint = 0):void Lädt eine Komponente einer Cubemaptextur aus einem BitmapData-Objekt hoch.	CubeTexture
		uploadFromByteArray(data:ByteArray, byteArrayOffset:uint, side:uint, miplevel:uint = 0):void Lädt eine Komponente einer Cubemaptextur aus einem ByteArray-Objekt hoch.	CubeTexture
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object
		willTrigger(type:String):Boolean Ü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

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

Vererbte Ereignisse ausblenden

Vererbte Ereignisse anzeigen

	Ereignis		Übersicht	Definiert von
		activate	[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.	EventDispatcher
		deactivate	[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.	EventDispatcher

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

flash.events.Event.TEXTURE_READY

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: positiv X : 0 negativ X : 1 positiv Y : 2 negativ Y : 3 positiv Z : 4 negativ Z : 5

	`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: positiv X : 0 negativ X : 1 positiv Y : 2 negativ Y : 3 positiv Z : 4 negativ Z : 5

	`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: Das`Stage3D` -API darf nicht bei der Ausführung im Hintergrund verwendet werden.

Rechtliche Hinweise | Onlinedatenschutzerklärung

CubeTexture - AS3

Klassen x

uploadCompressedTextureFromByteArray

uploadFromBitmapData

uploadFromByteArray