home *** CD-ROM | disk | FTP | other *** search
/ Atari FTP / ATARI_FTP_0693.zip / ATARI_FTP_0693 / Tex / Dvi / dviatari.zoo / dviatari.txt < prev   
Text File  |  1990-05-05  |  4KB  |  98 lines
  1. DVIATARI:
  2.  
  3. Here's a dvi viewer that will work in any resolution. It's a rather
  4. quick and dirty hack; I just grabbed the source code for the dvieps
  5. printer driver and a viewer for the BBN Bitgraph (dvibit), and hacked away
  6. to make it work for the atari screen. All the writing is done directly
  7. to the screen, so I'm not sure whether this will work with the Moniterm
  8. monitor or not; if so, it should look really nice on one! Normal
  9. high and medium res. are quite usable; low res is passable, but I wouldn't
  10. really recommend it unless you only have a color monitor and need a 1:1
  11. aspect ratio.
  12.  
  13. Usage:
  14. dviatari [-b][-eENVVAR=value][-ffontsubfile][-l][-mMAG] [-oPAGES][-q]
  15.          [-xLEFTMARGIN][-yTOPMARGIN]
  16.  
  17. Meaning of options:
  18.  
  19. -b: print pages backwards (pretty useless)
  20. -e: set an environment variable. Meaningful environment variables are:
  21.       TEXFONTS: path to the dvi font files
  22.       TEXINPUTS: used to search for any font substitution file
  23. -f: specify a font substitution file to use. This file has lines of the
  24.     form:
  25.        font1.1000 -> font2.1200
  26.     which means that font1 at magnification 1000 (200 dpi) should be
  27.     replaced by font2 at magnification 1200 (240 dpi),
  28.     or
  29.        font1 -> font2
  30.     which means that 'font1' should always be replaced by 'font2'.
  31.     Lines starting with '%' are comments and are ignored.
  32.  
  33.     If the -f option is not given, the dviatari looks for ``foo.sub''
  34.     (for the dvi file ``foo.dvi''), ``texfonts.sub'', and
  35.     ``{$TEXINPUTS}texfonts.sub'', in that order; the first one found (if
  36.     any, is used as the font substitution file.
  37.  
  38. -l: don't log errors; if this option is not given, any errors (e.g. fonts
  39.     not found) are recorded in a file  ``foo.err'' (for the dvi file
  40.     ``foo.dvi'').
  41.  
  42. -m: specify magnification; default is -m482
  43.  
  44. -o: select output page range:
  45.       -oN       just page N
  46.       -oN:M     page N to M
  47.       -oN:M:P   page N to M in steps of P
  48.  
  49. -q: quiet; suppress status messages
  50.  
  51. -xA: set left margin to A inches
  52.  
  53. -yB: set top margin to B inches
  54.  
  55.  
  56. Font files are searched for the same way ``dvieps'' does, i.e. cmr10 at
  57. 96 dots per inch is looked for in $TEXFONTS\cmr10\96pk. The default for
  58. TEXFONTS is ``\tex\fonts''.
  59.  
  60. 96 dpi is the default resolution, to maintain compatibility with ``dvist''
  61. and ``showdvi''. Personally, I like 116 dpi better, and you can get this by
  62. aliasing dviatari to 'dviatari -m579' in gulam. Also, F1 will increase the
  63. magnification (zoom in), and SHIFT-F1 will decrease it (zoom out).
  64.  
  65. You can use the fonts posted to the net earlier for the various other dvi
  66. programs. Note that different programs round differently; the "dvist" fonts,
  67. for example, come in 96dpi, 105dpi, and 115dpi sizes, whereas dviatari
  68. expects:
  69.  
  70. Magsteps    Resolution  Magnification
  71. 0            96  dpi      482
  72. +.5          106 dpi      503
  73. +1           116 dpi      579
  74. +2           139 dpi      694
  75. +3           167 dpi      833
  76. +4           200 dpi      1000
  77.  
  78. This nicely meshes with "dvieps", but means that you'll have to rename
  79. or copy the fonts that came with "dvist" (or, if you have symbolic links,
  80. make appropriate symbolic links; "dviatari" understands the UNIXMODE
  81. convention for filenames and symbolic links).
  82.  
  83. Commands:
  84.  
  85. Pressing the HELP key will get a list of the on-line commands available.
  86. Basically, the cursor keys can move the page around, UNDO get you out,
  87. F1 and SHIFT-F1 zoom out and in respectively, SPACE moves to the next page,
  88. and BACKSPACE moves to the previous page.
  89.  
  90. Credits:
  91.  
  92. As I said, I just hacked the code together from some dvi viewers available
  93. for Unix. Thanks to John R. Dunning for his port of dvieps to the atari,
  94. and Marcus Moehrmann for the original dvieps.
  95.  
  96. Eric R. Smith
  97. ersmith@uwovax.uwo.ca
  98.