EFIX(1) 																   EFIX(1)

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 cod-
		ing  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 suc-
		cessive 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

       -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, centime-
       tres, 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 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  letter-
       head 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).

3rd Berkeley Distribution					   February 1999							   EFIX(1)