home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / beehive / utilitys / gtr03.arc / GTR+.DOC < prev    next >
Text File  |  1991-01-13  |  4KB  |  102 lines
  1.  
  2.  
  3.                    GRAPHICS REMAPPER  v 0.3
  4.                    ========================
  5.  
  6.                 by   Simeon Cran.   Australia.
  7.                          October 1990
  8.  
  9. GRAPHICS TERMINAL REMAPPER is designed to allow ZPM3 and CP/M 3 users to 
  10. conveniently display IBM type grapics on an ordinary ASCII 
  11. terminal.  The IBM type grapics are eight bit characters with 
  12. their high bit set.  On ordinary terminals, either rubbish is 
  13. displayed, or more normally the terminal strips the high bit and 
  14. inappropriate ASCII characters are displayed.
  15.  
  16. GRAPHICS TERMINAL REMAPPER converts many of these graphics characters to 
  17. appropriate ASCII characters.
  18.  
  19. GRAPHICS TERMINAL REMAPPER will normally be used with a communications 
  20. program when communicating with bulletin boards.  GTR+ is 
  21. automatically installed with the communications program and 
  22. removed when the program terminates.
  23.  
  24.  
  25.                      *                *  
  26.  
  27.  
  28. This package:
  29.  Contains all the source code to get you going, as well as a demo 
  30. file, sample submit files to automate assembly and a standalone 
  31. version of GTR+.
  32.  
  33.  By running GTR+.COM you can install the GRAPHICS TERMINAL REMAPPER to stay 
  34. resident.  Running GTR+.COM again will remove it.
  35.  
  36.  GTR+RSX.Z80 is the source for the RSX.  It can be assembled to 
  37. produce either the standalone resident RSX, or an RSX for 
  38. attaching to other programs.
  39.  
  40.  GTR+RSX.RSX is the RSX ready to be attached to your 
  41. communications program.
  42.  
  43.  DEMO.TXT is an example of IBM type graphics.  Because most 
  44. typing programs reset the high bit as a matter of course, you 
  45. probably won't notice any difference when you type it with or 
  46. without GTR+.  To see the difference, display it with the command: 
  47. PIP CON:=DEMO.TXT.  Then run GTR+.COM and try again.  Get the 
  48. idea?!
  49.  
  50.  
  51.                      *                *
  52.  
  53.  
  54. NOTE:
  55.  that many communications programs strip the high bit as a matter 
  56. of course.  In such a case, GRAPHICS TERMINAL REMAPPER has nothing to work 
  57. with, so it won't have any effect.  ZMP is an exception, and 
  58. seeing as it is the only CP/M ZMODEM program, you probably should 
  59. be running it anyhow.
  60.  
  61. If you're wanting to to use MEX114, then use the POKE command within MEX114
  62. to poke a 0FFH at address 04823H & 0496EH. This effectily allows MEX114 to
  63. pass the 8th bit in terminal mode. You could then CLONE mex with the changes.
  64.  
  65.  To install GRAPHICS TERMINAL REMAPPER into ZMP, run the command: GENCOM 
  66. ZMP GTR+RSX.  GTR+RSX.RSX as it comes in this package has been 
  67. assembled to run with a communications program.  If you 
  68. reassemble GTR+RSX.Z80, check the TYPE equate.
  69.  
  70.  
  71.                      *                *
  72.  
  73.  
  74. A TECHNICAL NOTE:
  75.  I haven't seen much of it around, but the concept of making 
  76. simple RSXs which automatically remove themselves when another 
  77. identical RSX is installed, is very simple to implement.
  78.  
  79.  The code used in GTR+ is worth studying.  It checks through all 
  80. the other RSXs in memory to see if any have the same name as 
  81. itself.  If it finds one, it calls the code at RSX_base+1ah.  
  82. This is the remove code.
  83.  
  84.  If it finds the loader, it installs itself.  This system saves 
  85. having special driver programs and making RSX calls.  Although 
  86. there could be a problem if a different RSX has the same name, 
  87. this is much less likely than choosing an RSX number the same as 
  88. another RSX's.
  89.  
  90.  
  91.                      *                *
  92.  
  93.  
  94. ACKNOWLEDGEMENTS:
  95.  must be made to Steven Greenberg's CORK10 program for CP/M 2.2.  
  96. Although all the code in GRAPHICS TERMINAL REMAPPER is original, the 
  97. inspiration came from CORK10.  GRAPHICS TERMINAL REMAPPER is much simpler 
  98. due to the way ZPM3 and CP/M 3 work.
  99.  
  100.  
  101. Simeon.
  102.