Guide de référence ActionScript® 3.0 pour la plate-forme Adobe® Flash®
Accueil  |  Masquer la liste des packages et des classes |  Packages  |  Classes  |  Nouveautés  |  Index  |  Annexes  |  Pourquoi existe-t-il du contenu en anglais ?
Filtres : Récupération des données du serveur...
Récupération des données du serveur...
flash.display3D.textures 

CubeTexture  - AS3

Packageflash.display3D.textures
Classepublic final class CubeTexture
HéritageCubeTexture Inheritance TextureBase Inheritance EventDispatcher Inheritance Object

La classe CubeTexture représente une texture de cube téléchargée dans un contexte de rendu.

Définit une texture de cube en vue de l’utiliser au cours du rendu. Le mappage de cube est utilisé pour de nombreuses techniques de rendu, notamment les textures d’environnement, les skybox et l’éclairage diurne.

Vous ne pouvez pas créer d’objet CubeTexture directement ; utilisez plutôt la méthode createCubeTexture() de l’objet Context3D.

Informations complémentaires

Eléments de l’API associés



Propriétés publiques
 PropriétéDéfini par
 Inheritedconstructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.
Object
Méthodes publiques
 MéthodeDéfini par
 Inherited
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
 Inherited
Distribue un événement dans le flux d’événements.
EventDispatcher
 Inherited
Libère toutes les ressources GPU associées à cette texture.
TextureBase
 Inherited
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement.
EventDispatcher
 Inherited
Indique si la propriété spécifiée d’un objet est définie.
Object
 Inherited
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
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Supprime un écouteur de l’objet EventDispatcher.
EventDispatcher
 Inherited
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.
Object
 Inherited
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.
Object
 Inherited
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 de cube au format ATF (Adobe Texture Format) à partir d'un tableau d'octets.
CubeTexture
  
uploadFromBitmapData(source:BitmapData, side:uint, miplevel:uint = 0):void
Télécharge un composant d’une texture de cube à partir d’un objet BitmapData.
CubeTexture
  
uploadFromByteArray(data:ByteArray, byteArrayOffset:uint, side:uint, miplevel:uint = 0):void
Télécharge un composant d’une texture de cube à partir d’un objet ByteArray.
CubeTexture
 Inherited
Renvoie la valeur primitive de l’objet spécifié.
Object
 Inherited
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
 Evénement Synthèse Défini par
 Inherited[Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active.EventDispatcher
 Inherited[Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive.EventDispatcher
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 de cube au format ATF (Adobe Texture Format) à partir d'un tableau d'octets.

Le tableau d'octets doit contenir toutes les faces et tous les mipmaps de la texture.

Paramètres

data:ByteArray — tableau d'octets contenant une texture de cube compressée incluant des mipmaps. L’objet ByteArray doit utiliser le format petit-boutiste.
 
byteArrayOffset:uint — décalage facultatif à partir duquel commencer la lecture des données de texture.
 
async:Boolean (default = false) — Si vous choisissez true, cette fonction est immédiatement renvoyée. 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. 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.
 
ArgumentError — La texture doit être un carré : lorsque la texture décompressée n'a la même largeur et la même hauteur.
 
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 à la longueur du bord de la texture.
 
ArgumentError — Niveau mip trop grand : si le niveau mip de la texture décompressée est supérieur à celui impliqué par la longueur du bord 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 ou qui n’est pas une texture de cube.
 
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 data 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, side: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 un composant d’une texture de cube à partir d’un objet BitmapData.

Cette fonction télécharge un niveau mip d’un côté du cube. Appelez uploadFromBitmapData() lorsque cela est nécessaire pour télécharger chaque niveau mip et chaque face du cube.

Paramètres

source:BitmapData — Une image bitmap.
 
side:uint — Code indiquant le côté du cube à télécharger :

    X positif : 0
    X négatif : 1
    Y positif : 2
    Y négatif : 3
    Z positif : 4
    Z négatif : 5

 
miplevel:uint (default = 0) — niveau mip à charger, le niveau zéro étant l’image haute résolution de niveau supérieur. La valeur par défaut est zéro.


Valeur émise
TypeError — Erreur de pointeur nul : si source est null.
 
ArgumentError — Niveau mip trop grand : si le niveau mip spécifié est supérieur à celui impliqué par les dimensions de la texture.
 
ArgumentError — Côté du cube non valide : si side est supérieur à 5.
 
ArgumentError — Erreur d'objet BitmapData non valide : si source si l'objet BitmapData ne contient pas de face de texture de cube valide. L'image doit être carrée et ses côtés 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.

uploadFromByteArray

()méthode 
public function uploadFromByteArray(data:ByteArray, byteArrayOffset:uint, side: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 un composant d’une texture de cube à partir d’un objet ByteArray.

Cette fonction télécharge un niveau mip d’un côté du cube. Appelez uploadFromByteArray() lorsque cela est nécessaire pour télécharger chaque niveau mip et chaque face du cube.

Paramètres

data:ByteArray — tableau d’octets contenant l’image au format spécifié lors de la création de cet objet CubeTexture. L’objet ByteArray doit utiliser le format petit-boutiste.
 
byteArrayOffset:uint — La lecture du tableau d’octets commence ici.
 
side:uint — Code indiquant le côté du cube à télécharger :

    X positif : 0
    X négatif : 1
    Y positif : 2
    Y négatif : 3
    Z positif : 4
    Z négatif : 5

 
miplevel:uint (default = 0) — niveau mip à charger, le niveau zéro étant l’image haute résolution de niveau supérieur.


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




[ X ]Pourquoi existe-t-il du contenu en anglais ?
Certaines parties du Guide de référence ActionScript 3.0 sont en anglais

Tout le contenu du Guide de référence ActionScript 3.0 n’a pas été traduit dans toutes les langues. Si un élément de langage n’est pas traduit, il s’affiche en anglais. Par exemple, la classe ga.controls.HelpBox n’est traduite dans aucune langue. Ainsi, dans la version française du guide de référence, la classe ga.controls.HelpBox apparaît en anglais.