home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / KAYPRO / TOON12.LBR / TOON12.DQC / TOON12.DOC
Text File  |  2000-06-30  |  7KB  |  144 lines
  1.                       **>> TOON v 1.2 <<**
  2.  
  3. TOON12.COM records what is on the computer screen. It is useful
  4. to anyone who writes about, or needs to record, video computer 
  5. output.  TOON.COM takes its name from the carTOON of your screen 
  6. which it places in a disk file.  The file of screens, also called 
  7. Toon, is a standard ASCII text file.  It can be further edited for 
  8. any purpose by using a text editor.  The screens can also be printed, 
  9. or inserted in any other document. This is an advantage of making 
  10. a disk file instead of sending screens directly to the printer: 
  11. the screen data is available for all uses.
  12.  
  13.                            Use of TOON
  14.  
  15. A>toon12<cr>
  16.  
  17. A>                                           TOON.COM loads, then
  18.                                              returns you to CP/M.
  19.  
  20. Now you use your computer normally.  A part of TOON.COM is 
  21. resident in your RAM, residing just below your CCP.  You can 
  22. easily tell that TOON.COM is loaded, because it will remind you 
  23. every time you Warm Boot:
  24.  
  25. A>^C
  26. Toon = ^_
  27.  
  28. Instead of the usual "Warm Boot" message, you see a notice 
  29. containing's TOON.COM's signal to save the screen; ^_ (control 
  30. underline).  Because this character can be generated from the 
  31. keyboard, but is used extrememly rarely for anything else, it can 
  32. serve as the "save screen" signal.  To activate TOON.COM, just 
  33. type ^_ (On my keyboard, ^_ and ^- are the same).
  34.  
  35. After ^_ is typed, you see nothing onscreen, because TOON.COM has 
  36. intercepted the ^_ and not written it to the screen.  But the
  37. disk drives should start, then stop again when the screen file is 
  38. finished.  If the output file Toon does not exist, TOON.COM 
  39. creates it.  If it does exist, the new screen is added onto the 
  40. existing screens with just a crlf in between.  As many successive 
  41. screens as desired may be appended to the file Toon.
  42.  
  43. When you no longer need TOON to save screens, just cold boot the 
  44. computer (press the reset button).  The ensuing reconstruction of 
  45. the CP/M system will turn TOON off.
  46.  
  47.                          How TOON Works
  48.  
  49. TOON.COM first loads into the TPA (program area) of your computer 
  50. like other CP/M programs, at 0100h.  But its first actions are
  51. unusual, in that it redirects one of the standard functions of
  52. the computer BIOS (the CONIN, or console input function) to the
  53. site where TOON will soon be, below the CCP.  Then, as its last
  54. gesture, TOON relocates its screen-saving code to the high memory
  55. site, and returns you to CP/M.  The screen saver remains active 
  56. until overwritten by something else, or until a cold boot (reset) 
  57. repoints the CONIN jump to its normal destination.
  58.  
  59. TOON's 627-byte watchdog in high memory takes all calls to the 
  60. normal CONsole INput function, checking every character. When it 
  61. finds a ^_ in CONIN, it uses the system's status port to bank-
  62. switch back and forth from video to normal memory.  TOON reads the 
  63. video memory and writes it into the file, Toon, on the currently 
  64. logged disk. To keep TOON small, no disk error messages are 
  65. issued.  This means that, for example, if the disk becomes full, 
  66. TOON will write part of a file without notifying you.
  67.  
  68.                      Using TOON Effectively
  69.  
  70. TOON really can write all screen information, which means that 
  71. all the blank spaces onscreen will be represented in the file as 
  72. blank characters (20h). Thus lines in the output file Toon can be 
  73. wide (80 chars), and just fit on a normal printer. Eighty 
  74. character lines will not fit comfortably onscreen in your text 
  75. editor if it (eg, Wordstar) tries to put other characters on the 
  76. same line. Monitor routines (the programs which run screens) also 
  77. will add lf to 80 character lines, and thus Toon would 
  78. (incorrectly) appear to have blank lines in its text when TYPE'd 
  79. from CP/M. In order to avoid this distortion of the text, and 
  80. still preserve all characters onscreen, TOON deletes the last 
  81. character of screen lines, but only if the last character is a 
  82. blank.  Lines which contain information in the 80th column will be 
  83. preserved, and will have a ghost line inserted after them when 
  84. TYPE'd to the screen.
  85.  
  86.                        Different Computers
  87.  
  88. By their very nature, screen-saving programs are very machine 
  89. dependent.  Every computer uses a different method to store its 
  90. video information. TOON is no exception. The distributed version 
  91. reads video memory in the early Kaypro II (sometimes called the 
  92. '83 model, before graphics).  TOON will not work as is, even on 
  93. other Kaypros which do not use bank-switched video memory.  
  94. However, the machine-specific part (called rdvid) has been 
  95. isolated and clearly marked in TOON.ASM.  If you know how your 
  96. computer uses screen information, you can delete rdvid and drop 
  97. another routine into its place, and reassemble TOON.COM.  If you 
  98. do this and lengthen the program, check that the new TOON still 
  99. allows enough space below the ccp for itself (endmv-begin+1 in 
  100. the line labeled launch0 must be less than the offs equate).
  101.  
  102.             Possible Interaction with Other Programs
  103.  
  104. TOON's watchdog sits in a fairly safe place, but it can be 
  105. overwritten by programs which keep data or code in high 
  106. memory.  This is true of programs compiled with Turbo Pascal 
  107. using its default End address, for example.  If you get bizarre 
  108. behavior, or lockup, when TOON and another program are combined, 
  109. this is almost surely what is happening. The same thing can 
  110. happen if you have an extra-luxurious ccp, because TOON assumes 
  111. that the ccp start = bios start - 1600h, as for standard 64k CP/M 
  112. 2.2. This will give trouble as soon as you type A>Toon because 
  113. you will overwrite an essential piece of your CP/M system. It is 
  114. easy to get around this difficulty by experimentally changing the 
  115. "offs" equate in TOON.ASM, then recompiling. As "offs" grows, 
  116. TOON will relocate further and further down in memory, leaving 
  117. more room above it for your CP/M system or other programs.
  118.  
  119.                     TOON Reduces the TPA Size
  120.  
  121. There is one other consideration.  TOON loads at the hard-coded 
  122. address we have just talked about, below the ccp in high memory.  
  123. But it alters the BDOS jump to point to itself.  Other programs 
  124. loaded after TOON, if they look at the BDOS jump to see how much 
  125. program space is available, will automatically load under TOON, 
  126. and not overwrite it.  To make the best use of this deception, 
  127. load TOON first to set the BDOS signpost.
  128.  
  129.                            **>>  <<**
  130.  
  131. If you prefer that assembly language be spoken only in Toyota 
  132. factories, take heart!  You can use TOON without understanding 
  133. any of the above if you have a standard CP/M 2.2 system, like the 
  134. one distributed with the Kaypro II.
  135.  
  136. Good luck with TOON! It is often the best way to show other 
  137. people what your computer does.
  138.  
  139. June, 1985                                   Mike Yarus
  140.                                              2231 16th Street
  141.                                              Boulder, CO 80302
  142.  
  143.                                              Compuserve 73145,513
  144.