summary refs log tree commit diff
path: root/pbmpage.html
blob: 2e9b4888e8692656162f01d5067eea1fdc13a8cd (plain) (blame)
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
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.3//EN">
<html><head><title>Pbmpage User Manual</title></head>
<body>
<h1>pbmpage</h1>
Updated: 08 June 2019
<br>
<a href="#index">Table Of Contents</a>

<h2>NAME</h2>
pbmpage - create a one page test pattern for printing

<h2 id="synopsis">SYNOPSIS</h2>

<b>pbmpage</b>
[<b>-a4</b>]
<i>test_pattern</i>

<h2 id="description">DESCRIPTION</h2>

<p>This program is part of <a href="index.html">Netpbm</a>.

<p><b>pbmpage</b> 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.

<p><b>pbmpage</b> produces an image intended for 600 dots per inch
printer resolution.

<p>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 <b>pbmtoppa</b>.

<p>
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.

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

<p><i>test_pattern </i> is the number of the test pattern to generate,
as follows.  The default is <b>1</b>.

<dl compact>
<dt><b>1</b>

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

<p>Before Netpbm 10.18 (August 2003), the perimeter box was not there.

<dt><b>2</b>

<dd>
A vertical line segment, one pixel wide, extending 1/2" up from the
exact center of the page.
<dt><b>3</b>

<dd>
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.
</dl>

<h2 id="options">OPTIONS</h2>

<p>In addition to the options common to all programs based on libnetpbm
(most notably <b>-quiet</b>, see <a href="index.html#commonoptions">
Common Options</a>), <b>pbmpage</b> recognizes the following
command line option:

<dl compact>
<dt><b>-a4</b>

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

</dl>

<h2 id="seealso">SEE ALSO</h2>

<b><a href="pbmtoppa.html">pbmtoppa</a></b>,
<b><a href="pamcut.html">pamcut</a></b>,
<b><a href="pbm.html">pbm</a></b>

<h2 id="author">AUTHOR</h2>

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

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

<hr>
<h2 id="index">Table Of Contents</h2>
<ul>
<li><a href="#synopsis">SYNOPSIS</a>
<li><a href="#description">DESCRIPTION</a>
<li><a href="#options">OPTIONS</a>
<li><a href="#seealso">SEE ALSO</a>
<li><a href="#author">AUTHOR</a>
</ul>
</body>
</html>