1G3topbm User Manual(0) G3topbm User Manual(0)
2
3
4
6 g3topbm - convert a Group 3 fax file into a PBM image
7
8
10 g3topbm [-kludge] [-reversebits] [-stretch] [-width=pixels |
11 paper_size={A3|A4|A5|A6|B4}] [-stop_error] [g3file]
12
13 Minimum unique abbreviation of option is acceptable. You may use dou‐
14 ble hyphens instead of single hyphen to denote options. You may use
15 white space in place of the equals sign to separate an option name from
16 its value.
17
18
20 This program is part of Netpbm(1).
21
22 g3topbm reads a Group 3 fax file with MH (Modified Huffman) compression
23 as input and produces a PBM image as output.
24
25 g3topbm tolerates various deviations from the standard, so as to
26 recover some of the image if there was a transmission error. One thing
27 it tolerates is lines of varying length. The standard requires all the
28 lines to be the same length; g3topbm makes the output image as wide as
29 the longest line in the input and pads the others on the right. It
30 warns you when it does this.
31
32 You can use the stop_error option to make g3topbm insist on valid
33 input.
34
35 There is no Netpbm program that understands the other G3 fax compres‐
36 sion methods: MR (Modified Read) and MMR (Modified Modified Read).
37
38 Note that the Group 3 fax file format does not include any kind of a
39 signature so that g3topbm might verify it's actually looking at a G3
40 file or that the compression method is MH. The program will interpret
41 any sequence of bytes you give it as if it is G3 and, while typically
42 issuing a lot of error messages about the file not conforming to the G3
43 MH format, will produce output (unless you use -stoperror). In partic‐
44 ular, if you feed g3topbm an MR or MMR file, it will not tell you of
45 your mistake.
46
47 There are subformats of TIFF that use the Group 3 fax encodings inside.
48 See tifftopnm.
49
50
51
53 In addition to the options common to all programs based on libnetpbm
54 (most notably -quiet, see
55 Common Options ⟨index.html#commonoptions⟩ ), g3topbm recognizes the
56 following command line options:
57
58
59
60 -kludge
61 Tells g3topbm to ignore the first few lines of the file; some‐
62 times fax files have some junk at the beginning.
63
64
65 -reversebits
66 Tells g3topbm to interpret bits least-significant first, instead
67 of the default most-significant first. Apparently some fax
68 modems do it one way and others do it the other way. If you get
69 a whole bunch of "bad code word" messages, try using this
70 option.
71
72
73 -stretch
74 This option tells g3topbm to stretch the image vertically by
75 duplicating each row. This is for the low-quality transmission
76 mode.
77
78
79 -width=pixels
80 This option tells g3topbm that the image is supposed to be pix‐
81 els pixels wide. If any line in it is not that size, g3topbm
82 issues a warning or fails, depending on whether you specify
83 -stop_error.
84
85 You cannot specify both -width and -paper_size.
86
87 This option was new in Netpbm 10.33 (March 2006).
88
89
90 -paper_size={A3,A4,A5,A6,B4}
91 This option tells g3topbm for what size paper this image is sup‐
92 posed to be formatted. g3topbm uses the width of the paper the
93 same way as with the -width option. g3topbm does not use the
94 height of the paper for anything.
95
96 You cannot specify both -width and -paper_size.
97
98 This option was new in Netpbm 10.33 (March 2006).
99
100
101 -stop_error
102 This option tells g3topbm to fail when it finds a problem in the
103 input. "Fail" means it terminates with a nonzero status code
104 with the contents of the output file undefined.
105
106 If you don't specify this option, g3topbm does its best to work
107 around input errors and salvage as much of the image as possible
108 in the output image. It first tries to resynchronize to a later
109 line by searching for the next End Of Line marker, skipping any
110 lines or partial lines in between. It saves the beginning of
111 the line in which it encountered the problem. If the input file
112 ends prematurely, g3topbm produces output containing the lines
113 up to where it encountered the problem.
114
115 g3topbm issues warning messages when it continues in spite of
116 input errors.
117
118 This option was new in Netpbm 10.24 (August 2004). Before that,
119 g3topbm always failed when it encountered premature EOF and
120 never failed when it encountered other problems.
121
122
123
124
125
127 pbmtog3(1), tifftopnm(1), pbm(1), fax formats(1)
128
130 This manual page was generated by the Netpbm tool 'makeman' from HTML
131 source. The master documentation is at
132
133 http://netpbm.sourceforge.net/doc/g3topbm.html
134
135netpbm documentation 03 December 2008 G3topbm User Manual(0)