N-R > printAsBitmap

 

printAsBitmap

Availability

Flash Player 4.20.

Usage

printAsBitmap(target, "Bounding box")

Parameters

target The instance name of movie clip to print. By default, all of the frames in the movie are printed. If you want to print specific frames in the movie, attach a #P frame label to those frames.

Bounding box A modifier that sets the print area of the movie. You can choose one of the following parameters:

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 Designates that the bounding box of each printable frame 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

Action; prints the target movie clip as a bitmap. Use the printAsBitmap action to print movies that contain frames with objects that use transparency or color effects. The printAsBitmap action prints at the highest available resolution of the printer in order to maintain as much definition and quality as possible.

If your movie does not contain alpha transparencies or color effects, it is recommended that you use the print action for better quality results.

By default, the print area is determined by the Stage size of the loaded movie. The movie does not inherit the main movie's Stage size. You can control the print area by specifying the bmovie, bmax, or bframe parameters.

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, printAsBitmapNum, printNum