Black Box 4/BlackBox.cdr/bbs_opus/oac121.arj/OACDEMO.OEC

INI File | 1990-05-22 | 10KB | 207 lines

[VERS 1.15][OnExit]Y:\EDTORIAL
[$1E][CLS][MoreOff]The [OACOMP] is an [OECC] clone with many improvements. Most
improvements are concerned with the new codes supported by OPUS 1.1x,
but the compiler itself also offers a great enhancement over [OECC], most
notably in the way it handles privileges and colours. This file gives you
some examples on this.
[Colour][GOTO LOOP][EndColour]
You may not get the full advantage to this demo, as you do not accept ANSI
or AVATAR control codes to control colours.
[LABEL LOOP]
[SAVE][COLOUR][KEYCOL]C[TXTCOL]olours, [KEYCOL]P[TXTCOL]rivileges, [KEYCOL]S[TXTCOL]upport programs, [KEYCOL]H[TXTCOL]ow do I get it or [KEYCOL]Q[TXTCOL]uit [[c,P,s,h,q] [Menu]CPQSH|
[GOTO TEST][ENDCOLOUR]Colours, Priviliges, Support programs, How do I get it or Quit [[c,P,s,h,q] [Menu]CPQSH|

[LABEL TEST][LOAD][Choice]Q[SAVE][Cyan][RESTORE][CLS][QUIT]
[Choice]S[GOTO SUPPORT]
[Choice]C[GOTO COLOURS]
[Choice]H[GOTO HOW]
[CLS]In [OECC] you had to remember several codes for controlling display based upon
privilege levels, some of them are:
[TABCOL]
        [[@LINE]         - Only see rest of line if Above or equal to @
        [[@FILE]         - Quit file is less than @
        [[@XCLUDE]       - If not equal to @, skip rest of line
[LOAD]
and the problem with these is that it is impossible to remember which tokens
means See rest of line, which means Don't see rest of line, Which is Above,
Above or Equal or Below. [OACOMP] introduces some new tokens that
should be more easy to understand, plus it will enable some privilege combina-
tions that are not normally possible with a single Opus/Avatar code by combi-
ning two codes on the fly:

        [TABCOL][[<Operator> <Privilege> <Action>][LOAD]
[INCLUDE Continue]        [TABCOL][[<Operator> <Privilege> <Action>][LOAD]
where
        [KWDCOL]<Operator>[LOAD] is
            [EXPCOL]ABOVE[LOAD], [EXPCOL]GT           [DETCOL]Above the privilege[LOAD]
            [EXPCOL]BELOW[LOAD], [EXPCOL]LT           [DETCOL]Below the privilege[LOAD]
            [EXPCOL]EQUAL[LOAD], [EXPCOL]EQ           [DETCOL]Equal to the privilege[LOAD]
            [EXPCOL]UNEQUAL[LOAD], [EXPCOL]NE         [DETCOL]Not equal to the privilege[LOAD]
            [EXPCOL]AE[LOAD], [EXPCOL]GE              [DETCOL]Above or Equal to the privilege[LOAD]
            [EXPCOL]BE[LOAD], [EXPCOL]LE              [DETCOL]Below or Equal to the privilege[LOAD]

        [KWDCOL]<Privilege>[LOAD] is
            [EXPCOL]Sysop[LOAD], [EXPCOL]S            [DETCOL]Sysop[LOAD]
            [EXPCOL]AsstSysop[LOAD], [EXPCOL]A        [DETCOL]Assistant Sysop[LOAD]
            [EXPCOL]Clerk[LOAD], [EXPCOL]C            [DETCOL]Clerk[LOAD]
            etc.

        [KWDCOL]<Action>[LOAD] is
            [EXPCOL]SEE                 [DETCOL]See rest of line if condition met[LOAD]
            [EXPCOL]SKIP                [DETCOL]Skip (don't see) rest of line if condition met[LOAD]
            [EXPCOL]QUIT                [DETCOL]Quit file if condition met[LOAD]
[INCLUDE Continue]All combinations are legal, [OACOMP] wil combine two or more codes
to get the desired result, if needed. F.ex. the token

        [TABCOL][[ABOVE AsstSysop QUIT][LOAD]

will be compiled as if you had defined

        [TABCOL][[ALINE][[AXCLUDE][[QUIT][LOAD]

ie. (in [OACOMP] tokens) :

        [TABCOL][[ABOVE AsstSysop SEE][[QUIT][LOAD]

or

        [TABCOL][[AE AsstSysop SEE][[EQ AsstSysop SKIP][[QUIT][LOAD]

which would be compiled into

        [TABCOL]^PLA^PXA^OQ[LOAD]
[INCLUDE Continue]As you can see, controlling display with privileges is much easier accomplished
with the [OACOMP].
[GOTO LOOP][LABEL COLOURS][CLS]
Colours in [OACOMP] is a totally new experience. Gone are all the
usual limitations that you have to define both foreground and background
colours when you define colours and the need to redefine the colours after a
temporary change in colours is also gone. You can even turn off blink! This
was previously only available by specifying the colour you had before the
blink.

The new tokens in [OACOMP] that deals with the colours are:

        [EXPCOL][[SAVE]         [DETCOL]Save the colours in a 128-level stack[LOAD]
        [EXPCOL][[LOAD]         [DETCOL]Restore the last [[SAVE]'d colour[LOAD]
        [EXPCOL][[FG Colour]    [DETCOL]Change the foreground colour only[LOAD]
        [EXPCOL][[BG Colour]    [DETCOL]Change the background colour only.[LOAD]
        [EXPCOL][[STEADY]       [DETCOL]Turn off blink (also available as [[BLINK OFF])[LOAD]
        [EXPCOL][[RESTORE]      [DETCOL]Like [[LOAD] but without emitting any code[LOAD]
[INCLUDE Continue][[SAVE] and [[LOAD] can be used in the following construct:

[TABCOL][[LightGreen]
.
[[SAVE][[White on Red][[Blink] WARNING [[LOAD]
.[LOAD]

This will ensure that any text following the WARNING statement will be the same
colour as the one before it. Even if you should decide to alter the colour
before the WARNING, you will not have to alter it two places, as you normally
should if you had only used OECL codes:

[TABCOL][[LightGreen]
.
[[White on Red][[Blink] WARNING [[LightGreen]
.[LOAD]

Note the second [[LightGreen] token needed to restore the colour. If you then
later on wanted to change the colour of the preceeding and following text to
light cyan, you would have to alter the colour code twice.
[INCLUDE Continue]You can also use the [[SAVE] and [[LOAD] token in [[INCLUDE] files, as I have
done with this .OEC file:

     [TABCOL][[SAVE][[White]
     Continue [[FG LightCyan][[[[[[FG Yellow]Y[[FG LightCyan],n][[FG White] [[Menu]YN|
     [[LOAD][[Choice]N[[Quit]
     [[Cls][LOAD]

This [[INCLUDE] file generates the prompt:
[SAVE][White]
Continue [FG LightCyan][[[FG Yellow]Y[FG LightCyan],n][FG White]
[LOAD]
and ensures that the colours are unchanged after the completion of the
prompt.
[INCLUDE Continue]The [[FG] and [[BG] tokens can be used to only change the foreground and back-
ground colours respectively. You can use it in a construct like this:
[TABCOL]
[[White on Red]                           [[Cyan]
[[White on Red]   This text is in White   [[Cyan]
[[White on Red]           on Red          [[Cyan]
[[White on Red]  The word [[SAVE][[FG Yellow]Next[[LOAD] is Yellow  [[Cyan]
[[White on Red]                           [[Cyan][LOAD]
[SAVE][Colour]
which produces an output like this:

[SAVE][White on Red]                           [LOAD]
[SAVE][White on Red]   This text is in White   [LOAD]
[SAVE][White on Red]           on Red          [LOAD]
[SAVE][White on Red]  The word [SAVE][FG Yellow]Next[LOAD] is Yellow  [LOAD]
[SAVE][White on Red]                           [LOAD]
[GOTO CONT][EndColour][RESTORE]
which would produce a red box with white characters in it, except the word
Next, which would be Yellow.
[LABEL CONT][INCLUDE Continue]One problem with the way [OACOMP] makes these features is that
ALL colour tokens are processed sequentially, including the ones that are
within conditional codes.

This means, than a file containing
[TABCOL]
        [[White on Red]
        .
        .
        [[Choice]Y[[Cyan][[CLS][[QUIT]
        [[FG Yellow]
[LOAD]
will have the final [[FG] token insert the colour code for Yellow on Black,
as [[Cyan] (which is the same as [[Cyan on Black]) changes the background
colour, and OACOMP processes this. The solution is to make the file look like
[TABCOL]
        [[White on Red]
        .
        .
        [[SAVE][[Choice]Y[[Cyan][[CLS][[QUIT][[RESTORE]
        [[FG Yellow]
[LOAD][INCLUDE Continue]The [[BLINK] and [[STEADY] tokens can be used, as in:

      [TABCOL]You [[BLINK]HAD[[STEADY] been warned![LOAD]

which produces

      You [BLINK]HAD[STEADY] been warned!
[Colour][GOTO LOOP][EndColour]
With the HAD word blinking.
[GOTO LOOP][LABEL SUPPORT][CLS][OACOMP] has two support programs, [OAVIEW] and the
[OADECOMP].

[OAVIEW] is an [OVIEW] clone, but with powerful options that allow you
to tell it excactly what privilege level, keys and setup you want to emulate
in that particular invocation. You can also make [OAVIEW] load a user
from your [TABCOL]USER.DAT[LOAD] file, either by name, by number or (by specifying /USER=RND)
by random.

[OADECOMP] is an [OUNECC] clone and will take your .BBS file and
decompile it to an .OEC file. It has switches that allows you to define if the
output file should be [OECC] compatible or not.
[GOTO LOOP][LABEL HOW][CLS]You can obtain a copy of the three programs in several ways:

        F.req. it from me                  ([NODECOL]2:234/10.0[LOAD], [BPSCOL]2400[LOAD] bps)
        Download it from me                ([PHONECOL][phone][LOAD], Area 3)
        F.req. it from StarFleet Academy   ([NODECOL]1:203/57.0[LOAD], [BPSCOL]HST 9600[LOAD])
        F.req. it from The Migrant BBS     ([NODECOL]1:114/7.0[LOAD], [BPSCOL]2400[LOAD] bps ([BPSCOL]9600[LOAD] ?))

The names of the files are:

               [SAVE][White On Red]                                      [LOAD]
               [SAVE][White On Red]     ╒════════════╦═════════════╕     [LOAD]
               [SAVE][White On Red]     │ [FG Yellow]File name[FG White]  ║  [FG LightCyan]Magic name[FG WHITE] │     [LOAD]
               [SAVE][White On Red]     ╞════════════╬═════════════╡     [LOAD]
               [SAVE][White On Red]     │ [FG Yellow]OAC1??.ZIP[FG White] ║  [FG LightCyan]OACOMP[FG White]     │     [LOAD]
               [SAVE][White On Red]     │ [FG Yellow]OAV1??.ZIP[FG White] ║  [FG LightCyan]OAVIEW[FG White]     │     [LOAD]
               [SAVE][White On Red]     │ [FG Yellow]OAD1??.ZIP[FG White] ║  [FG LightCyan]OADECOMP[FG White]   │     [LOAD]
               [SAVE][White On Red]     │ [FG Yellow]OA?1??.ZIP[FG White] ║  [FG LightCyan]OAPACKAGE[FG White]  │     [LOAD]
               [SAVE][White On Red]     └────────────╨─────────────┘     [LOAD]
               [SAVE][White On Red]                                      [LOAD]

[GOTO LOOP]