| Pacchetto | flash.display3D.textures |
| Classe | public final class Texture |
| Ereditarietà | Texture  TextureBase EventDispatcher Object |
Definisce una texture 2D da utilizzare durante il rendering.
Non è possibile creare direttamente un'istanza Texture. Le istanze vanno create utilizzando il metodo Context3D CreateTexture.
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 compressa nel formato ATF (Adobe Texture Format) da un oggetto ByteArray. | Texture | ||
Carica una texture da un oggetto BitmapData. | Texture | ||
Carica miplevel 0 per una texture in modo asincrono da un oggetto BitmapData. | Texture | ||
Carica una texture da un ByteArray. | Texture | ||
Carica miplevel 0 per una texture in modo asincrono da un ByteArray. | Texture | ||
|
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 compressa nel formato ATF (Adobe Texture Format) da un oggetto ByteArray. La versione del file ATF 2 richiede la versione SWF 21 o successiva e la versione del file ATF 3 richiede la versione SWF 29 o successiva. Per i file ATF creati con immagine png senza alfa la stringa formato assegnata durante Context3DObject::createTexture deve essere “COMPRESSED” e per i file ATF creati con immagine png con alfa la stringa formato assegnata durante Context3DObject::createTexture deve essere “COMPRESSED_ALPHA”.
Parametri
data:ByteArray — Un array di byte che contiene una texture cubica compressa contenente delle mipmap. L'oggetto ByteArray deve utilizzare il formato little endian.
| |
byteArrayOffset:uint — La posizione dell'array di byte in corrispondenza della quale iniziare a leggere i dati della texture.
| |
async:Boolean (default = false)CubeTexture 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 o quando la versione SWF non è compatibile con la versione del file ATF.
| |
ArgumentError — Dimensione texture non corrispondente: quando la larghezza e l'altezza della texture decompressa non equivale alle dimensioni di questo oggetto Texture.
| |
ArgumentError — Miplevel troppo grande: se il livello mip della decompressa è maggiore di quello determinato dalla dimensione della texture.
| |
ArgumentError — Formato texture non corrispondente: se i byte decodificati di ATF non contiene texture compatibile con il formato di questo fotogramma.
| |
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, miplevel:uint = 0):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 11, AIR 3 |
Carica una texture da un oggetto BitmapData.
Parametri
source:BitmapData — Una bitmap.
| |
miplevel:uint (default = 0) |
Genera
TypeError — Puntatore nullo: quando source è null.
| |
ArgumentError — Miplevel troppo grande: se il livello mip specificato è maggiore di quello determinato dalla più grande delle dimensioni della texture.
| |
ArgumentError — BitmapData non valido: se l'origine se l'oggetto BitmapData non contiene una faccia di texture cubica. L'immagine deve avere i lati corrispondenti a una potenza di due e la dimensione corretta per il 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.
|
uploadFromBitmapDataAsync | () | metodo |
public function uploadFromBitmapDataAsync(source:BitmapData, miplevel:uint = 0):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 24 |
Carica miplevel 0 per una texture in modo asincrono da un oggetto BitmapData. Qualsiasi metodo di disegno che tenta di usare la texture avrà esito negativo fino al completamento dell’upload. Al termine dell’upload, l'oggetto Texture invia Event.TEXTURE_READY. Event.TEXTURE_READY è una funzione di callback utilizzata per indicare che le chiamate asincrone ricevute per l’oggetto texture sono state eseguite correttamente. In caso di errore durante il caricamento in background, l’oggetto Texture invia Event.ERROREVENT.
Parametri
source:BitmapData — Una bitmap
| |
miplevel:uint (default = 0) |
Genera
TypeError — Puntatore nullo: quando source è null.
| |
ArgumentError — Errore di BitmapData non valido: se source se l’oggetto BitmapData non contiene una texture valida. L’immagine deve corrispondere a una potenza di due e deve essere di dimensione corretta per il 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.
| |
ArgumentError — Il caricamento asincrono è supportato solo per miplevel 0.
| |
Error — 3768: L’API Stage3D non può essere utilizzato durante l’esecuzione in background.
|
Elementi API correlati
uploadFromByteArray | () | metodo |
public function uploadFromByteArray(data:ByteArray, byteArrayOffset:uint, miplevel:uint = 0):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 11, AIR 3 |
Carica una texture da un ByteArray.
Parametri
data:ByteArray — Un array di byte che include byte sufficienti nel formato interno della texture per riempire la texture. Le texture rgba vengono lette come byte per singolo componente texel (1 o 4). Le texture float vengono lette come float per singolo componente texel (1 o 4). L'oggetto ByteArray deve utilizzare il formato little endian.
| |
byteArrayOffset:uint — La posizione dell'oggetto array di byte in corrispondenza della quale iniziare a leggere i dati della texture.
| |
miplevel:uint (default = 0) |
Genera
TypeError — Puntatore nullo: quando matrix è null.
| |
ArgumentError — Miplevel troppo grande: se il livello mip specificato è maggiore di quello determinato dalla più grande delle 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.
|
uploadFromByteArrayAsync | () | metodo |
public function uploadFromByteArrayAsync(data:ByteArray, byteArrayOffset:uint, miplevel:uint = 0):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 24 |
Carica miplevel 0 per una texture in modo asincrono da un ByteArray. Qualsiasi metodo di disegno che tenta di usare la texture avrà esito negativo fino al completamento dell’upload. Al termine dell’upload, l'oggetto Texture invia Event.TEXTURE_READY. Event.TEXTURE_READY è una funzione di callback per indicare che le chiamate asincrone ricevute per l’oggetto texture sono state eseguite correttamente. In caso di errore durante il caricamento in background, l’oggetto Texture invia Event.ERROREVENT.
Parametri
data:ByteArray — Un array di byte che include byte sufficienti nel formato interno della texture per riempire la texture. Le texture rgba vengono lette come byte per singolo componente texel (1 o 4). Le texture float vengono lette come float per singolo componente texel (1 o 4). L'oggetto ByteArray deve utilizzare il formato little endian.
| |
byteArrayOffset:uint — La posizione dell’oggetto array di byte in corrispondenza della quale iniziare a leggere i dati della texture.
| |
miplevel:uint (default = 0) |
Genera
TypeError — Puntatore nullo: quando matrix è null.
| |
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 livello mip 0 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.
| |
ArgumentError — Il caricamento asincrono è supportato solo per miplevel 0.
| |
Error — 3768: L’API Stage3D non può essere utilizzato durante l’esecuzione in background.
| |
Error — Se un caricamento asincrono è stato avviato su un oggetto texture ed esiste un’altra chiamata di caricamento asincrono sullo stesso oggetto texture.
|
Elementi API correlati
Tue Jun 12 2018, 02:44 PM Z