Debian Codegraph @

upstream/debian-unstable/man1/pbmtomacp.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 "Pbmtomacp User Manual" 1 "26 April 2015" "netpbm documentation"
7
8 .SH NAME
9 pbmtomacp - convert a PBM image to a MacPaint file
10
11 .UN synopsis
12 .SH SYNOPSIS
13
14 \fBpbmtomacp\fP
15 [\fB-left\fP \fIleft\fP]
16
17 [\fB-right\fP \fIright\fP]
18
19 [\fB-top\fP \fItop\fP]
20
21 [\fB-bottom\fP \fIbottom\fP]
22
23 [\fIpbmfile\fP]
24 .PP
25 All options can be abbreviated to their shortest unique prefix.
26 You may use two hyphens instead of one to designate an option. You
27 may use either white space or equals signs between an option name and
28 its value.
29
30
31 .UN description
32 .SH DESCRIPTION
33 .PP
34 This program is part of
35 .BR "Netpbm" (1)\c
36 \&.
37 .PP
38 \fBpbmtomacp\fP reads a PBM image as input and produces a MacPaint
39 file as output.
40 .PP
41 If you do not specify \fIpbmfile\fP, \fBpbmtomacp\fP uses Standard Input.
42 .PP
43 The generated file is only the data fork of a picture. You will
44 need a program such as \fBmcvert\fP to generate a Macbinary or a
45 BinHex file that contains the necessary information to identify the
46 file as a PNTG file to MacOS.
47
48
49 .UN options
50 .SH OPTIONS
51 .PP
52 In addition to the options common to all programs based on libnetpbm
53 (most notably \fB-quiet\fP, see
54 .UR index.html#commonoptions
55 Common Options
56 .UE
57 \&), \fBpbmtomacp\fP recognizes the following
58 command line options:
59
60
61
62 .TP
63 \fB-norle\fP
64 This option tells \fBpbmtomacp\fP not to use any run length encoding
65 compression in the MacPaint image it produces. This output, while not
66 normal, conforms to MacPaint specifications and can be read by any
67 MacPaint decoder without any special settings.
68 .sp
69 The only value of this option is testing and experimentation. The option
70 causes every output image to contain exactly 53072 bytes, which is the
71 theoretical maximum size for a MacPaint image.
72 .sp
73 Without \fB-norle\fP, MacPaint compresses the image as much as possible
74 and the output size depends on the nature of the input.
75
76 .TP
77 \fB-left\fP
78 \fB-right\fP
79 \fB-top\fP
80 \fB-bottom\fP
81 These options let you define a rectangle within the image to convert. The
82 default is the whole file. If the specified image is too large for a
83 MacPaint-file, \fBpbmtomacp\fP cuts the image to fit, starting at the
84 specified top left corner.
85 .sp
86 These options exist for backward compatibility with an unfortunate original
87 design. They do the same thing that you can do in a more Netpbm-like way and
88 more flexibly by processing the input through \fBpamcut\fP.
89
90
91
92 .UN seealso
93 .SH SEE ALSO
94 .BR "macptopbm" (1)\c
95 \&,
96 .BR "ppmtopict" (1)\c
97 \&,
98 .BR "pamcut" (1)\c
99 \&,
100 .BR "pbm" (1)\c
101 \&,
102 \fBmcvert\fP documentation
103
104 .UN history
105 .SH HISTORY
106 .PP
107 \fBpbmtomacp\fP was added to Netpbm in 1988, written by Douwe van der
108 Schaaf (...!mcvax!uvapsy!vdschaaf).
109 .PP
110 In 2015, Akira Urushibata replaced the program with the current
111 version, using different logic and none of the original code. The new
112 version used the "packed PBM" facilities of the Netpbm library and the
113 shhopt method of command line parsing.
114 .SH DOCUMENT SOURCE
115 This manual page was generated by the Netpbm tool 'makeman' from HTML
116 source. The master documentation is at
117 .IP
118 .B http://netpbm.sourceforge.net/doc/pbmtomacp.html
119 .PP