1EFIX(1) EFIX(1)
2
3
4
6 efix - convert between fax, text, bit-map and gray-scale formats
7
9 efix [ options ] file...
10
11
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 "-" for standard input (-O-). Default is no overlay file.
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
139 If no -n options are given, output is written to the standard output.
140
141
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
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 used to transform
163 images before combining them. For example, the commands
164 efix -d4,8 signature >sig.fax
165 efix -O sig.fax letterhead >letterhead.fax
166 efix -O letterhead.fax 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
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
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
189 efax(1), ghostscript(1), pbm(5), pgm(5).
190
191
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)