home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 149.lha / ColorTerm / ReadMe < prev    next >
Text File  |  1988-04-25  |  7KB  |  152 lines
  1.  
  2.  
  3.      ColorTerm/Amiga -- A Color Terminal Program For The Amiga
  4.  
  5.                           January 24, 1987
  6.  
  7.      ColorTerm is actually a type of C64 emulator; that is, it accepts
  8. and correctly responds to the C64 formatting and color codes and
  9. graphics characters.  I saw all the colors and effects on a C64
  10. running the PC Worlds BBS right here in town (605-348-2357--and keep
  11. trying), and was amazed.  It seemed strange that the Amiga, with all
  12. its mighty graphic power, couldn't do something like that.  ColorTerm
  13. was the result; if there is a demand for it, new versions may be
  14. produced on machines like the Mac (in black and white, but with all
  15. the cursor moves and graphics characters) and Atari ST.  Writing
  16. something like this to work on the less graphically powerful machines
  17. like the Apple II series or any of the MS-DOS machines I leave up to
  18. those who enjoy it; of course, it's already available for the C64/128.
  19. What we have here, folks, is a sort of "micro" graphics standard.
  20.  
  21. Installation
  22.  
  23.      To run ColorTerm, you must install two 8-point fonts into the
  24. fonts directory on your bootup disk: c64upper and c64lower.  To make
  25. this process simpler, just Execute the included "execute.me" file.
  26.  
  27.      By the way, the fonts may not be exactly like those on the 64.  I
  28. laboriously drew them in with Fed from the 1.2 Extras disk, and keep
  29. finding little screw-ups.  They are pretty close, though.
  30.  
  31.      Note that this version of ColorTerm has almost no error checking.
  32. If the program can't find its fonts, allocate enough memory, or some
  33. run-time error occurs, it will very likely crash (some of the crashes
  34. are rather impressive, too).  If I get real motivated, the program
  35. will be made more robust in the future.  As things stand, it seems to
  36. work ok most of the time.
  37.  
  38. Usage Notes
  39.  
  40.      ColorTerm uses the Exec Wait routine to wait for characters from
  41. the keyboard or serial port; that way, it doesn't eat processor time
  42. that other programs might need.  In other words, it is set up to
  43. multitask, although the lack of error checking dictates that you save
  44. your work often.
  45.  
  46.      The function keys are implemented as the C64 color-control keys,
  47. and they follow the same patterns.  For example, F3 changes text to
  48. red.  You can use either CTRL or SHIFT to access the "upper" colors,
  49. like orange (shift-F1).  F9 and F10 are RVS on and off, while the ESC
  50. key is used as the HOME/CLR key.  The arrow keys act normally.
  51.  
  52.                            Key Defintions
  53.  
  54.              +-------+-------+-------+-------+-------+
  55.  Shifted     |Orange | Brown |Lt Red |Dk Gray|Md Gray|
  56.              |       |       |       |       |       |
  57.  Unshifted   | Black | White |  Red  | Cyan  |Purple |
  58.              +-------+-------+-------+-------+-------+
  59.                  F1      F2      F3      F4      F5
  60.  
  61.  
  62.              +-------+-------+-------+-------+-------+   (Note: RVS On
  63.  Shifted     |Lt Grn |Lt Blue|Lt Gray|       |       |   and RVS Off
  64.              |       |       |       |RVS On |RVS Off|   perform the
  65.  Unshifted   | Green | Blue  |Yellow |       |       |   same with and
  66.              +-------+-------+-------+-------+-------+   without the
  67.                 F6      F7      F8      F9      F10      Shift key.)
  68.  
  69.                               +------+
  70.                   Shifted     | CLR  |
  71.                               |      |
  72.                   Unshifted   | HOME |
  73.                               +------+
  74.                                 ESC
  75.  
  76.  
  77.      When you're ready to quit ColorTerm, either select Quit from the
  78. menu, type right-Amiga-Q, or click in the invisible, secret, hidden,
  79. close gadget in the upper left corner of the screen.
  80.  
  81. Design Credits
  82.  
  83.      ColorTerm was written in Amiga Multi-Forth, from Creative
  84. Solutions.  If you like Forth, you'll love Multi-Forth, and it goes
  85. for only $89.  The serial communications and keymap conversion words
  86. were based on ideas I got from looking (mostly) at ATerm1.3, an early
  87. Amiga terminal program by Michael Mounier.  The video and other stuff
  88. (yecchhh) is all my own.  Special thanks for lending me equipment and
  89. books go to John Fassbender and Burt Landman, nice guys both.
  90.  
  91.      If you get Multi-Forth, be sure to get ConMan to use with it.  I
  92. also reccommend Aedit for a general-purpose editor.  ConMan is
  93. shareware from Bill Hawes; Aedit is 57K of very tight 68000 assembler,
  94. an industrial-strength editor by Joe Bostic.  It is available from DRM
  95. Programs, 1329 Arthur Ave, Las Vegas, NV 89101, (702) 457-9489.
  96.  
  97. Flaws (other than the lack of error checking)
  98.  
  99.      Screen scrolling is slow, especially in 80-column mode.  This is
  100. because the Intuition routines MakeScreen and RethinkDisplay are used
  101. to sync up the display (if you have a non-flickering alternative
  102. method, please, please send it to me!).  Using the simple ScrollRaster
  103. routine caused all the odd-colored characters on the screen to flicker
  104. to white during a scroll, and this caused severe eye strain. I decided
  105. to live with the slow version.
  106.  
  107.      Baud rates higher than 2400 are unsupported, not because they are
  108. any tougher to implement, but because even 2400-baud C64-type BBSs are
  109. exceedingly rare.  If there is a demand for higher rates, I may put
  110. them in.  Whatever.
  111.  
  112.      Receiving and "printing" a CTRL-G (bell) character only flashes
  113. the screen.  This is mainly due to laziness on my part, although I
  114. also really hate it when somebody puts 400 CTRL-Gs in a message and it
  115. beeps at me for ten minutes.
  116.  
  117.      The source code is, well, ragged in some places.  It's still not
  118. too bad overall.  Please send suggestions, mods, and questions to me
  119. at the address below.  Letters that include a SASE are more likely to
  120. get a reply.
  121.  
  122.      There are still some mysterious insects lurking in there.  I'm
  123. not sure whether they are the fault of Multi-Forth, AmigaDOS, or, more
  124. likely, myself.  If you think you've found one, try to find a way to
  125. reproduce it, and let me know.
  126.  
  127. Yours Truly
  128.  
  129.      My name is Warren Block.  To make a living, I write articles and
  130. reviews for magazines like INFO, Amazing Computing, and (back when
  131. they still covered interesting machines) BYTE.  (Note that, unlike
  132. most, that's ALL I do--I don't work for a software company, nor do I
  133. accept "free" software from manufacturers).  If you like this program
  134. or my writing, feel free to correspond with me at:
  135.  
  136.      1921 Fifth, Apt. 3
  137.      Rapid City, SD 57701
  138.      (605) 342-1632
  139.  
  140. Better yet, send me a few bucks, or write to the magazine of your
  141. choice and tell them I ought to get a big raise and a company car.
  142.  
  143. Status
  144.  
  145.      ColorTerm is a "shareware" program; in other words, just like
  146. public domain, freely redistributable and all, but I hope that people
  147. will send me a little money for the effort I've put into it. (If
  148. you're in a quandary over the amount, may I suggest $15 or $20?)
  149. Please feel free to upload it all over the place.  Both the program
  150. and this file are Copyright 1988 by Warren Block, and I thank you for
  151. your support.
  152.