MACROMEDIA FLASH MX 2004 - ACTIONSCRIPT, Reference Manual

Page: 594 / 816

594 Chapter 12: ActionScript Dictionary
printAsBitmapNum()
Availability
Flash Player 5.
Note: If you are authoring for Flash Player 7 or later, you can create a PrintJob object, which gives
you (and the user) more control over the printing process. For more information, see the PrintJob
class entry.
Usage
printAsBitmapNum( level , " Bounding box ")
Parameters
level
The level in Flash Player to print. By default, all of the frames in the level print. If you
want to print specific frames in the level, assign a
#p
frame label to those frames.
Bounding box
A modifier that sets the print area of the movie. Enclose this parameter in
quotation marks, and specify one of the following values:
•
bmovie
Designates the bounding box of a specific frame in a movie as the print area for all
printable frames in the movie. Assign a
#b
frame label to the frame whose bounding box you
want to use as the print area.
•
bmax
Designates a composite of all of the bounding boxes of all the printable frames as the
print area. Specify the
bmax
parameter when the printable frames in your movie vary in size.
•
bframe
Indicates that the bounding box of each printable frame should be used as the print
area for that frame. This changes the print area for each frame and scales the objects to fit the
print area. Use
bframe
if you have objects of different sizes in each frame and want each object
to fill the printed page.
Returns
None.
Description
Function; prints a level in Flash Player as a bitmap according to the boundaries specified in the
parameter (
bmovie
,
bmax
, or
bframe
). Use
printAsBitmapNum()
to print movies that contain
frames with objects that use transparency or color effects. The
printAsBitmapNum()
action
prints at the highest available resolution of the printer in order to maintain the highest possible
definition and quality. To calculate the printable file size of a frame designated to print as a
bitmap, multiply pixel width by pixel height by printer resolution.
If your movie does not contain alpha transparencies or color effects, it is recommended that you
use
printNum()
for better quality results.
If you use
bmovie
for the
Bounding box
parameter but do not assign a
#b
label to a frame, the
print area is determined by the Stage size of the loaded movie. (The loaded movie does not inherit
the main movie’s Stage size.)
All of the printable elements in a movie must be fully loaded before printing can begin.
The Flash Player printing feature supports PostScript and non-PostScript printers. Non-
PostScript printers convert vectors to bitmaps.
See also
print()
,
printAsBitmap()
, PrintJob class ,
printNum()