| 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 "Pbmtog3 User Manual" 1 "20 April 2017" "netpbm documentation" |
| 7 |
|
| 8 |
.SH NAME |
| 9 |
pbmtog3 - convert a PBM image into a Group 3 MH fax file |
| 10 |
|
| 11 |
.UN synopsis |
| 12 |
.SH SYNOPSIS |
| 13 |
|
| 14 |
\fBpbmtog3\fP |
| 15 |
[\fB-reversebits\fP] |
| 16 |
[\fB-nofixedwidth\fP] |
| 17 |
[\fB-align8\fP|\fB-align16\fP] |
| 18 |
[\fIpbmfile\fP] |
| 19 |
|
| 20 |
.UN description |
| 21 |
.SH DESCRIPTION |
| 22 |
.PP |
| 23 |
This program is part of |
| 24 |
.BR "Netpbm" (1)\c |
| 25 |
\&. |
| 26 |
.PP |
| 27 |
\fBpbmtog3\fP reads a PBM image as input and produces a Group 3 MH fax |
| 28 |
file as output. |
| 29 |
.PP |
| 30 |
You can also generate a TIFF file that uses the same encoding |
| 31 |
inside, with \fBpamtotiff\fP. |
| 32 |
.PP |
| 33 |
There is no program in Netpbm that generates other fax formats, |
| 34 |
such as MR and MMR, but \fBpamtotiff\fP can generate TIFF files that |
| 35 |
use those encodings. |
| 36 |
|
| 37 |
.UN options |
| 38 |
.SH OPTIONS |
| 39 |
.PP |
| 40 |
In addition to the options common to all programs based on libnetpbm |
| 41 |
(most notably \fB-quiet\fP, see |
| 42 |
.UR index.html#commonoptions |
| 43 |
Common Options |
| 44 |
.UE |
| 45 |
\&), \fBpbmtog3\fP recognizes the following |
| 46 |
command line options: |
| 47 |
|
| 48 |
|
| 49 |
.TP |
| 50 |
\fB-reversebits\fP |
| 51 |
This option causes the output to have the bits in every byte |
| 52 |
reversed so the least significant bit becomes the most significant bit. |
| 53 |
Some fax modems expect bits in reverse order, and this compensates for |
| 54 |
that. If you get a whole bunch of "bad code word" messages when you try |
| 55 |
to read the G3 file (e.g. with \fBg3topbm\fP), try using this option. |
| 56 |
Note that the output is not G3 when you use this option. |
| 57 |
|
| 58 |
.TP |
| 59 |
\fB-nofixedwidth\fP |
| 60 |
Most fax machines expect the image to be 1728 columns wide, so |
| 61 |
\fBpbmtog3\fP cuts the output to this width by default. If you want to |
| 62 |
keep the width of the original image, use this option. |
| 63 |
.sp |
| 64 |
This option was new in Netpbm 10.6 (July 2002). Before that, |
| 65 |
\fBpbmtog3\fP always kept the width of the original image. |
| 66 |
|
| 67 |
.TP |
| 68 |
\fB-align8\fP |
| 69 |
.TP |
| 70 |
\fB-align16\fP |
| 71 |
These options say to align output rows to 8-bit or 16-bit boundaries, |
| 72 |
respectively, by adding padding bits in front of EOL codes |
| 73 |
.sp |
| 74 |
Without these options, \fBpbmtog3\fP adds no padding and rows may begin |
| 75 |
and ends anywhere within a byte. |
| 76 |
.sp |
| 77 |
You cannot specify both. |
| 78 |
.sp |
| 79 |
These options were new in Netpbm 10.79 (June 2017). |
| 80 |
|
| 81 |
|
| 82 |
|
| 83 |
.UN seealso |
| 84 |
.SH SEE ALSO |
| 85 |
.BR "g3topbm" (1)\c |
| 86 |
\&, |
| 87 |
.BR "pamtotiff" (1)\c |
| 88 |
\&, |
| 89 |
.BR "pbm" (1)\c |
| 90 |
\&, |
| 91 |
.BR "fax formats" (1)\c |
| 92 |
\& |
| 93 |
|
| 94 |
.UN history |
| 95 |
.SH HISTORY |
| 96 |
.PP |
| 97 |
Before Netpbm 10.79 (June 2017), there was a different program by the same |
| 98 |
name in Netpbm, which was written by by Paul Haeberli |
| 99 |
<\[email protected]\fP> in 1989 |
| 100 |
and then modified extensively by others. |
| 101 |
.PP |
| 102 |
Akira Urushibata <[email protected]> wrote the current version, with |
| 103 |
an entirely different algorithm, in April 2017 and contributed his work to the |
| 104 |
public domain. |
| 105 |
.PP |
| 106 |
The current program is backward compatible with the pre-10.79 version. |
| 107 |
.SH DOCUMENT SOURCE |
| 108 |
This manual page was generated by the Netpbm tool 'makeman' from HTML |
| 109 |
source. The master documentation is at |
| 110 |
.IP |
| 111 |
.B http://netpbm.sourceforge.net/doc/pbmtog3.html |
| 112 |
.PP |