| Home | Previous | Next | 
 
  
    Under X-Windows, Zoom does not currently provide a graphical
    interface for configuration. Instead, you can configure Zoom by
    editting a .zoomrc file in your home directory, or a
    global zoomrc in /usr/local/share/zoom
    by default (this will be created when you install Zoom). It is
    probably advisable to copy this default file to your home
    directory and edit it rather than create a whole new file from
    scratch.
  
The .zoomrc file consists of a single default definition, followed by an optional number of definitions for individual games. Game definitions can override any option defined in the default defintion (so you can give a particular game different fonts, for example). However, this feature is most often used for setting the title of individual games to something more descriptive than the filename and serial number.
    Each definition in the zoomrc file begins with a specifier that
    indicates which game it is for. This is of the form 'game
    "<title>" <serial numbers>'. The
    default definition is specified by 'default
    "<title>"'. The title can be any string you
    like - the default is "%s (%i.%.6s.%04x)" (this piece of magic
    tells Zoom to substitute in the filename and serial number of the
    game). Serial numbers have two forms: RELEASE.SERIAL (eg
    23.020901 - most games display their release and serial numbers at
    startup) and RELEASE.SERIAL.CHECKSUM (eg 23.020901.6f94 - Zoom
    displays this form in its title bar when you use the default
    title). The advantage of the latter is that it is much more unlikely
    that any two games will have the same ID. If a game has multiple
    releases, you can specify multiple IDs by seperating them with commas.
  
The specifier may, optionally, be followed by a list of options enclosed in curly brackets ({}). A complete list of these follows:
revision
      Z). Games usually just print this at the start and
      otherwise ignore it.
    font3'. You can obtain an X font specifier using
      the xfontsel utility. Type 1 fonts are only
      available if Zoom was compiled with T1Lib support built in: the
      file name should be followed by a space and a number indicating
      the font size (in pixels) - ghostscript comes with a useful
      selection of type 1 fonts that can be used. 'font3' is a special
      font indicating that Zoom should use the 'symbolic' font 3 that
      it has built in. The 'style' parameter indicates for which
      display styles the font should be used. roman is
      the default style. The style can also be one, or a combination
      of, fixed, bold, italic
      and symbolic: combine styles with '-' - eg
      'fixed-bold-italic'. You should provide at least
      roman and fixed fonts: there are a
      total of 16 possible styles, but most games only use the 'pure'
      styles rather than combinations.
      The number should be unique for each font, counting from 1.
NOTE: Zoom will use Xft for font rendering if at all possible. This enables anti-aliasing, and also provides support for rendering Unicode. Zoom will, however, fall back to the standard X font system if Xft is not available for any reason. Any fixed pitch fonts should be specified as being the same size, and Type 1 fonts do not make good fixed-pitch fonts.
(Red, Green, Blue)', wher Red, Green and Blue are
      numbers in the range 0 - 255. Colours are seperated with commas,
      and are defined starting with colour 0. You should provide at
      least the 8 standard colours. The Z-Machine colours are defined
      as follows:
      
    This provides an example of a definition for a game. Note that any
    options not specified for a game will be taken from the
    default block.
  
game "Beyond Zork" 47.870915, 49.870917, 51.870923, 57.871221
{
  interpreter 5
  revision    Z
  font 1 "/usr/share/ghostscript/fonts/n021003l.pfb 14" roman
  font 2 "/usr/share/ghostscript/fonts/n021004l.pfb 14" bold
  font 3 "/usr/share/ghostscript/fonts/n021023l.pfb 14" italic
  font 4 "-*-courier-medium-r-*-*-14-*-*-*-*-*-*-*"     fixed
  font 5 "-*-courier-bold-r-*-*-14-*-*-*-*-*-*-*"       fixed-bold
  font 6 "-*-courier-medium-o-*-*-14-*-*-*-*-*-*-*"     fixed-italic
  font 7 "-*-courier-bold-o-*-*-14-*-*-*-*-*-*-*"       fixed-bold-italic
  font 8 "/usr/share/ghostscript/fonts/n021024l.pfb 14" bold-italic
  font 9 "font3"                                        symbolic, fixed-symbolic
}
  
  Zoom written by Andrew Hunter. Mail any suggestions, bug reports or abuse to andrew@logicalshift.demon.co.uk