1Pbmtog3 User Manual(0)                                  Pbmtog3 User Manual(0)
2
3
4

NAME

6       pbmtog3 - convert a PBM image into a Group 3 MH fax file
7
8

SYNOPSIS

10       pbmtog3 [-reversebits] [-nofixedwidth] [-align8|-align16] [pbmfile]
11
12

DESCRIPTION

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

OPTIONS

28       In  addition  to  the options common to all programs based on libnetpbm
29       (most notably -quiet, see
30        Common Options ⟨index.html#commonoptions⟩ ),  pbmtog3  recognizes  the
31       following command line options:
32
33
34
35       -reversebits
36              This  option  causes  the  output to have the bits in every byte
37              reversed so the least significant bit becomes the most  signifi‐
38              cant  bit.   Some  fax  modems expect bits in reverse order, and
39              this compensates for that. If you get a whole bunch of "bad code
40              word"  messages  when  you  try  to  read the G3 file (e.g. with
41              g3topbm), try using this option.  Note that the output is not G3
42              when you use this option.
43
44
45       -nofixedwidth
46              Most  fax  machines expect the image to be 1728 columns wide, so
47              pbmtog3 cuts the output to this width by default.  If  you  want
48              to keep the width of the original image, use this option.
49
50              This  option  was  new in Netpbm 10.6 (July 2002).  Before that,
51              pbmtog3 always kept the width of the original image.
52
53
54       -align8
55
56       -align16
57              These options say to align output rows to 8-bit or 16-bit bound‐
58              aries,  respectively,  by  adding  padding  bits in front of EOL
59              codes
60
61              Without these options, pbmtog3 adds  no  padding  and  rows  may
62              begin and ends anywhere within a byte.
63
64              You cannot specify both.
65
66              These options were new in Netpbm 10.79 (June 2017).
67
68
69
70

SEE ALSO

72       g3topbm(1), pamtotiff(1), pbm(1), fax formats(1)
73
74

HISTORY

76       Before  Netpbm  10.79 (June 2017), there was a different program by the
77       same name in Netpbm, which was  written  by  Paul  Haeberli  <paul@man‐
78       ray.sgi.com> in 1989 and then modified extensively by others.
79
80       Akira Urushibata <afu@wta.att.ne.jp> wrote the current version, with an
81       entirely different algorithm, in April 2017 and contributed his work to
82       the public domain.
83
84       The current program is backward compatible with the pre-10.79 version.
85

DOCUMENT SOURCE

87       This  manual  page was generated by the Netpbm tool 'makeman' from HTML
88       source.  The master documentation is at
89
90              http://netpbm.sourceforge.net/doc/pbmtog3.html
91
92netpbm documentation             20 April 2017          Pbmtog3 User Manual(0)