Debian Codegraph @

upstream/debian-unstable/man1/pbmtoepsi.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 "Pbmtoepsi User Manual" 1 "June 2002" "netpbm documentation"
7
8 .SH NAME
9 pbmtoepsi - convert a PBM image to an encapsulated PostScript
10 style preview bitmap
11
12 .UN synopsis
13 .SH SYNOPSIS
14
15 \fBpbmtoepsi\fP
16 [\fB-dpi=\fP\fIN\fP[\fBx\fP\fIN\fP]]
17 [\fB-bbonly\fP]
18 [\fIpbmfile\fP]
19 .PP
20 All options can be abbreviated to their shortest unique prefix.
21 You may use two hyphens instead of one. You may separate an option
22 name and its value with white space instead of an equals sign.
23
24 .UN description
25 .SH DESCRIPTION
26 .PP
27 This program is part of
28 .BR "Netpbm" (1)\c
29 \&.
30 .PP
31 Reads a PBM image as input. Produces an encapsulated Postscript
32 style bitmap as output. The output is not a stand alone postscript
33 file, it is only a preview bitmap, which can be included in an
34 encapsulated PostScript file.
35 .PP
36 \fBpbmtoepsi\fP assumes the PBM input describes a whole output
37 page, with one pixel on the page corresponding to one PBM pixel. It
38 detects white borders in the image and generates Postscript output
39 that contains a Bounding Box statement to describe the location of the
40 principal image (the image excluding the white borders) on the page
41 and thus does not include the borders in the raster part of the
42 Postscript output.
43 .PP
44 There is no \fBepsitopbm\fP tool - this transformation is one way.
45
46 .UN options
47 .SH OPTIONS
48 .PP
49 In addition to the options common to all programs based on libnetpbm
50 (most notably \fB-quiet\fP, see
51 .UR index.html#commonoptions
52 Common Options
53 .UE
54 \&), \fBpbmtoepsi\fP recognizes the following
55 command line options:
56
57
58 .TP
59 \fB-dpi=\fP\fIN\fP[\fBx\fP\fIN\fP]
60 .sp
61 This option specifies the resolution in dots per inch of the
62 ultimate output device. You must specify this because the
63 Bounding Box statement defines the bounding box in absolute
64 distances, not in pixels. \fBpbmtoepsi\fP assumes in
65 calculating the bounding box that each PBM pixel will become one
66 dot on the output device, and applies your \fBdpi\fP
67 specification to calculate the size and location on the page of
68 the bounding box.
69 .sp
70 If you specify \fIN\fP\fBx\fPN, the first number is the
71 horizontal resolution and the second number is the vertical
72 resolution. If you specify just a single number \fIN\fP, that is the
73 resolution in both directions.
74 .sp
75 The default is 72 dots per inch in both directions.
76 .sp
77 This option was new In Netpbm 10.3 (June 2002). Before that,
78 \fBpbmtoepsi\fP always assumed 72 dots per inch in both directions.
79
80 .TP
81 \fB-bbonly\fP
82 Only create a boundary box, don't fill it with the image.
83
84
85 .UN seealso
86 .SH SEE ALSO
87 .BR "pbm" (1)\c
88 \&,
89 .BR "pnmtops" (1)\c
90 \&,
91 .BR "pstopnm" (1)\c
92 \&,
93 .BR "psidtopgm" (1)\c
94 \&,
95 .BR "pbmtolps" (1)\c
96 \&,
97
98 Postscript language documentation
99
100 .UN author
101 .SH AUTHOR
102
103 Copyright (C) 1988 Jef Poskanzer, modified by Doug Crabill 1992
104 .SH DOCUMENT SOURCE
105 This manual page was generated by the Netpbm tool 'makeman' from HTML
106 source. The master documentation is at
107 .IP
108 .B http://netpbm.sourceforge.net/doc/pbmtoepsi.html
109 .PP