home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / util2 / simcga41.lzh / READ.ME < prev    next >
Text File  |  1987-08-17  |  9KB  |  233 lines
  1.  
  2.            SIMCGA - A CGA SIMULATOR FOR MONOCHROME
  3.                 GRAPHICS CARDS
  4.  
  5.  
  6.      SIMCGA and this document copyright 1987 by C. P. Guzis
  7.             All rights reserved.
  8.  
  9.      Reproduction of SIMCGA or this document is prohibited
  10.      without the express written permission of C. P. Guzis.
  11.  
  12.                 ------------------
  13.  
  14.     This is version 4.0 of SIMCGA, released in July of 1987.  If you
  15.     have questions or inquiries concerning this product, please be
  16.     sure to mention that this is the "July 1987" version of SIMCGA.
  17.  
  18.  
  19.             -WHAT IS THIS PROGRAM?-
  20.  
  21.     SIMCGA is a program written for those IBM PC or "compatible"
  22.     users who have a Hercules Monochrome Graphics adapter card or
  23.     Hercules-compatible display adapter and would like to be able to
  24.     run programs requiring the IBM Color Graphics display adapter
  25.     facility.
  26.  
  27.  
  28.              -WHAT WILL AND WON'T WORK?-
  29.  
  30.     Because SIMCGA is a software product, there are certain hardware
  31.     limitations on its use.  Programs which access the Color Graphics
  32.     Adapter hardware registers directly generally will not operate in
  33.     a satisfactory manner - the hardware just isn't there to interact
  34.     with!  In general, try running the program - you won't clobber your
  35.     disks if it doesn't work.
  36.  
  37.     SIMCGA will not work with a plain old IBM monochrome adapter or-
  38.     with an Enhanced Graphics Adapter (EGA).
  39.  
  40.     Version 4.0 incorporates support for non-DOS diskettes which con-
  41.     tain their own operating system rather than using DOS.
  42.  
  43.  
  44.              -WILL SIMCGA RUIN MY MONITOR?-
  45.  
  46.     No.     SIMCGA programs your display adapter so that the frequencies
  47.     generated are very much within the specifications of your
  48.     monochrome monitor. (18.5 KHz horizontal and 53 Hz vertical).
  49.     However, you should avoid using programs which will cause
  50.     problems with a Hercules or Hercules-compatible card.  Most
  51.     "screen-saver" programs are in this category and may cause damage
  52.     to your monitor whether or not you are using SIMCGA.
  53.  
  54.  
  55.              -HOW DO I USE SIMCGA?-
  56.  
  57.     To run SIMCGA, copy the programs (all files ending with .COM) on
  58.     this disk to the directory or diskette where you normally keep
  59.     your system programs.  Then decide if you want to run in "stand-
  60.     alone" or DOS mode.  Standalone mode is used with programs which
  61.     "boot up" without DOS; many games fall in this category.  DOS mode
  62.     is used with programs which require DOS to execute.     In either case,
  63.     first load DOS.
  64.  
  65.     If you want to run a "standalone" program, enter -
  66.  
  67.             SIMCGA S<Return)
  68.  
  69.     (<Return> means press the "Return" key on your keyboard).  SIMCGA
  70.     will display the product notice and request that a program diskette
  71.     be inserted into diskette drive "A".  Place the diskette containing
  72.     the program you wish to run in the "A" drive and press any key.  The
  73.     program will be loaded and begin execution in CGA emulation mode.
  74.     To remove SIMCGA from your computer, turn the computer's power switch
  75.     off, then on again.     A Ctl-Alt-Del keyboard reset will, on most com-
  76.     puters, also cause SIMCGA to disappear.
  77.  
  78.     If you want to run a DOS-based program enter -
  79.  
  80.            SIMCGA<Return>
  81.  
  82.     (<Return> means press the "Return" key on your keyboard).
  83.     SIMCGA will load its resident part (or tell you why it won't) and
  84.     set your display to 80x25 color text mode.    Your display adapter
  85.     will appear to be a Color Graphics Adapter board to most programs
  86.     accessing it.
  87.  
  88.     To resume ordinary monochrome text operations, enter -
  89.  
  90.            MONO<Return>
  91.  
  92.     To go back to CGA 80x25 mode, enter -
  93.  
  94.            CGA<Return>
  95.  
  96.     To set 640x200 high-resolution graphics mode, enter -
  97.  
  98.            HIRES<Return>
  99.  
  100.     To set 320x200 medium-resolution graphics mode, enter -
  101.  
  102.            MEDRES<Return>
  103.  
  104.     For most applications, MONO and CGA will suffice to set either
  105.     monochrome or graphics modes.
  106.  
  107.     To completely remove SIMCGA from your computer's memory, enter -
  108.  
  109.           RMVCGA<Return>
  110.  
  111.     Like the standalone mode, the DOS mode SIMCGA will disappear
  112.     with a Ctl-Alt-Del keyboard reset.
  113.  
  114.     If you desire, you may also run DOS as a standalone program.
  115.     Just insert your DOS diskette when the program diskette is re-
  116.     quested.
  117.  
  118.         -IF YOUR PROGRAM RUNS TOO SLOWLY-
  119.  
  120.     Some programs, especially games, require large amounts of atten-
  121.     tion from your computer.  SIMCGA also requires some of your com-
  122.     puter's attention to keep the display looking good.  If you find
  123.     that there is not enough computer to go around, you may instruct
  124.     SIMCGA to use less of your machine's resources.  However, nothing
  125.     is free, and the display will exhibit more "ghosting".
  126.  
  127.     To change the amount of time SIMCGA "steals" from your application,
  128.     use a number from 0 to 9 on the SIMCGA command line.  0 tells
  129.     SIMCGA to use the largest portion of your computer's power to
  130.     maintain the display; hence programs will run more slowly.    9 tells
  131.     SIMCGA to use the least practical amount of your computer's
  132.     power to maintain the display; you will however, see the greatest
  133.     amount of "ghosting".  If you are using SIMCGA in the "standalone"
  134.     mode, the number may either precede or follow the "S" parameter.
  135.  
  136.     For example -
  137.  
  138.         SIMCGA 3<Return>
  139.         SIMCGA S 2<Return>
  140.         SIMCGA 5S<Return>
  141.  
  142.     are all forms that SIMCGA can understand.
  143.  
  144.  
  145.        -"IT LOOKS LIKE I'M LOOKING THOUGH A SCREEN WINDOW"-
  146.  
  147.     If you're running a program (most likely a game) and you notice
  148.     that the display has fine black lines running horizontally across
  149.     it, try using SIMCGA up with the letter "I" on the command line.
  150.     This has to do with how SIMCGA deals with the timer on your com-
  151.     puter, but should not otherwise affect program operation.  The
  152.     "I" parameter may be combined with any of the others.
  153.  
  154.     For example -
  155.  
  156.         SIMCGA I
  157.         SIMCGA I 2
  158.         SIMCGA 3SI
  159.  
  160.     are forms acceptable to SIMCGA.
  161.  
  162.             -THINGS YOU MAY NOTICE-
  163.  
  164.     "Ghosting" of moving graphics images - this is just the way the
  165.     program operates and is nothing to be worried about.
  166.  
  167.     Some lines are thicker than others in graphics mode - SIMCGA
  168.     fills out the displayed image by "doubling" every other line.
  169.  
  170.  
  171.                 -COMPATIBILITY-
  172.  
  173.     When you run SIMCGA, you may get a message to the effect that
  174.     SIMCGA has detected that your monochrome graphics adapter is not
  175.     CGA-compatible.  What this is trying to say is that not all
  176.     "clones" -accurately- reproduce the functionality of the Hercules
  177.     monochrome graphics adapter.  SIMCGA will attempt to make the
  178.     best of the situation; however, the simulation may not be perfect
  179.     in the 80x25 and 40x25 CGA text modes.  Graphics modes will work
  180.     correctly regardless of the brand of monochrome graphics adapter
  181.     used.
  182.  
  183.  
  184.            -DISTYPE - DETERMINE DISPLAY TYPE-
  185.  
  186.     A utility program for use in batch files is provided for the purpose
  187.     of determining the type of the current active display adapter.  DIS-
  188.     TYPE may be invoked by the following statement -
  189.  
  190.          DISTYPE
  191.  
  192.     DISTYPE returns an error code corresponding to the display adapter
  193.     configuration found -
  194.  
  195.      0    A monochrome adapter with no graphics capabilities has been
  196.           detected.
  197.      1    SIMCGA is currently installed with a monochrome graphics
  198.           adapter.
  199.      2    A Color Graphics Adapter (CGA) is in use.
  200.      3    An Enhanced Color Graphics Adapter (EGA) is in use.
  201.      4    A monochrome graphics adapter (HGC) is installed, but SIMCGA
  202.           has not been run.
  203.  
  204.     The code returned by DISTYPE may be queried by use of the DOS "IF
  205.     ERRORLEVEL" statement (consult the DOS reference manual for details).
  206.     Here is an example of the use of DISTYPE in a batch file -
  207.  
  208.           ECHO OFF
  209.           DISTYPE
  210.           IF ERRORLEVEL 4 GOTO DOSIM
  211.           IF ERRORLEVEL 3 GOTO EGA
  212.           IF ERRORLEVEL 2 GOTO CGA
  213.           IF ERRORLEVEL 1 GOTO SETCGA
  214.           ECHO  *** ERROR ***
  215.           ECHO  GRAPHICS ADAPTER REQUIRED
  216.           GOTO QUIT
  217.           :DOSIM         GOT HGC WITH NO SIMCGA YET
  218.           SIMCGA
  219.           GOTO QUIT
  220.           :EGA         GOT EGA, OKAY
  221.           :CGA         GOT CGA, OKAY
  222.           GOTO QUIT
  223.           :SETCGA         SIMCGA AROUND, ENABLE EMULATION
  224.           CGA
  225.           :QUIT         COMMON EXIT POINT
  226.  
  227.  
  228.              -----------------------
  229.  
  230.  
  231.     "Hercules" is a trademark of Hercules Computer Technology; "IBM" is a
  232.     trademark of International Business Machines Corporation.
  233.