home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / UTILITY / SCREEN / WARPDRV.ZIP / WARP.DOC next >
Encoding:
Text File  |  1991-02-15  |  6.4 KB  |  145 lines
  1.  
  2.                                    Warp Driver
  3.  
  4.                                        by
  5.  
  6.                                    Eric Tauck
  7.                                1304 Deerpass Road
  8.                                 Marengo, IL 60152
  9.                                      U.S.A.
  10.  
  11.                              Compuserve: 72457,1557
  12.                        Internet: 72457.1557@compuserve.com
  13.  
  14.         Warp is a device driver for speeding up standard output.  Addi-
  15.         tional features of Warp include auto-pause, a shortened BIOS
  16.         beep, and partial ANSI support.  Warp requires a PC/XT/AT compat-
  17.         ible and DOS 2.0 or higher.
  18.  
  19.         There are three flavors of Warp, WARP.SYS, WARPF.SYS, and
  20.         WARPVF.SYS.  WARP.SYS is the most compatible but slowest, while
  21.         WARPVF.SYS is the least compatible but the fastest (the 'F' in
  22.         WARPF.SYS stands for fast and the 'VF' in WARPVF.SYS stand for
  23.         very fast).  Both WARPF.SYS and WARPVF.SYS use the undocumented
  24.         but standard PUTCHAR function (interrupt 29H).  Additionally,
  25.         WARPVF.SYS updates the hardware cursor only when necessary.  With
  26.         WARPVF.SYS, the cursor may be in odd locations during DOS opera-
  27.         tions, but should be moved to the correct location by the time
  28.         input is expected.  I recommend trying all three drivers to
  29.         determine which is most suitable for your system.
  30.  
  31.         Warp is installed in the CONFIG.SYS file:
  32.  
  33.           DEVICE=WARP.SYS [options]
  34.  
  35.         The possible options are:
  36.  
  37.           /C:x  Set the initial output color to x.  This value is an
  38.                 attribute byte in the range 0 to 255.  You need to look
  39.                 up the color values in a technical reference to set the
  40.                 output color in this manner.  You can also set the color
  41.                 with an ANSI sequence documented below.
  42.  
  43.           /S    Disable auto-pause.
  44.  
  45.           /S:x  Set auto-pause to x lines.
  46.  
  47.         The auto-pause feature works something like the MORE utility
  48.         included with DOS.  Whenever a specified number of lines have
  49.         been displayed, the message "Press any key to continue ..." is
  50.         displayed at the bottom of the screen and Warp waits for a key to
  51.         be pressed.  The auto-pause feature is enabled whenever scroll-
  52.         lock is active.  A screen can also be un-paused by turning off
  53.         scroll-lock.  By default, Warp will pause the screen after a
  54.         single page of lines, however, auto-pause can be set to a specif-
  55.         ic number of lines or totally disabled with the /S option.  Note
  56.         that Warp starts counting lines sent to the CON device after any
  57.  
  58.  
  59.  
  60.         input and will pause no matter what's being executed.  If you
  61.         plan on running a program unattended that sends its output to the
  62.         standard output device (CON), make sure you disable auto-pause or
  63.         turn scroll-lock off.
  64.  
  65.         Warp automatically generates a shorter and less annoying beep
  66.         than produced by DOS or BIOS.  This is done by hooking interrupt
  67.         10H and trapping all ASCII code 7's sent to the BIOS TTY func-
  68.         tion.  Only a few, mostly older, applications will be affected by
  69.         this.
  70.  
  71.         Warp's ANSI support is limited to clear screen, move cursor, and
  72.         set color.  The exact ANSI sequences supported are as follows:
  73.  
  74.           ESC[2J            clear screen
  75.           ESC[#;#f          move cursor
  76.           ESC[#;#H          move cursor
  77.           ESC[#;...;#m      set colors
  78.  
  79.         All ANSI sequences begin with ESC (ASCII code 27) and '[' (ASCII
  80.         code 91).  The # in the sequences refer to decimal numbers.  The
  81.         two numbers in the move cursor sequences are the row and column
  82.         location.  The numbers in the set colors sequence affect the
  83.         screen colors as follows:
  84.  
  85.            0  all attributes off, switch to normal color
  86.            1  bold on
  87.            4  (underscore, not supported)
  88.            5  blink on
  89.            7  (reverse video, not supported)
  90.            8  (concealed, not supported)
  91.           30  black foreground
  92.           31  red foreground
  93.           32  green foreground
  94.           33  yellow foreground (usually mapped to brown)
  95.           34  blue foreground
  96.           35  magenta foreground
  97.           36  cyan foreground
  98.           37  white foreground
  99.           40  black background
  100.           41  red background
  101.           42  green background
  102.           43  yellow background (usually mapped to brown)
  103.           44  blue background
  104.           45  magenta background
  105.           46  cyan background
  106.           47  white background
  107.  
  108.         Warp should work in all recognizable text modes.  If the /S
  109.         option is NOT specified, Warp will dynamically adjust the auto-
  110.         pause line count to the current number of displayed lines.  In
  111.         graphics modes, Warp passes all output to the BIOS.  Auto-pause
  112.         does not work in graphics modes.
  113.  
  114.         Though the ANSI sequence to clear the screen appears to work in
  115.  
  116.  
  117.  
  118.         all text modes, on my system, the DOS CLS command doesn't work
  119.         (it only clears the first 25 lines in the greater than 25 line
  120.         modes).  I think this is because DOS makes a direct call the to
  121.         BIOS to clear the screen, rather than using the CON device driv-
  122.         er.  If you have this problem, you could clear the screen by
  123.         displaying the clear screen ANSI sequence, for instance by ECHO-
  124.         ing ESC[2J.
  125.  
  126.         Compatibility considerations:
  127.  
  128.           * Warp expects the BIOS video routines to preserve the DI, SI,
  129.             and BP registers.  Some older ROM's (like the original IBM PC
  130.             ROM's) don't always do this.
  131.  
  132.           * Warp never waits for "vertical retrace" when displaying
  133.             characters, which may cause flickering on some CGA monitors.
  134.  
  135.           * Warp uses the older non-AT keyboard BIOS input routines, so
  136.             DOS will not be able to return extended keycodes (like F11
  137.             and F12).  This will probably effect few if any programs,
  138.             since most programs that use these codes use the BIOS for
  139.             input rather than DOS.
  140.  
  141.           * Warp positions the cursor by directly setting the location in
  142.             the video controller ports.  This may not work on nonstandard
  143.             video systems and may cause problems in some operating envi-
  144.             ronments.
  145.