home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-386-Vol-2of3.iso / h / hercap10.zip / HERCAP.DOC < prev    next >
Text File  |  1991-01-13  |  8KB  |  187 lines
  1.  
  2.  
  3.  
  4.                            H E R C A P  1 . 0
  5.                            ==================
  6.  
  7.                        TapirSoft Gisbert W.Selke
  8.  
  9.                                 Jan 1991
  10.  
  11.  
  12. General Overview
  13. ================
  14.  
  15. HerCap provides you with the possibility to capture Hercules graphics
  16. screens to your disk. The graphics output is written in TIFF format,
  17. which has been specified jointly by Aldus and MicroSoft; today, this
  18. format comes as close to a raster graphics file standard as any.
  19.  
  20. Many graphics packages are able to read and process this format; chances
  21. are that the graphics editor of your choice does support this format.
  22. (If not, you might consider using PoMTEd, the Poor Man's TIFF Editor, by
  23. the same author.) Alternatively, there are graphics format converters
  24. available for free or as shareware which allow you to convert TIFF
  25. format into a bunch of other 'standard' formats. (A good example is
  26. Graphic WorkShop, or GWS, which is copyrighted by Alchemy Mindworks
  27. and is available form many bulletin boards all over the world.)
  28.  
  29.  
  30. Basic Instructions
  31. ==================
  32.  
  33. The simplest way to run HerCap is to invoke it from the DOS command
  34. line just like that:
  35.  
  36.                 hercap
  37.  
  38. HerCap will install itself in memory with default values (cf. below) and
  39. wait for you to trigger it. You may now enter your graphics application,
  40. and whenever your screen shows a picture you want to save, hit the hot
  41. key, by default Ctrl-F9. HerCap will then write the graphics screen to a
  42. file named SCN00000.TIF in the current directory, which takes a few
  43. moments, depending on the speed of your disk.
  44.  
  45. The next time you want to save some picture, press Ctrl-F9 again, and a
  46. new file named SCN00001.TIF will be written to the current directory,
  47. and so forth.
  48.  
  49. After exiting you graphics application, you will be able to view these
  50. graphics files with any of a bunch of TIFF viewers, or include them for
  51. printer output in your word processor (e.g., MicroSoft's can do so, at
  52. least for versions 5.0 and up).
  53.  
  54. HerCap will remain in memory until you re-boot, so you may enter your
  55. graphics application again and again without having to run HerCap again.
  56.  
  57. Note that the TIFF files are always written to the current directory,
  58. unless you have explicitly requested otherwise (cf. below); the number
  59. part of the name, however, will be incremented even if you have changed
  60. directories in the meantime. HerCap will never overwrite an existing
  61. file, though.
  62.  
  63.  
  64. Optional arguments
  65. ==================
  66.  
  67. The behaviour of HerCap may be changed on the command line by a few
  68. optional arguments, to wit:
  69.  
  70. /?      : display list of available arguments; do not install
  71. /0      : The Hercules graphics adapter has two pages, 0 and 1. Most
  72.           applications use page 0, so this is the default.
  73. /1      : Alternatively, this tells HerCap to use page 1. Specify this
  74.           argument if your TIFF files end up empty.
  75. /P<path>: Use the path given instead of the current directory. This
  76.           ensures that you'll find all your graphics dumps in one place,
  77.           even if you change directories wildly. You should use absolute
  78.           paths (i.e., as seen from the root directory) and drive
  79.           specifier, to make sure. (Don't type the angle brackets!)
  80. /K<xxxx>: Use a different hot key specified by the 4 hex digits <xxxx>
  81.           (again, don't type the angle brackets!). The default is 4309
  82.           for Ctrl-F9. If you specify /K?, you will be prompted to hit a
  83.           key; HerCap will not install itself but show the hex number
  84.           that this key corresponds to.
  85. /U      : Uninstall HerCap, i.e., tell HerCap to remove itself from
  86.           memory. You may want to do this when you're sure you no longer
  87.           need HerCap for a while; it will return a considerable chunk
  88.           of memory to DOS and your other programmes.
  89.  
  90.  
  91. As an example, if you want HerCap to write the graphics file to your RAM
  92. disk E: and to trigger whenever you type Ctrl-Alt-P, you should use
  93.  
  94.                 hercap /pe: /k1908
  95.  
  96. Note that there are no blanks between "/p" and the path, and between
  97. "/k" and the number.
  98.  
  99. To remove HerCap later, type
  100.  
  101.                 hercap /u
  102.  
  103. There is no way to change the parameters once HerCap has been started;
  104. so, if you discover you want to change one of the parameters later, you
  105. have to remove HerCap using the "/u" argument and install it anew.
  106.  
  107.  
  108. Possible Problems
  109. =================
  110.  
  111. HerCap uses about 32 kB of main DOS memory. This may be a problem with
  112. very large graphics applications. If, however, your graphics application
  113. runs fine with HerCap in memory, but a different programme needs more
  114. memory (say, your word processor), you can easily reclaim memory by
  115. removing HerCap from memory as soon as you're finished capturing.
  116.  
  117. Note that, due to the design of DOS, memory is *not* freed up if another
  118. resident utility has been loaded *after* HerCap. In this case, you
  119. should first remove that utility and then proceed to uninstalling
  120. HerCap.
  121.  
  122. A common conflict arises from hot key usage. If your graphics
  123. application acts on Ctrl-F9, you won't be able to perform this action
  124. anymore. Unles... you tell HerCap what other hot key to use! Find a key
  125. that is not used for any other purpose, and restart HerCap with a
  126. different hot key assignment (cf. above). (Remember you have to
  127. uninstall HerCap if it's already loaded!)
  128.  
  129. If your TIFF file shows all black-on-black, your graphics programme
  130. maybe uses a different video page. Try "/1" on the command line.
  131.  
  132.  
  133. Restrictions
  134. ============
  135.  
  136. HerCap uses some 32 KB memory, which is quite a lot. The reason is that
  137. the complete screen is stored in memory before it is written out to
  138. disk. This, in turn, is necessitated by DOS not being re-entrant.
  139.  
  140. HerCap uses neither extended nor expanded memory. If interest warrants,
  141. such a feature will be included in a future release... maybe.
  142.  
  143. HerCap writes its output uncompressed. This is in order to keep the
  144. resident code as small as possible. Use one of the standard TIFF file
  145. processors in order to compress files, if you so desire.
  146.  
  147. HerCap, as the name suggests, works only on Hercules graphics adapters
  148. and compatibles. If you have a different adapter, don't use HerCap! (No
  149. harm would be done, but you won't like the results either.) There are
  150. quite a few around, commercial and shareware, that you can use in such
  151. an environment.
  152.  
  153. HerCap hooks into interrupts 09h, 13h, 16h, and 21h. It is, however,
  154. 'well-behaved'; i.e, it interferes only as far is unavoidable. This
  155. means it will not pass along the hot key, and it also reserves int 16h
  156. calls with ax=4242h and ax=4243h, which should be no problem at all. -
  157. Some memory mappers report that HerCap also hooks interrupts ECh and
  158. EFh; this seems to be an artifact, as HerCap definitely does *not* touch
  159. these vectors that are purported to be used by DOS's BASIC interpreter.
  160.  
  161. HerCap will handle errors during writing to disk only so-so. In
  162. particular, a full disk leads to a partial TIFF file that will probably
  163. be unusable. Also, if you write to your disk's root directory and it
  164. becomes full, you'll be in trouble. (This is a limitation of DOS;
  165. use a subdirectory instead.)
  166.  
  167.  
  168. Legal Stuff
  169. ===========
  170.  
  171. HerCap is a heavily hacked version of a PC Magazine Utility by name of
  172. Capture, which dumps text screens to disk files. The original utility's
  173. copyright remains intact; for the parts written by me, I retain the
  174. copyright. In any case, this utility may be used and copied freely.
  175.  
  176.  
  177. In case of problems, suggestions etc., why not get in touch with me at
  178.  
  179. TapirSoft
  180. Gisbert W.Selke
  181. Ermekeilstr. 28
  182. D-5300 Bonn 1
  183. Germany
  184.  
  185.  
  186.  
  187.