home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / graf / gemcap.zip / GEMCAP.DOC < prev   
Text File  |  1987-10-03  |  6KB  |  148 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                   Natural Software
  8.                                 19 South 5th. Street
  9.                              St. Charles, Illinois 60174
  10.                                    (312) 377-7320
  11.  
  12.  
  13.         This share-ware  utility program:  GEMCAP.COM, allows  you to capture
  14.         screen images  from other  programs, save  them in  separate GEM .IMG
  15.         files, and  later load  them into  other programs  that can read this
  16.         format such as Ventura Publisher. 
  17.  
  18.         GEMCAP requires an IBM color graphics adapter (CGA) or EGA or compati-
  19.         ble. It will not work with other display adapters such as Hercules.
  20.  
  21.         GEMCAP is a Terminate and Stay Resident (TSR)  program. When  you run
  22.         it  from  the  DOS  command  line,  it will announce its presence and
  23.         quietly sink into the background and  wait to  be called  into action
  24.         (when  its  "hot  key"  is  pressed).  When  you run GEMCAP, you must
  25.         provide it with the location and starting file  name to  use to store
  26.         the screen  images it  captures. For  example, you might start GEMCAP
  27.         with this command:
  28.  
  29.                     GEMCAP C:\SCREENS\SCREENA.IMG
  30.  
  31.         Now GEMCAP will store its screens  in the  SCREENS sub-directory. The
  32.         first screen  it saves will be called SCREENA.IMG, the second will be
  33.         called SCREENB.IMG. Each  subsequent  .IMG  file  will  increment the
  34.         character in  the filename just before the extension. These files are
  35.         graphic bit image files  compatible with  any program  that reads GEM
  36.         .IMG files,  regardless of  whether the  original screen  was in text
  37.         mode or graphics mode.
  38.  
  39.         To activate GEMCAP and save the  current screen  to a  .IMG file, you
  40.         press the [Alt + left Shift] keys together. You will hear a beep when
  41.         GEMCAP is  called. Three  beeps means  it successfully  wrote an .IMG
  42.         file to the specified directory. Only one beep means it was unable to
  43.         create the file (could not find the directory?). Only two beeps means
  44.         it created  the file, but could not write the full 16k screen buffer,
  45.         (disk full?).
  46.  
  47.         GEMCAP will  detect the  current video  mode and  adjust. It converts
  48.         text mode screens into bit mapped graphics.
  49.  
  50.         Like any other TSR, GEMCAP may have compatibility problems with other
  51.         software, especially other TSR's. If you have trouble, try installing
  52.         GEMCAP by  itself and  adding your  other TSR utilities one at a time
  53.         after you get GEMCAP to work.
  54.  
  55.         Removing GEMCAP:
  56.  
  57.         You can remove GEMCAP from memory (well, almost) by pressing the [Alt
  58.         + Right  Shift] key  combination. This  disengages GEMCAP  so that it
  59.         will not interfere with other software. This will  also release (most
  60.         of) the  memory used  by GEMCAP.  When loaded and active, GEMCAP uses
  61.         3856 bytes of memory. After removal  with [Alt  + Right  Shift], only
  62.         288 bytes remain allocated. It's probably a good idea to do this only
  63.         at the DOS command prompt!
  64.  
  65.  
  66.  
  67.  
  68.  
  69.         Different sized images:
  70.  
  71.         The size of the captured image is controlled by two words in the .IMG
  72.         file. These are constants  in  the  GEMCAP  program.  The  first word
  73.         specifies  the  pixel  size  in  width, the second word specifies the
  74.         pixel size in height  (unit of  measure is  in microns).  The default
  75.         values are: (in hexidecimal):
  76.  
  77.           Address        Value        
  78.           0108           00D5 (width), 
  79.           010A           01AA (heigth).
  80.  
  81.         To make  the displayed image one half the size of the default, change
  82.         these values to
  83.  
  84.  
  85.           Address        Value        
  86.           0108           006A (width), 
  87.           010A           00D5 (heigth).
  88.  
  89.         The steps using Debug to do this are: (you enter the stuff marked ^^)
  90.  
  91.                DEBUG XYZ.IMG                 (Load the image file)
  92.            ^^^^^^^^^^^^^
  93.                E 0108                        (enter data at address 0108)
  94.            ^^^^^^
  95.                XXXX:0108 00.00 D5.6A         (change  00D5   to  006A,  press
  96.                             ^^    ^^           space bar between entries)
  97.  
  98.                E 010A                        (do the same for address 010a)
  99.            ^^^^^^
  100.                XXXX:010A 01.00 AA.D5         (change 01AA to 00D5)
  101.                 ^^      ^^
  102.                W                             (write the changes to the file)
  103.            ^
  104.                Writing 4020 bytes
  105.  
  106.                Q                             (return to DOS)
  107.            ^
  108.         You can experiment with other values. However, some combinations will
  109.         cause truncations of pixels when the image is displayed.
  110.  
  111.         If you  find a  set of values that work for your application and wish
  112.         to make them the default values for all  captured images,  change the
  113.         corresponding values in the program (GEMCAP.COM) itself. These are at
  114.         address locations 0951 and 0953  (hex)  when  GEMCAP  is  loaded into
  115.         DEBUG.
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.         ShareWare:
  128.  
  129.         GEMCAP is  being distributed  as shareware. This means that it is not
  130.         free. This means that you must  pay to  use it.  However, you  do not
  131.         have to pay to try it, test it, and to determine if it is going to be
  132.         useful to you. You  are probably  familiar with  the concept  by now.
  133.         ShareWare programs give you the advantage of "test driving" them. The
  134.         advantage to the developer  is a  relatively inexpensive distribution
  135.         method.  For  this  concept  to  work and keep working for our mutual
  136.         advantage, you really must register  and  pay  for  the  software you
  137.         actually find useful.
  138.  
  139.         To register  your use  of GEMCAP,  send $20.00 to Natural Software at
  140.         the address above. We  will  send  you  a  description  of  our other
  141.         software offerings and provide telephone support. 
  142.  
  143.         If you  have suggestions for improvement, or problems please write or
  144.         call.
  145.  
  146.  
  147.  
  148.