Bitmap Too Large to Be Uploaded Into a Texture (5312x2988

The Texture class represents a 2-dimensional texture uploaded to a rendering context.

Defines a 2D texture for use during rendering.

Texture cannot exist instantiated directly. Create instances by using Context3D createTexture() method.

---

Public Properties

	Belongings		Defined By
		constructor : Object A reference to the class object or constructor function for a given object example.	Object

Public Methods

	Method		Divers By
		addEventListener(blazon:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = imitation):void Registers an event listener object with an EventDispatcher object so that the listener receives notification of an issue.	EventDispatcher
		dispatchEvent(event:Event):Boolean Dispatches an event into the effect flow.	EventDispatcher
		dispose():void Frees all GPU resource 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:Cord):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 epitome chain of the object specified as the parameter.	Object
		propertyIsEnumerable(name:Cord):Boolean Indicates whether the specified belongings exists and is enumerable.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = faux):void Removes a listener from the EventDispatcher object.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Sets the availability of a dynamic holding for loop operations.	Object
		toLocaleString():String Returns the cord representation of this object, formatted according to locale-specific conventions.	Object
		toString():String Returns the cord representation of the specified object.	Object
		uploadCompressedTextureFromByteArray(data:ByteArray, byteArrayOffset:uint, async:Boolean = false):void Uploads a compressed texture in Adobe Texture Format (ATF) from a ByteArray object.	Texture
		uploadFromBitmapData(source:BitmapData, miplevel:uint = 0):void Uploads a texture from a BitmapData object.	Texture
		uploadFromBitmapDataAsync(source:BitmapData, miplevel:uint = 0):void Uploads miplevel 0 for a texture from a BitmapData object asynchronously.	Texture
		uploadFromByteArray(data:ByteArray, byteArrayOffset:uint, miplevel:uint = 0):void Uploads a texture from a ByteArray.	Texture
		uploadFromByteArrayAsync(data:ByteArray, byteArrayOffset:uint, miplevel:uint = 0):void Uploads miplevel 0 for a texture from a ByteArray asynchronously.	Texture
		valueOf():Object Returns the primitive value of the specified object.	Object
		willTrigger(type:String):Boolean Checks whether an upshot listener is registered with this EventDispatcher object or any of its ancestors for the specified result type.	EventDispatcher

Events

	Event		Summary	Defined Past
		activate	[broadcast consequence] Dispatched when the Flash Player or AIR application gains operating organisation focus and becomes active.	EventDispatcher
		deactivate	[circulate event] Dispatched when the Flash Player or AIR application operating loses organization focus and is condign inactive.	EventDispatcher

public function uploadCompressedTextureFromByteArray(data:ByteArray, byteArrayOffset:uint, async:Boolean = false):void

Language Version:

ActionScript iii.0

Runtime Versions:

Flash Histrion 11, AIR 3

Uploads a compressed texture in Adobe Texture Format (ATF) from a ByteArray object. ATF file version 2 requires SWF version 21 or newer and ATF file version three requires SWF version 29 or newer. For ATF files created with png paradigm without alpha the format string given during Context3DObject::createTexture should exist "COMPRESSED" and for ATF files created with png image with alpha the format cord given during Context3DObject::createTexture should be "COMPRESSED_ALPHA".

Parameters

	information:ByteArray — a byte array that contains a compressed texture including mipmaps. The ByteArray object must use the little endian format.
	byteArrayOffset:uint — the position in the byte array at which to offset reading the texture data.
	async:Boolean (default = false) — If true, this office returns immediately. Any draw method which attempts to apply the texture will fail until the upload completes successfully. Upon successful upload, this CubeTexture object dispatches Event.TEXTURE_READY. Default value: false.

Throws

	TypeError — Null Arrow 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 information in information or when the SWF version is incompatible with the ATF file version.
	ArgumentError — Texture Size Does Not Match: when the width and height of the decompressed texture practice not equal the dimensions of this Texture object.
	ArgumentError — Miplevel Too Large: if the mip level of the decompressed texture is greater than that unsaid by the size of the texture.
	ArgumentError — Texture Format Mismatch: if the decoded ATF bytes don't contain a texture compatible with this texture'south format.
	Error — 3768: The Stage3D API may non be used during groundwork execution.
	RangeError — Bad Input Size: when there is integer overflow of byteArrayOffset or if byteArrayOffset + vi is greater than the length of data, or if the number of bytes bachelor from byteArrayOffset to the end of the data byte assortment is less than the amount of data required for ATF texture.

Related API Elements

public office uploadFromBitmapData(source:BitmapData, miplevel:uint = 0):void

Language Version:

ActionScript three.0

Runtime Versions:

Wink Thespian 11, AIR iii

Uploads a texture from a BitmapData object.

Parameters

	source:BitmapData — a bitmap.
	miplevel:uint (default = 0) — the mip level to be loaded, level goose egg being the tiptop-level full-resolution prototype.

Throws

	TypeError — Cypher Pointer Mistake: when source is null.
	ArgumentError — Miplevel Too Large: if the specified mip level is greater than that implied past the larger of the Texture'due south dimensions.
	ArgumentError — Invalid BitmapData Error: if source if the BitmapData object does not contain a valid cube texture face up. The image must have sides equal to a power of ii, and the right size for the miplevel specified.
	ArgumentError — Texture Format Mismatch: if the texture format is Context3DTextureFormat.COMPRESSED or Context3DTextureFormat.COMPRESSED_ALPHA and the code is executing on a mobile platform where runtime texture compression is not supported.
	Fault — 3768: The Stage3D API may non be used during background execution.

public part uploadFromBitmapDataAsync(source:BitmapData, miplevel:uint = 0):void

Language Version:

ActionScript three.0

Uploads miplevel 0 for a texture from a BitmapData object asynchronously. Whatever describe method which attempts to employ the texture fails until the upload completes successfully. Upon successful upload, this Texture object dispatches Issue.TEXTURE_READY. Event.TEXTURE_READY is a callback to indicate that the asynchronous phone call received for the texture object have been executed successfully. Upon any fault during the background upload , this Texture object dispatches Effect.ERROREVENT.

Parameters

Throws

	TypeError — Naught Pointer Fault: when source is zip.
	ArgumentError — Invalid BitmapData Fault: if source if the BitmapData object does not comprise a valid texture. The image must exist equal to a power of two, and the correct size for the miplevel specified.
	ArgumentError — Texture Format Mismatch: if the texture format is Context3DTextureFormat.COMPRESSED or Context3DTextureFormat.COMPRESSED_ALPHA and the code is executing on a mobile platform where runtime texture compression is non supported.
	ArgumentError — Asynchronous upload supported for miplevel 0 but.
	Error — 3768: The Stage3D API may not be used during background execution.

Related API Elements

public role uploadFromByteArray(data:ByteArray, byteArrayOffset:uint, miplevel:uint = 0):void

Language Version:

ActionScript iii.0

Runtime Versions:

Wink Thespian 11, AIR 3

Uploads a texture from a ByteArray.

Parameters

	data:ByteArray — a byte array that is contains enough bytes in the textures internal format to fill the texture. rgba textures are read equally bytes per texel component (ane or 4). float textures are read equally floats per texel component (ane or 4). The ByteArray object must use the niggling endian format.
	byteArrayOffset:uint — the position in the byte array object at which to start reading the texture data.
	miplevel:uint (default = 0) — the mip level to be loaded, level zero is the summit-level, full-resolution image.

Throws

	TypeError — Zippo Pointer Error: when data is nix.
	ArgumentError — Miplevel Likewise Large: if the specified mip level is greater than that implied by the larger of the Texture's dimensions.
	RangeError — Bad Input Size: if the number of bytes bachelor from byteArrayOffset to the end of the information byte array is less than the amount of data required for a texture of this mip level or if byteArrayOffset is greater than or equal to the length of information.
	ArgumentError — Texture Format Mismatch: if the texture format is Context3DTextureFormat.COMPRESSED or Context3DTextureFormat.COMPRESSED_ALPHA and the lawmaking is executing on a mobile platform where runtime texture compression is not supported.
	Fault — 3768: The Stage3D API may not be used during groundwork execution.

public role uploadFromByteArrayAsync(information:ByteArray, byteArrayOffset:uint, miplevel:uint = 0):void

Language Version:

ActionScript 3.0

Uploads miplevel 0 for a texture from a ByteArray asynchronously. Any draw method which attempts to employ the texture fails until the upload completes successfully. Upon successful upload, this Texture object dispatches Issue.TEXTURE_READY. Event.TEXTURE_READY is a callback to betoken that the asynchronous calls received for the texture object have been executed successfully. Upon any error during the background upload, this Texture object dispatches Issue.ERROREVENT.

Parameters

	data:ByteArray — a byte array that contains enough bytes in the textures internal format to fill the texture. rgba textures are read as bytes per texel component (i or iv). float textures are read as floats per texel component (1 or 4). The ByteArray object must apply the little endian format.
	byteArrayOffset:uint — the position in the byte array object at which to start reading the texture data.
	miplevel:uint (default = 0)

Throws

	TypeError — Null Pointer Error: when data is null.
	RangeError — Bad Input Size: if the number of bytes available from byteArrayOffset to the end of the data byte assortment is less than the corporeality of data required for a texture of mip level 0 or if byteArrayOffset is greater than or equal to the length of information.
	ArgumentError — Texture Format Mismatch: if the texture format is Context3DTextureFormat.COMPRESSED or Context3DTextureFormat.COMPRESSED_ALPHA and the lawmaking is executing on a mobile platform where runtime texture pinch is non supported.
	ArgumentError — Asynchronous upload supported for miplevel 0 only.
	Error — 3768: The Stage3D API may not be used during background execution.
	Error — if an async upload has been initiated on a texture object and there is another asynchronous upload telephone call on the same texture object.

Related API Elements

---

© 2015 Adobe Systems Incorporated. All rights reserved.
Thu Dec 6 2018, 01:12 PM -08:00

morissettedrined.blogspot.com

Source: https://help.adobe.com/en_US/FlashPlatform//reference/actionscript/3/flash/display3D/textures/Texture.html