g32pbm

g32pbm(1)                     mgetty+sendfax manual                    g32pbm(1)



NAME
       g32pbm - convert a Group 3 fax file into a portable bitmap

SYNOPSIS
       g32pbm [-reversebits] [-stretch] [g3file]

DESCRIPTION
       Reads a Group 3 fax file (raw or digifax) as input. If no filename is
       given, stdin is used.  Produces a portable bitmap as output.

OPTIONS
       -r     Tells g32pbm to interpret bits least-significant first, instead of
              the default most-significant first ("-reversebits").  Some fax
              modems do it one way and others do it the other way. If you get a
              whole bunch of "invalid code" messages (nearly one per line), try
              using this flag.

       -s     Double each horizontal row of the fax file in the pbm file
              ("-stretch)".  You can use this to adjust the aspect ratio of a
              "normal resolution" fax file to match that of a "fine resolution"
              fax file.  This might not seem like it belongs here, but it's much
              faster than using pnmscale|pgmtopbm later.  -s is activated
              automatically if the file is specified on the command line and its
              name starts with "fn..." (fax/normal).

       -l(aserjet)
              Instead of a portable bitmap (PBM), output HP LaserJet files,
              suitable for direct printing on a HP LaserJet or DeskJet.

       -d <dpi>
              Scale output to <dpi> dots per inch before printing. Normal FAX
              resolution is 204x196 dpi (fine mode), or 204x98 dpi (normal
              mode). In LaserJet mode, only the values 75, 150 and 300 are
              allowed for <dpi>.

       -t     turn image by 90 degrees clockwise. Multiple -t commands increase
              angle, that is, -t -t will turn it upside down, and so on.

       -?     Print a short command syntax.

REFERENCES
       The standard for Group 3 fax is defined in CCITT Recommendation T.4.

BUGS
       g32pbm could be smarter about the image width, at the moment, the maximum
       width is 1728 pixels, and the maximum height is 4300 lines. Everything
       bigger is just cut off.

       Only 'raw' pbm files are created.

       Scaling is too slow.

       Turning is too slow (and not yet fully implemented either).

SEE ALSO
       pbm2g3(1), pbm(5), g3cat(1), sendfax(8), mgetty(1)

AUTHOR
       g32pbm is Copyright (C) 1993 by Gert Doering, <gert@greenie.muc.de>. It
       is similar to the g3topbm program in Jef Poskanzers pbmplus package, but
       it's a complete re-write. No code is copied.



greenie                             27 Oct 93                          g32pbm(1)