summaryrefslogtreecommitdiff
path: root/obsolete/dviware/dvi2xx/dvi2xx.txt
blob: 18cf56aa3b40c93f985ab3340f2883941a76a31b (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
322
323
324
325
326
327
328
329
330



DVILJ2(1)						DVILJ2(1)


NAME
       dvilj2,	dvilj2p,  dvilj,  dviljp,  dvi3812  - convert dvi
       files to HP LaserJet or IBM 3812 format

SYNOPSIS
       dvi2lj [-afontpath] [-b ] [-ccopies]  [-dmode]  [-D]  [-E]
       [-eoutput  file]	[-ffrompage]  [-g]  [-hheader file] [-l]
       [-Mflag] [-mmag] [-ppages] [-q] [-r]  [-ttopage]	[-spage-
       size]  [-v]  [-w] [-xxoff(mm)] [-yyoff(mm)] [-Xxoff(dots)]
       [-Yyoff(dots)] [-z] [filename]

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.
       Dvilj2p	converts  TeX-output  .dvi files into HP PCL com-
       mands 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.
       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.
       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  resolu-
       tion  of	600 dpi. In addition it provides support for the
       printers builtin fonts using Karl Berry's coding scheme.
       Dvi3812 converts TeX-output .dvi files into PMP files, the
       native command language of the IBM 3812 page printer.
       All  programs are generated from the same source dvi2xx.c.
       They are usually called by a shell script  or  as  a  line
       printer filter.


OPTIONS
       -afontpath
	      directory	to take fonts from (alternative to envi-
	      ronment variable TEXPXL);	see  below  for  details
	      about the font directory structure

       -b
	      take  paper  for first page from alternate cassette
	      (only 3812)

       -cnumber
	      print each page number times (including original)

       -dnumber
	      print in duplex mode. The	option	-d1  means  long
	      edge  binding,  -d2  stands for short edge binding.
	      This option is only selectable from dvilj2p, and is



								1





DVILJ2(1)						DVILJ2(1)


	      known to works on a LaserJet IId or a LaserJet IIId
	      or LaserJet IV.

       -D
	      Double-sided printing - see below; -D1  prints  odd
	      sides  only,  -D2	is  for even pages, a trailing -
	      suppresses printing of empty padding pages.

       -E     Switch printer into econo mode (dvilj4 only)

       -eoutput file
	      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.

       -fpage number
	      start printing at top of given page number

       -g
	      go - do not reset printer at start of job

       -hheader file
	      headerfile to be copied before translation of  dvi-
	      file.   Used  to	send  arbitrary	commands  to the
	      laserprinter.

       -l
	      landscape - print output in  landscape  mode.  This
	      option  is  provided  only  for dvilj2p, dvilj4 and
	      dvi3812.

       -Mflag Do not call MakeTeXPK. -M1 and -M	are  equivalent,
	      -M0  switches  to	the default behavior (like no -M
	      specified). This flag is only valid if  dvi2xx  was
	      compiled with support for MakeTeXPK.

       -mmagnification
	      Specifiy	the  magnification  to use. The following
	      are available:
	      -m#usermag  e.g. #1200
	      -m0  equivalent to -m#1000
	      -mh  equivalent to -m#1095
	      -m1  equivalent to -m#1200
	      -mq  equivalent to -m#1250
	      -m2  equivalent to -m#1440
	      -m3  equivalent to -m#1728
	      -m4  equivalent to -m#2074
	      -m5  equivalent to -m#2488





								2





DVILJ2(1)						DVILJ2(1)


       -pnumber of pages
	      print given number of pages

       -q
	      quiet operation

       -r
	      toggle reverse/not reverse order	for  output.   By
	      default  reverse=FALSE  for  3812, reverse=TRUE for
	      laserjet.

       -spagesize
	      Spezify pagesize (LJ-family only!)
	      -s1:  executive	 (7.25in * 10.5in)
	      -s2:  letter	     (8.5in * 11in)
	      -s3:  legal	      (8.5in * 14in)
	      -s26: A4		 (210mm * 297mm)
	      -s80: monarch	  (3.875in * 7.5in)
	      -s81: commercial-10    (4.125in * 9.5in)
	      -s90: international DL   (110mm * 220mm)
	      -s91: international C5   (162mm * 229mm)
	      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.

       -tpage number
	      print to end of given page number

       -v
	      verbose mode, list used fonts

       -w
	      print no warnings

       -xoffset
	      global x-offset in mm on output page relative to	1
	      inch/1 inch origin

       -yoffset
	      global  y-offset in mm on output page relative to 1
	      inch/1 inch origin

       -Xoffset
	      global x-offset in dots on output page  (to  set	1
	      inch/1 inch origin)

       -Yoffset
	      global  y-offset	in  dots on output page (to set 1
	      inch/1 inch origin)

       -z
	      print a test page with the page counter at  end  of
	      job (only for laserjet)




								3





DVILJ2(1)						DVILJ2(1)


       If no arguments are specified a short help file is dis-
	      played.


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:
       - dpi<resolution>/<fontname>.pk (eg: ./dpi300/cmr10.pk)
       - dpi<resolution>/<fontname>.pxl (eg: ./dpi300/cmr10.pxl)
       -	  pxl<magnification>/<fontname>.pk	   (eg:
       ./pxl1500/cmr10.pk)
       -			pxl<magnification>/<fontname>.pxl
       (eg:./pxl1500/cmr10.pxl)
       - <fontname>.<resolution>pk (eg: ./cmr10.300pk)
       - <fontname>.<resolution>pxl (eg: ./cmr10.300pxl)
       - <fontname>.<resolution> (eg: ./cmr10.300)


\special commands
       Two TeX '\special' commands are implemented:

       \special{file=<filename>}
	      copy specified file to the printer; either  vector-
	      or  bitmap-graphics  PMP commands (for laserjet and
	      3812)

       \special{orientation=<value>}
	      set page orientation to 0, 1, 2, 3; rotate  follow-
	      ing output to landscape mode etc.	(3812 only).

       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.


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 1 or 2)  the  following  will  happen
       after half of the pages is printed:

       3812: 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.

       LJ:   the printer stops, shows message "FEED" and switches
	     on manual	feed  led.  The	printer  continues  when



								4





DVILJ2(1)						DVILJ2(1)


	     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).

       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.

       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.

       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).

       Caveat  on  the	doubleside-option:  When  it is used fre-
       quently or on very large files, it might become	necessary
       to clean the printer much more frequently.

       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).


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 preproces-
       sor switch USEPIXEL set.

       Dvilj4 reads .tmf files and uses the contents of the envi-
       ronment variable TEXFONTS as search path.


AUTHOR
       Gustaf Neumann, Wirtschaftsuniversitaet Wien
       neumann@wu-wien.ac.at






								5