Penguin
Recent Changes
Annotated edit history of dvilj2p(1) version 2, including all changes. View license author blame.
Rev Author # Line
1 perry 1 DVILJK
2 !!!DVILJK
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 special COMMANDS
8 DOUBLE PAGE PRINTING
9 ENVIRONMENT
10 AUTHOR
11 ----
12 !!NAME
13
14
2 perry 15 dvilj4, dvilj4l, dvilj2p, dvilj - convert a TeX DVI file to PCL, for HP !LaserJet printers
1 perry 16 !!SYNOPSIS
17
18
19 __dvilj__ [[__--D__''number'']
20 [[__-c__''copies''] [[__-d__''mode''] [[__-D__]
21 [[__-E__] [[__-e__''outputfile'']
22 [[__-f__''frompage''] [[__-g__]
23 [[__-h__''headerfile''] [[__-l__]
24 [[__-M__''flag''] [[__-m__''mag'']
25 [[__-p__''pages''] [[__-q__] [[__-r__]
26 [[__-t__''topage''] [[__-s__''pagesize'']
27 [[__-v__] [[__-V__''mode''] [[__-w__]
28 [[__-x__''xoff(mm)''] [[__-y__''yoff(mm)'']
29 [[__-X__''xoff(dots)''] [[__-Y__''yoff(dots)'']
30 [[__-z__] [[__-__] [[''filename'']
31 !!DESCRIPTION
32
33
34 Dvilj and siblings convert TeX-output .dvi files into PCL
35 (the Hewlett-Packard Printer Control Language) commands
2 perry 36 suitable for printing on a HP !LaserJet+, HP !LaserJet IIP
37 (using dvilj2p), HP !LaserJet 4 (using dvilj4), and fully
1 perry 38 compatible printers.
39
40
41 Dvilj4 also provides support for the builtin Intellifont and
2 perry 42 !TrueType fonts; TFM and VF files are provided in the
1 perry 43 distribution. Virtual fonts are not supported directly by
44 Dvilj, so you must run dvicopy(1) first, or otherwise
45 expand the virtual fonts
46
47
48 All programs are generated from one source file dvi2xx.c.
49 They are usually called via a shell script or as a line
50 printer filter. One such script, dvihp, is included in the
51 distribution. It provides command-line options similar to
52 those of dvips(1).
53 !!OPTIONS
54
55
56 __--D__''number''
57
58
59 Debug according to the bits of ''number''; see the
60 Kpathsea manual for values. Also turns on general
61 verbosity.
62
63
64 __-c__''number''
65
66
67 print each page ''number'' times (including
68 original)
69
70
71 __-d__''number''
72
73
74 print in duplex mode. The option -d''1'' means long edge
75 binding, -d''2'' stands for short edge binding. This
76 option is only selectable from ''dvilj2p'', and is known
2 perry 77 to work on the !LaserJet IId, !LaserJet IIId, and !LaserJet
1 perry 78 4.
79
80
81 __-D__[[-]
82
83
84 Double-sided printing - see below; -D''1'' prints odd
85 sides only, -D''2'' is for even pages, a trailing
86 ''-'' suppresses printing of empty padding
87 pages.
88
89
90 __-E__ Switch printer into econo mode (dvilj4
91 only).
92
93
94 __-e__''outfile''
95
96
97 Send output to ''outfile'' instead of the basename of dvi
98 file extended with `.lj'. If ''outfile'' is `-' (as in
99 `-e-') the output is directed to standard output and can be
100 directly piped into a spooler.
101
102
103 __-f__''pagenum''
104
105
106 Print pages with TeX page numbers greater than or equal to
107 ''pagenum''.
108
109
110 __-g__ ``go'' mode: do not reset printer at start of
111 job.
112
113
114 __-h__''headerfile''
115
116
117 Copy ''headerfile'' to output before translation of the
118 DVI file. Used to send arbitrary commands to the
119 laserprinter.
120
121
122 __-l__ print output in landscape mode; supported only by
123 dvilj2p and dvilj4.
124
125
126 __-M__''flag''
127
128
129 Do (not) call mktexpk to generate fonts on demand.
130 __-M__''1'' and __-M__ are equivalent.
131 __-M__''0'' enables invoking mktexpk. (This is the
132 same as dvips.) The default behavior (i.e., if no __-M__
133 option is given) is chosen at compile-time; as distributed,
134 mktexpk is enabled. __-M__ is only valid if dvi2xx was
135 compiled with support for mktexpk.
136
137
138 __-m__''magnification''
139
140
141 Specify the magnification to use. The following are
142 available:__
143 -m#__''usermag'' e.g., __#900
144 -m0__ equivalent to __-m#1000
145 -mh__ equivalent to __-m#1095
146 -m1__ equivalent to __-m#1200
147 -mq__ equivalent to __-m#1250
148 -m2__ equivalent to __-m#1440
149 -m3__ equivalent to __-m#1728
150 -m4__ equivalent to __-m#2074
151 -m5__ equivalent to __-m#2488__
152
153
154 __-p__''pagecount''
155
156
157 print ''pagecount'' pages after the starting
158 page.
159
160
161 __-q__ Quiet operation: omit final statistics,
162 etc.
163
164
165 __-r__ toggle page reversal; by default, pages are
166 reversed.
167
168
169 __-s__''pagesize''
170
171
172 Specify the page size:__
173 -s1__: executive (7.25in x 10.5in)__
174 -s2__: letter (8.5in x 11in)__
175 -s3__: legal (8.5in x 14in)__
176 -s26__: A4 (210mm x 297mm)__
177 -s80__: monarch (3.875in x 7.5in)__
178 -s81__: commercial-10 (4.125in x 9.5in)__
179 -s90__: international DL (110mm x 220mm)__
180 -s91__: international C5 (162mm x 229mm)
181 All values are from the LJ II technical reference manual. If
182 the -s commandline option is omitted, no clipping is
183 performed at the bottom of the page.
184
185
186 __-t__''pagenum''
187
188
189 Print pages with TeX page numbers less than or equal to
190 ''pagenum''.
191
192
193 __-v__ Verbose mode: list fonts used, etc.
194
195
196 __-V__''mode''
197
198
199 compatibility mode. Use ''K'' for Kyocera, ''B'' for
200 Brother, ''6'' for LJ6 printers.
201
202
203 __-w__ Omit warnings.
204
205
206 __-x__''offset''
207
208
209 global x-offset in mm on output page relative to 1 inch/1
210 inch origin
211
212
213 __-y__''offset''
214
215
216 global y-offset in mm on output page relative to 1 inch/1
217 inch origin
218
219
220 __-X__''offset''
221
222
223 global x-offset in dots on output page (overrides 1 inch/1
224 inch origin)
225
226
227 __-Y__''offset''
228
229
230 global y-offset in dots on output page (overrides 1 inch/1
231 inch origin)
232
233
234 __-z__ print a test page with the page counter at end of
235 job
236
237
238 __-__ Take input from standard input (must be seekable),
239 write to standard output.
240
241
242 If no arguments are specified a brief usage message is
243 displayed.
244 !!special COMMANDS
245
246
247 TeX `special' commands that are implemented:
248
249
250 __special{file=__
251
252
253 copy specified file to the printer; either vector- or
254 bitmap-graphics PMP commands
255
256
257 __special{hpfile=__
258
259
260 Same as `file'.
261
262
263 others:
264 There are a few other special commands implented for the
265 LJ-series, which should only be used in connection with the
266 distributed style files (e.g., graybox.sty). They may change
267 in forthcoming versions.
268
269
2 perry 270 You can include Encapsulated !PostScript (EPS) files in the
1 perry 271 PCL files output by dvilj if you convert them to PCL first.
272 The distribution includes a script `epspcl' to do this
273 (using Ghostscript, so your Ghostscript must have the
2 perry 274 necessary !LaserJet driver(s) compiled in).
1 perry 275 !!DOUBLE PAGE PRINTING
276
277
278 The command line option -D causes the printer to print in
279 doublepage mode, that is, roughly speaking, printing first
280 the even pages and then the odd pages of a document. If -D
281 is used to print both even and odd pages (-D is used without
282 the optional ''1'' or ''2'') the following will happen
283 after half of the pages is printed: __LJ:__ the printer
284 stops, shows message
285 __
286
287
288 If -D1 was specified only odd pages will be printed, -D2 can
289 be used for even pages. A trailing `-' (as in -D-, -D1- or
290 -D2-) supresses printing of empty pages which are generated
291 for padding otherwise.
292
293
294 The driver allows the -D option for both print-directions
295 (front-to-back or back-to-front printing). It tries to be
296 clever in certain cases: when a document has an odd number
297 of pages it inserts in the right place an empty page when a
298 document starts with page 0 the driver inserts an empty page
299 after the 0-page when a piece of a document is printed that
300 starts with an even page-number it prints this page at the
301 backside of the first page to ensure that the odd sides are
302 always on the frontside. The 0-page is treated like an odd
303 page.
304
305
306 The doubleside option works for all LJs, not only for the
307 new D model with does doubleside-printing (actually, I don't
308 know whether it makes much sense on the new LJ II D at
309 all).
310
311
312 Caveat on the doubleside-option: When it is used frequently
313 or on very large files, it might become necessary to clean
314 the printer much more frequently.
315
316
317 The command line option -pX can be used to abort printing
318 after the output of X pages (can lead to strange results
319 together with -D). I personally dislike this option. The
320 secure way of printing a part of a document is using -f
321 (from) and -t (to).
322 !!ENVIRONMENT
323
324
325 Dviljk uses the same environment variables and algorithms
326 for finding font files as TeX and its friends do. See the
327 documentation for the Kpathsea library for details.
328 (Repeating it here is too cumbersome.)
329
330
331 DVILJFONTS, if set, overrides all other font
332 paths.
333
334
335 DVILJMAKEPK, if set, overrides `mktexpk' as the name of the
336 command to execute to create a PK file if one isn't
337 found.
338
339
340 The DVILJSIZES variable may be set to indicate which sizes
341 of fonts are available. It should consist of a list of
342 numbers separated by colons. If the list begins with a
343 colon, the system default sizes are used, as well. Sizes are
344 expressed in dots per inch; decimals may be used for ``pxl''
345 files: for example, a 300 dots per inch file magnified by
346 half a step comes out to 1643 dots per five inches, which
347 should be encoded as 328.6. ''dvilj'' tries the actual
348 size of the font before trying any of the given
349 sizes.
350
351
352 KPATHSEA_DEBUG: Trace Kpathsea lookups; set to -1 for
353 complete tracing.
354 !!AUTHOR
355
356
357 Gustaf Neumann, Wirtschaftsuniversitaet Wien
358 neumann@wu-wien.ac.at
359
360
361 dviljk changes by kb@mail.tug.org; email bug reports to
362 tex-k@mail.tug.org.
363 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.