home *** CD-ROM | disk | FTP | other *** search
/ norge.freeshell.org (192.94.73.8) / 192.94.73.8.tar / 192.94.73.8 / pub / computers / pcjr / games / PIXTRIX.LZH / GRABBER.DOC < prev    next >
Text File  |  1987-05-28  |  9KB  |  212 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                      GRABBER.COM  Ver. 2.10
  8.                      ----------------------
  9.                    The Screen-Capture Program
  10.                       for the IBM PC/XT/AT
  11.                    and Color/Graphics Adapter
  12.  
  13.  
  14.  
  15.                 DOCUMENTATION AND TECHNICAL NOTES
  16.                           May 28, 1987
  17.  
  18.  
  19.  
  20.                       Copyright (C) 1987 by
  21.                         Gerald A. Monroe
  22.                       All rights reserved.
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30. GRABBER is currently marketed as a shareware program.
  31.  
  32. This means you have the opportunity to use and evaluate it
  33. before you decide to buy.  If you find that it meets your
  34. expectations, then you are strongly encouraged to send your
  35. contribution of $5.00 to me at the address given below.
  36.  
  37. That's a very reasonable price, I think, for the very unique
  38. and efficient utility you've received in this package.  Whether
  39. you use your computer mainly for spreadsheet analysis, system
  40. development, PC consulting or just playing games, I'm sure
  41. you'll find GRABBER a very helpful tool.
  42.  
  43. From a programmer's perspective, GRABBER is a prime candidate
  44. for your AUTOEXEC.BAT file.  It takes advantage of some of
  45. DOS's most interesting characteristics to perform file I/O 
  46. safely and promptly whenever called upon.  GRABBER is fully
  47. compatible with Borland's SideKick (tm), provided it is loaded
  48. before that program, and has tested reliably in some of the 
  49. most treacherous memory environments I could cook up.
  50.  
  51. Avid users, please send your $5.00 contributions to:
  52.  
  53.             Jerry Monroe
  54.             1241 Bunts Road
  55.             Lakewood, Ohio 44107
  56.  
  57.  
  58. If you have any questions or comments concerning GRABBER.COM,
  59. and you have a modem, please leave a message for Jerry Monroe
  60. on Norm Henke's PC-Ohio BBS at (216) 381-3320.
  61.  
  62.  
  63. GRABBER.COM -- Documentation and Technical Notes      Page 2 of 4
  64.  
  65.  
  66.  
  67. PART I
  68. ------------
  69.  
  70.  
  71. GRABBER.COM, Ver. 2.10, is a memory-resident screen-capture 
  72. utility for the IBM Personal Computer and true compatibles.
  73.  
  74. Requirements:  IBM PC, XT, AT or compatible computer; one 
  75.                diskette drive; Color/Graphics display adapter;
  76.                PC- or MS-DOS Version 2.0 or greater.
  77.  
  78. Unlike any other resident screen-capture program of which the 
  79. author is yet aware, GRABBER saves all text and graphics screens 
  80. produced by the Color/Graphics Adapter to an executable .COM 
  81. file.  In order to restore the saved image to the screen, it is 
  82. necessary only to execute the resulting program file at the DOS 
  83. command level.  Interpreted BASIC BLOADers and similar external 
  84. front-end methods are unnecessary.
  85.  
  86. To install the program in memory, type GRABBER [d:] at the DOS 
  87. prompt.  If the optional drive parameter is absent, GRABBER will 
  88. save screen images to the current logged drive and path whenever 
  89. the proper "trigger" keystrokes are detected.  If a valid drive
  90. parameter is specified, all images will be saved to program files 
  91. on that logical or physical drive.  
  92.  
  93. GRABBER does not recognize subdirectory names on the command 
  94. line.  Users of DOS versions 3.10 and above, however, may use the 
  95. external SUBST command to refer to any path in their hard disk 
  96. tree structures using a logical drive letter.
  97.  
  98. GRABBER cannot remove itself from memory, nor can the drive 
  99. parameter specified at installation time be changed without 
  100. rebooting the computer.
  101.  
  102.  
  103. GRABBER.COM -- Documentation and Technical Notes      Page 3 of 4
  104.  
  105.  
  106.  
  107. Once GRABBER has attached itself to the resident portion of DOS, 
  108. it monitors all keyboard activity, waiting for the key combina-
  109. tions of Ctrl-= (or Ctrl-1) before springing into action.  These 
  110. two keystroke combinations have different uses which are ex-
  111. plained below.  Upon detecting the trigger, GRABBER steps in to 
  112. create a .COM program file containing the current text or graph-
  113. ics image, either in the current default path or the pre-
  114. specified path, as explained above.  Control is then returned to 
  115. DOS or the interrupted application.
  116.  
  117. If a capture request is made via the trigger keys and an error is 
  118. encountered while writing the "offspring" .COM file, the program 
  119. will signal the error condition by sounding three short beeps on 
  120. the PC's speaker.  The beeps mean that the image has not been 
  121. saved, and the user should correct the error condition and try 
  122. the capture again.  Common errors include trying to write to an 
  123. empty diskette drive, a write-protected or damaged disk, or a 
  124. disk whose directory or data space is already full.  (If GRABBER 
  125. signals an error while attempting to write to a hard disk, this 
  126. could indicate a very serious problem with the disk, and the user 
  127. should investigate the cause immediately.)
  128.  
  129. As noted above, GRABBER responds to two key combinations: Ctrl-= 
  130. and Ctrl-1.  To capture any text image and most graphics images 
  131. to disk, use Ctrl-=.
  132.  
  133. In some situations where a graphics captured is required, it may 
  134. be necessary to use Ctrl-1 instead.  The graphics mode of Lotus 
  135. 1-2-3, Rel. 1 and 1A(*), is one such situation.  This program, 
  136. and others which may be encountered by the user, employ custom 
  137. video drivers to manipulate the display screen directly without 
  138. using the PC's built-in video services, which act rather slowly.  
  139.  
  140. In normal operation (Ctrl-=), GRABBER depends on the computer's 
  141. BIOS data area to determine whether the display is in graphics or 
  142. text mode, and consequently, how large a screen file to create.  
  143. And since most programs keep the video BIOS informed of their 
  144. whereabouts, Ctrl-= normally gives the intended result.
  145.  
  146. The above-mentioned versions of 1-2-3, however, do not update the 
  147. BIOS when switching to graphics mode, so that using Ctrl-= in 
  148. this situation creates a screen file displaying only garbage.  If 
  149. Ctrl-1 is used, GRABBER will disregard the BIOS and assume that 
  150. the display is in the medium-resolution graphics mode, with color 
  151. enabled (Video Mode 4).
  152.  
  153. To clarify things, 1-2-3 Rel. 2.0 and above use Ctrl-= in any 
  154. video mode.  Rel. 1 and 1A(*) use Ctrl-1 only in graphics mode, 
  155. and Ctrl-= in text mode.
  156.  
  157.  
  158. GRABBER.COM -- Documentation and Technical Notes      Page 4 of 4
  159.  
  160.  
  161. PART II
  162. ------------
  163.  
  164.  
  165. GRABBER.COM's "offspring," i.e. the screen programs it creates, 
  166. are named sequentially, SCREEN_A.COM, SCREEN_B.COM, and so forth.  
  167. The filenames will start over again at SCREEN_A every time the 
  168. computer is rebooted, or after the twenty-sixth snapshot in a 
  169. session (SCREEN_Z) is taken.  In order to prevent valued screen 
  170. files from being overwritten by new screens with the same name, 
  171. therefore, it is advisable to REName them at the first available 
  172. opportunity to something more descriptive.  (Of course, the 
  173. renamed file must retain the .COM extension to be recognized by 
  174. DOS as an executable program.)
  175.  
  176. Suppose that you have created a bar graph using 1-2-3 and 
  177. captured the image to disk, renaming the file GRAPH.COM.  
  178. Entering the command GRAPH [/F] at the DOS prompt will restore 
  179. the graphics image to the screen almost instantly.  (More on the 
  180. optional /F switch in a moment.) The GRAPH program then clears 
  181. the keyboard buffer and pauses until a key is pressed.  At this 
  182. point, the screen is cleared, the video mode and palette in 
  183. effect when GRAPH.COM was invoked will be restored, and the 
  184. cursor will reappear at the lower left-hand corner of the screen.
  185.  
  186. When invoked, GRABBER offspring always test the current video 
  187. mode with the mode required to display the images they carry 
  188. within them.  If the modes differ, the offspring programs will 
  189. blank the screen for about half a second (8 "ticks" of the system 
  190. clock) before displaying their images.  This technique eliminates 
  191. unattractive video "snow" patterns and the screen bounce which 
  192. occurs when the Color/Graphics Adapter switches modes.
  193.  
  194. If the modes are the same (for instance, you're in 80-column text 
  195. mode at the DOS prompt and invoke an offspring program carrying 
  196. an 80-column text screen), then the image will pop up almost 
  197. before your finger can leave the Return key -- if the program re-
  198. sides on a RAM disk or hard disk, and only shortly thereafter if 
  199. on a floppy.
  200.  
  201. There are situations in which the user might wish to load an 
  202. image on the screen and return control to DOS immediately, 
  203. without having to press a key first.  This is where the optional 
  204. /F switch comes in.  In the example above, the command GRAPH /F 
  205. alters program execution so that the image is displayed as be-
  206. fore, but the cursor will be placed at the lower left corner of 
  207. the screen right away and the DOS prompt will reappear there.  
  208. This method does not restore the original video mode, however, 
  209. and in this example the screen would remain in graphics mode when 
  210. a text mode might be desired instead.  The /F switch will probab-
  211. ly be most useful for text-mode images such as menu screens.
  212.