pbmpage man page

pbmpage — create a one page test pattern for printing


pbmpage [-a4] test_pattern


pbmpage generates a one page test pattern to print on a sheet of paper, for use in calibrating a printer. The test pattern in is PBM format.

pbmpage produces an image intended for 600 dots per inch printer resolution.

If you are printing on an HP PPA printer, you can convert the output of this program to a stream that you can feed to the printer with pbmtoppa.

Bear in mind that when you print the test pattern, you are testing not only the printer, but any converter or driver software along the printing path. Any one of these components may adjust margins, crop the image, erase edges, and such.

If, because of addition of margins, the printer refuses to print the image because it is too big, use pamcut to cut the right and bottom edges off the test pattern until it is small enough to print.

test_pattern is the number of the test pattern to generate, as follows. The default is 1.

A black on white grid ruled in numbers of pixels. A black one pixel box is at the very edges of the paper.

Before Netpbm 10.18 (August 2003), the perimeter box was not there.
A vertical line segment, one pixel wide, extending 1/2" up from the exact center of the page.
Two diagonal line segments, one starting at the upper left corner of the page, the other starting from the lower left corner of the page. Both extend 1/2" toward the center of the page at 45 degrees.


Generate an image for A4 (European) paper. Without this option, pbmpage generates an image for US standard paper (8 1/2" wide x 11" high).

See Also

pbmtoppa(1) , pamcut(1) , pbm(1)


Tim Norman. Copyright (C) 1998. Licensed under GNU Public License

Manual page by Bryan Henderson, May 2000. Contributed to the public domain by its author.

Document Source

This manual page was generated by the Netpbm tool 'makeman' from HTML source. The master documentation is at


Referenced By


Explore man page connections for pbmpage(1).