1 DVILN03
DVILN03 is a program to convert TeX Device Independent (DVI) output
files into a form suitable for printing on a Digital LN03 laser
printer. The "Local Guide to DVILN03" contains full details of this
program. Please report any problems or suggestions to Brian Hamilton
Kelly, or by sending electronic mail to user TEX.
Format:
DVILN03 file-name
If the program terminates successfully, it will produce two new files,
with the same name, but different types.
file-name.LN3 - the output file, suitable for printing on a Digital
LN03 laser printer using the TEXPRINT command.
file-name.TYP - the log file, recording messages sent by DVILN03 to
the terminal, plus additional information.
2 Parameter
file-name
Specifies the TeX DeVice Independent (DVI) file to be converted to
a form suitable for printing on a Digital LN03 laser printer.
2 Command_Qualifiers
/STARTING_PAGE
/STARTING_PAGE=starting_page_number (default = *)
This qualifier specifies the first TeX page to be converted. A
wildcard qualifier may be used, in which case, the first page number
matching the specification is used. DVILN03 accepts TeX multiple page
specifiers e.g. 1.*.19.4; see the user guide for further details.
If you omit this qualifier, DVILN03 will start at the first page of the
document.
/NUMBER_OF_PAGES
/NUMBER_OF_PAGES=number_of_pages_to_print (default=1000000)
This qualifier specifies the number of TeX pages to be converted.
If you omit this qualifier, DVILN03 will print the entire document.
/ORIENTATION
/ORIENTATION=image_orientation (default=PORTRAIT)
This qualifier specifies the orientation of the document as it will be
printed on the Digital LN03 printer. Two options are available:
/ORIENTATION = PORTRAIT
The output is intended to be printed taller than it is wide.
/ORIENTATION = LANDSCAPE
The output is intended to be printed wider than it is tall.
/OUTPUT
/OUTPUT=file_spec
The output (ready for printing on an LN03 printer) will normally be
written in the current directory, with the same name as the DVI file
and file extension `.LN3'. The /OUTPUT qualifier, which requires a
partial file specification, can be used to override some or all of
these defaults.
This qualifier can be particularly useful for users with limited disk
quota who can use it to divert output to a scratch disk, or even send
it directly to a spooled printer.
/LOG
/LOG[=file_spec]
/NOLOG
This allows the user to control whether the log file will be kept after
processing the document and optionally to provide an alternative file
specification for the file. The default for this file is to write it
in the current directory, with the same name as the DVI file, but with
file type `.TYP'. Any value provided to the /LOG qualifier allows the
user to override some or all of these defaults. If /LOG is specified,
with or without a file specification, the log file will always be
retained, even if no error or warning messages have been issued.
If /NOLOG is specified, the file will always be deleted at the end of
processing, even if an error or warning message has been issued.
The default action, if neither qualifier is present, is to delete the
file if no error or warning messages were issued, but to retain it
otherwise.
/VERBOSE
/VERBOSE (deafult)
/NOVERBOSE
Controls the amount of progress messages sent to the user's terminal.
All messages go to the log file (see /LOG) in the usual fashion, but
if /NOVERBOSE has been specified, the terminal only shows the total
number of bytes of fonts downloaded and the page numbers processed;
warning and error messages still appear, of course.
/LEFT_MARGIN
/LEFT_MARGIN=left_page_margin_offset (default=300px)
This qualifier specifies the distance (in the given unit) between the
physical left-hand edge of the paper and TeX's logical left-hand edge
of the paper. Device Independent (DVI) files are produced by TeX under
the assumption that this distance is one inch. The resolution of the
Digital LN03 printer is 300 pixels/inch; the default value is therefore
set to 300px. `px' is used to specify pixels as the unit for this
dimension; any of TeX's standard physical units (e.g. pt, mm, in) may
be used instead.
Use this qualifier with care.
/TOP_MARGIN
/TOP_MARGIN=top_margin_offset (default=300px)
This qualifier specifies the distance (in the given unit) between the
physical top edge of the paper and TeX's logical top edge of the paper.
Device Independent (DVI) files are produced by TeX under the assumption
that this distance is one inch. The resolution of the Digital LN03
printer is 300 pixels/inch; the default value is therefore set to
300px. `px' is used to specify pixels as the unit for this dimension;
any of TeX's standard physical units (e.g. pt, mm, in) may be used
instead.
Use this qualifier with care.
/HFUZZ
/HFUZZ=dimension (default=100sp)
Ordinarily, TeX never generates lines that exceed the right margin; if
it does, it issues an `Overfull /hbox' message. However, some macro
packages cause TeX to exceed the margin by a few points or so, and
these pages, when processed by DVItoLN03, will give rise to warning
messages if the right margin is exceeded by more than the value
specified with /HFUZZ. The default value of this qualifier is 100sp,
which is invisibly small (it's approximately the wavelength of visible
light!); using larger values with this qualifier can suppress the
warning messages.
Use this qualifier with care.
/VFUZZ
/VFUZZ=dimension (default=100sp)
TeX is even less likely to write output below the bottom margin of the
page, but this qualifier can be used analogously to /HFUZZ (q.v.) to
suppress the resultant warning messages if it does!
/DUPLEX_BY_PAGE_NUMBERS
/DUPLEX_BY_PAGE_NUMBERS (default)
/NODUPLEX_BY_PAGE_NUMBERS
Specifies whether or not DVItoLN03 should use the page numbers stored
in the .DVI file for deciding which pages should be printed on left and
right pages. Each page may have more than one number, and DVItoLN03
will use the number (from TeX's \count0). Pages will be printed on
alternating right and left pages when /NODUPLEX_BY_PAGE_NUMBERS is
specified. When /DUPLEX_BY_PAGE_NUMBERS is specified, DVItoLN03 will
print pages with odd and even numbers on right and left pages
respectively. However, if a page has number 0, it will be printed on a
right page. The /PRINT_MODE must be specified to enable duplex
printing.
/PRINT_MODE
/PRINT_MODE=(print_mode[,...])
/PRINT_MODE=(SIMPLEX,NORMAL) (default)
Permits use of extra facilities of newer printers such as the DEClaser
models 2100 and 2200 (LN05 and LN06). Some combination of options can
be used with the traditional LN03 as well.
The options are as follows:
SIMPLEX Print only on one side of the paper. This is the default.
DUPLEX Print on both sides of the paper.
MASTER Used together with DUPLEX for producing a master for copying.
This will make the printer print on one side of the paper,
but insert a blank sheet when the left page in the copies is
to be blank. The output is therefore correctly sequenced
to be photocopied into a double-sided document. This option
can even be used with an ordinary LN03.
TUMBLED Used together with duplex mode. MASTER may not be specified.
Print left pages upside down.
NORMAL The opposite of TUMBLED. This is the default.
/FEED_TRAY
/FEED_TRAY=(option=tray_type[,...])
/FEED_TRAY=ALL=DEFAULT_TRAY (default)
The LN05 printer is capable of selecting paper feed from its paper tray
or by manual insertion of a sheet or envelope: this could be used, for
example, to print the first page on a manually-fed sheet of letterhead
stationery.
The LN06 has two individually selectable paper trays and manual feed as
standard; in addition, it may be fitted with an optional envelope
feeder and a large capacity (1000 sheet) external paper tray.
Any of these paper sources may be selected through use of the
/FEED_TRAY qualifier; the options available are
ALL=tray_type Feed all sheets from the specified tray
FIRST=tray_type Feed the first sheet from this tray
REST=tray_type Feed subsequent sheets from this tray
Tray types are specified through use of the following keywords:
DEFAULT_TRAY TOP_TRAY BOTTOM_TRAY ENVELOPE_TRAY MANUAL_FEED
/DEVICE_TYPE
/DEVICE_TYPE=printer_type (default: LN03)
Selects the model of printer for which output is being prepared; the
default value of this qualifier will vary from site to site, but may
readily be overridden to generate output for a different model.
Values accepted for printer_type are:
LN03 The traditional LN03, or the LN03-plus. Not the LN03R
PostScript printer.
LN05 The DEClaser 2100.
LN06 The DEClaser 2200.
/TFM_DIRECTORY
/TFM_DIRECTORY=file_spec (default=TEX$FONTS:)
Specifies where files containing TeX Font Metrics will be found.
Only use this qualifier if you are a system wizard!
/VIRTUAL_DIRECTORY
/VIRTUAL_DIRECTORY=file_spec (default=TEX$FONTS:)
Specifies where files containing the description of virtual fonts will
be found.
Only use this qualifier if you are a system wizard!
/PK_FONT_DIRECTORY
/PK_FONT_DIRECTORY=file_spec (default=TEX$PK:)
Specifies where files containing packed pixel rasters will be found. If
the specification (after logical name translation, if necessary) ends
with the characters ".]", a tree-structured directory will be assumed,
with fonts of different magnifications held in separate directories.
Otherwise, a flat structure is assumed, with the different
magnifications being distinguishable by different file type extensions.
Only use this qualifier if you are a system wizard!
/PXL_FONT_DIRECTORY
/PXL_FONT_DIRECTORY=file_spec (default=TEX$PXL_ROOT:)
Specifies where files containing unpacked pixel rasters will be found.
If the specification (after logical name translation, if necessary)
ends with the characters ".]", a tree-structured directory will be
assumed, with fonts of different magnifications held in separate
directories. Otherwise, a flat structure is assumed, with the
different magnifications being distinguishable by different file type
extensions.
Only use this qualifier if you are a system wizard!
/PAPER_SIZE
/PAPER_SIZE=paper (Default = A4)
Controls whether the program assumes the use of European A4 (210x297mm)
paper or US (8-1/2x11in). It is insufficient just to use this qualifier
to control the output: it is also necessary to power down the printer,
move the paper size switch on the back to the desired setting, and switch
on again. Therefore, it is extremely unlikely that this qualifier will
ever be specified by a user: rather it is present so that the system
manager can define the default paper size in use at any individual site.
2 Examples
DVILN03 LATEX_OUTPUT_FILE
This command converts LATEX_OUTPUT_FILE.DVI to a form suitable for
printing on a Digital LN03 laser printer. All pages are converted
for printing in portrait form, starting one inch (300 printer
pixels) from the top and left-hand edges of the paper.
DVILN03/START_PAGE=5.3.2/NUMBER_OF_PAGES=13 LATEX_OUTPUT_FILE
As above, but convert only thirteen TeX pages, starting at TeX
page [5.3.2].
DVILN03/NUMBER_OF_PAGES=20/ORIENTATION=LANDSCAPE LATEX_OUTPUT_FILE;-1
This command converts the immediately previous version of file
LATEX_OUTPUT_FILE.DVI to a form suitable for printing on a Digital LN03
laser printer. The first 20 pages are converted for printing in
landscape form, starting one inch (300 printer pixels) from the top
and left-hand edges of the paper.
$ DEFINE MY_FONTS 'F$ENVIRONMENT("DEFAULT"),TEX$FONTS:
$ DEFINE MY_PK 'F$ENVIRONMENT("DEFAULT"),TEX$PK:
$ TEX/TEXFONTS=MY_FONTS: TESTFONT
Name of the font to test = myfont
*\table\bye
$ DVILN03/TFM_DIRECTORY=MY_FONTS:/PK_FONT_DIRECTORY=MY_PK: TESTFONT
This is one circumstance in which a user might want to use the extra
qualifiers, for use with a font that has just been built (by METAFONT)
and is residing in the current directory. TeX (and DVItoLN03) will
expect to find MYFONT.TFM in the current directory; failing that it
will look, as usual, in the directory indicated by TEX$FONTS.
DVItoLN03 will in addition look for MYFONT.300PK in one of those
places.
DVILN03 /PRINT_MODE=DUPLEX /NODUPLEX_BY_PAGE_NUMBERS -
/FEED_TRAY=(FIRST=MANUAL_FEED,REST=TOP_TRAY) LATEX_OUTPUT_FILE
Converts LATEX_OUTPUT_FILE.DVI to a form suitable for printing on the
DEClaser 2200. Pages are printed on both sides of the paper, and
DVItoLN03 does not insert blank pages when page numbers indicate it.
The first sheet of paper must be manually fed, and the rest are taken
from the top tray.