home *** CD-ROM | disk | FTP | other *** search
/ HomeWare 14 / HOMEWARE14.bin / utils2 / pcmous12.arj / PCMOUSE.DOC next >
Text File  |  1993-08-06  |  7KB  |  168 lines
  1.  
  2. PCMOUSE.DOC - documentation of PCMOUSE 1.2
  3.  
  4. 06-Aug-93
  5.  
  6.  
  7. PC-MOUSE: Paste what you have Cut with your MOUSE 
  8.           in the text-mode of DOS or OS/2 2.0 VDM.
  9.           PCMOUSE is a shareware program but free 
  10.           for personal use.
  11.  
  12.  
  13.         The author does not warrant the correctness of the documentation
  14. or the function of the program and does not warrant uninterrupted or
  15. error free operation of the Program.
  16.         The user is advised to test the program fully. The risk of using
  17. this software is exclusively at the user. The author assumes no liability
  18. whatever for damages of any kind that might result from using the program.
  19.  
  20. Cited product names are trade names.
  21.  
  22.  
  23.  
  24. PCMOUSE copyright (c) 1992 by Jürgen Weber
  25.                               
  26.  
  27. Jürgen Weber
  28. Wiesentalstraße 1
  29. D-74523 Schwäbisch Hall
  30. Germany - European Community
  31.  
  32. email: weberj@dia.informatik.uni-stuttgart.de
  33.  
  34. Please send comments and reports of reproduceable bugs to the email
  35. address.
  36.  
  37. INTRODUCTION:
  38.  
  39. Do you prefer the well readable text mode of your video card to the
  40. flicker of graphical user interfaces but would like to simply copy
  41. text by selecting and inserting it with your mouse (cut and paste)?
  42. Then you should use PCMOUSE. After going resident PCMOUSE enables Cut
  43. and Paste in the text modes of PC video cards. Programs that use the
  44. mouse themselves work as usual and ignore the presence of PCMOUSE.
  45.  
  46. VERSIONS: 1.0     First public release
  47.           1.1     if you specify option /T PCMOUSE's buffer is stuffed
  48.                   into the keyboard buffer at every timer tick, too.
  49.           1.2     Un-install Option /U
  50.                   8088 Version
  51.  
  52. HARDWARE/SOFTWARE NEEDED:
  53.  
  54. 80286 or better (not necessary for 8088 version)
  55. Bios with extended keyboard support (not necessary for 8088 version)
  56. Microsoft compatible mouse
  57. New mouse driver (with functions 14h,21h)
  58. MS-DOS compatible operating system (OS/2 2.x Dos Emulation is o.k.)
  59.  
  60. (PCMOUSE complains if you lack anything.)
  61.  
  62. SHAREWARE: 
  63.  
  64. PCMOUSE may be freely copied provided that you copy the complete
  65. package.
  66. The package consists of:
  67.  
  68. PCMOUSE  EXE      2990   6.08.93  9.46  : PC-Mouse executable for ATs
  69. PCMSE88  EXE      3078   6.08.93  9.45  : executable for 8088/8086 based PCs
  70. PCMOUSE  DOC                            : the file you are reading
  71.  
  72.  
  73. PCMOUSE is free for personal use.
  74.  
  75. Business users may try the program for a period of thirty days. After
  76. that time they must discontinue using PCMOUSE or pay the registration
  77. fee (40 US Dollars or 50 German Marks). Please send bills or a check
  78. to the above address.
  79.  
  80.  
  81. HOW TO USE:
  82.  
  83. If you start PCMOUSE.EXE it displays an identification message and
  84. goes resident. If PCMOUSE is already installed or if it hasn't found
  85. the right processor, bios or mouse driver, it aborts with an error
  86. message.
  87. If you do not use the mouse you will see no sign of PCMOUSE being
  88. present. Only when you move the mouse, the mouse cursor gets visible.
  89. It gets hidden again as soon as the next character is displayed on
  90. screen. To select a text area move the mouse cursor to the beginning of
  91. the area. Keep the left button pressed and move over the area you want
  92. to select. When you release the left button the selected text is
  93. copied to PCMOUSE's internal buffer.
  94. If the mouse cursor is on a word you can select it by double clicking
  95. the left button. A word is a sequence of letters, digits, the
  96. underline character and European special letters (IBM ascii values 80h
  97. to 0a5h, 0e0h to 0ebh).
  98. If you select a new screen area the internal buffer is overwritten. If
  99. you press and release the left button without selecting an area the
  100. internal buffer is cleared.
  101. Press the right mouse button to simulate the content of the buffer being
  102. typed in with the keyboard. If you keep the CONTROL key pressed
  103. while pressing the right button, an additional pressing of ENTER is
  104. simulated.
  105. PCMOUSE's internal buffer has space for 1024 characters. If you
  106. selected a text that is too large to fit into the buffer the last part
  107. is discarded. But the buffer gets rarely full as blanks are
  108. compressed. Also blanks at the end of a line are discarded. After the
  109. last non-blank of a line PCMOUSE inserts a CR char to simulate
  110. pressing ENTER. Control characters with ascii values below 32 are not
  111. stored in the buffer and discarded.
  112. The selected area is de-selected as soon as you press the left key
  113. again or if anything is displayed on the screen. This is done because
  114. the programs you run don't know anything about the selection. The
  115. de-selecting is done to prevent chaos on the screen. There can be
  116. problems if programs write directly to the screen memory which PCMOUSE
  117. can't intercept. But this occurs rarely and causes only optical harm.
  118. Programs run as usual. If a program offers mouse support itself the
  119. mouse functions of PCMOUSE lay dormant until the program ends.
  120.  
  121. TECHNICAL NOTES:
  122.  
  123. PCMOUSE hooks interrupts 10h, 16h and 21h. Int 10h is hooked to
  124. de-select a selected screen region every time a program calls int 10h.
  125. Int 16h is hooked to read from PC-Mouse's buffer. It also gets a new
  126. function 80h that PCMOUSE uses to see if it is already installed.
  127. With int 21h the exec function is patched. Before each program start
  128. via exec the mouse routine of PCMOUSE is activated and after the exec
  129. function the previous mouse routine is restored. So PCMOUSE works at
  130. the normal dos prompt and also with dos shells started within user
  131. programs.
  132. Every time a program calls the keyboard interrupt 16h PCMOUSE fills up
  133. the keyboard buffer with characters from its internal buffer.
  134. As some programs bypass int 16h and read directly from the keyboard
  135. buffer you can specify option /T so that PCMOUSE's buffer is stuffed
  136. into the keyboard buffer at every timer tick, too.
  137. This option hooks int 1ch.
  138.  
  139. Use option /u to un-install PCMOUSE. But this is only possible,
  140. if there is no other TSR loaded after PCMOUSE that hooks the
  141. same int vectors.
  142.  
  143. PCMOUSE uses a little more than 2.5K of memory and half of that is used for its
  144. text buffer.
  145. The selecting of a screen area is indicated by XORing the attribute
  146. bytes with 50h. To de-select they are simply XORed again.
  147.  
  148.  
  149.  
  150. return values: 0  successfully installed
  151.                1  hardware/software preconditions 
  152.                   not met 
  153.                2  already installed
  154.  
  155. PROBLEMS: 
  156.  
  157. If you leave Borland's TD386 with PCMOUSE installed it hangs the
  158. computer. When MSDOS 5.0 came out Borland had to distribute a patch
  159. for TD386 because then the same problem occurred. So this seems to be
  160. not PCMOUSE's problem but TD386's.
  161.  
  162.  
  163. THE AUTHOR is now (1993) 26 years old and student of computer science
  164. at the university of Stuttgart in southern Germany. He is also author
  165. of ZSIM, a Z80 - CP/M bios emulator that is available from ftp
  166. servers.
  167.  
  168.