home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 2 / FFMCD02.bin / new / gfx / show / egsdvi / egsdvi.manual < prev    next >
Text File  |  1993-12-21  |  12KB  |  251 lines
  1.  
  2.    NAME
  3.      EGSDVI - DVI Previewer for the EGS window system
  4.  
  5.    SYNOPSIS
  6.      egsdvi shrink/k/n, density/k/n, dpi/k/n, side/k, top/k, paper/k,
  7.             altfont/k, listfonts/s, hush/s, hushspecials/s, hushlostchars/s,
  8.             copy/s, thorough/s, version/s, mgs/k/n, page/k, width/k/n,
  9.             height/k/n, dvifile/f/a
  10.  
  11.    STATUS AND COPYRIGHT
  12.      This program is public domain. It may be distributed as long as the
  13.      program and this manual file are always distributed together with the
  14.      following copyright notice and are not modified in any way:
  15.              EGSDVI Copyright in 1993 by Dietmar Heidrich
  16.  
  17.    DESCRIPTION
  18.      EGSDVI is a program which runs under the EGS window system. It is used to
  19.      preview DVI files, such as are produced by TeX. EGSDVI needs EGS version 6
  20.      or higher.
  21.  
  22.      This program has the capability of showing the file shrunken by various
  23.      (integer) factors, and also has a `magnifying glass' which allows one to
  24.      see a small part of the unshrunk image momentarily.
  25.  
  26.      Before displaying any page or part thereof, it checks to see if the dvi
  27.      file has changed since the last time it was displayed.  If this is the
  28.      case, then EGSDVI will reinitialize itself for the new dvi file.  For this
  29.      reason, exposing parts of the EGSDVI window while TeX is running should be
  30.      avoided.  This feature allows you to preview many versions of the same
  31.      file while running EGSDVI only once.
  32.  
  33.      In addition to using keystrokes to move within the file, EGSDVI provides
  34.      buttons on the right side of the window, which are synonymous with vari-
  35.      ous sequences of keystrokes.
  36.  
  37.    SHELL OPTIONS
  38.      In addition to specifying the .dvi file (with or without the .dvi suffix),
  39.      EGSDVI supports the following command line options. The corresponding name
  40.      for the environment file (see below) is given in parantheses.
  41.  
  42.      page
  43.           Specifies the first page to show; the first page is the default.
  44.  
  45.      shrink
  46.           (shrinkFactor) Defines the initial shrink factor.  The default value
  47.           is 3.
  48.  
  49.      density
  50.           (densityPercent) Determines the density used when shrinking bitmaps
  51.           for fonts.  A higher value produces a lighter font.  The default
  52.           value is 40.
  53.  
  54.      dpi
  55.           (pixelsPerInch) Defines the size of the fonts to use, in pixels
  56.           per inch.  The default value is 300.
  57.  
  58.      altfont
  59.           (altFont) Declares a default font to use when the font in the dvi
  60.           file cannot be found.  This is useful, for example, with PostScript
  61.           <tm> fonts.
  62.  
  63.      listfonts
  64.           (listFonts) Causes the names of the fonts used to be listed.
  65.  
  66.      hushspecials
  67.           (hushSpecials) Causes EGSDVI to suppress warnings about \special
  68.           strings which it cannot process.
  69.  
  70.      hushlostchars
  71.           (hushLostChars) Causes EGSDVI to suppress warnings about references
  72.           to characters which are not defined in the font.
  73.  
  74.      hush
  75.           (hush) Causes EGSDVI to suppress all suppressable warnings.
  76.  
  77.      thorough
  78.           (thorough) EGSDVI will usually try to ensure that overstrike charac-
  79.           ters (e.g.  \notin) are printed correctly.  On monochrome displays,
  80.           this is always possible with one logical operation, either and or
  81.           or.  On color displays, however, this may take two operations, one
  82.           to set the appropriate bits and one to clear other bits.  If this
  83.           is the case, then by default EGSDVI will instead use the copy opera-
  84.           tion, which does not handle overstriking correctly.  The
  85.           `thorough' option chooses the slower but more correct choice.
  86.           See also copy, below.
  87.  
  88.      copy
  89.           (copy) Always use the copy operation when writing characters to
  90.           the display.  This option may be necessary for correct operation on
  91.           a color display, but overstrike characters will be incorrect.
  92.  
  93.      version
  94.           (version) Print information on the version of EGSDVI.
  95.  
  96.      sidemargin
  97.           (sideMargin) Specifies the side margin.
  98.           This should be a decimal number optionally followed by "cm",
  99.           e.g., 1.5 or 3cm, giving a measurement in inches or centimeters.
  100.           It determines the `home' position of the page within the window
  101.           as follows.  If the entire page fits in the window, then the margin
  102.           settings are ignored.  If, even after removing the margins from the
  103.           left, right, top, and bottom, the page still cannot fit in the win-
  104.           dow, then the page is put in the window such that the top and left
  105.           margins are hidden, and presumably the upper left-hand corner of
  106.           the text on the page will be in the upper left-hand corner of the
  107.           window.  Otherwise, the text is centered in the window.  See also
  108.           `M' under the KEYSTROKES section.
  109.  
  110.      topmargin
  111.           (topMargin) Specifies the top and bottom margins (see above).
  112.  
  113.      paper
  114.           (paper) Specifies the size of the printed page.  This may be of
  115.           the form wxh (or wxhcm), where w is the width in inches (or cm) and
  116.           h is the height in inches (or cm), respectively.  There are also
  117.           synonyms which may be used:  us (8.5x11), usr (11x8.5), legal
  118.           (8.5x14), foolscap (13.5x17), as well as the ISO sizes a1-a7, b1-
  119.           b7, c1-c7, a1r-a7r (a1-a7 rotated), etc.  The default size is 8.5 x
  120.           11 inches.
  121.  
  122.      mgs
  123.           (magnifierSize[n]) Specifies the size of the window to be used for
  124.           the `magnifying glass' for button n.  See the MOUSE ACTIONS sec-
  125.           tion.  Defaults are 200, 350, 600, 900, and 1200.  The shell option
  126.           lets you only specify the size for button 1.
  127.  
  128.      width
  129.           (width) Specifies the initial window width.
  130.  
  131.      height
  132.           (height) Specifies the initial window height.
  133.  
  134.    WORKBENCH
  135.      For the workbench, you will need to click the icon of the dvi file to
  136.      display and then double-click the EGSDVI icon while pressing a shift key.
  137.  
  138.    KEYSTROKES
  139.      EGSDVI recognizes the following keystrokes when typed in its window.
  140.  
  141.      q    Quits the program.  'x' will do this, too.
  142.  
  143.      n    Moves to the next page.  Synonyms are Space, Control-M (Carriage
  144.           Return) and Control-J (Line Feed).  If you press shift
  145.           simultaneously, the top part of that page will be displayed.
  146.  
  147.      p    Moves to the previous page.  Synonym is `b'.  If you press shift
  148.           simultaneously, the bottom part of that page will be displayed.
  149.  
  150.      cursor-up
  151.      cursor-down
  152.      cursor-left
  153.      cursor-right
  154.           Moves into the specified direction.  Pressing an alternate key
  155.           simultaneously moves a bigger portion, pressing a shift key
  156.           moves to the appropriate border.
  157.  
  158.      R    Forces the dvi file to be reread.  This allows you to preview many
  159.           versions of the same file while running EGSDVI only once.
  160.  
  161.    MOUSE ACTIONS
  162.      If the shrink factor is set to any number other than one, then clicking
  163.      any mouse button will pop up a `magnifying glass' which shows the
  164.      unshrunk image in the vicinity of the mouse click.  This subwindow
  165.      disappears when the mouse button is released.  Different mouse buttons
  166.      produce different sized windows, as indicated by the mgs option.  Mov-
  167.      ing the cursor while holding the button down will move the magnifying
  168.      glass.
  169.  
  170.      Also, the scrollbars behave in the standard way.  The buttons work the
  171.      expected way.  The page gadget lets you enter a direct page number.
  172.  
  173.    ENVIRONMENT
  174.      For access to persistent defaults, EGSDVI reads an environment file named
  175.      "TEX:.egsdvidefaults".  This file contains the options listed above.  Each
  176.      line of the file consists of a keyword and its arguments, separated by
  177.      spaces or tabs.  Comment lines start with a semicolon as the first
  178.      character.  Additionally, there can be the environment variables explained
  179.      in the following paragraph.
  180.  
  181.      The environment variable `DVIFONTS' determines the path(s) searched for
  182.      fonts in the following manner.  The string consists of one or more stri