Passau (FRG), August 23, 1990 First, the copyright notice: Showdvi and dviprint are distributed in binary form. Flib, imginfo and environ are distributed in both binary and source form. The programs and code are copyrighted, but may be freely distributed. The only restrictions are: 1. No charge may be made other than reasonable charges for reproduction. In case of doubt contact one of the persons whose addresses are listed at the very end of this file. 2. Modified versions must be clearly marked as such. 3. The authors are not responsible for any harmful consequences of using this software, even if they result from defects in it. You are encouraged to make copies for friends, upload it to bulletin boards, or distribute it via networks. This is not a shareware product. Second, a warning: THIS IS ONLY A QUICK-REFERENCE FOR USING THE PROGRAMS ----- showdvi - show TeX dvifiles on monochrome and color screens dviprint - print TeX dvifiles on various printers flib - manages libraries of Metafont pkfiles imginfo - print some information about IMG files environ - set AES environment variables before AES is initialized -------------------------------------------------- Using showdvi: commandline options: DVI-Preview - Version 1.00T for ATARI (c) 1990 (c)Copyright 1990, hes/rbs. All rights reserved. Jul 15 1990 usage: showdvi [-?] [-a fontarea] [-b bytes] [-f page] [-z dpi] [-l] [-s] [-h offset] [-v offset] [-p] dvifile where offset = real number{pt|pc|in|bp|cm|mm|dd|cc} -? this help, -a directory of the fontlibs, -b size of memory reserved for fonts (default: 120000 bytes), -f start at page, -z resolution in dpi, -h horizontal offset (def.: 1.00in), -v vertical offset (def.: 1.00in), -p preload all fonts, -s print statistics, -l no log file. Standard path for font libraries: f:\fonts\tex\screen to change it: showdvi -a c:\local\fonts myfile.dvi -------------- Standard path for configuration files: c:\config This path can be changed via the environment variable DVICONFIG. If showdvi.cnf is not found in $DVICONFIG, then it is searched in the GEM path PATH that can be modified at boot time via the program environ.c (which is included in this distribution). A sample for showdvi.cnf: ; This is a machine generated configuration file ; for DVI-Preview scrollbars off ; state of scrollbars (on/off) window_x 0 ; x-coordinate of display window window_y 19 ; y-coordinate of display window window_width 640 ; width of display window window_height 381 ; height of display window color-index0 0 ; index for foreground color (only ; used on monitors with more than one ; bit-plane) color-index1 255 ; index for background color default_resolution 100 ; default resolution in dpi ; end of configuration file Description of key bindings: F1 - one page forward F2 - go to last page F3 - go to first page F4 - one page backwards F5 - enter new resolution (in dpi) F6 - enter number of next page to display F7 - use Atari's file selector box SHIFT-F7 - enter new dvi filename F8 - save internal font/library pathes to showdvi.log F9 - save configuration to showdvi.log SHIFT-F9 - save configuration to showdvi.cnf (search path see above) -S or -P: enter number of next page to display -F: enter filename or -C: quit --+ : go to last page --- : go to first page + or -+ : one page forward - or -- : one page backwards : one page forward and top of the page : one page forward : toggle scrollbars on/off -7: show upper left corner of the page -9: show upper right corner of the page -8: scroll up one screen size -2: scroll down one screen size -4: scroll left one screen size -6: scroll right one screen size -1: show lower left corner of the page -3: show lower right corner of the page Usage of scrollbars: upper/lower left/right arrow: scroll 16 points with SHIFT-key: scroll one screen size right scrollbar: Click at the scrollbar and hold down the left mouse button; the screen then scrolls by moving the mouse up/down buttom scrollbar: Click at the scrollbar and hold down the left mouse button; the screen then scrolls by moving the mouse left/right area above the right scrollbar: Clicking into this area moves the contents one screen size up area below the right scrollbar: Clicking into this area moves the contents one screen size down area on right of the buttom scrollbar: Clicking into this area moves the contents one screen size to the right area on right of the buttom scrollbar: Clicking into this area moves the contents one screen size to the left Window handling: The DVI window can be moved by clicking into the contents and holding the left mouse button down. The lower right button of the window allows to resize the window: Click at this button and hold the left button down. The window can now be resized. ------------------------------------------------- Using dviprint: DVI-Print - Version 1.00T for ATARI (c) 1990 (c)Copyright 1988-90, (hes/rbs) , All rights reserved. Jul 16 1990 usage: dviprint [-?] [-a fontarea] [-b bytes] [-m bytes] [-f page] [-t page] [-z dpi] [-o {0|1}] [-d {0|1|2|3|4|5}] [-u] [-x] [-r] [-p] [-q] [-l] [-s] [-h offset] [-v offset] dvifile where offset = real number{pt|pc|in|bp|cm|mm|dd|cc} -? this help, -a directory of the fontlibs, -b size of the memory for the fonts (def.: 200000 bytes), -m maximum size of the memory for the bitmap (def.: 500000 bytes), -f start at page, -t stop at page, -h horizontal offset (def.: 1.00in), -v vertical offset (def.: 1.00in), -d printer type, one of the following numbers: 0: Atari Laser Printer SLM 804 1: NEC P6/P7 (24 pins) 2: HP DeskJet / Laserjet 3: HP DeskJet / Laserjet (no optimizing) 4: Epson FX (9 pins) 5: Epson FX (9 pins) (without ESC $ n) default is: 1 -o printing quality (0: high quality, 1: draft), only for HP DeskJet (2: cheap hq, 3: cheap draft), default is: 0 -u printing bidirectional (default unidirectional), -x no form feed at the end of last page, -r print in reverse order, -z resolution in dpi, -p preload fonts, -q quiet, -s print statistics, -l no logfile. (default resolution for SLM 804: high: 300 dpi draft: 150 dpi) The program can be aborted by simultaneously pressing the right SHIFT key and the ALTERNATE key. ------------------------------ Including IMG files into TeX: showdvi/dviprint can handle IMG file within TeX-DVI-files: Syntax: in TeX file: vvvvv horiz. vvvvv vertical size of image in cm \special{imgfile=ente.img hsize=10 vsize=15} ^^^^^^^keyword for img filename filenames can be of the form: e;/local/raster/ente.img ^ ^path separator (stands for '\') this is ok (stands for ':') The IMG files should be in resolution for the printer. On the screen they are displayed in the size given as parameters at hsize and vsize within the \special command (in cm) ------------------------------------------------------------------ These versions of showdvi and dviprint allow both the use of flib's and the use of "bare" pk files. Since the loading of fonts within a flib is much faster the authors recommend the use of flib's for the majority of the fonts. The path to the fonts can either be specified in the font configuration file showdvi.fnt/dviprint.fnt (see below) or via the the environment variables PKDIR (for pk fonts) and FLIBDIR (for font libraries). It is allowed to add more than one path to these variables. The single pathes should be separated by ';' (or '!'). An other possibility to specify the font directory is to use the option -a. Showdvi/dviprint look for a configuration file where to search the fonts. This file is called showdvi.fnt/dviprint.fnt. It is searched in: - the contents of the environment variable DVICONFIG (default: c:\config) - via the system function shel_find (this function uses the environment variable PATH). PATH must be set before AES is initialized (i.e. in the \auto directory). The format of such a file: ; this is a comment font_str pk%04d\%s ; this specifies how showdvi searches single fonts. ; This string is added to the below specified ; directory for single fonts (e.g. f:\fonts\tex) ; It is analogous to the C function printf ; %d <---> resolution (e.g. 100 dpi) ; %s <---> name of the font (e.g. cmr10) font cmr10 100 f:\fonts\tex ; search the font cmr10 in the directory ; f:\fonts\tex\pk0100 ; ^^^^^^ flib_str pk%04d ; analogous to font_str (only %d allowed) flib 100 f:\fonts\tex\screen ; search the library for resolution 100 dpi ; in the directory f:\fonts\tex\screen. ; It must be called pk0100. The default path for libraries: f:\fonts\tex\libs The path for single fonts: f:\fonts\tex\fonts The default mask for single fonts: %d\%s The mask for libraries: pk%04d ------------------------------------------------------------------ Using flib: commandline options: FontLib Manager - Version 1.03 for ATARI ½ 1990 Georg Hessmann/Robert Stabl usage: flib c|a|x|d|z|p|l|t[v] library [-|[modules]*] c,a : create library / add (replace) module(s) to (in) library, x : extract module(s) from library, d : delete module(s) in library, t : print table, r : rename module(s) in library, z : create new flib from old flib, p : test checksums of all modules, l : create a flib link (second arg is the link destination), v : verbose mode, ? : print this help, - : read module name(s) from stdin. ------------------------------------------------------ This description to the new versions of showdvi and dviprint is very, very short. A more detailed version will be available soon (Georg is still working on it :-). ------------------------------------------------------ If there are still any questions about the usage of the programs or if you detect errors in the programs, feel free to contact me at: Robert Stabl Hollaenderstr. 45 D-8390 Passau Germany email: Internet: stabl@fmi.uni-passau.de or stabl@unipas.fmi.uni-passau.de or UUCP: ...uunet!unido!unipas!stabl or stabl@unipas.uucp