home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / screen / blockcur.arc / BLOCKCUR.DOC < prev   
Text File  |  1989-08-29  |  11KB  |  214 lines
  1.  
  2. BLOCKCUR Copr. 1988-9 by Soapbox Software, PO Box 17998, Boulder, CO 80308.
  3.  
  4. BLOCKCUR creates a user-chosen cursor and then maintains that shape through TSR
  5. or terminate-and-stay-resident logic.
  6.  
  7.    A one or two-digit number after the command causes BLOCKCUR to wait about
  8. that many seconds before forcing the cursor into the desired shape.  This can
  9. cut the background processing required to maintain the shape of the cursor.  If
  10. you find your cursor changing shape too often, using an interval of zero forces
  11. the cursor into shape about 20 times a second; issue the command BLOCKCUR 0.
  12.  
  13.    Issue BLOCKCUR OFF to inactivate BLOCKCUR. Start BLOCKCUR with the /B switch
  14. if BLOCKCUR does not seem to work with your hardware; it will use your BIOS.
  15.  
  16.    Switches will produce cursors other than the default full block; use
  17.       /F   to get a full-height block;
  18.       /H   to get a half-height block;
  19.       /M   to get a middle-block;
  20.       /O   to get an overline cursor;
  21.       /T   to get a top half-high block; or
  22.       /U   to get an underscore cursor.
  23. The switch /Q reports the current state of BLOCKCUR, with no other action.
  24.  
  25. BLOCKCUR 1.08T Copr. 1988-9 by Soapbox Software, Box 17998, Boulder, CO 80308.
  26. After a week of free testing, contined use requires a ten-dollar license fee.
  27. ==============================================================================
  28.  
  29. Above is the information printed out in response to the command BLOCKCUR ? (the
  30. BLOCKCUR command followed by a question mark).  What follows is additional
  31. information for the curious or interested user.
  32.  
  33. A cursor is generated by a computer video card to let programs draw attention
  34. an important position on the display -- usually the position where the next
  35. character typed will appear.
  36.  
  37. Unfortunately, the cursor that is usually adequate on a CRT display can dis-
  38. appear on a display with less contrast, such as a liquid-crystal display (LCD)
  39. of the type commonly used on laptop or portable computers.  The same problem
  40. exists for some monochrome displays, since most programs are designed for
  41. high-contrast color displays.  Even a CRT user may wish for a more visible
  42. cursor.
  43.  
  44. BLOCKCUR addresses this problem, allowing the user to specify the size of the
  45. cursor, and then continuing as a resident program to prevent other programs
  46. from changing the shape chosen by the user. It takes less than 1K (1,024 bytes)
  47. of memory to do this, and allows changes of mind by the computer user with no
  48. additional cost in memory; further BLOCKCUR commands update the copy it finds
  49. already resident in the computer, so the user can experiment with various
  50. alternatives before settling on one.
  51.  
  52. Here are the parameters of the BLOCKCUR command.  All are optional, and the
  53. default values are given for each. They may be entered in any order.
  54.  
  55.  BLOCKCUR [interval][?][/Q][/F][/H][/M][/O][/T][/U][/B][/V][C=XY][/N][/W][OFF]
  56.  
  57. "interval" is the approximate number of seconds between the times that BLOCKCUR
  58. forces the cursor into the shape chosen by the user.  It is given as one or two
  59. decimal digits and varies from 0 to 99 seconds.  If 0 (zero) is specified, the
  60. cursor shape is updated as often as possible, approximately 20 times per
  61. second.  When BLOCKCUR is preventing cursor changes by monitoring the
  62. BIOS service call (Interrupt 10H, AH=1), running with a large value for this
  63. interval should work acceptably; therefore, 60 seconds has been chosen as the
  64. default value used if no value is entered.  However, if the programs you use
  65. do change your cursor shape (as they can do by writing directly to the
  66. video hardware), specifying a short interval should make the changes less
  67. noticable.
  68.  
  69. "?" generates a display of the information shown above.  No other action
  70. is taken if this parameter appears on the command line.
  71.  
  72. "/Q" (for "query") generates a report of the current status of BLOCKCUR.  If
  73. it is resident in memory, the report will indicate whether it is active or
  74. turned off; how many seconds the interval is set to; and the values being
  75. used for the top and bottom lines of the cursor.
  76.  
  77. "/F" specifies a cursor the full height of the character box.  This is the
  78. default value used if no cursor specification is entered.
  79.  
  80. "/H" specifies a cursor about half the height of the character box.
  81.  
  82. "/M" specifies a cursor occupying the middle half of the character box.
  83.  
  84. "/O" specifies a thin, line-sized cursor (an "overline") at the top of the
  85. character box.
  86.  
  87. "/T" specifies a cursor about half the height of the character box at the top.
  88.  
  89. "/U" specifies an underline cursor at the bottom of the character box.
  90.  
  91. "/B" specifies that BLOCKCUR should use the BIOS interface to your video card,
  92. rather than attempting to program the hardware itself.  Use this option if
  93. BLOCKCUR does not seem to have the desired effect on your machine.  Since
  94. the BIOS programs resident in your machine have been tailored to your machine's
  95. hardware, possibly they can do the job when BLOCKCUR finds the hardware
  96. incompatible.
  97.  
  98. "/V" specifies that BLOCKCUR should program the video hardware directly.  This
  99. is the default; you can use the flag to reverse the effect of the "/B" flag.
  100.  
  101. "C=XY" allows you to specify your own cursor. "X" represents a hexadecimal
  102. digit used to specify the top line of the cursor and "Y" another hexadecimal
  103. digit used to specify the bottom line.  (Hexadecimal digits are those used
  104. in the computer field to represent base 16 numbers, where the letters A through
  105. F stand for the decimal numbers 10, 11, 12, 13, 14 and 15, respectively.)
  106. BLOCKCUR is designed to work on CGA, EGA and VGA cards using the true cursor.
  107. If the cursor you select doesn't look right to you on your hardware, you can
  108. use this option to try to generate one that does.  You can also try for
  109. unusual effects.  On some display hardware, for instance, specifying the
  110. bottom line higher than the top line (such as C=D3) will produce a "split"
  111. cursor, with part of it at the top of the character box and part at the bottom.
  112. On other video cards, however, the result may be to make the cursor invisible.
  113. Experiment until you find something that works for you.
  114.  
  115. "/N" tells BLOCKCUR to allow other programs to change the cursor shape
  116. through the BIOS interface; by default, BLOCKCUR prevents use of this interface.
  117.  
  118. "/W" tells BLOCKCUR to keep other programs from using BIOS to change the cursor.
  119. You may want to use "/N" to allow other programs to change the cursor so you
  120. can see, for instance, whether an editor or word processor is in insert mode.
  121. If so, specify a short interval so that BLOCKCUR will change it back quickly.
  122.  
  123. "OFF" causes BLOCKCUR to turn itself off.  It remains resident in memory and
  124. can be turned on again with another BLOCKCUR command.  Just BLOCKCUR will be
  125. sufficient; the program will remember the options you have previously chosen.
  126. You might want to turn BLOCKCUR off if it is not compatible with another
  127. program you want to use.  (Since graphics modes do not show true hardware
  128. cursors, BLOCKCUR watches for programs entering graphics modes and turns
  129. itself off until the computer is set back to a non-graphics mode.)
  130.  
  131. (Note that turning BLOCKCUR off has no effect on the cursor; however, it
  132. allows other programs to modify the cursor without interference.)
  133.  
  134. The term "true hardware cursor" as used above here deserves some explana-
  135. tion.  The hardware cursor is generated by the video card that drives the
  136. display.  Since it is generated automatically by a part of the computer,
  137. there is no program overhead involved.  BLOCKCUR modifies the shape of this
  138. hardware cursor, but spends none of your computer processor time in making
  139. it appear, since that is a function of the hardware.
  140.  
  141. Some programs turn off the hardware cursor (which can be done by defining
  142. it to be very small -- starting and ending on the same line, for instance --
  143. or by positioning it off the screen) and generate a software or "virtual"
  144. cursor.  Programs that produce a non-blinking cursor or one that blinks
  145. faster or slower on demand usually do this through the "virtual cursor"
  146. approach, since the commonly available display cards do not provide for a
  147. non-blinking cursor or one with a variable blink rate.  While the effect
  148. may be pleasing, you should remember that there is a cost in using the
  149. power of your computer processor to simulate something usually done by
  150. hardware.  A considerable part of the processor power may be lost.  In some
  151. cases, there may not be enough power left to do the job at hand -- for
  152. instance, running a communications line at rated speed without errors may
  153. not be possible if the processor is also being used to simulate a cursor.
  154. Because BLOCKCUR uses the hardware cursor, it can be run at the same time
  155. as a communications line.
  156.  
  157. BLOCKCUR is a shareware program created and distributed by Soapbox Software,
  158. PO Box 17998, Boulder, CO 80308.  Shareware is supported by satisfied users.
  159. After a week of free testing, contined use requires a ten-dollar license fee
  160. for each machine on which it is being used.
  161.  
  162. BLOCKCUR.DOC Copr. 1989 by Soapbox Software.  All rights reserved.
  163.  
  164. IMPORTANT NOTICE: Any use of this software for any
  165. period of time for any purpose whatsoever constitutes
  166. your unqualified acceptance of this LICENSE and
  167. subjects you to all of the terms and conditions set
  168. forth below:
  169.  
  170. Soapbox Software ("SOAPBOX") warrants to any Licensee
  171. that acquires the program from SOAPBOX or from
  172. an authorized SOAPBOX representative ONLY that:
  173.  
  174.  1) All diskettes SOAPBOX provides constitute an accurate
  175.     duplication of the software and SOAPBOX will replace
  176.     any diskette it provided that is found to be defective
  177.     within 30 days from date provided.  SOAPBOX will not honor this
  178.     warranty if (in SOAPBOX's sole judgment) the diskette
  179.     has been subjected to physical abuse, or used in defective
  180.     or non-compatible equipment.
  181.  
  182.  2) SOAPBOX's software will perform substantially as
  183.     described in the documentation SOAPBOX regularly
  184.     supplies with that software, if operated as
  185.     prescribed in such documentation including the
  186.     hardware and software environment specified.
  187.  
  188.  3) If a significant defect in any program is found,
  189.     Licensee's only remedy shall be to receive refund
  190.     of the actual fee Licensee paid for such defective
  191.     program.  In no event will such a refund exceed
  192.     the fee SOAPBOX charges for such program.
  193.  
  194.  4) SOAPBOX makes no warranty or representation that the
  195.     software will be error free nor that its use by
  196.     Licensee will be uninterrupted.
  197.  
  198. Except as provided above, SOAPBOX disclaims all other
  199. warranties, either express or implied, including but
  200. not limited to any implied warranty of merchantability
  201. or fitness for any particular purpose.
  202.  
  203. Licensee agrees to take full responsibility for the
  204. selection of and any use whatsoever made of the
  205. software.
  206.  
  207. IN NO EVENT WILL SOAPBOX SOFTWARE BE LIABLE FOR ANY DAMAGES
  208. WHATSOEVER (INCLUDING WITHOUT LIMITATION DAMAGES FOR
  209. LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS
  210. OF BUSINESS INFORMATION OR THE LIKE) ARISING OUT OF
  211. THE USE OF, INTERRUPTION IN THE USE OF, OR INABILITY
  212. TO USE THIS SOFTWARE, EVEN IF SOAPBOX HAS BEEN ADVISED OF
  213. ANY POSSIBILITY OR LIKELIHOOD OF SUCH DAMAGES.
  214.