pbm2g3 - convert portable bitmaps (PBM) into G3 fax files


SYNOPSIS

       pbm2g3  [-r]  [-w<pagewidth>]  [-h<blanklines>]  [-d] [-a]
       [pbmfile]


DESCRIPTION

       Reads a portable bitmap as input, converting it into a  G3
       fax  file  on  stdout. That file is suitable for faxing it
       with sendfax(8) or queueing it for faxing with faxspool(1)
       (provided that it gets a ``.g3'' suffix).

       faxspool(1)  uses  pbm2g3(1) internally to convert various
       bitmap formats into fax g3 format.


OPTIONS

       -a     byte-aligns  the   end-of-line   codes,   inserting
              padding bits as necessary.

       -w <page width>
              sets the width of the resulting G3 page. Default is
              1728. If you want to be able to fax it  with  send­
              fax,  don't  use  anything else. For other fax pro­
              grams, 2048, 2432, 864 and 1216 may be useful.  For
              other purposes, use what you like.

              If  you set it to 0, the width of the pbm file will
              be used.

       -h <blank lines>
              specifies the number of blank lines  pbm2g3  should
              prepend to each page. Default is 0.

              To produce identical output as pbmplus' pbm2g3 pro­
              gram (with my patch!)  does, use ``-h 4''.

       -r     reverse the bit order in the bytes.

       -d     will one day make pbm2g3 prepend a  digifax  header
              to the page.


REFERENCES

       The standard for Group 3 fax is defined in CCITT Recommen­
       dation T.4.


BUGS

       The -d option isn't implemented yet.

       If a raw pbm file is converted, and the width  of  the  g3
       file is smaller than the width of the pbm file, the former
       is rounded up to the next multiple of 8.

       g32pbm(1), pbm(5), sendfax(8)


AUTHOR

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


Man(1) output converted with man2html