sgi2fax

SGI2FAX(1)                  General Commands Manual                 SGI2FAX(1)



NAME
       sgi2fax - convert a Silicon Graphics image file for facsimile
       transmission

SYNOPSIS
       /usr/lib/fax/sgi2fax [ options ] files...

DESCRIPTION
       sgi2fax converts Silicon Graphics format images to bilevel TIFF Class F
       images in preparation for transmission as facsimile.  sgi2fax is not
       normally invoked directly; it is usually run by sendfax(1) when an SGI
       image file is submitted for transmission.

       Images are converted by scaling them to fill the guaranteed
       reproducible area on a default page.  Each RGB pixel p is converted to
       greyscale according to:
            pr * %r + pg * %g + pb * %b
       where %r, %g, and %b default to 30, 59, and 11, respectively.
       Greyscale images are then process with a high pass filter and dithered
       to a bilevel image.  The resultant image are written as a TIFF Class F
       document.

       By default, the output image is created with 204 dots/inch horizontal
       resolution and 98 lines/inch vertical resolution.  The image is written
       as Group 3 1D-encoded data.

OPTIONS
       -1     (-2) Write the image as Group 3 1D- (2D-) encoded data.

       -b %b  Set the %b parameter used to convert color pixel values to
              greyscale pixel values.

       -g %g  Set the %g parameter used to convert color pixel values to
              greyscale pixel values.

       -l     Generate an image at 98 lines/inch vertical resolution.  know as
              low resolution.

       -m     Generate an image at 196 lines/inch vertical resolution.

       -o file
              Write output to file instead of the default file named sgi.fax.

       -r %r  Set the %r parameter used to convert color pixel values to
              greyscale pixel values.

       -s size
              Set the output size according to the named page size.  Images
              are normally created with a system-default page size (usually
              letter-size pages, 8.5" by 11", for sites in North America).
              Alternate page sizes are specified symbolically using either the
              name or abbreviation of an entry in the pagesizes(5F) database;
              e.g.  a3 (ISO A3), a4 (ISO A4), a5 (ISO A5), a6 (ISO A6), b4
              (ISO B4), na-let (North American Letter), us-leg (American
              Legal), us-led (American Ledger), us-exe (American Executive),
              jp-let (Japanese Letter), and jp-leg (Japanese Legal).
              Comparisons are case-insensitive and any match of a substring of
              the full page-size name is sufficient; e.g. ``legal'' would
              match ``American Legal''.

FILES
       /usr/lib/fax/pagesizes  page size database

SEE ALSO
       hylafax-client(1), sendfax(1), hylafax-server(5F)



                                 June 14, 1994                      SGI2FAX(1)