View comments | RSS feed

_quality property

_quality:String

Sets or retrieves the rendering quality used for a movie clip. Device fonts are always aliased and therefore are unaffected by the _quality property.

The _quality property can be set to the values described in the following table.

Value

Description

Graphic Anti-Aliasing

Bitmap Smoothing

"LOW"

Low rendering quality.

Graphics are not anti-aliased.

Bitmaps are not smoothed.

"MEDIUM"

Medium rendering quality. This setting is suitable for movies that do not contain text.

Graphics are anti-aliased using a 2 x 2 pixel grid.

Flash Player 8: Bitmaps are smoothed based on the smoothing parameter used in MovieClip.attachBitmap() and MovieClip.beginBitmapFill() calls.

Flash Player 6 and 7: Bitmaps are not smoothed.

"HIGH"

High rendering quality. This setting is the default rendering quality setting that Flash uses.

Graphics are anti-aliased using a 4 x 4 pixel grid.

Flash Player 8: Bitmaps are smoothed based on the smoothing parameter used in MovieClip.attachBitmap() and MovieClip.beginBitmapFill() calls.

Flash Player 6 and 7: Bitmaps are smoothed if the movie clip is static.

"BEST"

Very high rendering quality.

Graphics are anti-aliased using a 4 x 4 pixel grid.

Flash Player 8: Bitmaps are smoothed based on the smoothing parameter used in MovieClip.attachBitmap() and MovieClip.beginBitmapFill() calls. When smoothing is set to "Best", the result is rendered with higher quality when the movie clip is scaled down by the use of an averaging algorithm. This can slow down rendering, but it allows high-quality thumbnails of large images, for example.

Flash Player 6 and 7: Bitmaps are always smoothed.

Availability: ActionScript 1.0; Flash Player 5

Example

The following example sets the rendering quality to LOW:

_quality = "LOW";

Version 8

Comments


kurtd said on Sep 27, 2005 at 7:22 AM :
It seems that there is a problem when alternating movie clips between "HIGH" quality and "BEST" quality.

My issue is that I initially set a movie clip to "BEST". then after a tween I set it to "HIGH". after another tween I try to set it back to "BEST" but it doesn't appear to work. Though a trace of the _quality property will say it is "BEST", it definitely isn't.

Flash8. Smothing on in bitmap properties....

I'm not comfortable saying this is a bug, but it sure seems that way.
kurtd said on Sep 27, 2005 at 12:42 PM :
My bad on the comment below. I was changing quality elsewhere on the timeline.
No screen name said on Oct 12, 2005 at 3:06 AM :
Is there a way to set smoothing for images that aren't loaded with
attachBitmap()? I have a site with several JPG images that are loaded
using MovieClipLoader. When I moved the site to Flash 8, everything looks
jaggy even on BEST quality!
HELP!
subSE7EN said on Nov 15, 2005 at 10:46 AM :
To allow smoothing on a bitmap that was not imported using the attachBitmap function, right-click bitmap in the library and go to Properties.
Once there, click the "Allow Smoothing" check box. This allows the bitmap to inherit the smoothing quality (_quality in actionscript) that you've set. The default setting for _quality is "HIGH" but can be bumped up to "BEST" using _quality="BEST"; in a frame action.
ClayHalliwell said on Nov 28, 2005 at 9:23 AM :
This section of the documentation could use some clarifying. For movies published in Flash 8 format, is there any performance reason not to always set _quality to BEST, then select which bitmaps get smoothed using their Library properties?
oldskoolflash said on Jun 8, 2006 at 2:25 AM :
Tinic Uro posted a solution to smothing bitmaps that are loaded or attached externally from flash 8.

http://www.kaourantin.net/archive/2005_12_01_flashgraphics_archive.html
Marcanti said on Dec 11, 2006 at 3:56 AM :
The problem with using bitmapdata inside movieclip to solve the smooth problem is that the movieclip cant be scalled indefinetly, in my case the image will disappear or be destroyed when the movieclip is scaled to a size above 8000 pixels... This is definetly a bug...
juankpro said on Aug 1, 2007 at 2:37 PM :
Well I undertand that the _quality property is not local, that is, it changes the _quality for the complete movie and not only for just a Movie clip.

 

RSS feed | Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/flash/8/main/00001791.html