Debian Codegraph @

texmf-dist/doc/latex/eepic/fig2eepic/fig2epic.1

raw
1 .TH FIG2EPIC 1 "23 August 1988"
2 .SH NAME
3 fig2epic \- translates Fig intermediate code into EPIC or EEPIC macros
4 .SH SYNOPSIS
5 .B fig2epic
6 [
7 .B \-S
8 .I scale
9 ] [
10 .B \-s
11 .I size
12 ] [
13 .B \-m
14 .I mag
15 ] [
16 .B \-F
17 .I fspec
18 ] [
19 .B \-L
20 .I lang
21 ] [
22 .B \-l
23 .I lwidth
24 ] [
25 .B \-c
26 .I cfg-file
27 ] [
28 .B \-v
29 ] [
30 \fIfig-file\fR [ \fItex-file\fR ] ]
31 .SH DESCRIPTION
32 .I Fig2epic
33 translates fig objects in the named
34 .I fig-file
35 into EPIC or EEPIC macros and puts them in
36 .I tex-file.
37 If a file name is presented, it is assumed to be the input file (fig
38 output file). The output file
39 .I (tex-file),
40 if not presented, will be the stdout.
41 If the
42 .I fig-file
43 is not presented, input will be assumed to come from the stdin.
44 The output from fig2epic can be edited to change font sizes/types.
45 .LP
46 Fig (Facility for Interactive Generation of figures) is a screen-oriented
47 tool which allows the user to draw and manipulate objects interactively.
48 It runs under the Suntools/Sunview window environment.
49 Fig2epic is compatible with Fig versions 1.3 and 1.4.
50 .LP
51 EPIC is an enhancement to LaTeX picture drawing environment.
52 It was developed by Sunil Podar of Department of Computer Science
53 in S.U.N.Y at Stony Brook.
54 .LP
55 EEPIC is an extension to EPIC and LaTeX picture drawing
56 environment. It was written by Conrad Kwok of Division of
57 Computer Science at University of California, Davis.
58 .SH OPTIONS
59 .TP
60 .B \-S
61 Set the scale at which the figure is rendered to. This option
62 automatically set the magnification and default font to
63 .I scale
64 / 12 and
65 .I scale
66 -tt respectively. The font can be changed using \-F option.
67 The default is 12 and other valid options are 8, 9, 10 and 11.
68 .TP
69 .B \-s
70 Change the default font size to
71 .I size
72 .TP
73 .B \-m
74 Set the magnification at which the figure is rendered to
75 .I mag.
76 The default is 1.0 unless \-s option is used.
77 .TP
78 .B \-c
79 Use
80 .I cfg-file
81 as the configuration file.
82 .TP
83 .B \-F
84 Set the font specification command which precedes every text object in the
85 picture to
86 .I fspec.
87 This option, if specified, overrides any font changing commands.
88 The default is none.
89 Note that no "\\" is required in the font name.
90 .TP
91 .B \-l
92 Use "\fB\\thicklines\fR" when width of the line is wider than
93 .I lwidth.
94 The default is 2.
95 .TP
96 .B \-L
97 Use the specified language
98 .I lang
99 in the output. Default is EEPIC. Other valid options are EPIC and
100 EEPIC-EMU. EEPIC-EMU is for use with EEPIC emulation package.
101 .TP
102 .B \-v
103 Include comment in the output file.
104
105 .SH LATEX MACROS
106 In order to include EPIC or EEPIC pictures into a document, it is
107 necssary to load the EPIC and EEPIC macros. It can be done by
108 including \fBEPIC\fR and \fBEEPIC\fR in \fB\\documentstyle\fR
109 option. See the EPIC or EEPIC manaul for details.
110
111 .SH Configuration File
112 All the defaults in fig2epic can be changed using configuration
113 file. When fig2pic is executed, it will look for the files
114 specified in \-c option if any,
115 .I fig-file.cfg
116 (if
117 .I fig-file
118 is ended with ".fig", it will be replaced by ".cfg"), fig2epic.cfg
119 and $HOME/.fig2epic in the order specified above. The first
120 configuration file found will be used.
121
122 .TP
123 .I LowerLeftX
124 This specify X coordinate of the lower left hand corner of the Fig
125 picture. Default is 0.
126 .TP
127 .I LowerLeftY
128 This specify Y coordinate of the lower left hand corner in unitlength of the Fig
129 picture. Default is 0.
130 .TP
131 .I TopMargin
132 Set the distance in unitlength of the figure from the top of the
133 LaTeX picture box. Default is 5.
134 .TP
135 .I BottomMargin
136 Set the distance in unitlength of the figure from the bottom of the
137 LaTeX picture box. Default is 10.
138 .TP
139 .I SegmentLength
140 The maximum segment length in inch used in generating splines
141 (for EPIC) and arc (for EPIC and EEPIC-EMU). Default is 0.0625
142 inch.
143 .TP
144 .I TextFont
145 Set the font used for all text. This option overrides FontType
146 and FontSize. However, it is overrided by \-s, -S and -F options.
147 Note that no "\\" is required in the font name.
148 .TP
149 .I Magnification
150 Same as \-m option. Default is 1.0.
151 .TP
152 .I Verbose
153 Same as \-v. Default is FALSE
154 .TP
155 .I DotDistance
156 Dot distance in unitlength for dotted lines.
157 .TP
158 .I LineThick
159 Same as \-l. Default is 2.
160 .TP
161 .I Language
162 Same is -L. Default is EEPIC
163 .TP
164 .I DashScale
165 Scale the dash length. Default is 1.0.
166 .TP
167 .I EllipseCommand
168 Specify the command used in drawing an ellipse. Default is
169 ellipse for EEPIC or EEPIC-EMU. oval is always used for EPIC. Possible
170 values are ellipse and oval.
171 .TP
172 .I UseBox
173 Specify whether fig2epic should generate \\framebox and/or
174 \\dashbox command
175 in the output file or not. Default is not to use the *box
176 command. Possible options are none, solid, dash and both.
177 .TP
178 .I DashType
179 This option is only used when EPIC option is selected. Valid options
180 are "Normal" (use dashline in drawing dash lines), "Economic"
181 (use drawline with -50 stretch in drawing dash lines) and
182 "Dotted" (use dotted lines to replace dash lines). Default is
183 "Normal". "Normal" option will use up TeX memory quickly if long
184 dash lines are drawn. If you get "TeX Capacity Exceed" error, you should
185 try the "Economic" or "Dotted" option.
186 .TP
187 .I FontType
188 Selects one of the following font types as the default--Roman,
189 Bold, Italics, Modern and Typewriter. Default is Typewriter.
190 .TP
191 .I FontSize
192 Selects default font size in points. Default is 12.
193
194 .SH "SEE ALSO"
195 fig(1),
196 EPIC manual,
197 EEPIC manual and TransFig manual
198 .SH AUTHOR
199 Conrad Kwok ([email protected])
200 .br
201 University of California, Davis
202 .br
203 August 14, 1988
204 .sp
205 modified from fig2latex, fig2tex and f2p.