| window.runtime property | window.runtime.flash.display3D.textures.CubeTexture |
| Inheritance | CubeTexture  TextureBase EventDispatcher Object |
| Runtime Versions: | 2 |
Defines a cube map texture for use during rendering. Cube mapping is used for many rendering techniques, such as environment maps, skyboxes, and skylight illumination.
You cannot create a CubeTexture object directly; use the
Context3D createCubeTexture() instead.
Hide Inherited Public Properties
Show Inherited PropertiesPublic Methods
| Method | Defined By | ||
|---|---|---|---|
 | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registers an event listener object with an EventDispatcher object so that the listener
receives notification of an event. | EventDispatcher | |
| dispatchEvent(event:Event):Boolean
Dispatches an event into the event flow. | EventDispatcher | |
| dispose():void
Frees all GPU resources associated with this texture. | TextureBase | |
| hasEventListener(type:String):Boolean
Checks whether the EventDispatcher object has any listeners registered for a specific type
of event. | EventDispatcher | |
| hasOwnProperty(name:String):Boolean
Indicates whether an object has a specified property defined. | Object | |
| isPrototypeOf(theClass:Object):Boolean
Indicates whether an instance of the Object class is in the prototype chain of the object specified
as the parameter. | Object | |
| propertyIsEnumerable(name:String):Boolean
Indicates whether the specified property exists and is enumerable. | Object | |
| removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Removes a listener from the EventDispatcher object. | EventDispatcher | |
| setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
Sets the availability of a dynamic property for loop operations. | Object | |
| toLocaleString():String
Returns the string representation of this object, formatted according to locale-specific conventions. | Object | |
| toString():String
Returns the string representation of the specified object. | Object | |
uploadCompressedTextureFromByteArray(data:ByteArray, byteArrayOffset:uint, async:Boolean = false):void
Uploads a cube texture in Adobe Texture Format (ATF) from a byte array. | CubeTexture | ||
uploadFromBitmapData(source:BitmapData, side:uint, miplevel:uint = 0):void
Uploads a component of a cube map texture from a BitmapData object. | CubeTexture | ||
uploadFromByteArray(data:ByteArray, byteArrayOffset:uint, side:uint, miplevel:uint = 0):void
Uploads a component of a cube map texture from a ByteArray object. | CubeTexture | ||
| valueOf():Object
Returns the primitive value of the specified object. | Object | |
| willTrigger(type:String):Boolean
Checks whether an event listener is registered with this EventDispatcher object or any of
its ancestors for the specified event type. | EventDispatcher | |
Method Detail
uploadCompressedTextureFromByteArray | () | method |
public function uploadCompressedTextureFromByteArray(data:ByteArray, byteArrayOffset:uint, async:Boolean = false):voidUploads a cube texture in Adobe Texture Format (ATF) from a byte array.
The byte array must contain all faces and mipmaps for the texture.
Parameters
data:ByteArray — a byte array that containing a compressed cube texture
including mipmaps. The ByteArray object must use the little endian format.
| |
byteArrayOffset:uint — an optional offset at which to start reading the
texture data.
| |
async:Boolean (default = false) |
Throws
TypeError — Null Pointer Error: when data is null.
| |
ArgumentError — Texture Decoding Failed: when the compression format of this object cannot be
derived from the format of the compressed data in data.
| |
ArgumentError — Texture Needs To Be Square: when the decompressed texture does not have
equal width and height.
| |
ArgumentError — Texture Size Does Not Match: when the width and height of the decompressed
texture do not equal the length of the texture's edge.
| |
ArgumentError — Miplevel Too Large: if the mip level of the decompressed texture is greater
than that implied by the length of the texture's edge.
| |
ArgumentError — Texture Format Mismatch: if the decompressed texture is not BGRA or is not a
cube texture.
|
uploadFromBitmapData | () | method |
public function uploadFromBitmapData(source:BitmapData, side:uint, miplevel:uint = 0):voidUploads a component of a cube map texture from a BitmapData object.
This function uploads one mip level of one side of the cube map.
Call uploadFromBitmapData() as necessary to upload each mip level and face of the
cube map.
Parameters
source:BitmapData — a bitmap.
| |
side:uint — A code indicating which side of the cube to upload:
| |
miplevel:uint (default = 0) |
Throws
TypeError — Null Pointer Error: if source is null.
| |
ArgumentError — Miplevel Too Large: if the specified mip level is greater than
that implied by the the texture's dimensions.
| |
ArgumentError — Invalid Cube Side: if side is greater than 5.
| |
ArgumentError — Invalid BitmapData Error: if source if the BitmapData
object does not contain a valid cube texture face. The image must be square, with sides
equal to a power of two, and the correct size for the miplevel specified.
|
uploadFromByteArray | () | method |
public function uploadFromByteArray(data:ByteArray, byteArrayOffset:uint, side:uint, miplevel:uint = 0):voidUploads a component of a cube map texture from a ByteArray object.
This function uploads one mip level of one side of the cube map.
Call uploadFromByteArray() as neccessary to upload each mip level and face of the
cube map.
Parameters
data:ByteArray — a byte array containing the image in the format specified when this CubeTexture object
was created. The ByteArray object must use the little endian format.
| |
byteArrayOffset:uint — reading of the byte array starts there.
| |
side:uint — A code indicating which side of the cube to upload:
| |
miplevel:uint (default = 0) |
Throws
TypeError — Null Pointer Error: when data is null.
| |
ArgumentError — Miplevel Too Large: if the specified mip level is greater than that
implied by the Texture's dimensions.
| |
RangeError — Bad Input Size: if the number of bytes available from byteArrayOffset
to the end of the data byte array is less than the amount of data required
for a texture of this mip level.
|
Thu Sep 29 2011, 02:34 AM -07:00