1EFIX(1)                                                                EFIX(1)
2
3
4

NAME

6       efix - convert between fax, text, bit-map and gray-scale formats
7

SYNOPSIS

9       efix [ options ] file...
10
11

OPTIONS

13       Where options are:
14
15
16       -i f     the  input  image  is in format f. Default is to automatically
17                determine the input type from its contents.
18
19
20          fax   fax ("Group3") 1-D coded image
21
22
23          text  text.  Line feeds separate lines, form feeds cause page breaks
24                and tabs are expanded assuming tabs every 8 columns.
25
26
27          pbm   raw PBM (portable bit map)
28
29
30          tiffg3
31                TIFF format with Group 3 (fax) compression.
32
33
34          tiffraw
35                TIFF format with no compression.
36
37
38       -o f     write the output in format f.  Default is tiffg3.
39
40
41          fax   fax ("Group3") 1-D coded image
42
43
44          pbm   raw PBM
45
46
47          pgm   raw  PGM  (Portable Gray Map).  Gray-scale values are produced
48                by summing pixels in 4x4 pixel blocks.  The output file is 1/4
49                of  the size given by -p.  The resulting image has 17 discrete
50                values between 0 and 255.
51
52
53          pcl   HP-PCL (e.g. HP LaserJet).
54
55
56          ps    encapsulated Postscript (e.g. Apple Laserwriter).  The file is
57                compressed using differential coding vertically and run-length
58                coding horizontally.  There is no  provision  for  positioning
59                the  image within the page and so the image will appear at the
60                lower left corner of the page when printed.
61
62
63          tiffg3
64                TIFF format with Group 3 (fax) compression.
65
66
67          tiffraw
68                TIFF format with no compression.
69
70
71       -n pat   use the printf(3) pattern path to  generate  the  output  file
72                name.   Up  to  three  %d escapes will be replaced by the page
73                number starting with 1 (e.g. -n order.%03d  will  create  file
74                names order.001, order.002, etc.)
75
76
77       -v lvl   print  messages of type in string lvl.  Each lower-case letter
78                in lvl enables one type of message:
79
80                   e - errors
81                   w - warnings
82                   i - information messages
83                   a - program arguments
84                   f - file format details
85
86                The default is "ewi".
87
88
89       -f fnt   use font file fnt for text.  The font file  for  an  WxH  font
90                should  be  a bit map of an image of H rows and 256*W columns.
91                Each successive WxH cell contains the bit map  for  characters
92                with  codes  from  0 to 255.  The default is to use a built-in
93                8x16 font.
94
95
96       -s XxY   scale the input by a factor of X  horizontally  and  Y  verti‐
97                cally.   Scaling  does  not change the size of the output (use
98                -p).  If Y is not specified it is assumed to be the same as X.
99                Any  floating point value may be used for X and Y. The default
100                is 1,1.
101
102
103       -d R,D   displace the output right by R and down by D (opposite if neg‐
104                ative). See below for units.  Default is 0,0.
105
106
107       -p WxH   truncate or pad the output to generate an image of width W and
108                height H.  This does not  scale  the  input.   See  below  for
109                units.   The  default is the size of the input image if it can
110                be determined or A4 (215x297mm) if it can't.
111
112
113       -r XxY   assume an output device resolution of X by Y  dots  per  inch.
114                If  Y is not specified it is assumed to be the same as X.  The
115                default is the input resolution if it can be determined or the
116                fax resolution of 204.1x195.6 dpi if it can't.
117
118
119       -R XxY   assume an input device resolution of X by Y dots per inch.  If
120                Y is not specified it is assumed to be the  same  as  X.   The
121                default is the input resolution if it can be determined or the
122                fax resolution of 204.1x195.6 dpi if it can't.
123
124
125       -l n     place n lines per page during text input. Default is 66.
126
127
128       -O f     overlay (logical OR) the image from file f  into  the  output.
129                Use
130
131
132       -M       ignore  all  other  options and copy the standard input to the
133                standard output while applying base64 (MIME) encoding as spec‐
134                ified by RFC 1521.
135
136
137

FILES

139       If no -n options are given, output is written to the standard output.
140
141

UNITS

143       The  units of the W, H, R, and D values above are in inches by default.
144       Any floating point value may be used.  Units  of  inches,  centimetres,
145       millimetres  or  points  (72 per inch) can be used instead by appending
146       one of the strings `in', `cm', `mm', or  `pt'  to  the  argument  (e.g.
147       -d2,4cm).
148
149

CUT AND PASTE

151       The  -d and -p options allow efix to cut out images from received faxes
152       for use in other faxes or documents.  The -d option specifies  the  top
153       left  portion  of the desired image and the -p option gives the size of
154       the cut image.  For example, the command
155                   efix -d-5,-8 -p2,1 sample.001 >sig.001
156       would cut out part of the input with its top left corner 5 inches  from
157       the  left  edge  and  8 inches from top of the input image.  The output
158       image would be 2 inches wide and 1 inch high.
159
160       The -O option allows efix to superimpose two or more images.  The over‐
161       lay  image  must  be  in  fax format and cannot be scaled, truncated or
162       shifted. However, multiple efix commands may be pipelined to  transform
163       images before combining them.  For example, the command
164                   efix -d4,8 signature | \
165                   efix -O- letterhead | \
166                   efix -O- letter.002 >letter.002.new
167       will  shift  the  image in the file signature down 8 inches and right 4
168       inches and combine (overlay) it with the images in the files letterhead
169       and letter.002.
170
171

REFERENCES

173       Gunter  Born,  "The File Formats Handbook", International Thompson Com‐
174       puter Press, 1995.
175
176
178       efix is copyright 1994 -- 1999 by Ed Casas.  It may be used, copied and
179       modified under the terms of the GNU Public License.
180
181

DISCLAIMER

183       Although  efix  has been tested it may have errors that will prevent it
184       from working correctly on your system.  Some of these errors may  cause
185       serious problems including loss of data.
186
187

SEE ALSO

189       efax(1), ghostscript(1), pbm(5), pgm(5).
190
191

BUGS

193       Only reads two types of TIFF compression formats.
194
195       Does not write multi-page TIFF files (a feature).
196
197
198
199
2003rd Berkeley Distribution        February 1999                         EFIX(1)
Impressum