NAME

       efix - convert between fax, text, bit-map and gray-scale formats

SYNOPSIS

       efix [ options ] file...

OPTIONS

       Where options are:

       -i f     the  input  image  is in format f. Default is to automatically determine the input type from its
                contents.

          fax   fax ("Group3") 1-D coded image

          text  text.  Line feeds separate lines, form feeds cause page breaks and tabs  are  expanded  assuming
                tabs every 8 columns.

          pbm   raw PBM (portable bit map)

          tiffg3
                TIFF format with Group 3 (fax) compression.

          tiffraw
                TIFF format with no compression.

       -o f     write the output in format f.  Default is tiffg3.

          fax   fax ("Group3") 1-D coded image

          pbm   raw PBM

          pgm   raw  PGM  (Portable  Gray  Map).   Gray-scale values are produced by summing pixels in 4x4 pixel
                blocks.  The output file is 1/4 of the size given by -p.  The resulting image  has  17  discrete
                values between 0 and 255.

          pcl   HP-PCL (e.g. HP LaserJet).

          ps    encapsulated  Postscript  (e.g.  Apple  Laserwriter).  The file is compressed using differential
                coding vertically and run-length coding horizontally.  There is no provision for positioning the
                image  within  the  page  and so the image will appear at the lower left corner of the page when
                printed.

          tiffg3
                TIFF format with Group 3 (fax) compression.

          tiffraw
                TIFF format with no compression.

       -n pat   use the printf(3) pattern path to generate the output file name.  Up to three %d escapes will be
                replaced  by  the  page  number  starting  with  1  (e.g.  -n  order.%03d will create file names
                order.001, order.002, etc.)

       -v lvl   print messages of type in string lvl.  Each  lower-case  letter  in  lvl  enables  one  type  of
                message:

                   e - errors
                   w - warnings
                   i - information messages
                   a - program arguments
                   f - file format details

                The default is "ewi".

       -f fnt   use  font file fnt for text.  The font file for an WxH font should be a bit map of an image of H
                rows and 256*W columns.  Each successive WxH cell contains the bit map for characters with codes
                from 0 to 255.  The default is to use a built-in 8x16 font.

       -s XxY   scale  the  input  by  a factor of X horizontally and Y vertically.  Scaling does not change the
                size of the output (use -p).  If Y is not specified it is assumed to be  the  same  as  X.   Any
                floating point value may be used for X and Y. The default is 1,1.

       -d R,D   displace  the  output  right  by  R  and  down by D (opposite if negative). See below for units.
                Default is 0,0.

       -p WxH   truncate or pad the output to generate an image of width W and height H.  This  does  not  scale
                the  input.   See  below  for  units.   The  default is the size of the input image if it can be
                determined or A4 (215x297mm) if it can't.

       -r XxY   assume an output device resolution of X by Y dots per inch.  If Y is not specified it is assumed
                to  be  the  same  as X.  The default is the input resolution if it can be determined or the fax
                resolution of 204.1x195.6 dpi if it can't.

       -R XxY   assume an input device resolution of X by Y dots per inch.  If Y is not specified it is  assumed
                to  be  the  same  as X.  The default is the input resolution if it can be determined or the fax
                resolution of 204.1x195.6 dpi if it can't.

       -l n     place n lines per page during text input. Default is 66.

       -O f     overlay (logical OR) the image from file f into the output.  Use "-" for standard  input  (-O-).
                Default is no overlay file.

       -M       ignore  all  other  options  and  copy  the standard input to the standard output while applying
                base64 (MIME) encoding as specified by RFC 1521.

FILES

       If no -n options are given, output is written to the standard output.

UNITS

       The units of the W, H, R, and D values above are in inches by default.  Any floating point value  may  be
       used.  Units of inches, centimetres, millimetres or points (72 per inch) can be used instead by appending
       one of the strings `in', `cm', `mm', or `pt' to the argument (e.g. -d2,4cm).

CUT AND PASTE

       The -d and -p options allow efix to cut out images  from  received  faxes  for  use  in  other  faxes  or
       documents.  The -d option specifies the top left portion of the desired image and the -p option gives the
       size of the cut image.  For example, the command
                   efix -d-5,-8 -p2,1 sample.001 >sig.001
       would cut out part of the input with its top left corner 5 inches from the left edge and  8  inches  from
       top of the input image.  The output image would be 2 inches wide and 1 inch high.

       The -O option allows efix to superimpose two or more images.  The overlay image must be in fax format and
       cannot be scaled, truncated or shifted. However, multiple efix commands may be used to  transform  images
       before combining them.  For example, the commands
                   efix -d4,8 signature >sig.fax
                   efix -O sig.fax letterhead >letterhead.fax
                   efix -O letterhead.fax letter.002 >letter.002.new
       will shift the image in the file signature down 8 inches and right 4 inches and combine (overlay) it with
       the images in the files letterhead and letter.002.

REFERENCES

       Gunter Born, "The File Formats Handbook", International Thompson Computer Press, 1995.

COPYRIGHT

       efix is copyright 1994 -- 1999 by Ed Casas.  It may be used, copied and modified under the terms  of  the
       GNU Public License.

DISCLAIMER

       Although  efix  has  been  tested  it may have errors that will prevent it from working correctly on your
       system.  Some of these errors may cause serious problems including loss of data.

SEE ALSO

       efax(1), ghostscript(1), pbm(5), pgm(5).

BUGS

       Only reads two types of TIFF compression formats.

       Does not write multi-page TIFF files (a feature).