home *** CD-ROM | disk | FTP | other *** search
/ Atari FTP / ATARI_FTP_0693.zip / ATARI_FTP_0693 / Tex / Dvi / shdvi10b.zoo / readme.txt < prev    next >
Text File  |  1990-08-23  |  12KB  |  325 lines
  1. Passau (FRG), August 23, 1990
  2.  
  3. First, the copyright notice:
  4.  
  5.       Showdvi and dviprint are distributed in binary form.
  6.       Flib,  imginfo  and  environ  are  distributed in both binary and 
  7.       source  form.  The  programs and code are copyrighted, but may be
  8.       freely distributed.
  9.       The only restrictions are: 
  10.  
  11.        1.  No  charge  may  be  made  other than reasonable charges for
  12.            reproduction.  In  case  of doubt contact one of the persons
  13.            whose addresses are listed at the very end of this file.
  14.  
  15.        2.  Modified versions must be clearly marked as such.
  16.  
  17.        3.  The   authors   are   not   responsible   for   any  harmful
  18.            consequences  of  using  this  software, even if they result
  19.            from defects in it.
  20.  
  21.       You  are  encouraged  to  make  copies  for friends, upload it to
  22.       bulletin  boards,  or  distribute it via networks.  This is not a
  23.       shareware  product.
  24.  
  25.  
  26. Second, a warning:
  27.  
  28.  THIS IS ONLY A QUICK-REFERENCE FOR USING THE PROGRAMS
  29.                 -----
  30.  
  31.            showdvi - show TeX dvifiles on monochrome and color screens
  32.        
  33.        dviprint - print TeX dvifiles on various printers
  34.  
  35.        flib    - manages libraries of Metafont pkfiles
  36.  
  37.            imginfo - print some information about IMG files
  38.  
  39.            environ - set AES environment variables before AES is initialized
  40.  
  41. --------------------------------------------------
  42.  
  43. Using showdvi:
  44.  
  45.  commandline options:
  46.  
  47. DVI-Preview - Version 1.00T for ATARI (c) 1990
  48. (c)Copyright 1990, hes/rbs. All rights reserved. Jul 15 1990
  49. usage: showdvi [-?] [-a fontarea] [-b bytes] [-f page] [-z dpi]
  50.            [-l] [-s] [-h offset] [-v offset] [-p] dvifile
  51.           where offset = real number{pt|pc|in|bp|cm|mm|dd|cc}
  52.     -?   this help,
  53.     -a   directory of the fontlibs,
  54.     -b   size of memory reserved for fonts (default: 120000 bytes),
  55.     -f   start at page,
  56.     -z   resolution in dpi,
  57.     -h   horizontal offset (def.: 1.00in),
  58.     -v   vertical offset (def.: 1.00in),
  59.     -p   preload all fonts,
  60.     -s   print statistics,
  61.     -l   no log file.
  62.  
  63. Standard path for font libraries:
  64.  f:\fonts\tex\screen
  65.   to change it:
  66.    showdvi -a c:\local\fonts myfile.dvi
  67.               --------------
  68.  
  69. Standard path for configuration files:
  70.  c:\config
  71.  
  72.  This path can be changed via the environment variable DVICONFIG.
  73.  
  74.  If showdvi.cnf is not found in $DVICONFIG, then it is searched
  75.  in the GEM path PATH that can be modified at boot time via the program
  76.  environ.c (which is included in this distribution).
  77.  
  78.  A sample for showdvi.cnf:
  79. ; This is a machine generated configuration file
  80. ; for DVI-Preview
  81. scrollbars    off            ; state of scrollbars (on/off)
  82. window_x    0            ; x-coordinate of display window
  83. window_y    19            ; y-coordinate of display window
  84. window_width    640            ; width of display window
  85. window_height    381            ; height of display window
  86. color-index0    0            ; index for foreground color (only
  87.                                         ; used on monitors with more than one
  88.                                         ; bit-plane)
  89. color-index1    255            ; index for background color
  90. default_resolution    100        ; default resolution in dpi
  91. ; end of configuration file
  92.  
  93. Description of key bindings:
  94.  F1        - one page forward
  95.  F2        - go to last page
  96.  F3        - go to first page
  97.  F4        - one page backwards
  98.  F5        - enter new resolution (in dpi)
  99.  F6        - enter number of next page to display
  100.  F7        - use Atari's file selector box
  101.  SHIFT-F7  - enter new dvi filename
  102.  F8        - save internal font/library pathes to showdvi.log
  103.  F9        - save configuration to showdvi.log
  104.  SHIFT-F9  - save configuration to showdvi.cnf (search path see above)
  105.  
  106.  <CTRL>-S
  107.     or
  108.  <CTRL>-P: enter number of next page to display
  109.  
  110.  <CTRL>-F: enter filename
  111.  
  112.  <UNDO>
  113.    or
  114.  <CTRL>-C: quit
  115.  
  116.  <NUMKEYS>-<SHIFT>-+ : go to last page
  117.  
  118.  <NUMKEYS>-<SHIFT>-- : go to first page
  119.  
  120.      +
  121.      or
  122.  <NUMKEYS>-+ : one page forward
  123.  
  124.      -
  125.      or
  126.  <NUMKEYS>-- : one page backwards
  127.  
  128.  <ENTER>: one page forward and top of the page
  129.  <RETURN>: one page forward
  130.  
  131.  <INSERT>: toggle scrollbars on/off
  132.  
  133.  <NUMKEYS>-7: show upper left corner of the page
  134.  <NUMKEYS>-9: show upper right corner of the page
  135.  <NUMKEYS>-8: scroll up one screen size
  136.  <NUMKEYS>-2: scroll down one screen size
  137.  <NUMKEYS>-4: scroll left one screen size
  138.  <NUMKEYS>-6: scroll right one screen size
  139.  <NUMKEYS>-1: show lower left corner of the page
  140.  <NUMKEYS>-3: show lower right corner of the page
  141.  
  142. Usage of scrollbars:
  143.  upper/lower left/right arrow: scroll 16 points
  144.    with SHIFT-key: scroll one screen size
  145.  
  146.  right scrollbar: 
  147.   Click at the scrollbar and hold down the left mouse button; 
  148.   the screen then scrolls by moving the mouse up/down
  149.  
  150.  buttom scrollbar:
  151.   Click at the scrollbar and hold down the left mouse button; 
  152.   the screen then scrolls by moving the mouse left/right
  153.  
  154.  area above the right scrollbar:
  155.   Clicking into this area moves the contents one screen size up
  156.  
  157.  area below the right scrollbar:
  158.   Clicking into this area moves the contents one screen size down
  159.  
  160.  area on right of the buttom scrollbar:
  161.   Clicking into this area moves the contents one screen size to the right
  162.  
  163.  area on right of the buttom scrollbar:
  164.   Clicking into this area moves the contents one screen size to the left
  165.  
  166. Window handling:
  167.  The DVI window can be moved by clicking into the contents and holding the
  168.  left mouse button down.
  169.  
  170.  The lower right button of the window allows to resize the window:
  171.   Click at this button and hold the left button down. The window can now be
  172.   resized.
  173.  
  174. -------------------------------------------------
  175.  
  176. Using dviprint:
  177.  
  178. DVI-Print - Version 1.00T for ATARI (c) 1990
  179. (c)Copyright 1988-90, (hes/rbs) , All rights reserved. Jul 16 1990
  180. usage: dviprint [-?] [-a fontarea] [-b bytes] [-m bytes]
  181.         [-f page] [-t page] [-z dpi] [-o {0|1}] [-d {0|1|2|3|4|5}]
  182.         [-u] [-x] [-r] [-p] [-q] [-l] [-s]
  183.         [-h offset] [-v offset] dvifile
  184.           where offset = real number{pt|pc|in|bp|cm|mm|dd|cc}
  185.     -?   this help,
  186.     -a   directory of the fontlibs,
  187.     -b   size of the memory for the fonts (def.: 200000 bytes),
  188.     -m   maximum size of the memory for the bitmap (def.: 500000 bytes),
  189.     -f   start at page,
  190.     -t   stop at page,
  191.     -h   horizontal offset (def.: 1.00in),
  192.     -v   vertical offset (def.: 1.00in),
  193.     -d   printer type, one of the following numbers:
  194.            0: Atari Laser Printer SLM 804
  195.            1: NEC P6/P7 (24 pins)
  196.            2: HP DeskJet / Laserjet
  197.            3: HP DeskJet / Laserjet (no optimizing)
  198.            4: Epson FX (9 pins)
  199.            5: Epson FX (9 pins) (without ESC $ n)
  200.            default is: 1
  201.     -o   printing quality (0: high quality, 1: draft),
  202.            only for HP DeskJet (2: cheap hq, 3: cheap draft),
  203.            default is: 0
  204.     -u   printing bidirectional (default unidirectional),
  205.     -x   no form feed at the end of last page,
  206.     -r   print in reverse order,
  207.     -z   resolution in dpi,
  208.     -p   preload fonts,
  209.     -q   quiet,
  210.     -s   print statistics,
  211.     -l   no logfile.
  212.  
  213. (default resolution for SLM 804: 
  214.  high: 300 dpi
  215.  draft: 150 dpi)
  216.  
  217. The program can be aborted by simultaneously pressing the right SHIFT key and
  218. the ALTERNATE key.
  219.  
  220. ------------------------------
  221.  
  222. Including IMG files into TeX:
  223. showdvi/dviprint can handle IMG file within TeX-DVI-files:
  224.  Syntax:
  225.   in TeX file:                  vvvvv horiz. vvvvv vertical size of image in cm
  226.       \special{imgfile=ente.img hsize=10     vsize=15}
  227.                ^^^^^^^keyword for img filename
  228.    filenames can be of the form: e;/local/raster/ente.img
  229.                                   ^             ^path separator (stands for '\')
  230.                              this is ok (stands for ':')
  231.  
  232. The IMG files should be in resolution for the printer. On the screen they
  233. are displayed in the size given as parameters at hsize and vsize within the
  234. \special command (in cm)
  235.  
  236. ------------------------------------------------------------------
  237.  
  238. These versions of showdvi and dviprint allow both the use of flib's and the use 
  239. of "bare" pk files. Since the loading of fonts within a flib is much faster 
  240. the authors recommend the use of flib's for the majority of the fonts.
  241.  
  242. The path to the fonts can either be specified in the font configuration file
  243. showdvi.fnt/dviprint.fnt (see below) or via the the environment variables
  244. PKDIR (for pk fonts) and FLIBDIR (for font libraries). It is allowed to
  245. add more than one path to these variables. The single pathes should be
  246. separated by ';' (or '!').
  247. An other possibility to specify the font directory is to use the option -a. 
  248.  
  249. Showdvi/dviprint look for a configuration file where to search the fonts.
  250. This file is called showdvi.fnt/dviprint.fnt.
  251. It is searched in:
  252.  - the contents of the environment variable DVICONFIG (default: c:\config)
  253.  - via the system function shel_find (this function uses the environment
  254.    variable PATH). PATH must be set before AES is initialized (i.e. in the
  255.    \auto directory).
  256.  
  257. The format of such a file:
  258.  
  259. ; this is a comment
  260. font_str pk%04d\%s  ; this specifies how showdvi searches single fonts.
  261.                     ; This string is added to the below specified
  262.                     ; directory for single fonts (e.g. f:\fonts\tex)
  263.                     ; It is analogous to the C function printf
  264.                     ; %d <---> resolution (e.g. 100 dpi)
  265.                     ; %s <---> name of the font (e.g. cmr10)
  266. font cmr10 100 f:\fonts\tex ; search the font cmr10 in the directory
  267.                             ; f:\fonts\tex\pk0100
  268.                             ;              ^^^^^^
  269. flib_str pk%04d   ; analogous to font_str (only %d allowed)
  270. flib 100 f:\fonts\tex\screen ; search the library for resolution 100 dpi
  271.                              ; in the directory f:\fonts\tex\screen.
  272.                              ; It must be called pk0100.
  273.  
  274. The default path for libraries:    f:\fonts\tex\libs
  275. The path for single fonts:         f:\fonts\tex\fonts
  276. The default mask for single fonts: %d\%s
  277. The mask for libraries:            pk%04d
  278.  
  279. ------------------------------------------------------------------
  280. Using flib:
  281.  
  282.  commandline options:
  283.  
  284. FontLib Manager - Version 1.03 for ATARI ╜ 1990 Georg Hessmann/Robert Stabl
  285. usage: flib c|a|x|d|z|p|l|t[v] library [-|[modules]*]
  286.     c,a : create library / add (replace) module(s) to (in) library,
  287.     x   : extract module(s) from library,
  288.     d   : delete module(s) in library,
  289.     t   : print table,
  290.     r   : rename module(s) in library,
  291.     z   : create new flib from old flib,
  292.     p   : test checksums of all modules,
  293.     l   : create a flib link (second arg is the link destination),
  294.     v   : verbose mode,
  295.     ?   : print this help,
  296.     -   : read module name(s) from stdin.
  297.  
  298.  
  299. ------------------------------------------------------
  300.  
  301. This description to the new versions of showdvi and dviprint is very, very
  302. short. A more detailed version will be available soon (Georg is still working 
  303. on it :-).
  304.  
  305. ------------------------------------------------------
  306.  
  307. If there are still any questions about the usage of the programs or if you 
  308. detect errors in the programs, feel free to contact me at:
  309.  
  310.  Robert Stabl
  311.  Hollaenderstr. 45
  312.  D-8390 Passau
  313.  Germany
  314.  
  315. email:
  316.  Internet:
  317.       stabl@fmi.uni-passau.de
  318.                  or
  319.    stabl@unipas.fmi.uni-passau.de
  320.  
  321.  or UUCP:
  322.    ...uunet!unido!unipas!stabl
  323.                or
  324.        stabl@unipas.uucp
  325.