flash.display

# StageQuality - AS3

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
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

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
--- | --- | ---
|  | 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.

© 2015 Adobe Systems Incorporated. All rights reserved.
Mon Apr 10 2017, 12:28 PM -07:00