summaryrefslogtreecommitdiffstats
path: root/upstream/mageia-cauldron/man1/pbmpage.1
blob: 7a7f26f5ca247b79c764d8e214d028f4a46651be (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
\
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Pbmpage User Manual" 0 "08 June 2019" "netpbm documentation"

.SH NAME
pbmpage - create a one page test pattern for printing

.UN synopsis
.SH SYNOPSIS

\fBpbmpage\fP
[\fB-a4\fP]
\fItest_pattern\fP

.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR "Netpbm" (1)\c
\&.
.PP
\fBpbmpage\fP 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.
.PP
\fBpbmpage\fP produces an image intended for 600 dots per inch
printer resolution.
.PP
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 \fBpbmtoppa\fP.
.PP
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.
.PP
If, because of addition of margins, the printer refuses to print the
image because it is too big, use \fBpamcut\fP to cut the right and
bottom edges off the test pattern until it is small enough to print.
.PP
\fItest_pattern \fP is the number of the test pattern to generate,
as follows.  The default is \fB1\fP.


.TP
\fB1\fP
A black on white grid ruled in numbers of pixels.  A black one pixel box
is at the very edges of the paper.
.sp
Before Netpbm 10.18 (August 2003), the perimeter box was not there.

.TP
\fB2\fP
A vertical line segment, one pixel wide, extending 1/2" up from the
exact center of the page.
.TP
\fB3\fP
Two diagonal line segments, one starting at the upper left corner of the
page, the other starting from the lower right corner of the page.  Both
extend 1/2" toward the center of the page at 45 degrees.


.UN options
.SH OPTIONS
.PP
In addition to the options common to all programs based on libnetpbm
(most notably \fB-quiet\fP, see 
.UR index.html#commonoptions
 Common Options
.UE
\&), \fBpbmpage\fP recognizes the following
command line option:


.TP
\fB-a4\fP
Generate an image for A4 (European) paper.  Without this option,
\fBpbmpage\fP generates an image for US standard paper (8 1/2"
wide x 11" high).



.UN seealso
.SH SEE ALSO
.BR "pbmtoppa" (1)\c
\&,
.BR "pamcut" (1)\c
\&,
.BR "pbm" (1)\c
\&

.UN author
.SH AUTHOR

Tim Norman.  Copyright (C) 1998.  Licensed under GNU Public License
.PP
Manual page by Bryan Henderson, May 2000.  Contributed to the public
domain by its author.
.SH DOCUMENT SOURCE
This manual page was generated by the Netpbm tool 'makeman' from HTML
source.  The master documentation is at
.IP
.B http://netpbm.sourceforge.net/doc/pbmpage.html
.PP