summaryrefslogtreecommitdiff
path: root/obsolete/dviware/dvi2xx/dvi2xx.man
blob: 11232302380d2ae50af490a6891a7fd9dafe8b77 (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
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
.TH DVILJ2 1
.ad b
.SH NAME
dvilj2, dvilj2p, dvilj, dviljp, dvi3812 \- convert dvi files to HP
LaserJet or IBM 3812 format
.SH SYNOPSIS
\f3dvi2lj\f1 [\f3-a\f2fontpath\f1] 
[\f3-b \f1] 
[\f3-c\f2copies\f1] 
[\f3-d\f2mode\f1]
[\f3-D\f1]
[\f3-E\f1] 
[\f3-e\f2output file\f1] 
[\f3-f\f2frompage\f1] 
[\f3-g\f1] 
[\f3-h\f2header file\f1] 
[\f3-l\f1] 
[\f3-M\f2flag\f1] 
[\f3-m\f2mag\f1] 
[\f3-p\f2pages\f1] 
[\f3-q\f1] 
[\f3-r\f1] 
[\f3-t\f2topage\f1] 
[\f3-s\f2pagesize\f1] 
[\f3-v\f1] 
[\f3-w\f1] 
[\f3-x\f2xoff(mm)\f1] 
[\f3-y\f2yoff(mm)\f1] 
[\f3-X\f2xoff(dots)\f1] 
[\f3-Y\f2yoff(dots)\f1] 
[\f3-z\f1] 
[\f2filename\f1]
.SH DESCRIPTION
Dvilj2 converts TeX-output .dvi files into HP PCL (i.e. HP Printer 
Control Language) commands suitable for printing on a HP LaserJet+,  
HP LaserJet II and fully compatible printers.
.br
Dvilj2p converts TeX-output .dvi files into HP PCL commands suitable
for printing on a HP LaserJet IIp, HP LaserJet III or HP Laserjet 2000
and fully compatible printers. This version uses a newer PCL command
set and provides landscape printing.
.br
Dviljp and dvilj are similar to dvilj2p and dvilj2 but they support
only 128 character fonts. They may be used for Laserjet clones which do
not support 256 character fonts.
.br
Dvilj4 is for the HP LasterJet IV printer familiy and fully compatible
clones. It implements a superset of the commands available for dvilj2p
and prints with an resolution of 600 dpi. In addition it provides support
for the printers builtin fonts using Karl Berry's coding scheme.
.br
Dvi3812 converts TeX-output .dvi files into PMP files, 
the native command language of the IBM 3812 page printer.
.br
All programs are generated from the same source dvi2xx.c.
They are usually called by a shell script or as a line printer filter.

.SH OPTIONS
.TP
\f3-a\f2fontpath\f1
directory to take fonts from (alternative to environment variable TEXPXL);
see below for details about the font directory structure
.TP
\f3-b\f1
.br
take paper for first page from alternate cassette (only 3812)
.TP
\f3-c\f2number\f1 
print each page \f2number\f1 times (including original)
.TP
\f3-d\f2number\f1 
print in duplex mode. The option -d\f21\f1 means long edge binding,
-d\f22\f1 stands for short edge binding. This option is only
selectable from \fIdvilj2p\fP, and is known to works on a LaserJet IId or a
LaserJet IIId or LaserJet IV.
.TP
\f3-D\f1
.br
Double-sided printing - see below; -D\f21\f1 prints odd sides only,
-D\f22\f1 is for even pages, a trailing \f2-\f1 suppresses printing of
empty padding pages.
.TP
\f3-E\f1
Switch printer into econo mode (dvilj4 only)
.TP
\f3-e\f2output file\f1
default output filename is the basename of dvi file and extension '.lj' 
for laserjet and '.pmp' for 3812. The '-e' option can be used to override
this default and to direct the output to a different file. 
If the output filename is set to '-` (option '-e-') the output is directed 
to stdout and can be directly piped into a spooler.
.TP
\f3-f\f2page number \f1
start printing at top of given page number
.TP
\f3-g\f1
.br
go - do not reset printer at start of job
.TP
\f3-h\f2header file\f1
headerfile to be copied before translation of dvi-file.
Used to send arbitrary commands to the laserprinter.
.TP
\f3-l\f1
.br
landscape - print output in landscape mode. This option is provided 
only for dvilj2p, dvilj4 and dvi3812.
.TP
\f3-M\f2flag\f1
Do not call MakeTeXPK. \f3-M\f21\f1 and \f3-M\f1 are equivalent,
\f3-M\f20\f1 switches to the default behavior (like no \f3-M\f1
specified). This flag is only valid if dvi2xx was compiled with
support for MakeTeXPK.
.TP
\f3-m\f2magnification\f1
Specifiy the magnification to use. The following are available:
.br
\f3-m#\f2usermag\f1  e.g. \f3#1200\f1
.br
\f3-m0\f1  equivalent to \f3-m#1000\f1
.br
\f3-mh\f1  equivalent to \f3-m#1095\f1
.br
\f3-m1\f1  equivalent to \f3-m#1200\f1
.br
\f3-mq\f1  equivalent to \f3-m#1250\f1
.br
\f3-m2\f1  equivalent to \f3-m#1440\f1
.br
\f3-m3\f1  equivalent to \f3-m#1728\f1
.br
\f3-m4\f1  equivalent to \f3-m#2074\f1
.br
\f3-m5\f1  equivalent to \f3-m#2488\f1
.TP
\f3-p\f2number of pages\f1   
print given number of pages
.TP
\f3-q\f1   
.br
quiet operation
.TP
\f3-r\f1   
.br
toggle reverse/not reverse order for output.
By default reverse=FALSE for 3812, reverse=TRUE for laserjet.
.TP
\f3-s\f2pagesize \f1
Spezify pagesize (LJ-family only!)
.br
\f3-s1\f1:  executive         (7.25in * 10.5in)
.br
\f3-s2\f1:  letter             (8.5in * 11in)
.br
\f3-s3\f1:  legal              (8.5in * 14in)
.br
\f3-s26\f1: A4                 (210mm * 297mm)
.br
\f3-s80\f1: monarch          (3.875in * 7.5in)
.br
\f3-s81\f1: commercial-10    (4.125in * 9.5in)
.br
\f3-s90\f1: international DL   (110mm * 220mm)
.br
\f3-s91\f1: international C5   (162mm * 229mm)
.br
All values are from the LJ II technical reference manual.
If the -s commandline option is omitted no clipping is performed
at the bottom of the page.
.TP
\f3-t\f2page number \f1
print to end of given page number
.TP
\f3-v\f1   
.br
verbose mode, list used fonts
.TP
\f3-w\f1   
.br
print no warnings 
.TP
\f3-x\f2offset\f1 
global x-offset in mm on output page
relative to 1 inch/1 inch origin
.TP
\f3-y\f2offset\f1 
global y-offset in mm on output page
relative to 1 inch/1 inch origin
.TP
\f3-X\f2offset\f1 
global x-offset in dots on output page 
(to set 1 inch/1 inch origin)
.TP
\f3-Y\f2offset\f1 
global y-offset in dots on output page
(to set 1 inch/1 inch origin)
.TP
\f3-z\f1   
.br
print a test page with the page counter at end of job 
(only for laserjet)
.TP
.br
If no arguments are specified a short help file is displayed.
.PP
.SH font directory structure
The specified fontpath may contain more than directory names. Under
Unix the direcory names are separated by a ':', under MSDOS by a ';'.
The paths are searched from left to right. For each directory in the 
searchpath the following font naming conventions are tried:
.br 6
-
dpi<resolution>/<fontname>.pk
(eg: ./dpi300/cmr10.pk)
.br
-
dpi<resolution>/<fontname>.pxl
(eg: ./dpi300/cmr10.pxl)
.br
-
pxl<magnification>/<fontname>.pk
(eg: ./pxl1500/cmr10.pk)
.br
-
pxl<magnification>/<fontname>.pxl
(eg:./pxl1500/cmr10.pxl)
.br
-
<fontname>.<resolution>pk
(eg: ./cmr10.300pk)
.br
-
<fontname>.<resolution>pxl
(eg: ./cmr10.300pxl)
.br
-
<fontname>.<resolution>
(eg: ./cmr10.300)
.PP
.SH \especial commands
Two TeX '\especial' commands are implemented:
.TP
\f3\especial{file=<filename>}\f1
copy specified file to the printer; either vector- or bitmap-graphics PMP 
commands (for laserjet and 3812)
.TP
\f3\especial{orientation=<value>}\f1
set page orientation to 0, 1, 2, 3;
rotate following output to landscape mode etc.
(3812 only).
.TP 0
others:
There are a few other special commands implented for the LJ-series,
which should only be used in connection with the distributed style 
files (eg graybox.sty). They are likely to be changed in forthcoming 
versions.
.PP
.SH Double Page Printing
The command line option -D causes the printer to print
in doublepage mode, that is - roughly speaking - printing first
the even pagen and then the odd pages of a document.
If -D is used to print both even and odd pages (-D is used
without the optional \f21\f1 or \f22\f1) 
the following will happen after
half of the pages is printed:
.TP 6
\f33812: \f1
the printer beeps, shows message U1. An operator
has to refill the printed pages into the paper tray and to
push the continue button on the printer.
.TP
\f3LJ:\f1
the printer stops, shows message "FEED" and switches
on manual feed led. The printer continues when either
the printed pages are fed into the manual page feeder,
or the operator pushes the continue button (after placing first
the printed pages into the paper tray).
.PP
If -D1 was specified only odd pages will be printed, -D2 can be used
for even pages. A trailing `-' (as in -D-, -D1- or -D2-) supresses
printing of empty pages which are generated for padding otherwise.
.PP
The driver allows the -D option for both print-directions (front-to-back 
or back-to-front printing). It tries to be clever in certain cases:
when a document has an odd number of pages it inserts in the
right place an empty page
when a document starts with page 0 the driver inserts an empty
page after the 0-page
when a piece of a document is printed that starts with
an even page-number it prints this page at the backside
of the first page to ensure that the odd sides are always
on the frontside. The 0-page is treated like an odd page.
.PP     
The doubleside option works for all LJs, not only for the
new D model with does doubleside-printing (actually, i don't
know wether it makes much sense on the new LJ II D at all).
.PP   
Caveat on the doubleside-option: When it is used frequently
or on very large files, it might become necessary to clean
the printer much more frequently.
.PP
The command line option -pX can be used to abort printing
after the output of X pages (can lead to strange results together
with -D). I personally dislike this option. The secure way of
printing a part of a document is using -f (from) and -t (to).
.PP
.SH ENVIRONMENT
The environment variable TEXPXL can be used to specify one or
more paths to the raster fonts (.pk, .pxl). The path separator
under Unix is ':', under MSDOS ';'. GF-fonts can be used
when the source is compiled without the preprocessor switch
USEPIXEL set.
.PP
Dvilj4 reads .tmf files and uses the contents of the 
environment variable TEXFONTS as search path.
.PP
.SH AUTHOR
Gustaf Neumann, Wirtschaftsuniversitaet Wien
.br
neumann@wu-wien.ac.at