Index of /atarilibrary/atari_cd03/UNPACKED/TOOLS/TEXTTOOL/DVI_1_00/FLIB

      Name                    Last modified       Size  Description

[DIR] Parent Directory 11-May-2007 20:53 - [TXT] ACCESS.C 16-Jul-1990 05:14 1k [TXT] FLIB.C 23-Aug-1990 07:32 44k [TXT] FLIB.PRJ 15-Apr-1993 16:05 1k [TXT] FLIB.TTP 15-Apr-1993 16:05 18k

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