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