Penguin
Recent Changes
Annotated edit history of pnmtops(1) version 3, including all changes. View license author blame.
Rev Author # Line
1 perry 1 pnmtops
2 !!!pnmtops
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 SEE ALSO
8 AUTHOR
9 ----
10 !!NAME
11
12
2 perry 13 pnmtops - convert portable anymap to !PostScript
1 perry 14 !!SYNOPSIS
15
16
17 __pnmtops__ [[__-scale__ ''s''] [[__-dpi__
18 ''n''] [[__-imagewidth__ ''n''] [[__-imageheight__
19 ''n''] [[__-width__ ''n''] [[__-height__ ''n'']
20 [[__-equalpixels__] [[__-turn__|__-noturn__]
21 [[__-rle__|__-runlength__]
22 [[__-center__|__-nocenter__]
23 [[''pnmfile'']
24 !!DESCRIPTION
25
26
27 Reads a Netpbm image as input. Produces Encapsulated
2 perry 28 !PostScript as output.
1 perry 29
30
31 If the input file is in color (PPM), __pnmtops__
2 perry 32 generates a color !PostScript file. Some !PostScript
33 interpreters can't handle color !PostScript. If you have one
1 perry 34 of these you will need to run your image through
35 __ppmtopgm__ first.
36
37
38 If you specify no output dimensioning options, the output
39 image is dimensioned such that 72 pixels of the input image
40 generate one inch of output image. Except if that would
41 exceed the default page size (8.5 inches by 11 inches), the
42 output image is shrunk enough to fit.
43
44
45 Use __-imagewidth__, __-imageheight__,
46 __-equalpixels__, __-width__, __-height__, and
47 __-scale__ to adjust that.
48 !!OPTIONS
49
50
51 __-imagewidth__
52
53
54 __-imageheight__ Tells how wide and high you want the
55 image on the page, in inches. The aspect ratio of the image
56 is preserved, so if you specify both of these, the image on
57 the page will be the largest image that will fit within the
58 box of those dimensions.
59
60
61 If these dimensions are greater than the page size, you get
62 Postscript output that runs off the page.
63
64
65 You cannot use __imagewidth__ or __imageheight__ with
66 __-scale__ or __-equalpixels__.
67
68
69 __-equalpixels__
70
71
72 This option causes the output image to have the same number
73 of pixels as the input image. So if the output is 600 dpi
74 and your image is 3000 pixels wide, the output image would
75 be 5 inches wide.
76
77
78 You cannot use __-equalpixels__ with __-imagewidth__,
79 __-imageheight__, or __-scale__.
80
81
82 __-scale__
83
84
85 tells how big you want the image on the page. The value is
86 the number of inches of output image that you want 72 pixels
87 of the input to generate.
88
89
90 If the size so specified does not fit on the page (as
91 measured either by the __-width__ and __-height__
92 options or the default page size of 8.5 inches by 11
93 inches), __pnmtops__ ignores the __-scale__ options,
94 issues a warning, and scales the image to fit on the
95 page.
96
97
98 __-dpi__
99
100
101 This option specifies the dots per inch of your output
2 perry 102 device. The default is 300 dpi. In theory !PostScript is
1 perry 103 device-independent and you don't have to worry about this,
104 but in practice its raster rendering can have unsightly
105 bands if the device pixels and the image pixels aren't in
106 sync.
107
108
109 Also this option is crucial to the working of the
110 __equalpixels__ option.
111
112
113 __-width__
114
115
116 __-height__ These options specify the dimensions of the
117 page on which the output is to be printed. This affects the
118 size of the output image.
119
120
121 The page size has no effect, however, when you specify the
122 __-imagewidth__, __-imageheight__, or
123 __-equalpixels__ options.
124
125
126 The default is 8.5 inches by 11 inches.
127
128
129 __-turn__
130
131
132 __-noturn__ These options control whether the image gets
133 turned 90 degrees. Normally, if an image is wider than it is
134 tall, it gets turned automatically to better fit the page.
135 If you specify the __-turn__ option, __pnmtops__ turns
136 the image no matter what its shape; If you specify
137 __-noturn__, __pnmtops__ does ''not'' turn it no
138 matter what its shape.
139
140
141 __-rle__
142
143
144 __-runlength__ These identical options specify run-length
145 compression. This may save time if the host-to-printer link
146 is slow; but normally the printer's processing time
147 dominates, so __-rle__ makes things slower.
148
149
150 __-center__
151
152
153 __-nocenter__ By default, __pnmtops__ centers the
154 image on the output page. You can specify this explicitly
155 with the __-center__ option, or cause __pnmtops__ to
156 instead put the image against the upper left corner of the
157 page with the __-nocenter__ option. The latter is useful
2 perry 158 for programs which can include !PostScript files, but can't
1 perry 159 cope with pictures which are not positioned in the upper
160 left corner.
161
162
163 All options can be abbreviated to their shortest unique
164 prefix.
165 !!SEE ALSO
166
167
168 pnm(5), gs(1), psidtopgm(1),
169 pstopnm(1), pbmtolps(1), pbmtoepsi(1),
3 perry 170 pbmtopsg3(1), ppmtopgm(1),
1 perry 171 !!AUTHOR
172
173
174 Copyright (C) 1989, 1991 by Jef Poskanzer.
175 Modified November 1993 by Wolfgang Stuerzlinger,
176 wrzl@gup.uni-linz.ac.at
177 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.