Stext - A Maxs Text Utility  v1.1 (see bugz <oops> )
                        ~~~~~~~~~~~~~~~~~~~~~~~~~~~

  Written By Colin Wilson, Sysop of Amiga Phoenix BBS (+44) 151 252 1282

      Find me on DALnet, #amirc or #maxs nickname PHOE or PHOENIX_BBS

                My homepage is http://come.to/phoenixbbs



What is it ?
~~~~~~~~~~~~

      This is a small door to let you display a text slowly across the
screen. It can be useful for bulletins etc. and will let you give the
filename to display.

      The file must be adapted *slightly* so that the first two lines
give the pause between characters in 50ths of a second, and then the
pause before the each line is printed.

      You may use ansi from within the text by omitting the ESC character
from the start of the sequence - the program looks for a '[' character
at the start of the line, and outputs the rest of the line properly as
ansi without delay. For this reason, move text you want coloured etc.
to another line, or else it will be flashed up as one complete line.
      Ansi positioning may also be used by this method as seen in the
example below.

      You can also alter the initial settings of the speed between each
character being displayed by using a '%' followed by the new speed. This
will then affect all further output until you change it again.

NOTE: No provision is made for a pause at the end of the text, so I would
      suggest setting the print speed 'slower' and printing a few spaces
      to force a delay, or leave a few lines blank.


      OK, now for some practical demonstrations:


[37m        - changes the text colour to white

[25C        - leaves 25 spaces at the start of the next line of text

%1          - makes the text scroll QUICKLY    }   A maximum speed of 1
                                               }   and a minimum of 50
%15         - makes the text scroll SLOWLY     }   is permitted.


Running the door
~~~~~~~~~~~~~~~~

      Call the door as normal, it's default path is DOORS:STEXT/

      If no file is specified to print, or the specified file does not
exist, it will use it's default text called DOORS:STEXT/STEXT.TXT

      ie. INTRODOOR.TEXT can have the line :

                  doors:stext/stext.exe doors:news.text

                              to display the latest news....


          Or, run the door as normal from a key using function 34


------------------------->8--- SNIP ---8<-------------------------
3
10

[37m
This is a test text to check sloooow printing of characters under Maxs BBS
%1

[36m
[23C
Whaddya think ???? ;-)

%5
[35m
You can vary the pause between characters being printed and the pause between
%1
two lines being printed by using the first two lines of the text :-}

[32m
%3
You can also alter the character print speed from within the text ;-)))


[31m
%15
[15;16H
A P T
[33m
%4
[15;22H
    The choice of the lamest sysops




------------------------->8--- SNIP ---8<-------------------------


      This would also be a valid text :


------------------------->8--- SNIP ---8<-------------------------
3
10
This is a small test
to check that
the line
drops
------------------------->8--- SNIP ---8<-------------------------


Bugz
~~~~

      Hehehehe you're kidding right ?  One of * MY * programs bugged ?

      There shouldn't be any if the general rules are followed ;-) but I
didn't include checks for every eventuality.....


          ---->    OK, so i'm not (quite) perfect....    <----

      It turns out that the original version of the door cRaShEd if someone
logged on normally, ie. not local.

      I'll blame it on Trev Rycraft, 'cos it was his code I used to pass the
parameters into the program.....  Anyway, it seems to be fixed now, and I
even did some nullmodem connections to make sure this time :-}

          '.... honestly love, its never done this before ....'

      The fault lay in the incorrect passing of node parameters, not that
it would mean much to anyone :-}  It was resolved by passing the 2 right-
most characters from the CommandLine to the port open command, then the
same two bytes are removed to give the 'real' Command Line parameters to
the rest of the program.

      If you can follow what the hell that means, can you mail me with an
explanation, 'cos i'm not sure if I follow it myself !!!!


Greetz
~~~~~~

      Fly out to (and in Trev's case, a baseball bat...)

            Geoff Hewitt

                             /-  this lamer gave me the idea for the door
            Trevor Rycraft  /--
                            \-- ... and the dodgy command passing routine
                             \-     that I had to fix :-(

            Badmutz

            Rooster

      Anyone else who knows me (who hasn't flamed me for the bugs... :-) )


And ESPECIALLY to Ari Tsironis, who without his Amos extension, I wouldn't
have ever written ANY doors !