| Package | flash.display3D.textures |
| Classe | public final class Texture |
| Héritage | Texture  TextureBase EventDispatcher Object |
Définit une texture 2D en vue de l’utiliser lors du rendu.
Il est impossible d’instancier la texture directement. Créez des occurrences à l’aide de la méthode createTexture() de Context3D.
Eléments de l’API associés
Propriétés publiques
Masquer les propriétés publiques héritées
Afficher les propriétés publiques héritéesMéthodes publiques
| Méthode | Défini par | ||
|---|---|---|---|
 | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement. | EventDispatcher | |
|
Distribue un événement dans le flux d’événements. | EventDispatcher | |
|
Libère toutes les ressources GPU associées à cette texture. | TextureBase | |
|
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | EventDispatcher | |
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | |
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | |
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
|
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | |
uploadCompressedTextureFromByteArray(data:ByteArray, byteArrayOffset:uint, async:Boolean = false):void
Télécharge une texture compressée au format ATF (Adobe Texture Format) à partir d'un objet ByteArray. | Texture | ||
Télécharge une texture à partir d'un objet BitmapData. | Texture | ||
Télécharge de façon asynchrone le niveau mip 0 pour une texture à partir d’un objet BitmapData. | Texture | ||
Télécharge une texture à partir d'un objet ByteArray. | Texture | ||
Télécharge de façon asynchrone le niveau mip 0 pour une texture à partir d’un objet ByteArray. | Texture | ||
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
|
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié. | EventDispatcher | |
Evénements
Détails de la méthode
uploadCompressedTextureFromByteArray | () | méthode |
public function uploadCompressedTextureFromByteArray(data:ByteArray, byteArrayOffset:uint, async:Boolean = false):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 11, AIR 3 |
Télécharge une texture compressée au format ATF (Adobe Texture Format) à partir d’un objet ByteArray. La version 2 du fichier ATF nécessite SWF version 21 ou ultérieure et la version 3 nécessite SWF version 29 ou ultérieure. Pour les fichiers ATF créés avec une image png sans alpha, la chaîne format spécifiée pendant Context3DObject::createTexture doit être « COMPRESSED », et pour les fichiers ATF créés avec une image png avec alpha, la chaîne format spécifiée pendant Context3DObject::createTexture doit être « COMPRESSED_ALPHA ».
Paramètres
data:ByteArray — tableau d'octets qui contient une texture compressée incluant des mipmaps. L’objet ByteArray doit utiliser le format petit-boutiste.
| |
byteArrayOffset:uint — position dans le tableau d'octets à partir de laquelle commencer la lecture des données de texture.
| |
async:Boolean (default = false)CubeTexture distribue l’événement Event.TEXTURE_READY. Valeur par défaut : false.
|
Valeur émise
TypeError — Erreur de pointeur nulle : lorsque data est null.
| |
ArgumentError — Echec du décodage de la texture : lorsque le format de compression de cet objet ne peut pas être dérivé du format des données compressées dans data ou lorsque la version SWF est incompatible avec la version de fichier ATF.
| |
ArgumentError — Non concordance de la taille de la texture : lorsque la largeur et la hauteur de la texture décompressée ne sont pas égales aux dimensions de cet objet de texture.
| |
ArgumentError — Niveau mip trop grand : si le niveau mip de la texture décompressée est supérieur à celui impliqué par la taille de la texture.
| |
ArgumentError — Discordance du format de la texture : si les octets ATF décodés ne contiennent pas une texture compatible avec le format de cette texture.
| |
Error — 3768 : l’API Stage3D ne peut pas être utilisée lors d’une exécution en arrière-plan.
| |
RangeError — Taille d’entrée incorrecte : lorsqu’il existe un débordement d’entier de byteArrayOffset ou si byteArrayOffset + 6 est supérieur à la longueur de data, ou si le nombre d’octets disponibles de byteArrayOffset à la fin du tableau d’octets données est inférieur à la quantité de données requise pour une texture ATF.
|
Eléments de l’API associés
uploadFromBitmapData | () | méthode |
public function uploadFromBitmapData(source:BitmapData, miplevel:uint = 0):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 11, AIR 3 |
Télécharge une texture à partir d'un objet BitmapData.
Paramètres
source:BitmapData — Une image bitmap.
| |
miplevel:uint (default = 0) |
Valeur émise
TypeError — Erreur de pointeur nul : lorsque source est null.
| |
ArgumentError — Niveau mip trop grand : si le niveau mip spécifié est supérieur à celui impliqué par la plus large des dimensions de la texture.
| |
ArgumentError — Erreur d'objet BitmapData non valide : si source si l'objet BitmapData ne contient pas de face de texture de cube valide. Les côtés de l'image doivent être égaux à une puissance de deux, et la taille adéquate pour le niveau mip doit être spécifiée.
| |
ArgumentError — Discordance du format de la texture : si le format de texture est Context3DTextureFormat.COMPRESSED ou Context3DTextureFormat.COMPRESSED_ALPHA et que le code s’exécute sur une plate-forme mobile où la compression de texture à l’exécution n’est pas prise en charge.
| |
Error — 3768 : l’API Stage3D ne peut pas être utilisée lors d’une exécution en arrière-plan.
|
uploadFromBitmapDataAsync | () | méthode |
public function uploadFromBitmapDataAsync(source:BitmapData, miplevel:uint = 0):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 24 |
Télécharge de façon asynchrone le niveau mip 0 pour une texture à partir d’un objet BitmapData. Toutes les méthodes de dessin qui tentent d’utiliser la texture échouent jusqu’à ce que le chargement aboutisse. Une fois le chargement terminé, cet objet Texture distribue l’événement Event.TEXTURE_READY. L’événement Event.TEXTURE_READY est un rappel pour indiquer que l’appel asynchrone reçu pour l’objet Texture a été effectué correctement. Lors d’une erreur pendant le téléchargement en arrière-plan, cet objet Texture distribue l’événement Event.ERROREVENT.
Paramètres
source:BitmapData — Une image bitmap
| |
miplevel:uint (default = 0) |
Valeur émise
TypeError — Erreur de pointeur nul : lorsque source est null.
| |
ArgumentError — Erreur d’objet BitmapData non valide : si source si l’objet BitmapData ne contient pas de texture valide. L’image doit être égale à une puissance de deux, et la taille adéquate pour le niveau mip doit être spécifiée.
| |
ArgumentError — Discordance du format de la texture : si le format de texture est Context3DTextureFormat.COMPRESSED ou Context3DTextureFormat.COMPRESSED_ALPHA et que le code s’exécute sur une plate-forme mobile où la compression de texture à l’exécution n’est pas prise en charge.
| |
ArgumentError — Le chargement asynchrone est pris en charge uniquement pour le niveau mip 0.
| |
Error — 3768 : l’API Stage3D ne peut pas être utilisée lors d’une exécution en arrière-plan.
|
Eléments de l’API associés
uploadFromByteArray | () | méthode |
public function uploadFromByteArray(data:ByteArray, byteArrayOffset:uint, miplevel:uint = 0):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 11, AIR 3 |
Télécharge une texture à partir d'un objet ByteArray.
Paramètres
data:ByteArray — tableau d’octets contenant suffisamment d’octets dans le format interne de la texture pour remplir la texture. Les textures rgba sont lues en tant que composant octets par texel (1 ou 4). Les textures float sont lues en tant que composant float par texel (1 ou 4). L’objet ByteArray doit utiliser le format petit-boutiste.
| |
byteArrayOffset:uint — position dans le tableau d'octets objet à partir de laquelle commencer la lecture des données de texture.
| |
miplevel:uint (default = 0) |
Valeur émise
TypeError — Erreur de pointeur nulle : lorsque data est null.
| |
ArgumentError — Niveau mip trop grand : si le niveau mip spécifié est supérieur à celui impliqué par la plus large des dimensions de la texture.
| |
RangeError — Taille d’entrée incorrecte : si le nombre d’octets disponibles de byteArrayOffset à la fin du tableau d’octets data est inférieur à la quantité de données requise pour une texture de ce niveau mip ou si byteArrayOffset est supérieur ou égal à la longueur de data.
| |
ArgumentError — Discordance du format de la texture : si le format de texture est Context3DTextureFormat.COMPRESSED ou Context3DTextureFormat.COMPRESSED_ALPHA et que le code s’exécute sur une plate-forme mobile où la compression de texture à l’exécution n’est pas prise en charge.
| |
Error — 3768 : l’API Stage3D ne peut pas être utilisée lors d’une exécution en arrière-plan.
|
uploadFromByteArrayAsync | () | méthode |
public function uploadFromByteArrayAsync(data:ByteArray, byteArrayOffset:uint, miplevel:uint = 0):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 24 |
Télécharge de façon asynchrone le niveau mip 0 pour une texture à partir d’un objet ByteArray. Toutes les méthodes de dessin qui tentent d’utiliser la texture échouent jusqu’à ce que le chargement aboutisse. Une fois le chargement terminé, cet objet Texture distribue l’événement Event.TEXTURE_READY. L’événement Event.TEXTURE_READY est un rappel qui permet d’indiquer que les appels asynchrones reçus pour l’objet Texture ont été effectués correctement. Lors d’une erreur pendant le téléchargement en arrière-plan, cet objet Texture distribue l’événement Event.ERROREVENT.
Paramètres
data:ByteArray — tableau d’octets contenant suffisamment d’octets dans le format interne de la texture pour remplir la texture. Les textures rgba sont lues en tant que composant octets par texel (1 ou 4). Les textures float sont lues en tant que composant float par texel (1 ou 4). L’objet ByteArray doit utiliser le format petit-boutiste.
| |
byteArrayOffset:uint — position dans le tableau d'octets objet à partir de laquelle commencer la lecture des données de texture.
| |
miplevel:uint (default = 0) |
Valeur émise
TypeError — Erreur de pointeur nul : lorsque data est null.
| |
RangeError — Taille d’entrée incorrecte : si le nombre d’octets disponibles de byteArrayOffset à la fin du tableau d’octets data est inférieur à la quantité de données requise pour une texture d’un niveau mip de 0, ou si byteArrayOffset est supérieur ou égal à la longueur de data.
| |
ArgumentError — Discordance du format de la texture : si le format de texture est Context3DTextureFormat.COMPRESSED ou Context3DTextureFormat.COMPRESSED_ALPHA et que le code s’exécute sur une plate-forme mobile où la compression de texture à l’exécution n’est pas prise en charge.
| |
ArgumentError — Le chargement asynchrone est pris en charge uniquement pour le niveau mip 0.
| |
Error — 3768 : l’API Stage3D ne peut pas être utilisée lors d’une exécution en arrière-plan.
| |
Error — si un téléchargement asynchrone a été lancé sur un objet de texture et s’il existe un autre appel asynchrone de téléchargement sur le même objet de texture.
|
Eléments de l’API associés
Tue Jun 12 2018, 09:30 AM Z