home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 26 / CD_ASCQ_26_1295.iso / vrac / shwtxt19.zip / UTILS.DOC < prev    next >
Text File  |  1995-07-21  |  7KB  |  95 lines
  1.           ┌─────────────────────────────────────────────────────────────┐
  2.           │ >>>>>>>>  Documentation for the Utility Programs  <<<<<<<<  │
  3.           └─────────────────────────────────────────────────────────────┘
  4. ───────────────────────────────────────────────────────────────────────────────
  5. ANSIB.EXE   -This program will perform a variety of ANSI screen control
  6.              commands from inside batch files. For more information, type ANSIB
  7.              on the command line with no arguments.
  8. ───────────────────────────────────────────────────────────────────────────────
  9. CVT.EXE     -This program will convert several files from one type to another.
  10.              The file types include:
  11.                .ANS - ANSI Screen Files (typically used in BBS systems)
  12.                .ASC - Plain ASCII text files (25 lines maximum)
  13.                .BSV - BLOAD/BSAVE files   (file length=4OO7 bytes)
  14.                .COM - Self-displaying COM files. If a file named TEMP.COM is
  15.                       created, it can be displayed by typing TEMP or by using
  16.                       the command TEMP in a batch file.  Note that the cursor
  17.                       position is not changed.  The most common use of these
  18.                       self-displaying COM files is in batch files with ECHO OFF.
  19.                .SCN - Binary screen image (file length=4OOO bytes)
  20.                .STF - ShowText File format (file size <= 4OOO bytes)
  21.              The command syntax is: CVT filename.ext type /V
  22.              where (filename.ext) is the file specification of the files to be
  23.              converted.  The (type) is one of the 6 file types listed above.
  24.              Wildcards are acceptable and a path may be specified with either
  25.              command line argument, although specific filenames may not be
  26.              included with the (type) argument.  For example, CVT *.BSV STF will
  27.              convert/copy all BSV files to STF files.  The original files aren't
  28.              deleted.  Note: The file CVT2COM.FIL must reside in the ShowText
  29.              directory.  It was purposely kept separate from the CVT.EXE file
  30.              so that it could be used to convert an .STF file (or .SCN file)
  31.              directly into a .COM file by issuing the following DOS command,
  32.              COPY/B CVT2COM.FIL+TEMP.STF TEMP.COM 
  33.              The /V optional command line argument will allow you to (V)iew the
  34.              files as they are converted. The default is No View.
  35. ───────────────────────────────────────────────────────────────────────────────
  36. GETAKEY.COM -This program pauses a batch file until a key is pressed.  The 
  37.              ASCII value of that key is returned as the DOS ERRORLEVEL.  
  38.              Extended keys such as F1 etc. are returned as 128+scan_code.
  39.              These values are the same as the values in the keycode table in
  40.              SHOWTEXT.DOC (except that F11 and F12 are not supported).  This
  41.              program was meant to be used in batch files using self-displaying
  42.              .COM files (with ECHO OFF) or with the SHOW.COM program..
  43. ───────────────────────────────────────────────────────────────────────────────
  44. RAT.EXE     -This program allows the mouse to be used inside batch files. For
  45.              more information, type RAT on the command line with no arguments.
  46. ───────────────────────────────────────────────────────────────────────────────
  47. SHOW.COM    -This program will display an .STF file on the screen. It may be
  48.              used in a batch file.  The syntax is SHOW filename or SHOW/P
  49.              filename.  Note that an extension must NOT be specified on the
  50.              command line.  The first syntax form (SHOW filename) will display
  51.              the filename.STF on the screen and will continue.  The second form
  52.              (SHOW/P filename) will display the filename.STF on the screen and
  53.              will then pause until the user presses a key.  The ASCII value of
  54.              that keystroke (or 128+scan_code_value for extended function keys)
  55.              will be placed in the DOS ERRORLEVEL variable which can then be
  56.              tested inside a batch file.  This can be used in a simple batch
  57.              file menu system.
  58. ───────────────────────────────────────────────────────────────────────────────
  59. STCAP.COM   -This program is a TSR (memory-resident) program which takes only
  60.              13.3k bytes of conventional memory to run.  Its purpose is to
  61.              capture color ASCII text screens to BSV, SCN or STF file types.
  62.              The program is made memory resident by simply typing STCAP on the
  63.              DOS command line.  To invoke the program, in order to capture a
  64.              text screen to a file, type Ctrl-Alt-S.  Be sure that the program
  65.              you were running is in text mode (not graphics mode).  The default
  66.              file extension is STF.  If you type an incorrect filename, such as
  67.              one whose extension is not BSV, SCN or STF, the program will not
  68.              save the screen to disk.  To (R)emove the TSR from memory, type
  69.              STCAP/R on the DOS command line.
  70. ───────────────────────────────────────────────────────────────────────────────
  71. VIEWSCN.COM -This program will display a 4OOO-byte text screen image file on a
  72.              color monitor.  The syntax is: VIEWSCN filename.ext, where the
  73.              extension MUST be specified.  The STD drawing program is capable
  74.              of storing screen images in this format (as .SCN files).
  75. ───────────────────────────────────────────────────────────────────────────────
  76. Special Notes about using ANSIB and RAT :
  77. 1. The batch file should be in the ECHO OFF mode when using the RAT or ANSIB
  78.    programs.  This prevents screen scrolling.
  79. 2. It is generally a good idea to execute the RAT RESET at the beginning of
  80.    the batch file.  If the mouse driver is subsequently loaded/unloaded,
  81.    then execute the RAT RESET again. It takes a second or two to reset the
  82.    mouse driver, so your batch file should do this only once (if at all).
  83. 3. RAT uses the intra-application communication area at OOOO:O4FO, therefore
  84.    any application program that utilizes this area will cause RAT to reset
  85.    itself each time. This is a very minor consideration since very few 
  86.    programs use this area.
  87. 4. Each application program should leave the mouse pointer in the hidden
  88.    state.  This is the assumption made by the RAT program.
  89. 5. Each application program should exit to DOS in the 8O-column, 25-row
  90.    TEXT mode.  If it doesn't, then be sure to execute MODE CO80 before
  91.    running the RAT program.
  92. 6. The RAT program can be used to retrieve KEYcodes even if the mouse is
  93.    not available. Of course, there will not be a mouse cursor.
  94.  
  95.