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. 
