1DVILJK(1) General Commands Manual DVILJK(1)
2
6 dvilj4, dvilj4l, dvilj2p, dvilj - convert a TeX DVI file to PCL, for HP
7 LaserJet printers
8
10 dvilj [--Dnumber] [-ccopies] [-dmode] [-D] [-E] [-eoutputfile]
11 [-ffrompage] [-g] [-hheaderfile] [-l] [-Mflag] [-mmag] [-ppages] [-q]
12 [-r] [-ttopage] [-spagesize] [-v] [-Vmode] [-w] [-xxoff(mm)]
13 [-yyoff(mm)] [-Xxoff(dots)] [-Yyoff(dots)] [-z] [-] [filename]
14
16 Dvilj and siblings convert TeX-output .dvi files into PCL (the Hewlett-
17 Packard Printer Control Language) commands suitable for printing on a
18 HP LaserJet+, HP LaserJet IIP (using dvilj2p), HP LaserJet 4 (using
19 dvilj4), and fully compatible printers.
20 Dvilj4 also provides support for the builtin Intellifont and TrueType
22 fonts; TFM and VF files are provided in the distribution. Virtual
23 fonts are not supported directly by Dvilj, so you must run dvicopy(1)
24 first, or otherwise expand the virtual fonts
25 All programs are generated from one source file dvi2xx.c. They are
27 usually called via a shell script or as a line printer filter. One such
28 script, dvihp, is included in the distribution. It provides command-
29 line options similar to those of dvips(1).
30
32 --Dnumber Debug according to the bits of number; see the Kpathsea man‐
33 ual for values. Also turns on general verbosity.
34 -cnumber print each page number times (including original)
36 -dnumber print in duplex mode. The option -d1 means long edge binding,
38 -d2 stands for short edge binding. This option is only
39 selectable from dvilj2p, and is known to work on the LaserJet
40 IId, LaserJet IIId, and LaserJet 4.
41 -D[-] Double-sided printing - see below; -D1 prints odd sides only,
43 -D2 is for even pages, a trailing - suppresses printing of
44 empty padding pages.
45 -E Switch printer into econo mode (dvilj4 only).
47 -eoutfile Send output to outfile instead of the basename of dvi file
49 extended with `.lj'. If outfile is `-' (as in `-e-') the
50 output is directed to standard output and can be directly
51 piped into a spooler.
52 -fpagenum Print pages with TeX page numbers greater than or equal to
54 pagenum.
55 -g ``go'' mode: do not reset printer at start of job.
57 -hheaderfile
59 Copy headerfile to output before translation of the DVI file.
60 Used to send arbitrary commands to the laserprinter.
61 -l print output in landscape mode; supported only by dvilj2p and
63 dvilj4.
64 -Mflag Do (not) call mktexpk to generate fonts on demand. -M1 and
66 -M are equivalent. -M0 enables invoking mktexpk. (This is the
67 same as dvips.) The default behavior (i.e., if no -M option
68 is given) is chosen at compile-time; as distributed, mktexpk
69 is enabled. -M is only valid if dvi2xx was compiled with sup‐
70 port for mktexpk.
71 -mmagnification
73 Specify the magnification to use. The following are avail‐
74 able:
75 -m#usermag e.g., #900
76 -m0 equivalent to -m#1000
77 -mh equivalent to -m#1095
78 -m1 equivalent to -m#1200
79 -mq equivalent to -m#1250
80 -m2 equivalent to -m#1440
81 -m3 equivalent to -m#1728
82 -m4 equivalent to -m#2074
83 -m5 equivalent to -m#2488
84 -ppagecount
86 print pagecount pages after the starting page.
87 -q Quiet operation: omit final statistics, etc.
89 -r toggle page reversal; by default, pages are reversed.
91 -spagesize
93 Specify the page size:
94 -s1: executive (7.25in x 10.5in)
95 -s2: letter (8.5in x 11in)
96 -s3: legal (8.5in x 14in)
97 -s26: A4 (210mm x 297mm)
98 -s80: monarch (3.875in x 7.5in)
99 -s81: commercial-10 (4.125in x 9.5in)
100 -s90: international DL (110mm x 220mm)
101 -s91: international C5 (162mm x 229mm)
102 All values are from the LJ II technical reference manual. If
103 the -s commandline option is omitted, no clipping is per‐
104 formed at the bottom of the page.
105 -tpagenum Print pages with TeX page numbers less than or equal to
107 pagenum.
108 -v Verbose mode: list fonts used, etc.
110 -Vmode compatibility mode. Use K for Kyocera, B for Brother, 6 for
112 LJ6 printers.
113 -w Omit warnings.
115 -xoffset global x-offset in mm on output page relative to 1 inch/1
117 inch origin
118 -yoffset global y-offset in mm on output page relative to 1 inch/1
120 inch origin
121 -Xoffset global x-offset in dots on output page (overrides 1 inch/1
123 inch origin)
124 -Yoffset global y-offset in dots on output page (overrides 1 inch/1
126 inch origin)
127 -z print a test page with the page counter at end of job
129 - Take input from standard input (must be seekable), write to
131 standard output.
132 If no arguments are specified a brief usage message is displayed.
134
136 TeX `\special' commands that are implemented:
137 \special{file=<filename>} copy specified file to the printer; either
139 vector- or bitmap-graphics PMP commands
140 \special{hpfile=<filename>} Same as `file'.
142 others:
144 There are a few other special commands implented for the LJ-series,
145 which should only be used in connection with the distributed style
146 files (e.g., graybox.sty). They may change in forthcoming versions.
147 You can include Encapsulated PostScript (EPS) files in the PCL files
149 output by dvilj if you convert them to PCL first. The distribution
150 includes a script `epspcl' to do this (using Ghostscript, so your
151 Ghostscript must have the necessary LaserJet driver(s) compiled in).
152
154 The command line option -D causes the printer to print in doublepage
155 mode, that is, roughly speaking, printing first the even pages and then
156 the odd pages of a document. If -D is used to print both even and odd
157 pages (-D is used without the optional 1 or 2) the following will hap‐
158 pen after half of the pages is printed: LJ: the printer stops, shows
159 message "FEED" and switches on manual feed led. The printer continues
160 when either the printed pages are fed into the manual page feeder, or
161 the operator pushes the continue button (after placing first the
162 printed pages into the paper tray).
163 If -D1 was specified only odd pages will be printed, -D2 can be used
165 for even pages. A trailing `-' (as in -D-, -D1- or -D2-) supresses
166 printing of empty pages which are generated for padding otherwise.
167 The driver allows the -D option for both print-directions (front-to-
169 back or back-to-front printing). It tries to be clever in certain
170 cases: when a document has an odd number of pages it inserts in the
171 right place an empty page when a document starts with page 0 the driver
172 inserts an empty page after the 0-page when a piece of a document is
173 printed that starts with an even page-number it prints this page at the
174 backside of the first page to ensure that the odd sides are always on
175 the frontside. The 0-page is treated like an odd page.
176 The doubleside option works for all LJs, not only for the new D model
178 with does doubleside-printing (actually, I don't know whether it makes
179 much sense on the new LJ II D at all).
180 Caveat on the doubleside-option: When it is used frequently or on very
182 large files, it might become necessary to clean the printer much more
183 frequently.
184 The command line option -pX can be used to abort printing after the
186 output of X pages (can lead to strange results together with -D). I
187 personally dislike this option. The secure way of printing a part of a
188 document is using -f (from) and -t (to).
189
191 Dviljk uses the same environment variables and algorithms for finding
192 font files as TeX and its friends do. See the documentation for the
193 Kpathsea library for details. (Repeating it here is too cumbersome.)
194 DVILJFONTS, if set, overrides all other font paths.
196 DVILJMAKEPK, if set, overrides `mktexpk' as the name of the command to
198 execute to create a PK file if one isn't found.
199 The DVILJSIZES variable may be set to indicate which sizes of fonts are
201 available. It should consist of a list of numbers separated by colons.
202 If the list begins with a colon, the system default sizes are used, as
203 well. Sizes are expressed in dots per inch; decimals may be used for
204 ``pxl'' files: for example, a 300 dots per inch file magnified by half
205 a step comes out to 1643 dots per five inches, which should be encoded
206 as 328.6. dvilj tries the actual size of the font before trying any of
207 the given sizes.
208 KPATHSEA_DEBUG: Trace Kpathsea lookups; set to -1 for complete tracing.
210
212 Gustaf Neumann, Wirtschaftsuniversitaet Wien
213 neumann@wu-wien.ac.at
214 dviljk changes by kb@mail.tug.org; email bug reports to
216 tex-k@mail.tug.org.
217 10 June 1996 DVILJK(1)