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  val­
                ues between 0 and 255.

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

                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 mes­
                sage:

                   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.


       -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 reso­
                lution if it can be determined or the fax resolu­
                tion 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 reso­
                lution if it can be determined or the fax resolu­
                tion 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

       -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 stan­
       dard 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

       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 can­
       not be scaled, truncated  or  shifted.  However,  multiple
       efix  commands may be pipelined to transform images before
       combining them.  For example, the command
                   efix -d4,8 signature | \
                   efix -O- letterhead | \
                   efix -O- 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  Pub­
       lic 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).


Man(1) output converted with man2html