summaryrefslogtreecommitdiff
path: root/support/tek2eepic/tek2eepic.l
blob: 02c48e14acc65c9f429d0f91227fe11e0613aeee (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
.TH TEK2EEPIC 1 "25 Feb 1989"
.SH NAME
tek2eepic \- Tektronix 4015 to EEPIC converter
.SH SYNOPSIS
.B tek2eepic
[
.B \-i
] [
.B \-n
.I penthickness
] [
.B \-o
.I tex-file
] [
.B \-w
.I width
] [
.B \-h
.I height
] [
.I tek-file
]
.SH DESCRIPTION
.I Tek2eepic
converts Tektronix 4015 graphics sequences into EEPIC for inclusion in
LaTeX documents to be printed on an IMAGEN laser printer. Currently,
alphanumerics are not supported.
.I Tek2eepic
is based upon the Tektronix to PostScript converter 
.I Tek2ps
written by Edward Moy of UC Berkley.
.PP
EEPIC is an extension to EPIC and LaTeX picture drawing
environment. It was written by Conrad Kwok of Division of
Computer Science at University of California, Davis.
EPIC is an enhancement to LaTeX picture drawing environment.
It was developed by Sunil Podar of Department of Computer Science
in S.U.N.Y at Stony Brook.
EEPIC and EPIC can be ftp'd from sun.soe.clarkson.edu. They reside in
the directory pub/latex-styles.
.PP
In order to include EPIC or EEPIC pictures into a document, it is
necssary to load the EPIC and EEPIC macros. It can be done by
including \fBEPIC\fR and \fBEEPIC\fR in \fB\\documentstyle\fR
option. See the EPIC or EEPIC manaul for details.
.PP
If
.I tek-file 
is not specified,
.I tek2eepic
reads its standard input.
The output of
.I tek2eepic
is sent to the standard output, so that it can be redirected to a file.
If the -o option is used, output is directed to the specified 
.I tex-file.
.PP
The
.B \-w
and
.B \-h
options specify the size of the drawing space, in inches.
If only one of these is specified, the other is adjusted to preserve the
correct aspect ratio.
By specifying both
.I width
and 
.I height,
the aspect ratio can be changed
arbitrarily. By default, the drawing space is 6.5 inches horizontally
and 4.9 inches vertically. The actual plot may occupy only a fraction of
the drawing space. Therefore, some manual tweaking of the 
.I xsize
and 
.I ysize 
of the picture may be required in the output produced by tek2eepic.
To aid the manual adjustment, the actual 
.I xsize
and
.I ysize,
and the suggested
.I xpos
and 
.I ypos
of the picture are printed immediately following
.I end{picture}.
.PP
The
.B \-n
option specifies a factor by which to scale width of the pen used to
draw the plot. By default this value is 1.0, which corresponds to a
line 1 point wide.  (The 'n' stands for the pen's nib, by the way.)
.PP
Normally, the PAGE escape sequence causes the page to be erased, i.e.,
a new picture is started in the output.
If the
.B \-p
option is specified,
.I tek2eepic
continues plotting the picture without any
.I end{picture}
and 
.I begin{picture}
commands.
.PP
Certain programs that output Tektronix codes often clear the screen before
drawing anything. Use the
.B \-i
option to ignore the first PAGE escape sequence found in the input file.
.PP
A Huge model of 
.I TeX/LaTeX
may be required for processing the EEPIC code generated by 
.I tek2eepic. 
The parameters
.I Mem_max,
.I mem_top,
and 
.I max_halfword
in 
.I tex.web 
should be adjusted and 
.I initex, virtex, tex,
and 
.I latex
should be remade in order to compile a Huge version.
The following values were found to be suitable at University of Cincinnati:
.I mem_max=330000,
.I mem_top=330000,
and
.I max_halfword=330001.
Moreover, the type-definition of
.I halfword 
should be changed from 
.I unsigned short
to
.I unsigned long
in the file
.I ctex/tex.h.
More details about these parameters may be found in 
.I TeX: The Program, Computers & Typesetting 
/
.I B.
.PP
.SH "SEE ALSO"
tek2ps(1), tex(1), latex(1). 
.PP
EEPIC: Extensions to EPIC and LaTeX Picture Environment, Conrad Kwok,
Department of Electrical Engineering and Computer Science, University of
California, Davis, August 1988.
.PP
TeX: The Program, Computers & Typesetting / B, Donald E. Knuth, Addison
Wesley, 1986.
.PP
.SH AUTHOR
Atul K. Chhabra, Dept. of Electrical Engineering, Univeristy of Cincinnati,
Cincinnati, OH 45221.
Tek2ps was written by Edward Moy, UC Berkley.