NAME

       g3toxwd - converts a Group 3 fax file into a displayable xwd file

SYNOPSIS

       g3toxwd  [-kludge]  [-reversebits]  [-scale N]  [-aspect N]  [-skiprows N] [-name xwdname]
       [g3file]

DESCRIPTION

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

OPTIONS

       -kludge
              Tells g3toxwd to skip the first lines for synchronisation.

       -reversebits
              Tells  g3toxwd  to  interpret  bits least-significant first, instead of the default
              most-significant first.  Apparently some fax modems do it one way and others do  it
              the other way.  If you get a whole bunch of "invalid code" messages, try using this
              flag.

       -scale N
              Scale the output to match the printer resolution and paper  size,  the  default  of
              0.58 will do in most cases.

       -aspect N
              Scale the output to match the printer resolution and paper size, the default of 1.0
              will do for high resolution faxes, 2.0 will do for low resolution faxes.

       -skiprows N
              N faxrows of the input file will be skipped.

       -name <name>
              The name <name> will be put in the output file for xwd.

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

BUGS

       Long fax files are not handled properly.  Output size fixed 1000x1350  pixels  defined  at
       compile time.  Please report bugs to chel@vangennip.nl

SEE ALSO

       pbmtog3(1), pbm(5), g3cat(1), sendfax(8), mgetty(1)

AUTHOR

       g3toxwd  is Copyright (C) 1994 by Chel van Gennip, <chel@vangennip.nl>. Sources of g3topbm
       and pbmtoxwd programs in Jef Poskanzers pbmplus package have been used, but al lot of code
       has  been  changed or added to simplify its use for displaying faxes. Value added: low use
       of memory, fast scaling.