DVIATARI:

Here's a dvi viewer that will work in any resolution. It's a rather
quick and dirty hack; I just grabbed the source code for the dvieps
printer driver and a viewer for the BBN Bitgraph (dvibit), and hacked away
to make it work for the atari screen. All the writing is done directly
to the screen, so I'm not sure whether this will work with the Moniterm
monitor or not; if so, it should look really nice on one! Normal
high and medium res. are quite usable; low res is passable, but I wouldn't
really recommend it unless you only have a color monitor and need a 1:1
aspect ratio.

Usage:
dviatari [-b][-eENVVAR=value][-ffontsubfile][-l][-mMAG] [-oPAGES][-q]
         [-xLEFTMARGIN][-yTOPMARGIN]

Meaning of options:

-b: print pages backwards (pretty useless)
-e: set an environment variable. Meaningful environment variables are:
      TEXFONTS: path to the dvi font files
      TEXINPUTS: used to search for any font substitution file
-f: specify a font substitution file to use. This file has lines of the
    form:
       font1.1000 -> font2.1200
    which means that font1 at magnification 1000 (200 dpi) should be
    replaced by font2 at magnification 1200 (240 dpi),
    or
       font1 -> font2
    which means that 'font1' should always be replaced by 'font2'.
    Lines starting with '%' are comments and are ignored.

    If the -f option is not given, the dviatari looks for ``foo.sub''
    (for the dvi file ``foo.dvi''), ``texfonts.sub'', and
    ``{$TEXINPUTS}texfonts.sub'', in that order; the first one found (if
    any, is used as the font substitution file.

-l: don't log errors; if this option is not given, any errors (e.g. fonts
    not found) are recorded in a file  ``foo.err'' (for the dvi file
    ``foo.dvi'').

-m: specify magnification; default is -m482

-o: select output page range:
      -oN       just page N
      -oN:M     page N to M
      -oN:M:P   page N to M in steps of P

-q: quiet; suppress status messages

-xA: set left margin to A inches

-yB: set top margin to B inches


Font files are searched for the same way ``dvieps'' does, i.e. cmr10 at
96 dots per inch is looked for in $TEXFONTS\cmr10\96pk. The default for
TEXFONTS is ``\tex\fonts''.

96 dpi is the default resolution, to maintain compatibility with ``dvist''
and ``showdvi''. Personally, I like 116 dpi better, and you can get this by
aliasing dviatari to 'dviatari -m579' in gulam. Also, F1 will increase the
magnification (zoom in), and SHIFT-F1 will decrease it (zoom out).

You can use the fonts posted to the net earlier for the various other dvi
programs. Note that different programs round differently; the "dvist" fonts,
for example, come in 96dpi, 105dpi, and 115dpi sizes, whereas dviatari
expects:

Magsteps    Resolution  Magnification
0            96  dpi      482
+.5          106 dpi      503
+1           116 dpi      579
+2           139 dpi      694
+3           167 dpi      833
+4           200 dpi      1000

This nicely meshes with "dvieps", but means that you'll have to rename
or copy the fonts that came with "dvist" (or, if you have symbolic links,
make appropriate symbolic links; "dviatari" understands the UNIXMODE
convention for filenames and symbolic links).

Commands:

Pressing the HELP key will get a list of the on-line commands available.
Basically, the cursor keys can move the page around, UNDO get you out,
F1 and SHIFT-F1 zoom out and in respectively, SPACE moves to the next page,
and BACKSPACE moves to the previous page.

Credits:

As I said, I just hacked the code together from some dvi viewers available
for Unix. Thanks to John R. Dunning for his port of dvieps to the atari,
and Marcus Moehrmann for the original dvieps.

Eric R. Smith
ersmith@uwovax.uwo.ca