home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / EVENTS / MSGCOL1A.ARJ / MSGCOLOR.DOC < prev    next >
Text File  |  1994-02-07  |  7KB  |  198 lines
  1.               For WWIV Version 4.23 
  2.         (Works with Version 4.22 of WWIV)
  3.       
  4.       "MsgColor" is Copyright Matt Lampiasi, 1994.
  5.  
  6.      MsgColor adds even MORE colors to your already colorful WWIV
  7. BBS System, allowing a sysop-definable standard message text
  8. color to prevail on his/her bbs. Your default color can be
  9. changed anytime, staying within the limits of WWIV "Heart" codes
  10. (1-9).
  11.  
  12. Installation:
  13.      Simply delete the command lines for your full screen editor
  14. in INIT and replace them with the path and filename of the
  15. supplied batch files. IE: WWIVEDL.BAT for the local WWIVEdit
  16. Command line, and WWIVEDR.Bat for the WWIVEdit Remote command
  17. line. Change the number in MsgColor.Inf to reflect the WWIV color
  18. code of your choice to be used. This is the only thing needed in
  19. this file: A number from 0-9, corresponding with the 10
  20. (including plain white) colors available with WWIV Version 4.23 BBS
  21. Software. Other WWIV Versions should work but just stay within
  22. your color range of course (ie: 4.22 and below only has colors
  23. 0-7). Simple as that, you're done.. 
  24.  
  25. Note: MsgColor MAY work (and certainly should...) with other     
  26. full-screen editors for WWIV, but has only been tested with     
  27. Adam Caldwell's WWIVEdit version 2.5 and 2.5b as of this writing.
  28.  
  29. Note: See the msgcolor.Inf File for small details you should 
  30. know about :)
  31.  
  32. What happens once it's installed:
  33.      You get your messages in color, still retaining any user
  34. changed word. Meaning: any and all unmodified text (the user did
  35. not use any CTRL-P colors on) will be colored respective of the
  36. color code you've placed in your MsgColor.Inf file.
  37.  
  38. OK, great.. But what else? :
  39.             ** P I P E   C O D E S **
  40.      
  41.      Well here's the neat part. Your users (and yourself) can now
  42. use "PIPE CODES" in their messages, with NO Needed knowledge of
  43. programming whatsoever! 
  44.  
  45. Meaning what you ask?
  46.  
  47.      Pipe codes are a user configurable form of SAFE ansi color
  48. code insertion Right into the message. What I mean by safe is
  49. that anything BUT the supported codes will do NOTHING. So you
  50. don't really have to worry about "ansi bombs" that may remap your
  51. keyboard (Unless you've modified your WWIVEdit..).
  52.  
  53. So, for example: 
  54. The following would print "Copyright Matt Lampiasi 1994" in dark
  55. blue on a white background (colors that are NOT Normally
  56. available in WWIV- as you know!):
  57.  
  58. |01|23Copyright Matt Lampiasi 1994
  59.  
  60. You and your users get virtually (but not QUITE) instant ansi at
  61. the stroke of a few keys.. Any and ALL ansi colors can be used in
  62. ANY combination of foreground background colors.
  63. The following table describes all the colors available and their
  64. corresponding "pipe" code (ie: what you have to type to get the
  65. color):
  66.  
  67. Foreground Pipe Codes are as follows:
  68.  
  69. |00 Black                |08 Grey (Normal text)
  70. |01 Dark Blue            |09 Bright blue
  71. |02 Dark Green           |10 Bright Green
  72. |03 Dark Cyan            |11 Bright Cyan
  73. |04 Dark Red             |12 Bright Red
  74. |05 Dark Magenta         |13 Bright Magenta
  75. |06 Brown                |14 Yellow
  76. |07 Bright White
  77.  
  78. Background colors
  79.  
  80. |16 Black
  81. |17 Blue
  82. |18 Green
  83. |19 Cyan
  84. |20 Red
  85. |21 Magenta
  86. |22 Brown
  87. |23 Grey
  88.  
  89. So |17|15 would be Bright White on Blue.
  90.      
  91.   To make it perfectly clear (if I've been vague, -I hate docs!):
  92. If you type any of the above codes (ie: |01 through |14, and |16
  93. through |23, preceding any text will remain that code's
  94. corresponding ansi color until another color change takes place
  95. (through another pipe code or a standard WWIV CTRL-P code).
  96.  
  97. MsgColor fully supports it's "pipe Codes" in taglines too!
  98.  
  99. For you as a sysop it's still practical, because it automatically
  100. knows if you are editing an external file with your WWIVEdit and
  101. not a message, and appropriately DOESN'T color external files
  102. (thankfully). You'll value the importance of this if you've ever
  103. done any remote configuration/system file editing from your bbs.
  104.  
  105. Is that ALL?
  106.      No! MsgColor ALSO adds a random tagline from a SYSOP-
  107. CONFIGURABLE database of UNLIMITED TAGLINES to every message
  108. entered.Included you'll find a file called "Taglines.Txt" with
  109. approximately 3500(!) Taglines. You're free to add/delete as many
  110. as you want, though functionality and speed (obviously) will be
  111. maintained if you keep the size of the file reasonable.
  112.  
  113. MsgColor Also thanks your user by their real name for posting or
  114. e-mailing (even if you allow alias's on your bbs).
  115.  
  116. MsgColor works great with my other program "Coolquotes", a
  117. quoting enhancer/colorizer for WWIV.
  118.      
  119. MsgColor works great with User taglines (The pipe codes)!
  120.  
  121.      (Note: Look for version 1b as this addresses some bugs found
  122. in Version 1 and adds compatibility with THIS program. The
  123. archive should be named CoolQ1b.* , where * is the file
  124. extension..)
  125.  
  126. Pipe codes are NOT Quotable using WWIVEdit at this time, due to a
  127. security feature of WWIVEdit that strips ansi codes from any
  128. message text. It may work with versions other than WWIVEdit 2.5
  129. or 2.5b but I have not tested or seen the source. The same goes
  130. for any other Full screen editor.. It may, or it may NOT.
  131.  
  132. *****************************************************************
  133.  This program is NOT free, and took a LOT of time/energy/thought/
  134. and caring to create. You are free to use the program for a 30
  135. day evaluation period, at which point you must either
  136. register, or stop using the program (according to federal law!).
  137.               *******************
  138.  
  139. Registration is categorized as follows:
  140.  
  141. $10.00 U.S. Funds or drawn on a check from a U.S. Bank. Make
  142. checks payable to:
  143.  
  144.  Matt Lampiasi
  145.  7 Chapman Ave. (Apt. 3C)
  146.  Easthampton, MA 01027
  147.  
  148. $8.00 if you call and Download it from my bbs (if you opt this
  149. method I will call you when I receive your registration and make
  150. the arrangements (on my dime) for you to call the bbs).
  151.  
  152. $5.00 for any 1/2 to Full Time college student with proof (Copy
  153. of grades, etc.. whatever is sufficient). If you are a student
  154. and opt for calling my board and downloading, the rate is still
  155. $5.00 per copy.
  156.                ******************
  157.  
  158. Use above address for all correspondence, or for questions (NOT
  159. Technical support for an unregistered product- It's actually been
  160. DONE, believe it!) NETMAIL me:
  161.  
  162. Matt Lampiasi 1:321/314 on Fidonet.
  163.  
  164. Or: Call my bbs at (413) 527-3818  and use the "Product Support" 
  165. Message sub.
  166.  
  167. Registration of Shareware is the most appreciated by authors
  168. who's work goes into these products, but also keeps YOU
  169. continually getting new and better stuff! If this reason is not
  170. enough to compell you to register, at least consider this:
  171. I am a first year (first semester even!) computer Science
  172. convert:
  173.  
  174.       Help me get through school(I'm working for it!)..
  175.   And help avoid some REALLY annoying nagware in the future.
  176.  
  177.  Thanks to Kainen and Led. for suggesting the pipe code support.     
  178.  (And reluctantly answering my nagging questions for details.)
  179.  
  180.          WWIV BBS Software is Copyright Wayne Bell.
  181.          WWIVEdit is Copyright Adam Caldwell.
  182.        And thanks to both of them for writing great stuff!
  183.       
  184.  
  185.        
  186.  
  187.   
  188.  
  189.  
  190.  
  191.     
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.