home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Atari FTP
/
ATARI_FTP_0693.zip
/
ATARI_FTP_0693
/
Tex
/
Dvi
/
shdvi10b.zoo
/
readme.txt
< prev
next >
Wrap
Text File
|
1990-08-23
|
12KB
|
325 lines
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)
<CTRL>-S
or
<CTRL>-P: enter number of next page to display
<CTRL>-F: enter filename
<UNDO>
or
<CTRL>-C: quit
<NUMKEYS>-<SHIFT>-+ : go to last page
<NUMKEYS>-<SHIFT>-- : go to first page
+
or
<NUMKEYS>-+ : one page forward
-
or
<NUMKEYS>-- : one page backwards
<ENTER>: one page forward and top of the page
<RETURN>: one page forward
<INSERT>: toggle scrollbars on/off
<NUMKEYS>-7: show upper left corner of the page
<NUMKEYS>-9: show upper right corner of the page
<NUMKEYS>-8: scroll up one screen size
<NUMKEYS>-2: scroll down one screen size
<NUMKEYS>-4: scroll left one screen size
<NUMKEYS>-6: scroll right one screen size
<NUMKEYS>-1: show lower left corner of the page
<NUMKEYS>-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