| Pacchetto | flash.display3D.textures |
| Classe | public final class CubeTexture |
| Ereditarietà | CubeTexture  TextureBase EventDispatcher Object |
Definisce una map texture cubica da utilizzare durante il rendering. La mappatura cubica viene utilizzata per molte tecniche di rendering, ad esempio le mappe d'ambiente, gli skybox e l'illuminazione del cielo.
Non è possibile creare un oggetto CubeTexture direttamente; utilizzate invece il metodo createCubeTexture() di Context3D.
Altre informazioni
Elementi API correlati
Proprietà pubbliche
Nascondi proprietà pubbliche ereditate
Mostra proprietà pubbliche ereditateMetodi pubblici
| Metodo | Definito da | ||
|---|---|---|---|
 | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un oggetto listener di eventi con un oggetto EventDispatcher, in modo che il listener riceva la notifica di un evento. | EventDispatcher | |
|
Invia un evento nel flusso di eventi. | EventDispatcher | |
|
Libera tutte le risorse GPU associate a questa texture. | TextureBase | |
|
Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento. | EventDispatcher | |
|
Indica se per un oggetto è definita una proprietà specifica. | Object | |
|
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | |
|
Indica se la proprietà specificata esiste ed è enumerabile. | Object | |
|
Rimuove un listener dall'oggetto EventDispatcher. | EventDispatcher | |
|
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | |
|
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | |
|
Restituisce la rappresentazione in formato stringa dell'oggetto specificato. | Object | |
uploadCompressedTextureFromByteArray(data:ByteArray, byteArrayOffset:uint, async:Boolean = false):void
Carica una texture cubica nel formato ATF (Adobe Texture Format) da un array di byte. | CubeTexture | ||
Carica un componente di una texture map cubica da un oggetto BitmapData. | CubeTexture | ||
Carica un componente di una texture map cubica da un oggetto ByteArray. | CubeTexture | ||
|
Restituisce il valore di base dell'oggetto specificato. | Object | |
|
Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato. | EventDispatcher | |
Eventi
Descrizione dei metodi
uploadCompressedTextureFromByteArray | () | metodo |
public function uploadCompressedTextureFromByteArray(data:ByteArray, byteArrayOffset:uint, async:Boolean = false):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 11, AIR 3 |
Carica una texture cubica nel formato ATF (Adobe Texture Format) da un array di byte.
L'array di byte deve contenere tutte le facce e le mipmap della texture.
Parametri
data:ByteArray — Un array di byte che contengono una texture cubica compressa contenente delle mipmap. L'oggetto ByteArray deve utilizzare il formato little endian.
| |
byteArrayOffset:uint — Offset opzionale in corrispondenza del quale iniziare a leggere i dati della texture.
| |
async:Boolean (default = false)Texture invia Event.TEXTURE_READY. Valore predefinito: false.
|
Genera
TypeError — Puntatore nullo: quando matrix è null.
| |
ArgumentError — Decodifica texture non riuscita: quando il formato di compressione di questo oggetto non può essere derivato dal formato dei dati compressi presenti in data.
| |
ArgumentError — La texture deve essere quadrata: quando la texture decompressa non ha larghezza e altezza equivalenti.
| |
ArgumentError — Dimensione texture non corrispondente: quando la larghezza e l'altezza della texture decompressa non equivale alla lunghezza del bordo della texture.
| |
ArgumentError — Miplevel troppo grande: se il livello mip della decompressa è maggiore di quello determinato dalla lunghezza del bordo della texture.
| |
ArgumentError — Formato texture non corrispondente: se i byte decodificati di ATF non contiene texture compatibile con il formato di questo framework o non è una struttura del cubo.
| |
Error — 3768: L’API Stage3D non può essere utilizzata durante l’esecuzione in background.
| |
RangeError — Dimensione di input errata: in caso di overflow del numero intero byteArrayOffset o se byteArrayOffset + 6 è maggiore della lunghezza dei dati o se il numero di byte disponibili da byteArrayOffset alla fine dell’array di byte data è inferiore alla quantità di dati necessaria per una texture ATF.
|
Elementi API correlati
uploadFromBitmapData | () | metodo |
public function uploadFromBitmapData(source:BitmapData, side:uint, miplevel:uint = 0):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 11, AIR 3 |
Carica un componente di una texture map cubica da un oggetto BitmapData.
Questa funzione carica un solo livello mip su un unico lato della mappa cubica. Chiamate uploadFromBitmapData() quando occorre per caricare ogni livello mip e ogni faccia della mappa cubica.
Parametri
source:BitmapData — Una bitmap.
| |
side:uint — Un codice che indica quale lato del cubo deve essere caricato:
| |
miplevel:uint (default = 0) |
Genera
TypeError — Puntatore nullo: se source è null.
| |
ArgumentError — Miplevel troppo grande: se il livello mip specificato è maggiore di quello determinato dalle dimensioni della texture.
| |
ArgumentError — Lato cubo non valido: se side è maggiore di 5.
| |
ArgumentError — BitmapData non valido: se l'origine se l'oggetto BitmapData non contiene una faccia di texture cubica. L'immagine deve essere quadrata, con i lati corrispondenti a una potenza di due e la dimensione corretta del livello mip specificato.
| |
ArgumentError — Formato texture non corrispondente: se il formato della texture è Context3DTextureFormat.COMPRESSED o Context3DTextureFormat.COMPRESSED_ALPHA e il codice in esecuzione su una piattaforma mobile in cui la compressione di fotogramma runtime non è supportata.
| |
Error — 3768: L’API Stage3D non può essere utilizzato durante l’esecuzione in background.
|
uploadFromByteArray | () | metodo |
public function uploadFromByteArray(data:ByteArray, byteArrayOffset:uint, side:uint, miplevel:uint = 0):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 11, AIR 3 |
Carica un componente di una texture map cubica da un oggetto ByteArray.
Questa funzione carica un solo livello mip su un unico lato della mappa cubica. Chiamate uploadFromByteArray() quando occorre per caricare ogni livello mip e ogni faccia della mappa cubica.
Parametri
data:ByteArray — Un array di byte contenente l'immagine nel formato specificato quando è stato creato questo oggetto CubeTexture. L'oggetto ByteArray deve utilizzare il formato little endian.
| |
byteArrayOffset:uint — La lettura dell'array di byte inizia da qui.
| |
side:uint — Un codice che indica quale lato del cubo deve essere caricato:
| |
miplevel:uint (default = 0) |
Genera
TypeError — Puntatore nullo: quando matrix è null.
| |
ArgumentError — Miplevel troppo grande: se il livello mip specificato è maggiore di quello determinato dalle dimensioni della texture.
| |
RangeError — Dimensione di input errata: se il numero di byte disponibili da byteArrayOffset alla fine dell’array di byte data è inferiore alla quantità di dati necessaria per una texture di questo livello mip o se byteArrayOffset è maggiore o uguale alla lunghezza di data.
| |
ArgumentError — Formato texture non corrispondente: se il formato della texture è Context3DTextureFormat.COMPRESSED o Context3DTextureFormat.COMPRESSED_ALPHA e il codice in esecuzione su una piattaforma mobile in cui la compressione di fotogramma runtime non è supportata.
| |
Error — 3768: L’API Stage3D non può essere utilizzato durante l’esecuzione in background.
|
Tue Jun 12 2018, 02:44 PM Z