Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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
		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	verti-
		cally.	 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 neg-
		ative).	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 de-
		fault  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 spec-
		ified 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 im-
       age would be 2 inches wide and 1	inch high.

       The -O option allows efix to superimpose	two or more images.  The over-
       lay  image  must	 be  in	 fax format and	cannot be scaled, truncated or
       shifted.	However, multiple efix commands	may be used to	transform  im-
       ages 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 Com-
       puter 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)

NAME | SYNOPSIS | OPTIONS | FILES | UNITS | CUT AND PASTE | REFERENCES | COPYRIGHT | DISCLAIMER | SEE ALSO | BUGS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=efix&sektion=1&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help