StageQuality

Package	flash.display
Class	public final class StageQuality
Inheritance	StageQuality Object

Language Version:

ActionScript 3.0

Runtime Versions:

AIR 1.0, Flash Player 9, Flash Lite 4

The StageQuality class provides values for the Stage.quality property and for the value of the quality parameter to the BitmapData.drawWithQuality() method.

Higher quality settings produce better rendering of scaled bitmaps. However, higher quality settings are computationally more expensive. In particular, when rendering scaled video, using higher quality settings can reduce the frame rate.

In the desktop profile of Adobe AIR, quality can be set to StageQuality.BEST or StageQuality.HIGH (and the default value is StageQuality.HIGH). Attempting to set it to another value has no effect (and the property remains unchanged). In the moble profile of AIR, all four quality settings are available. The default value on mobile devices is StageQuality.MEDIUM.

For content running in Adobe AIR, setting the quality property of one Stage object changes the rendering quality for all Stage objects (used by different NativeWindow objects).

Note: The operating system draws the device fonts, which are therefore unaffected by the quality property.

Related API Elements

flash.display.Stage.quality
flash.display.BitmapData.drawWithQuality()

Public Properties

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

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
		BEST : String = "best" [static] Specifies very high rendering quality.	StageQuality
		HIGH : String = "high" [static] Specifies high rendering quality.	StageQuality
		HIGH_16X16 : String = "16x16" [static] Specifies very high rendering quality.	StageQuality
		HIGH_16X16_LINEAR : String = "16x16linear" [static] Specifies very high rendering quality.	StageQuality
		HIGH_8X8 : String = "8x8" [static] Specifies very high rendering quality.	StageQuality
		HIGH_8X8_LINEAR : String = "8x8linear" [static] Specifies very high rendering quality.	StageQuality
		LOW : String = "low" [static] Specifies low rendering quality.	StageQuality
		MEDIUM : String = "medium" [static] Specifies medium rendering quality.	StageQuality

Constant Detail

BEST

Constant

public static const BEST:String = "best"

Language Version:

ActionScript 3.0

Runtime Versions:

AIR 1.0, Flash Player 9, Flash Lite 4

Specifies very high rendering quality. Graphics are anti-aliased using a 4 x 4 pixel grid. If Bitmap.smoothing is true the runtime uses a high quality downscale algorithm that produces fewer artifacts (however, using StageQuality.BEST with Bitmap.smoothing set to true slows performance significantly and is not a recommended setting).

HIGH

Constant

public static const HIGH:String = "high"

Language Version:

ActionScript 3.0

Runtime Versions:

AIR 1.0, Flash Player 9, Flash Lite 4

Specifies high rendering quality. Graphics are anti-aliased using a 4 x 4 pixel grid, and bitmap smoothing is dependent on the Bitmap.smoothing setting. Runtimes use mip-mapping. This is the default rendering quality setting that Flash Player uses.

HIGH_16X16

Constant

public static const HIGH_16X16:String = "16x16"

Language Version:

ActionScript 3.0

Runtime Versions:

AIR 1.0, Flash Player 11.3

Specifies very high rendering quality. Graphics are anti-aliased using a 16 x 16 pixel grid. If Bitmap.smoothing is true the runtime uses a high quality downscale algorithm that produces fewer artifacts (however, using StageQuality.BEST with Bitmap.smoothing set to true slows performance significantly and is not a recommended setting).

HIGH_16X16_LINEAR

Constant

public static const HIGH_16X16_LINEAR:String = "16x16linear"

Language Version:

ActionScript 3.0

Runtime Versions:

AIR 1.0, Flash Player 11.3

Specifies very high rendering quality. Graphics are anti-aliased using a 16 x 16 pixel grid. Antialiasing is generated in linear sRGB space. If Bitmap.smoothing is true the runtime uses a high quality downscale algorithm that produces fewer artifacts (however, using StageQuality.BEST with Bitmap.smoothing set to true slows performance significantly and is not a recommended setting).

HIGH_8X8

Constant

public static const HIGH_8X8:String = "8x8"

Language Version:

ActionScript 3.0

Runtime Versions:

AIR 1.0, Flash Player 11.3

Specifies very high rendering quality. Graphics are anti-aliased using a 8 x 8 pixel grid. If Bitmap.smoothing is true the runtime uses a high quality downscale algorithm that produces fewer artifacts (however, using StageQuality.BEST with Bitmap.smoothing set to true slows performance significantly and is not a recommended setting).

HIGH_8X8_LINEAR

Constant

public static const HIGH_8X8_LINEAR:String = "8x8linear"

Language Version:

ActionScript 3.0

Runtime Versions:

AIR 1.0, Flash Player 11.3

Specifies very high rendering quality. Graphics are anti-aliased using a 8 x 8 pixel grid. Antialiasing is generated in linear sRGB space. If Bitmap.smoothing is true the runtime uses a high quality downscale algorithm that produces fewer artifacts (however, using StageQuality.BEST with Bitmap.smoothing set to true slows performance significantly and is not a recommended setting).

LOW

Constant

public static const LOW:String = "low"

Language Version:

ActionScript 3.0

Runtime Versions:

AIR 1.0, Flash Player 9, Flash Lite 4

Specifies low rendering quality. Graphics are not anti-aliased, and bitmaps are not smoothed, but runtimes still use mip-mapping.

MEDIUM

Constant

public static const MEDIUM:String = "medium"

Language Version:

ActionScript 3.0

Runtime Versions:

AIR 1.0, Flash Player 9, Flash Lite 4

Specifies medium rendering quality. Graphics are anti-aliased using a 2 x 2 pixel grid, bitmap smoothing is dependent on the Bitmap.smoothing setting. Runtimes use mip-mapping. This setting is suitable for movies that do not contain text.

Legal Notices | Online Privacy Policy

StageQuality - AS3

Classes x

BEST

HIGH

HIGH_16X16

HIGH_16X16_LINEAR

HIGH_8X8

HIGH_8X8_LINEAR

LOW

MEDIUM