g3toxwd
g3toxwd(d)            mgetty+sendfax manual            g3toxwd(d)



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 synchro-
              nisation.

       -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(3), pbm(m), g3cat(t), sendfax(x), mgetty(y)

AUTHOR
       g3toxwd  is  Copyright  (C)  1994  by  Chel  van   Gennip,
       <chel@vangennip.nl>.  Sources of g3topbm and pbmtoxwd pro-
       grams 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 mem-
       ory, fast scaling.



Chel                        22 may 94                  g3toxwd(d)