Debian Codegraph @

upstream/debian-unstable/man1/pbmpage.1

raw
1 \
2 .\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
3 .\" Do not hand-hack it! If you have bug fixes or improvements, please find
4 .\" the corresponding HTML page on the Netpbm website, generate a patch
5 .\" against that, and send it to the Netpbm maintainer.
6 .TH "Pbmpage User Manual" 1 "08 June 2019" "netpbm documentation"
7
8 .SH NAME
9 pbmpage - create a one page test pattern for printing
10
11 .UN synopsis
12 .SH SYNOPSIS
13
14 \fBpbmpage\fP
15 [\fB-a4\fP]
16 \fItest_pattern\fP
17
18 .UN description
19 .SH DESCRIPTION
20 .PP
21 This program is part of
22 .BR "Netpbm" (1)\c
23 \&.
24 .PP
25 \fBpbmpage\fP generates a one page test pattern to print on a
26 sheet of paper, for use in calibrating a printer. The test pattern in
27 is PBM format.
28 .PP
29 \fBpbmpage\fP produces an image intended for 600 dots per inch
30 printer resolution.
31 .PP
32 If you are printing on an HP PPA printer, you can convert the
33 output of this program to a stream that you can feed to the printer
34 with \fBpbmtoppa\fP.
35 .PP
36 Bear in mind that when you print the test pattern, you are testing not
37 only the printer, but any converter or driver software along the
38 printing path. Any one of these components may adjust margins, crop
39 the image, erase edges, and such.
40 .PP
41 If, because of addition of margins, the printer refuses to print the
42 image because it is too big, use \fBpamcut\fP to cut the right and
43 bottom edges off the test pattern until it is small enough to print.
44 .PP
45 \fItest_pattern \fP is the number of the test pattern to generate,
46 as follows. The default is \fB1\fP.
47
48
49 .TP
50 \fB1\fP
51 A black on white grid ruled in numbers of pixels. A black one pixel box
52 is at the very edges of the paper.
53 .sp
54 Before Netpbm 10.18 (August 2003), the perimeter box was not there.
55
56 .TP
57 \fB2\fP
58 A vertical line segment, one pixel wide, extending 1/2" up from the
59 exact center of the page.
60 .TP
61 \fB3\fP
62 Two diagonal line segments, one starting at the upper left corner of the
63 page, the other starting from the lower right corner of the page. Both
64 extend 1/2" toward the center of the page at 45 degrees.
65
66
67 .UN options
68 .SH OPTIONS
69 .PP
70 In addition to the options common to all programs based on libnetpbm
71 (most notably \fB-quiet\fP, see
72 .UR index.html#commonoptions
73 Common Options
74 .UE
75 \&), \fBpbmpage\fP recognizes the following
76 command line option:
77
78
79 .TP
80 \fB-a4\fP
81 Generate an image for A4 (European) paper. Without this option,
82 \fBpbmpage\fP generates an image for US standard paper (8 1/2"
83 wide x 11" high).
84
85
86
87 .UN seealso
88 .SH SEE ALSO
89 .BR "pbmtoppa" (1)\c
90 \&,
91 .BR "pamcut" (1)\c
92 \&,
93 .BR "pbm" (1)\c
94 \&
95
96 .UN author
97 .SH AUTHOR
98
99 Tim Norman. Copyright (C) 1998. Licensed under GNU General Public License
100 .PP
101 Manual page by Bryan Henderson, May 2000. Contributed to the public
102 domain by its author.
103 .SH DOCUMENT SOURCE
104 This manual page was generated by the Netpbm tool 'makeman' from HTML
105 source. The master documentation is at
106 .IP
107 .B http://netpbm.sourceforge.net/doc/pbmpage.html
108 .PP