Provided by: efax_0.9a-21_amd64 bug

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).