1Pbmtog3 User Manual(0) Pbmtog3 User Manual(0)
2
3
4
6 pbmtog3 - convert a PBM image into a Group 3 MH fax file
7
8
10 pbmtog3 [-reversebits] [-nofixedwidth] [-align8|-align16] [pbmfile]
11
12
14 This program is part of Netpbm(1).
15
16 pbmtog3 reads a PBM image as input and produces a Group 3 MH fax file
17 as output.
18
19 You can also generate a TIFF file that uses the same encoding inside,
20 with pamtotiff.
21
22 There is no program in Netpbm that generates other fax formats, such as
23 MR and MMR, but pamtotiff can generate TIFF files that use those encod‐
24 ings.
25
26
28 -reversebits
29 This option causes the output to have the bits in every byte
30 reversed so the least significant bit becomes the most signifi‐
31 cant bit. Apparently, there is some ambiguity in transmission
32 protocols so that the bits get reversed on transmission, and
33 this compensates for that. If you get a whole bunch of "bad
34 code word" messages when you try to read the G3 file (e.g. with
35 g3topbm), try using this option. Note that the output is not G3
36 when you use this option.
37
38
39 -nofixedwidth
40 Most fax machines expect the image to be 1728 columns wide, so
41 pbmtog3 cuts the output to this width by default. If you want
42 to keep the width of the original image, use this option.
43
44 This option was new in Netpbm 10.6 (July 2002). Before that,
45 pbmtog3 always kept the width of the original image.
46
47
48 -align8
49
50 -align16
51 These options say to align output rows to 8-bit or 16-bit bound‐
52 aries, respectively, by adding padding bits in front of EOL
53 codes
54
55 Without these options, pbmtog3 adds no padding and rows may
56 begin and ends anywhere within a byte.
57
58 You cannot specify both.
59
60 These options were new in Netpbm 10.79 (June 2017).
61
62
63
64
66 g3topbm(1), pamtotiff(1), pbm(1) fax formats(1)
67
68
69
71 Before Netpbm 10.79 (June 2017), there was a different program by the
72 same name in Netpbm, which was written by Paul Haeberli <paul@man‐
73 ray.sgi.com> in 1989 and then modified extensively by others.
74
75 Akira Urushibata <afu@wta.att.ne.jp> wrote the current version, with an
76 entirely different algorithm, in April 2017 and contributed his work to
77 the public domain.
78
79 The current program is backward compatible with the pre-10.79 version.
80
82 This manual page was generated by the Netpbm tool 'makeman' from HTML
83 source. The master documentation is at
84
85 http://netpbm.sourceforge.net/doc/pbmtog3.html
86
87netpbm documentation 20 April 2017 Pbmtog3 User Manual(0)