home *** CD-ROM | disk | FTP | other *** search
/ Groovy Bytes: Behind the Moon / groovybytes.iso / GROOVY / SND_TOOL / WM10.ZIP / DOC.DAT / dosbox.txt < prev    next >
Encoding:
Text File  |  1995-08-30  |  4.2 KB  |  82 lines
  1.  WM DOSbox
  2.  ─────────
  3.  
  4.  WM DOSbox constitutes an integrated part of the WAVmaker user interface. It
  5.  is NOT meant for standalone operation. The safest (and most convenient) way
  6.  to invoke it is to use the DOSBOX keyword in a menu definition file (see
  7.  {Customiz}), letting WMmain/WMmenu take care of the details. Should you
  8.  nevertheless wish to write your own code invoking WM DOSbox, then here's what
  9.  you'll need to know:
  10.  
  11.  What it does: WM DOSbox hooks DOS interrupt 29H (fast character output) and
  12.  ───────────── replaces it with its own handler, which color-codes DOS console 
  13.  output and redirects it to a restricted screen area. It also hooks and chains
  14.  DOS interrupt 08H (system timer), inserting screen saver and mouse poller, 
  15.  and DOS interrupt 09H (keyboard). It then launches the program specified in 
  16.  the THIRD command line parameter, passing all subsequent command line 
  17.  parameters to it. If the program is not found in the current directory, the 
  18.  PATH environment variable is used to search for it. If the program fails to 
  19.  execute directly, an attempt is made to load it with the command processor 
  20.  specified in the COMSPEC environment variable (this allows transparent 
  21.  execution of BAT files). WM DOSbox remains loaded in memory while the child 
  22.  process is running. Upon termination of the child process, it restores the 
  23.  original interrupts and exits.
  24.  
  25.  The use of command line parameters number 1 and 2 is detailed below.
  26.  
  27.  Interrupt 29H is not documented by Microsoft, but has been available in all
  28.  MS-DOS versions since 2.0. It is documented in Digital Research's DR-DOS, and
  29.  also works with IBM's PC-DOS. A simple way to make sure that all character 
  30.  output is filtered through it is to install ANSI.SYS (see your DOS manual).
  31.  
  32.  Command line parameters: The first two command line parameters passed to WM
  33.  ──────────────────────── DOSbox contain all information needed to set up the
  34.  screen output area and the screen saver. 
  35.  
  36.  ■ Parameter #2 is the program to be executed; it is also the title string to 
  37.    be displayed by the screen saver.
  38.    
  39.  ■ Parameter #1 is made up of the following parts:
  40.    
  41.    (1) A character specifying whether the screen saver is to be used (S) or 
  42.        not (N).
  43.    (2) A one-digit HEX number specifying the foreground color for characters
  44.        'A' through 'Z'.
  45.    (3) A one-digit HEX number specifying the background color for characters
  46.        'A' through 'Z'.
  47.    (4) A one-digit HEX number specifying the foreground color for characters
  48.        '0' through '9'.
  49.    (5) A one-digit HEX number specifying the background color for characters
  50.        '0' through '9'.
  51.    (6) A one-digit HEX number specifying the foreground color for all other
  52.        characters.
  53.    (7) A one-digit HEX number specifying the background color for all other
  54.        characters.
  55.    (8) A two-digit DECIMAL number specifying the leftmost column in the screen
  56.        output area (1-80).
  57.    (9) A two-digit DECIMAL number specifying the first row in the screen output
  58.        area (1-25).
  59.   (10) A two-digit DECIMAL number specifying the rightmost column in the screen
  60.        output area (1-80).
  61.   (11) A two-digit DECIMAL number specifying the last row in the screen output
  62.        area (1-25).
  63.  
  64.  Color numbering is standard DOS.
  65.  
  66.  Any deviation from this scheme or attempt to use illegal values (e.g. column
  67.  positions outside of the range 1-80, or a rightmost column position smaller
  68.  than the leftmost column position) will cause WM DOSbox to be aborted.
  69.  
  70.  No error messages are displayed upon premature termination, but the DOS
  71.  ERRORLEVEL is set to 1 (0 upon normal termination). This is also done if the
  72.  child process is terminated by the user with a Ctrl-C.
  73.  
  74.  The screen saver is a simple affair. It displays the title string specified in
  75.  ──────────────── command line parameter #2 after about 10 seconds of keyboard
  76.  and mouse inactivity and moves it to a new screen position every 3 seconds,
  77.  while redirecting all other screen output to a virtual screen. Moving the 
  78.  mouse, clicking a mouse button, or hitting a key dumps the virtual screen to 
  79.  the physical one and restarts the time count.
  80.  
  81.  Finally, keep in mind that WM DOSbox is STRICTLY textmode only!
  82.