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