flash.system.ImageDecodingPolicy - ActionScript® 3.0 Reference for the Adobe® Flash® Platform

Package	flash.system
Class	public final class ImageDecodingPolicy
Inheritance	ImageDecodingPolicy Object

Language Version:

ActionScript 3.0

Runtime Versions:

AIR 2.6, Flash Player 11

The ImageDecodingPolicy class defines the image download policies you can specify in the LoaderContext.imageDecodingPolicy property.

The two decoding policies are:

ON_DEMAND: Decode the image synchronously when it is needed. This setting is useful for smaller images.
ON_LOAD: Decode the image asynchronously, immediately after it loads. This setting is useful for larger images.

The default policy is ON_DEMAND.

Related API Elements

flash.system.LoaderContext

Public Properties

Hide Inherited Public Properties

Show Inherited Public Properties

	Property		Defined By
		constructor : Object A reference to the class object or constructor function for a given object instance.	Object
		prototype : Object [static] A reference to the prototype object of a class or function object.	Object

Public Methods

Hide Inherited Public Methods

Show Inherited Public Methods

	Method		Defined By
		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
		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
		valueOf():Object Returns the primitive value of the specified object.	Object

Public Constants

	Constant		Defined By
		ON_DEMAND : String = "onDemand" [static] Specifies that the bitmap image file is decoded synchronously at the time it is needed.	ImageDecodingPolicy
		ON_LOAD : String = "onLoad" [static] Specifies that the bitmap image file is decoded asynchronously at the time it is loaded.	ImageDecodingPolicy

Constant Detail

ON_DEMAND

Constant

public static const ON_DEMAND:String = "onDemand"

Language Version:

ActionScript 3.0

Runtime Versions:

AIR 2.6, Flash Player 11

Specifies that the bitmap image file is decoded synchronously at the time it is needed. This is the default policy. It is optimal for smaller images.

The decoded data may be flushed at will by the runtime. If the decoded data is flushed, the runtime decodes the data again when the data is needed.

Related API Elements

flash.system.LoaderContext.imageDecodingPolicy

ON_LOAD

Constant

public static const ON_LOAD:String = "onLoad"

Language Version:

ActionScript 3.0

Runtime Versions:

AIR 2.6, Flash Player 11

Specifies that the bitmap image file is decoded asynchronously at the time it is loaded. Decoding begins before the LoaderInfo object dispatches a complete event. This option is best for large images and for applications with complex effects and transitions.

The decoded image data is cached, and may be flushed at will by the runtime. If the decoded data is flushed, the runtime decodes the data again when the data is needed.

Related API Elements

flash.system.LoaderContext.imageDecodingPolicy

[an error occurred while processing this directive]

Legal Notices | Online Privacy Policy

Classes x

ON_DEMAND

ON_LOAD