home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / znode3 / uploads / gst03.lbr / GST.DZC / GST.DOC
Encoding:
Text File  |  1993-06-07  |  5.3 KB  |  99 lines
  1.  
  2.                           Graphic Script Tools
  3.                               Version 0.3
  4.  
  5.                               Dave Ramsey
  6. ----------------------------------------------------------------- 
  7. Version .3D - Updated for V4LIBD.           Bob Dean July 5, 1990 
  8. -----------------------------------------------------------------
  9.  
  10.    GST, (G)raphic (S)cript (T)ools, are a set of tools designed to allow 
  11. the user to exploit the new extended TCAP in the Z-System. The current 
  12. set of tools is minimal and does not represent a completed effort. In 
  13. particular, the tools currently do not respect the Z-System quiet flag, 
  14. nor do they check all the input parameters. This set is a very early set 
  15. released to the user community for comments and suggestions.
  16.  
  17.    This library contains the following tools:
  18.  
  19. BOX    - which allows the user to draw boxes on the screen;
  20. ERABOX - to erase these boxes;
  21. HBAR   - which allows the user to draw horizontal bars;
  22. VBAR   - which allows the user to draw vertical bars;
  23. ERABAR - to erase these bars;
  24. LINE   - to draw horizontal and vertical lines on the screen;
  25. ERALINE- to erase horizontal and vertical lines from the screen;
  26. CORNER - to draw one of the four corner graphic characters on the screen;
  27. ISEC   - to draw one of the five intersection chars on the screen;
  28. GXYMSG - which allows the user to echo a line to the screen at a
  29.          specific row and column; and
  30. GOTOXY - which places the cursor at a specific location on the screen.
  31.  
  32.    At this time, these tools comprise a complete set, at least from my 
  33. own viewpoint. If anyone can suggest other tools that might be useful 
  34. within ARUNZ and ZEX scripts, please feel free to let me know. 
  35. Obviously, if you are an assembly language programmer, these tools are 
  36. trivially simple. If you program yourself, take one as a template and 
  37. add yet another tool to the set. If you don't program, let me know and 
  38. I'll add it for you, if I understand what you want and if it makes sense 
  39. to me.
  40.  
  41.    It is possible that these tools do not represent what the user
  42. community wants. It is for this reason that I have released these early 
  43. versions - to get comments and to not waste my efforts if these are not 
  44. the sorts of graphic script tools that are wanted. If you like what you 
  45. see, let me know and I'll continue developing them. If not, well, I'll 
  46. continue developing them for my own use but I certainly won't make as 
  47. much effort to make them robust and reliant. And I might not bother to 
  48. release them. In any case, leave a few comments about what you would 
  49. want these tools to do. Or write to me at:
  50.  
  51.                Dave Ramsey
  52.                1188 Green Holly Drive
  53.                Annapolis, MD 21401
  54.                (301) 757-8413
  55.  
  56. I can't accept collect calls (sorry!) but if you want to spend your 
  57. nickel, I'll talk about whatever you'd like!
  58.  
  59.    Enhancements over version 0.1 include corrected stack initialization 
  60. code, extended tcap awareness, and removal of self-modifying code. (We 
  61. have to consider the future what with the Z280 slowly beginning to make 
  62. its presence felt!) Some routines do check some of their parameters 
  63. although none of them yet check all parameters. (I may develop some 
  64. generic routines to check values for row, column, height, width, etc., 
  65. that can be back-referenced at run-time against the Z-System TCAP. It 
  66. will be another good exercise, I suppose.)
  67.  
  68.    Things to add in future versions include selection of STANDOUT or 
  69. STANDEND (dim or reverse video versus highlighted text) for text 
  70. messages and graphics objects, case selection switches for these tools 
  71. (unless Jay Sage follows throw with his thoughts on providing access to 
  72. the command line before it has been capitalized), and more Z-System 
  73. awareness generally.  One bug fixed in this version relates to stack 
  74. usage. The 0.1 version setup a stack on the tail end of the CCP.  This 
  75. would obviously corrupt the CCP. I didn't notice this because I use ZCPR 
  76. 3.3 and an RCP installed as an RSX. I hope that the version 0.1 tools 
  77. didn't cause too many headaches! If anyone wants to tell me how to do 
  78. some things better, feel free! I enjoy getting expert critiques as it 
  79. helps clarify my coding practices.
  80.  
  81.    As a side issue, perhaps we might want to add a new system segment 
  82. to Z-System for graphics commands or add them to our RCPs. For myself, 
  83. running ZCPR 3.3, and loading my RCP as an RSX below the CCP, RCP size 
  84. is not problem and I routinely switch between RCPs and even drop them 
  85. altogether when needed. I understand that NZ-COM and ZCPR 3.4 users have 
  86. even more flexibility in this regard, so I will await your comments on 
  87. this idea.
  88.  
  89.    It is also possible, for instance, that the user community might want 
  90. a single, general-purpose, graphic script program that draws everything 
  91. based upon user input. I, personally, don't like that idea as I believe 
  92. that the small tools approach of Z-System (and Unix, from whence it 
  93. came) represent the best philosophy when it comes to software 
  94. engineering.
  95.  
  96.    So, pull the Graphic Script Tools out and have at it. Let me know 
  97. what you want to do with them and what features they need or shouldn't 
  98. have and I'll see what I can do about implementing them.
  99.