User Guide

706 Chapter 2: ActionScript Language Reference
printNum()
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
printNum (level:Number, "Bounding box":String) : Void
Parameters
level
The level in Flash Player to print. By default, all 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 clip. Enclose this parameter in
quotation marks (" or '), and specify one of the following values:
bmovie Designates the bounding box of a specific frame in a movie clip as the print area for
all printable frames in the movie clip. 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 the bounding boxes of all the printable frames as the print
area. Specify the
bmax parameter when the printable frames in your movie clip 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
Nothing.
Description
Function; prints the level in Flash Player according to the boundaries specified in the Bounding
box
parameter ("bmovie", "bmax", "bframe"). If you want to print specific frames in the target
movie clip, attach a
#p frame label to those frames. Although using printNum() results in higher
quality prints than using
printAsBitmapNum(), you cannot use printNum() to print movies
with alpha transparencies or special color effects.
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 clip. (The loaded movie clip does
not inherit the main movies Stage size.)
All the printable elements in a movie clip 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(), printAsBitmapNum(), PrintJob class
CHAPTER 2
ActionScript Language Reference