Cacheasbitmap (Movieclip.cacheasbitmap Property) - MACROMEDIA FLASH 8-ACTIONSCRIPT 2.0 LANGUAGE Reference

cacheAsBitmap (MovieClip.cacheAsBitmap
property)
public cacheAsBitmap : Boolean
If set to , Flash Player caches an internal bitmap representation of the movie clip. This
true
can increase performance for movie clips that contain complex vector content.
All vector data for a movie clip that has a cached bitmap is drawn to the bitmap instead of to
the main Stage. The bitmap is then copied to the main Stage as unstretched, unrotated pixels
snapped to the nearest pixel boundaries. Pixels are mapped one to one with the parent object.
If the bounds of the bitmap change, the bitmap is recreated instead of being stretched.
No internal bitmap is created unless the
After you set a movie clip's
however the movie clip performs pixel snapping automatically. The animation speed can be
significantly faster, depending on the complexity of the vector content.
The
cacheAsBitmap
movie clip (when its
is reported as
cacheAsBitmap
If you clear all filters for a movie clip, the
set to.
In the following cases a movie clip does not use a bitmap even if the
is set to , and instead renders the movie clip from vector data:
true
The bitmap is too large: greater than 2880 pixels in either direction.
The bitmap fails to allocate memory (due to an out of memory error).
The
cacheAsBitmap
and that do not scale and rotate frequently. With such movie clips,
to performance increases when the movie clip is translated (when its x and y position is
changed).
Availability: ActionScript 1.0; Flash Player 8
846 ActionScript classes
cacheAsBitmap
cacheAsBitmap
property is automatically set to
array is not empty). If a movie clip has a filter applied to it,
filter
for that movie clip, even if you set the property to
true
property is best used with movie clips that have mostly static content
property is set to
property to , the rendering does not change,
true
whenever you apply a filter to a
true
setting changes to what it was last
cacheAsBitmap
.
true
false
property
cacheAsBitmap
can lead
cacheAsBitmap
.