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:

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