  / | _ | \______________
 /         \             \                                            
(   o   o   )         /   |
 \  _| |_  /        _(__   \______                                
 =(_/v\_)=__)_____(______\_______)Ŀ
 SCROLL - ProBoard 2.1x PEX  Version 1.05         (C)1996 Fe-line Software 
 Written by Faye Pearson, Docs by Sarah Pearson         (27th August 1996) 


SCROLL is a ProBoard 2.1x PEX that will allow you to add a horizontal line
of continuous scrolling text to any ANSI screen or Menu. You can read the
Scroll Text in from textfiles and use the ProBoard @<...>@ macros.

Installation
------------

SCROLL needs the use of FeSetup 1.01 (at least).  You can download FeSetup
from the same place you got this archive from. 

Type : FESETUP SCROLL  <press enter>

FeSetup will now run.  Please follow the onscreen prompts and help.
Installation is relatively quick and very simple


SCROLL needs at least one command line parameter to function.

SCROLL [MENU] [x] [y] [len] [colour] "text"

[MENU] is an optional parameter that you use if the scrolling text is part of
       a menu.  This parameter just passes the key pressed back to ProBoard.

[x] is the x coordintate of how far across the screen you want the scroll
    window to begin.

[y] is the y coordinate of how far down the screen you want the scroll to be.

[colour] is the colour that you want the highlight to be.  Colours are entered
as hexadecimal numbers.  The first digit is background, the second is the
foreground.  Bright backgrounds are not usually shown and cause blinking text
with the dark background.

        0 - Black                     8 - Bright Black
        1 - Blue                      9 - Bright Blue
        2 - Green                     A - Bright Green
        3 - Cyan                      B - Bright Cyan
        4 - Red                       C - Bright Red
        5 - Magenta                   D - Bright Magenta
        6 - Yellow                    E - Bright Yellow
        7 - White (Grey)              F - Bright White (Grey)

"text" is the text that you want to be displayed and scrolled.  

Instead of having the text on the data line, you can read the text from a text
file.  Replace "text" with the full path and filename.
eg, d:\pb\scroll\welcome.txt


So, if for example you want to display the ANSI file TEST.A?? and scroll the
line "This is an example line of scrolling text" in cyan, enter the
following as two consecutive menu entries.

 HotKey   : <CTRl-A>                                                        
 Function : 8 - Display A?? file                                            
 Data     : TEST                                                            

 HotKey   : <CTRl-A>                                                        
 Function : 60 - Run SDK File                                               
 Data     : SCROLL "This is an example line of scrolling text"              

The above text is scrolled on the screen in cyan because that is the default
colour.

Change <CTRL-A> to whatever hotkey you prefer if you want to display scrolling
text with an ANSI from a menu option.


If for example you want to scroll the line "Press the highlighted character"
yellow as part of a menu, add the following to the relevant menu.

 HotKey   : <CTRl-A>                                                        
 Function : 60 - Run SDK File                                               
 Data     : SCROLL MENU 0e "Press the highlighted character"                   

SCROLL *must* the last item in the menu.


If for example you want to display the ansi file TEST2.A?? and add the line
"This is also an example line of scrolling text" in red, starting 15 spaces
in from the left, 22 lines down and in a window 35 characters wide, enter
the following :

 HotKey   : <CTRl-A>                                                        
 Function : 8 - Display A?? file                                            
 Data     : TEST2                                                           

 HotKey   : <CTRl-A>                                                        
 Function : 60 - Run SDK File                                               
 Data     : SCROLL 15 22 25 0b "This is also an example line of scrolling text"   

From the above 2 examples you get the idea :-)

The default settings are : x=20, y=20, length=40, colour=bright cyan on black.

You can replace the x, y and len with 0's if you wish to use the default
values.  This makes it easier to remember the parameter layout.

You can also use any of the ProBoard Macros (eg, Users Current File area) in
the scrolling text.


----------------------------------------------------------------------------

Scroll is FreeWare.  No registration fee is required for you to use this PEX.

This PEX is supplied "as is" and we will not be held responsible for any
damage caused by this PEX.  It works on several BBS ok.  This is the only
guarantee given

-----------------------------------------------------------------------------

If you have any bugs, comments or suggestions then you can contact us by :

  Fe-line      +44-181-548-9620, V34/VFC
  2:254/278    FidoNet
  752:752/0    The Global ProBoard Network
  173:902/300  DqP
  sysops@fe-line.demon.co.uk

You can find the latest version of Scroll and all our other ProBoard Software
on our WWW and FTP sites as well as on our BBS.

http://www.fe-line.demon.co.uk
ftp://ftp.pcmicro.com/4_authors/fe-line


Sarah and Faye
Home of Fe-line Software.
