Package | flash.display3D.textures |
Classe | public final class CubeTexture |
Héritage | CubeTexture TextureBase EventDispatcher Object |
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
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 de cube au format ATF (Adobe Texture Format) à partir d'un tableau d'octets. | CubeTexture | ||
Télécharge un composant d’une texture de cube à partir d’un objet BitmapData. | CubeTexture | ||
Télécharge un composant d’une texture de cube à partir d’un objet ByteArray. | CubeTexture | ||
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 |
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 :
| |
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 :
| |
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.
|
Tue Jun 12 2018, 09:30 AM Z