home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / bbs_opus / oac121.arj / OACDEMO.BBS < prev    next >
File List  |  1990-05-22  |  9KB  |  263 lines
  1. FY:\EDTORIAL
  2. ₧ The ƒOpus/Avatar COMPiler₧ is an ¥OECC₧ clone with many improvements. Most
  3. improvements are concerned with the new codes supported by OPUS 1.1x,
  4. but the compiler itself also offers a great enhancement over ¥OECC₧, most
  5. notably in the way it handles privileges and colours. This file gives you
  6. some examples on this.
  7. EV00494e
  8. You may not get the full advantage to this demo, as you do not accept ANSI
  9. or AVATAR control codes to control colours.
  10.  
  11. E₧C¢olours, ₧P¢rivileges, ₧S¢upport programs, ₧H¢ow do I get it or ₧Q¢uit [c,P,s,h,q] RCPQSH|
  12. V00719eColours, Priviliges, Support programs, How do I get it or Quit [c,P,s,h,q] RCPQSH|
  13.  
  14. ₧UQâ Q
  15. USV07128
  16. UCV03215
  17. UHV07849
  18. In ¥OECC₧ you had to remember several codes for controlling display based upon
  19. privilege levels, some of them are:
  20. Ü
  21.  [@LINE]     - Only see rest of line if Above or equal to @
  22.  [@FILE]     - Quit file is less than @
  23.  [@XCLUDE] - If not equal to @, skip rest of line
  24. ₧
  25. and the problem with these is that it is impossible to remember which tokens
  26. means See rest of line, which means Don't see rest of line, Which is Above,
  27. Above or Equal or Below. ƒOpus/Avatar COMPiler₧ introduces some new tokens that
  28. should be more easy to understand, plus it will enable some privilege combina-
  29. tions that are not normally possible with a single Opus/Avatar code by combi-
  30. ning two codes on the fly:
  31.  
  32.  Ü[<Operator> <Privilege> <Action>]₧
  33. ƒ
  34. Continue ¢[₧Y¢,n]ƒ RYNQXT|
  35. ₧UNQ
  36. UQQ
  37. UXQ
  38. UTT
  39.  
  40.  Ü[<Operator> <Privilege> <Action>]₧
  41. where
  42.  ƒ<Operator>₧ is
  43.   ¢ABOVE₧, ¢GT  ÜAbove the privilege₧
  44.   ¢BELOW₧, ¢LT  ÜBelow the privilege₧
  45.   ¢EQUAL₧, ¢EQ  ÜEqual to the privilege₧
  46.   ¢UNEQUAL₧, ¢NE     ÜNot equal to the privilege₧
  47.   ¢AE₧, ¢GE ÜAbove or Equal to the privilege₧
  48.   ¢BE₧, ¢LE ÜBelow or Equal to the privilege₧
  49.  
  50.  ƒ<Privilege>₧ is
  51.   ¢Sysop₧, ¢S  ÜSysop₧
  52.   ¢AsstSysop₧, ¢A ÜAssistant Sysop₧
  53.   ¢Clerk₧, ¢C  ÜClerk₧
  54.   etc.
  55.  
  56.  ƒ<Action>₧ is
  57.   ¢SEE ÜSee rest of line if condition met₧
  58.   ¢SKIP  ÜSkip (don't see) rest of line if condition met₧
  59.   ¢QUIT  ÜQuit file if condition met₧
  60. ƒ
  61. Continue ¢[₧Y¢,n]ƒ RYNQXT|
  62. ₧UNQ
  63. UQQ
  64. UXQ
  65. UTT
  66.  
  67. All combinations are legal, ƒOpus/Avatar COMPiler₧ wil combine two or more codes
  68. to get the desired result, if needed. F.ex. the token
  69.  
  70.  Ü[ABOVE AsstSysop QUIT]₧
  71.  
  72. will be compiled as if you had defined
  73.  
  74.  Ü[ALINE][AXCLUDE][QUIT]₧
  75.  
  76. ie. (in ƒOpus/Avatar COMPiler₧ tokens) :
  77.  
  78.  Ü[ABOVE AsstSysop SEE][QUIT]₧
  79.  
  80. or
  81.  
  82.  Ü[AE AsstSysop SEE][EQ AsstSysop SKIP][QUIT]₧
  83.  
  84. which would be compiled into
  85.  
  86.  Ü^PLA^PXA^OQ₧
  87. ƒ
  88. Continue ¢[₧Y¢,n]ƒ RYNQXT|
  89. ₧UNQ
  90. UQQ
  91. UXQ
  92. UTT
  93.  
  94. As you can see, controlling display with privileges is much easier accomplished
  95. with the ƒOpus/Avatar COMPiler₧.
  96. V00494
  97. Colours in ƒOpus/Avatar COMPiler₧ is a totally new experience. Gone are all the
  98. usual limitations that you have to define both foreground and background
  99. colours when you define colours and the need to redefine the colours after a
  100. temporary change in colours is also gone. You can even turn off blink! This
  101. was previously only available by specifying the colour you had before the
  102. blink.
  103.  
  104. The new tokens in ƒOpus/Avatar COMPiler₧ that deals with the colours are:
  105.  
  106.  ¢[SAVE]     ÜSave the colours in a 128-level stack₧
  107.  ¢[LOAD]     ÜRestore the last [SAVE]'d colour₧
  108.  ¢[FG Colour] ÜChange the foreground colour only₧
  109.  ¢[BG Colour] ÜChange the background colour only.₧
  110.  ¢[STEADY] ÜTurn off blink (also available as [BLINK OFF])₧
  111.  ¢[RESTORE] ÜLike [LOAD] but without emitting any code₧
  112. ƒ
  113. Continue ¢[₧Y¢,n]ƒ RYNQXT|
  114. ₧UNQ
  115. UQQ
  116. UXQ
  117. UTT
  118.  
  119. [SAVE] and [LOAD] can be used in the following construct:
  120.  
  121. Ü[LightGreen]
  122. .
  123. [SAVE][White on Red][Blink] WARNING [LOAD]
  124. .₧
  125.  
  126. This will ensure that any text following the WARNING statement will be the same
  127. colour as the one before it. Even if you should decide to alter the colour
  128. before the WARNING, you will not have to alter it two places, as you normally
  129. should if you had only used OECL codes:
  130.  
  131. Ü[LightGreen]
  132. .
  133. [White on Red][Blink] WARNING [LightGreen]
  134. .₧
  135.  
  136. Note the second [LightGreen] token needed to restore the colour. If you then
  137. later on wanted to change the colour of the preceeding and following text to
  138. light cyan, you would have to alter the colour code twice.
  139. ƒ
  140. Continue ¢[₧Y¢,n]ƒ RYNQXT|
  141. ₧UNQ
  142. UQQ
  143. UXQ
  144. UTT
  145.  
  146. You can also use the [SAVE] and [LOAD] token in [INCLUDE] files, as I have
  147. done with this .OEC file:
  148.  
  149.  Ü[SAVE][White]
  150.  Continue [FG LightCyan][[[FG Yellow]Y[FG LightCyan],n][FG White] [Menu]YN|
  151.  [LOAD][Choice]N[Quit]
  152.  [Cls]₧
  153.  
  154. This [INCLUDE] file generates the prompt:
  155. Å
  156. Continue ï[ÄYï,n]Å
  157. ₧
  158. and ensures that the colours are unchanged after the completion of the
  159. prompt.
  160. ƒ
  161. Continue ¢[₧Y¢,n]ƒ RYNQXT|
  162. ₧UNQ
  163. UQQ
  164. UXQ
  165. UTT
  166.  
  167. The [FG] and [BG] tokens can be used to only change the foreground and back-
  168. ground colours respectively. You can use it in a construct like this:
  169. Ü
  170. [White on Red] Cyan]
  171. [White on Red]   This text is in White   [Cyan]
  172. [White on Red]  on Red      [Cyan]
  173. [White on Red]  The word [SAVE][FG Yellow]Next[LOAD] is Yellow  [Cyan]
  174. [White on Red] Cyan]₧
  175. E
  176. which produces an output like this:
  177.  
  178. O ₧
  179. O   This text is in White   ₧
  180. O  on Red      ₧
  181. O  The word NNextO is Yellow  ₧
  182. O ₧
  183. V06114e
  184. which would produce a red box with white characters in it, except the word
  185. Next, which would be Yellow.
  186. ƒ
  187. Continue ¢[₧Y¢,n]ƒ RYNQXT|
  188. ₧UNQ
  189. UQQ
  190. UXQ
  191. UTT
  192.  
  193. One problem with the way ƒOpus/Avatar COMPiler₧ makes these features is that
  194. ALL colour tokens are processed sequentially, including the ones that are
  195. within conditional codes.
  196.  
  197. This means, than a file containing
  198. Ü
  199.  [White on Red]
  200.  .
  201.  .
  202.  [Choice]Y[Cyan][CLS][QUIT]
  203.  [FG Yellow]
  204. ₧
  205. will have the final [FG] token insert the colour code for Yellow on Black,
  206. as [Cyan] (which is the same as [Cyan on Black]) changes the background
  207. colour, and OACOMP processes this. The solution is to make the file look like
  208. Ü
  209.  [White on Red]
  210.  .
  211.  .
  212.  [SAVE][Choice]Y[Cyan][CLS][QUIT][RESTORE]
  213.  [FG Yellow]
  214. ₧ƒ
  215. Continue ¢[₧Y¢,n]ƒ RYNQXT|
  216. ₧UNQ
  217. UQQ
  218. UXQ
  219. UTT
  220.  
  221. The [BLINK] and [STEADY] tokens can be used, as in:
  222.  
  223.  ÜYou [BLINK]HAD[STEADY] been warned!₧
  224.  
  225. which produces
  226.  
  227.  You HAD₧ been warned!
  228. EV00494e
  229. With the HAD word blinking.
  230. V00494 ƒOpus/Avatar COMPiler₧ has two support programs, ƒOpus/Avatar VIEW₧ and the
  231. ƒOpus/Avatar DECOMPiler₧.
  232.  
  233. ƒOpus/Avatar VIEW₧ is an ¥OVIEW₧ clone, but with powerful options that allow you
  234. to tell it excactly what privilege level, keys and setup you want to emulate
  235. in that particular invocation. You can also make ƒOpus/Avatar VIEW₧ load a user
  236. from your ÜUSER.DAT₧ file, either by name, by number or (by specifying /USER=RND)
  237. by random.
  238.  
  239. ƒOpus/Avatar DECOMPiler₧ is an ¥OUNECC₧ clone and will take your .BBS file and
  240. decompile it to an .OEC file. It has switches that allows you to define if the
  241. output file should be ¥OECC₧ compatible or not.
  242. V00494 You can obtain a copy of the three programs in several ways:
  243.  
  244.  F.req. it from me (ƒ2:234/10.0₧, Ü2400₧ bps)
  245.  Download it from me  (¢+45-43710688₧, Area 3)
  246.  F.req. it from StarFleet Academy   (ƒ1:203/57.0₧, ÜHST 9600₧)
  247.  F.req. it from The Migrant BBS (ƒ1:114/7.0₧, Ü2400₧ bps (Ü9600₧ ?))
  248.  
  249. The names of the files are:
  250.  
  251.  O &₧
  252.  O ╒═ ╦══ ╕ ₧
  253.  O │ NFile nameO  ║  KMagic nameO │ ₧
  254.  O ╞═ ╬══ ╡ ₧
  255.  O │ NOAC1??.ZIPO ║  KOACOMPO │ ₧
  256.  O │ NOAV1??.ZIPO ║  KOAVIEWO │ ₧
  257.  O │ NOAD1??.ZIPO ║  KOADECOMPO   │ ₧
  258.  O │ NOA?1??.ZIPO ║  KOAPACKAGEO  │ ₧
  259.  O └─ ╨── ┘ ₧
  260.  O &₧
  261.  
  262. V00494
  263.