The LED Script


The script syntax for LED Sign V2.7 is 100% backward compatible with previous version of LED Sign. If your script ran on V2.5 it will run on V2.7. However, a V2.7 script may not run on V2.5.

The syntax for the LED script is extremely simple. Each command must be on one line; they cannot be split onto multiple lines. Only one command can be on a line. A line that starts with a "!!" is a comment. Here is an example of a script:
!! Just a simple script
   !! Move "Hello" up onto the sign
   ScrollUp delay=30 center=true text=Hello
   Sleep delay=1000

   !! Scroll "This is a test" left onto the sign
   ScrollLeft delay=30 startspace=20 endspace=80 text=This is a test
   Sleep delay=300

!! Repeat infinitely
Repeat times=-1

You can write a script with the same text editor that you use to write your HTML. Programs like Windows Notepad or Macintosh teachtext will work fine.

The Options

The different options for each function/transition are as follows:

The Functions/Transitions

The different functions/transitions available in LED Sign are as follows:


[spacing] = [center=true] | [startspace=<non-neg int>] [endspace=<non-neg int>]

Text Color

In LED Sign you can make the "on" LEDs eight different colors:

The way you specify a color is with a '\' followed by 'r', 'o', 'y', 'g', 'c', 'b', 'p', or 'w'. Everything after a color specification will be that color until another color is specified or the end of the line is reached. Each line starts out with the default of red. The text specified as:
  text=This \ois \ya \gtest
will appear on the sign as "This is a test" but with "Test" being red, "is" being orange, "a" being yellow and "test" being green.

Variable tags!!!

LED Sign also has the capability of displaying the current time/date. The tags are specified in the text just like the colors. Here are the time/date tags:

The way the time/date tags are used is by preceding them by a backslash ('\') and enclosing them in brackets ({}). Here is an exaple:
     ScrollLeft text=The current time is \{tt}.  Today is \{dd} \{mm} \{dn}, \{YY}.
The line above in a script would print somthing like "The current time is 6:19 pm. Today is Sun Oct 29, 1995." on the sign.

URL connections!

You can specify a URL to go to if the user clicks on LED Sign while it is displaying a certain message. To do this all you need to do is specify the URL on the function line in the script. Here's an example:
     ScrollLeft URL= text=Java is cool!
     ScrollLeft URL= endspace=40 text=Click on this sign now to go to Sun!
The URL tag is also valid for the "Sleep" function. So you can be displaying a message and sleeping, and they can still click on the sign and have it take them to the URL. Example:
     Appear center=true URL= text=Sun MicroSystems
     Sleep URL= delay=4000
     !! Wait a long time to give them a chance to click!


The "text" parameter must be the last parameter, because the string after the "text=" is your message. This makes it easy to parse (ie no nested quote problem) and easy for the user. What you see is what you get!!!

If the "clear=true" parameter is given to one of the transitions, it will cause the sign to clear (turn off LEDs) in the manner of the transition. i.e. "ScrollDown clear=true" would clear the sign by scrolling whatever is on the sign down off the sign.

If the "center=true" option is set, then the message will be centered on the sign if it fits on the sign. It doesn't make sense to center a message if it is longer than the sign. So, if your message isn't centering, then it is probably too long. The "startspace" and "endspace" parameters are ignored when the "center=true" parameter is given.

The script is much like HTML in how it handles function tags and parameters. It will ignore anything it does not recognize. However, there are some ways to stop the applet. For example, "delay=fifty" is incorrect because "delay" requires an integer and would thus cause the applet to stop. There is some script error output. If you are having trouble with LED Sign running your script, check your java console (under options menu in netscape); any error output is printed there.

The LED Sign Java applet is written and Copyright 1995 by Darrick Brown