DATE:     March 28, 1996

RE:       Script cuts



DADPRO and DAD486x implement three methods for directing script information to a
terminal or DAD's internal script machine:

1) Text to be displayed whenever its associated audio cut plays:  This is designed for artist
information, live tags for commercials, or RDS/RBDS data.

2) Text not associated with a particular audio cut; may be called up at anytime:  This is for
displaying weather, news, live copy, etc.

3) Hypertext scripts created with any word processor; designed to embed audio buttons,
special fonts, and lines into script with an internet-like script markup language (.SML)

To implement the first two methods, you must first assign one or more script channels to
a COM port or DAD's internal script machine.  This is accomplished by editing the
workstation's configuration file, i.e. \DAD\FILES\ONAIR.CFG or \DAD\FILES\NEWS.CFG,
etc.  Near the bottom of the file are four lines:

SEND_TEXT_A_IO      = 99
SEND_TEXT_B_IO      = 2
SEND_TEXT_C_IO      = 0
SEND_TEXT_D_IO      = 0

In the above example, channel A is assigned to the internal script machine (code 99) and
channel B is assigned to COM2:.  Note that there must be an associated com_info
statement in the .CFG file:

COM2_INFO           = "9600 N 8 1"
COM2_IRQ            = 3

Here, script channel B expects to send text data to a device on COM2: running at 9600
baud with no parity, 8 data bits, and 1 stop bit.

After this initial setup is complete, you may add scripts to DAD.  Using your favorite word
processor, design the script you wish to be displayed.  When it is complete, it must be
saved in ASCII text format.  Follow the appropriate instructions for each script method:
For method (1) above, you must name the cut after the associated audio cut number.  You
may create the script before or after the associated audio is recorded into DAD.  In the
record machine, the single digit box next to the cut number is the script designator field. 
According to the above example, in this field you would put A for the internal script
machine or B for COM2:.  If you have recorded cut number 56700 to location G:, you must
name your script file G:\CUTS\56700.TXT.  When these steps are completed, any time cut
56700 is played, the associated text file will be displayed.

For method (2) above, you may name the script file whatever you wish and place it in any
directory to which the workstation has access (usually \DAD\SCRIPTS).  Then to create the
script cut within DAD, select an available cut number, go to the library, touch ADD -
COMMAND CUT and enter the cut number you've selected.  Give it a meaningful title such
as "Weather Script" or "Morning News", etc.  Select a group such as SCRIPTS or
COMMANDS, then press ADD RECORD.  This will bring up the command cut editor.  The
syntax of the command to use is SEND TEXT <script channel> <path:\filename>.  For
instance, if there is a weather script file called \DAD\SCRIPTS\WEATHER.TXT, and you
wish to display it on the external script monitor attached to COM2: (according to our
example), the command would be SEND TEXT B \DAD\SCRIPTS\WEATHER.TXT  Press
the VERIFY SYNTAX button to ensure the command was properly entered.  This
command cut may now be executed from a playback machine, array button, p-play button,
or quad play button.  You may, for instance, schedule a script command cut in a playlist
just before an audio commercial so the tag will be displayed for the duration of the
commercial.  In this instance, make sure the commercial has an AutoLoad (L) designation
so DAD will stop and allow the announcer to read the live tag.

To use method (3) above (.SML language), you do not have to have SEND_TEXT set up
in the .cfg files.  Simply create a script with an .SML extension with your favorite word
processor, and save it in ASCII format in the \DAD\SCRIPTS subdirectory.  For instance,
you may have created \DAD\SCRIPTS\NEWS.SML.  To load this script, select the script
machine from the icon panel, type news in the field provided, and touch LOAD.  The script
will be displayed on the internal machine.  You may create macros in your word processor
to embed SML codes listed below.

               Script Markup Language Definition


<BACKGn> - backgroud color n: sets the documents background
color to the color value of n. (n >= 0, n <= 255)
e.g., <BACKG15> sets color to WHITE.

<FOREGn> - foregroud color n: sets the documents foreground
color to the color value of n. (n >= 0, n <= 255)
e.g., <FOREG0> sets color to BLACK.

<P> - paragraph end: a new line is issued and a double line
space is issued.

<HRn> - horizontal rule: issues a new line and horizontal line
is drawn whose thickness may optionally be specified by n,
default = 3. (n > 0, n <= 10)
e.g., <HR>, <HR1>, <HR5>

<Fn>, </Fn> - select font type: selects the font type of type n.
A new line is immediately issued and text thereafter is of font
type n.  All font type selections must be followed at a later
position in the document by a </Fn> token.  This reselects the
default font type of type 1 and issues a new line.
(n >= 0, n <= 2, or 12 if ENCO has prepared special fonts for you)
e.g., <F2> This is a test </F2>

<BUTTON="<cutid>" TEXT="<desc>" FOREG=f BACKG=b> - user input button:
A button is created of size dependent on the length of the <desc>
and current font type. Where, <cutid> is a double quoted 5 decimal
cut identifier, <desc> is a double quoted button description (may
contail line splitters '|'), f and b are numerical color value
designating the buttons foreground and background colors respectively.
e.g., <BUTTON="00123" TEXT="Back In The USA|Chuck Berry" FOREG=15
BACKG=4>