\ .\" This man page was generated by the Netpbm tool 'makeman' from HTML source. .\" Do not hand-hack it! If you have bug fixes or improvements, please find .\" the corresponding HTML page on the Netpbm website, generate a patch .\" against that, and send it to the Netpbm maintainer. .TH "G3topbm User Manual" 0 "03 December 2008" "netpbm documentation" .SH NAME g3topbm - convert a Group 3 fax file into a PBM image .UN synopsis .SH SYNOPSIS \fBg3topbm\fP [\fB-kludge\fP] [\fB-reversebits\fP] [\fB-stretch\fP] [\fB-width=\fP\fIpixels\fP | paper_size={A3|A4|A5|A6|B4}] [\fB-stop_error\fP] [\fIg3file\fP] .PP Minimum unique abbreviation of option is acceptable. You may use double hyphens instead of single hyphen to denote options. You may use white space in place of the equals sign to separate an option name from its value. .UN description .SH DESCRIPTION .PP This program is part of .BR "Netpbm" (1)\c \&. .PP \fBg3topbm\fP reads a Group 3 fax file with MH (Modified Huffman) compression as input and produces a PBM image as output. .PP \fBg3topbm\fP tolerates various deviations from the standard, so as to recover some of the image if there was a transmission error. One thing it tolerates is lines of varying length. The standard requires all the lines to be the same length; \fBg3topbm\fP makes the output image as wide as the longest line in the input and pads the others on the right. It warns you when it does this. .PP You can use the \fBstop_error\fP option to make \fBg3topbm\fP insist on valid input. .PP There is no Netpbm program that understands the other G3 fax compression methods: MR (Modified Read) and MMR (Modified Modified Read). .PP Note that the Group 3 fax file format does not include any kind of a signature so that \fBg3topbm\fP might verify it's actually looking at a G3 file or that the compression method is MH. The program will interpret any sequence of bytes you give it as if it is G3 and, while typically issuing a lot of error messages about the file not conforming to the G3 MH format, will produce output (unless you use \fB-stoperror\fP). In particular, if you feed \fBg3topbm\fP an MR or MMR file, it will not tell you of your mistake. .PP There are subformats of TIFF that use the Group 3 fax encodings inside. See \fBtifftopnm\fP. .UN options .SH OPTIONS .TP \fB-kludge\fP Tells \fBg3topbm\fP to ignore the first few lines of the file; sometimes fax files have some junk at the beginning. .TP \fB-reversebits\fP Tells \fBg3topbm\fP to interpret bits least-significant first, instead of the default most-significant first. Apparently some fax modems do it one way and others do it the other way. If you get a whole bunch of "bad code word" messages, try using this option. .TP \fB-stretch\fP This option tells \fBg3topbm\fP to stretch the image vertically by duplicating each row. This is for the low-quality transmission mode. .TP \fB-width=\fP\fIpixels\fP This option tells \fBg3topbm\fP that the image is supposed to be \fIpixels\fP pixels wide. If any line in it is not that size, \fBg3topbm\fP issues a warning or fails, depending on whether you specify \fB-stop_error\fP. .sp You cannot specify both \fB-width\fP and \fB-paper_size\fP. .sp This option was new in Netpbm 10.33 (March 2006). .TP \fB-paper_size=\fP{\fBA3\fP,\fBA4\fP,\fBA5\fP,\fBA6\fP,\fBB4\fP} This option tells \fBg3topbm\fP for what size paper this image is supposed to be formatted. \fBg3topbm\fP uses the width of the paper the same way as with the \fB-width\fP option. \fBg3topbm\fP does not use the height of the paper for anything. .sp You cannot specify both \fB-width\fP and \fB-paper_size\fP. .sp This option was new in Netpbm 10.33 (March 2006). .TP \fB-stop_error\fP This option tells \fBg3topbm\fP to fail when it finds a problem in the input. "Fail" means it terminates with a nonzero status code with the contents of the output file undefined. .sp If you don't specify this option, \fBg3topbm\fP does its best to work around input errors and salvage as much of the image as possible in the output image. It first tries to resynchronize to a later line by searching for the next End Of Line marker, skipping any lines or partial lines in between. It saves the beginning of the line in which it encountered the problem. If the input file ends prematurely, \fBg3topbm\fP produces output containing the lines up to where it encountered the problem. .sp \fBg3topbm\fP issues warning messages when it continues in spite of input errors. .sp This option was new in Netpbm 10.24 (August 2004). Before that, \fBg3topbm\fP always failed when it encountered premature EOF and never failed when it encountered other problems. .UN seealso .SH SEE ALSO .BR "pbmtog3" (1)\c \&, .BR "tifftopnm" (1)\c \&, .BR "pbm" (5)\c \& .BR "fax formats" (1)\c \& .SH DOCUMENT SOURCE This manual page was generated by the Netpbm tool 'makeman' from HTML source. The master documentation is at .IP .B http://netpbm.sourceforge.net/doc/g3topbm.html .PP