man > dvilj6(1)

man perldoc info pydoc3 ri search

📛 NAME

dvilj4, dvilj4l, dvilj2p, dvilj - convert a TeX DVI file to PCL, for HP LaserJet printers

🚀 Quick Reference

Use Case	Command	Description
Basic conversion	dvilj4 file.dvi	Convert DVI to PCL, output file.lj
Send output to stdout	dvilj4 -e- file.dvi	Pipe output directly to spooler
Print multiple copies	dvilj4 -c3 file.dvi	Print each page 3 times
Duplex printing (hardware)	dvilj4 -d1 file.dvi	Long edge binding duplex
Double-sided (manual)	dvilj4 -D file.dvi	Print even pages, then odd
Select paper size	dvilj4 -s26 file.dvi	A4 paper size
Landscape mode	dvilj4 -l file.dvi	Landscape orientation
Page range	dvilj4 -f10 -t20 file.dvi	Print pages 10-20
Magnification	dvilj4 -m1200 file.dvi	Scale to 1200 dpi equivalent
Quiet mode	dvilj4 -q file.dvi	Suppress final statistics
Include PCL file	Inside TeX: \special{hpfile=logo.pcl}	Insert PCL commands at current position

📋 SYNOPSIS

dvilj [--Dnumber] [-ccopies] [-dmode] [-D] [-E] [-eoutputfile]
      [-ffrompage] [-g] [-hheaderfile] [-l] [-Mflag] [-mmag] [-ppages]
      [-q] [-r] [-ttopage] [-spagesize] [-v] [-Vmode] [-w] [-xxoff(mm)]
      [-yyoff(mm)] [-Xxoff(dots)] [-Yyoff(dots)] [-z] [filename]

📖 DESCRIPTION

dvilj and siblings convert TeX-output ".dvi" files into PCL (the Hewlett-Packard Printer Control Language) commands suitable for printing on a HP LaserJet+, HP LaserJet IIP (using dvilj2p), HP LaserJet 4 (using dvilj4), and fully compatible printers.

dvilj4 also provides support for the builtin Intellifont and TrueType fonts; TFM and VF files are provided in the distribution. Virtual fonts are not supported directly by dvilj, so you must run dvicopy(1) first, or otherwise expand the virtual fonts.

All programs are generated from one source file dvi2xx.c. They are usually called via a shell script or as a line printer filter. One such script, dvihp(1), is included in the distribution. It provides command-line options similar to those of dvips(1).

⚙️ OPTIONS

• --Dnumber — Debug according to the bits of number; see the kpathsea(3) manual for values. Also turns on general verbosity.
• -cnumber — 🖨️ Print each page number times (including original).
• -dnumber — 🔄 Duplex mode. -d1 = long edge binding, -d2 = short edge binding. Only in dvilj4 and dvilj2p.
• -D[-12] — 📄 Double-sided printing. -D1 odd sides only, -D2 even pages. Trailing - suppresses empty padding pages.
• -E — 💡 Econo mode (dvilj4 only).
• -eoutfile — 💾 Send output to outfile instead of default ".lj". Use -e- for stdout.
• -fpagenum — 📄 Print pages with TeX page numbers ≥ pagenum.
• -g — 🚀 Go mode: do not reset printer at start of job.
• -hheaderfile — 📎 Copy headerfile to output before translation.
• -l — 🌄 Landscape mode (only dvilj2p and dvilj4).
• -Mflag — 🔧 Control call to mktexpk(1). -M1 disables, -M0 enables. Default: enabled.
• -mmagnification — 🔍 Magnification. Use -m#900 for user mag, -m0 = 1000, -mh = 1095, -m1 = 1200, -mq = 1250, -m2 = 1440, -m3 = 1728, -m4 = 2074, -m5 = 2488.
• -ppagecount — 📄 Print pagecount pages after the starting page.
• -q — 🤫 Quiet operation: omit final statistics.
• -r — 🔄 Toggle page reversal.
• -spagesize — 📐 Page size: -s1 Executive, -s2 Letter, -s3 Legal, -s6 Ledger, -s25 A5, -s26 A4, -s27 A3, -s45 JIS B5, -s46 JIS B4, -s71 Hagaki, -s72 Oufuku-Hagaki, -s80 Monarch Envelope, -s81 Com10 Envelope, -s90 DL, -s91 C5, -s100 B5 (ISO).
• -tpagenum — 📄 Print pages with TeX page numbers ≤ pagenum.
• -v — 🗣️ Verbose mode: list fonts used.
• -Vmode — 🔄 Compatibility mode: K for Kyocera, B for Brother, 6 for LJ6.
• -w — 🤫 Omit warnings.
• -xoffset — 📏 Global x-offset in mm relative to 1in/1in origin.
• -yoffset — 📏 Global y-offset in mm.
• -Xoffset — 📏 Global x-offset in dots (overrides origin).
• -Yoffset — 📏 Global y-offset in dots.
• -z — 🧪 Print a test page with page counter at end of job.

📂 OPERANDS

If no operands are specified a brief usage message is displayed.

• filename — The DVI file to convert. Must be seekable. Output name: filename with ".dvi" replaced by ".lj" or appended. If filename is -, read from stdin and write to stdout.

🎯 SUPPORTED TeX \special COMMANDS

\special commands have generic syntax:

\special{key1=value key1="value with space"}
\special{key3 = value key4 = 'note optional spaces around equal sign'}

Specials are a sequence of key/value pairs separated by an equal sign. Spaces around equal sign are ignored. Value is either a space-separated word or a quoted string (double or single quotes). No quoting of quote characters in values.

Valid key/value combinations:

📎 hpfile=file

Insert file at current position. File searched with kpathsea(3). File must contain PCL escape sequences or HP-GL/2 commands. Absolute PCL positioning is rewritten to relative.

📎 hpfile_verbatim=file

Insert file verbatim without changes. File searched with kpathsea(3). Used to keep absolute positions.

🖼️ psfile=file llx=x0 lly=y0 urx=x1 ury=y1 rwi=s

Convert PostScript file to HP PCL via Ghostscript (device "ljetplus") and insert at current position. Mandatory keys: llx, lly, urx, ury, rwi (all integers). Note: Exact semantics of rwi and corner dimensions are unclear; please report if you know.

🔧 dvilj-psfile-syntax=syntax

Where syntax is "dvilj" or "ignore". Crude control over psfile processing. "ignore" skips subsequent psfile specials; "dvilj" processes them. Only effective on the same page as the psfile special.

💬 comment=arbitrary text or comment arbitrary text

Rest of special is ignored. Used for meta-information. Second form is for compatibility.

🌄 orientation=po

Position page on physical paper: 0 = portrait, 1 = landscape, 2 = reverse portrait, 3 = reverse landscape.

📍 defpoint=n(x,y)

Define point number n (0-79). x and y are in pt relative to DVI page origin (1in,1in upper left, altered by -x, -y, -X, -Y but not by \hoffset/\voffset). Can be omitted to use current position.

🗑️ resetpoints="all"

Undefine all points.

🎨 gray=gray_scale / grey=gray_scale

Set fill mode for next fill special. gray_scale is percentage (0=white, 100=black). PCL shading patterns: only 8 patterns available: 1-2% (1-2), 3-10% (3-10), 11-20% (11-20), 21-35% (21-35), 36-55% (36-55), 56-80% (56-80), 81-99% (81-99), 100%.

🧩 pattern=pat

Set fill mode for next fill. pat: 1=horizontal lines, 2=vertical lines, 3=diagonal (lower left to upper right), 4=diagonal (upper right to lower left), 5=crossed vertical, 6=crossed diagonal.

🖍️ fill=a/b

Fill area between points a and b according to current fill mode. a must be upper left corner, b lower left corner. Default fill mode: 10% gray.

📄 filename (legacy)

Deprecated. If special is just one word naming an existing file, that file is included verbatim (not searched via kpathsea). Do not use.

Note: The special parser sometimes accepts invalid constructs, leading to output damage.

🔍 Searching for Included Files

Proper file include specials search with kpathsea(3). Search path: "DVILJINPUTS" first, then "TEXINPUTS". Program name in texmf.cnf is "dvilj" for all variants.

⚠️ Unknown Specials and "TEX_HUSH" configuration

Kpathsea(3) has "TEX_HUSH" variable to suppress warnings. If "special" is listed, no warnings about unknown specials. But invalid parameters on recognized specials still warn.

📄 DOUBLE PAGE PRINTING

If the printer has a duplex unit, use -d. Otherwise, -D enables doublepage mode (print even pages then odd pages). With -D (no number), after half pages printer stops with "FEED" message. Use manual feed or continue button.

• -D1 — print only odd pages
• -D2 — print only even pages
• Trailing - (e.g., -D-) — suppress empty padding pages

Works for all LJs, not only D models. Cautions: frequent use may require more printer cleaning. Use -p to abort after X pages (risky with -D). Prefer -f and -t for partial printing.

🌐 ENVIRONMENT

dvilj uses same environment variables as TeX for font finding (see kpathsea(3)).

• DVILJFONTS — overrides all font paths
• DVILJMAKEPK — overrides mktexpk(1) command
• DVILJSIZES — colon-separated list of font sizes in dpi (e.g., 328.6 for 300dpi magnified 1.5x). dvilj tries actual size first.
• DVILJINPUTS — primary search path for include files
• TEXINPUTS — secondary search path for include files
• TEX_HUSH — colon-separated identifiers: checksum, readable, special, all, none
• KPATHSEA_DEBUG — trace kpathsea lookups; set to -1 for complete tracing
• GS_PATH — on Windows, path to Ghostscript (default: gswin32c.exe). On Unix, not used; gs(1) must be in $PATH.

📚 SEE ALSO

dvihp(1), dvicopy(1), dvips(1), xdvi(1), mktexpk(1), gs(1), kpathsea(3)

Email bug reports to tex-k AT tug.org.

Source: http://mirror.ctan.org/dviware/dviljk/ (needs texk build environment).

PCL reference documentation: HP website at http://h20000.www2.hp.com/bizsupport/TechSupport/Document.jsp?objectID=bpl04568. Also PDFs at http://h20000.www2.hp.com/bc/docs/support/SupportManual/bpl<ID>/bpl<ID>.pdf where is:

• 13205 — PCL 5 Technical Quick Reference Guide
• 13210, 13211 — PCL 5 Technical Reference Manual (parts I & II)
• 13208, 13207 — PJL Technical Reference Manual
• 13212 — PCL 5 Color Manual
• 13206, 13209 — Comparison Guide

✍️ AUTHOR

dvi2xx by Gustaf Neumann, Wirtschaftsuniversitaet Wien.

dviljk fork by Karl Berry.

Joachim Schrod <jschrod AT acm.org> supplied security fixes and updated this man page.

📜 LICENSE

dvi2xx is public domain software. dviljk changes are covered by the GNU General Public License.

Version 2.6p5, 2012-03-12

📛 NAME 🚀 Quick Reference 📋 SYNOPSIS 📖 DESCRIPTION ⚙️ OPTIONS 📂 OPERANDS 🎯 SUPPORTED TeX \special COMMANDS 📄 DOUBLE PAGE PRINTING 🌐 ENVIRONMENT 📚 SEE ALSO ✍️ AUTHOR 📜 LICENSE