Width & Height
The width and height of the applet are set in the HTML code you add to the web page. Be sure to change the dimensions in the <object> and the <embed> tags.

The applet must be wide enough to display your longest text item with your chosen font. The height must be tall enough to display your chosen font. To avoid the trial-and-error of finding the best size, set the Testmode parameter to 'yes' and click anywhere inside the applet: the minimum width and height will be shown in a tooltip message. You can then edit the HTML code and set Testmode back to 'no'.

Parameters
The parameters below should be added to your datafile in the form NAME=VALUE (for instance, BgColor=FF0000). Each parameter should be on a separate line. You can leave blank lines in the list to organize the parameters into groups if you want to. The parameter names are not case-sensitive, and neither are the values, so BgColor=FF0000 is the same as bgcolor=ff0000. You can add the parameters to your file in any order. Most parameters have a default value which we show in bold text below: if you don't include the parameter in your datafile, the default value will be used automatically.

BorderColor
Sets the color of the border surrounding the applet, if ShowBorder is set to 'yes'. The default color is 000000 (black).

CPS
Sets the speed of NewsLine's text animation, in characters per second. The default value is 20. Decrease this value to reduce animation speed, or increase the value to make the animation faster.

DefaultTarget
Every item can link to a separate URL, and it can open it into a separate frame or window: we provide numbered Target parameters for that. However, you probably want most (or maybe all) the links to open into one particular frame. Enter the frame name in this parameter, and every item without its own Target parameter will open the link into this 'default' frame. You can use the HTML names _self, _top, _parent, _blank or _new. If you leave this parameter out of your datafile, links will open into _self (the frame or window containing the applet).

Heading
Sets the text of the heading shown at the left of the NewsLine applet if ShowHeading is set to 'yes'. The default is Headlines:.

HeadingFillColor
Sets the background color of the area at the left of the applet where the Heading is shown. The default is FFFFFF (white). (If TransparentHeading is set to 'yes', the color will match the background color of the applet set in your HTML code. If the applet is also Transparent, the HTML content behind the applet will be visible instead.)

HeadingFont
Sets the name, size and style of font to use for the Heading (if ShowHeading is set to 'yes'), with each part separated by commas. The default is Sans,8,bold.

• Name: You can include any number of font names, separated by pipe symbols (|), and the applet will use the first font available on the user's system. To ensure compatibility, finish with one of these generic names: Sans, Serif or Typewriter.
  
• Size: The size of the font in points.
  
• Style: The style can be plain, bold, italic or bold-italic.

HeadingTextColor
Sets the color of the text used for the Heading (if ShowHeading is set to 'yes'). The default color is 000000 (black).

Hold
Sets the number of seconds that each text item should remain on the screen before the next is shown. The default is 2 seconds.

ItemFillColor
Sets the background color of the area where the text items are displayed. The default color is FFFFFF (white).

ItemFocusUnderline
A choice of yes or no according to whether you want an HTML-style underline to be shown when the mouse moves over a text-item. The default is no. (This option is most effective is ShowBorder is set to 'no'.)

ItemFont
Sets the font used for the text-items, with a default of Sans,8,plain. This parameter is constructed in exactly the same way as the HeadingFont parameter.

ItemTextColor
Sets the default color for all text items displayed by NewsLine. Any item that doesn't have its own numbered TextColor parameter will use this color. The default for this parameter is 000000 (black).

ItemTextFocusColor
Sets the default focus-color for all text items, the color of the text when the mouse moves over it. The default for this parameter is 0000FF (blue).

ItemTextPressColor
Sets the color of a text items when clicked (active). The default is FF0000 (red).

Name
Specifies a name for this instance of the applet. This is only necessary if you are using the applet in conjunction with our free Satellite add-on, and it's explained in the documentation for Satellite, available from the Cool Focus web site. If you are not using Satellite with this applet, it's best not to include this parameter in your datafile (although nothing bad will happen if you do).

ShowBorder
A choice of yes or no, according to whether you want to display a border around the applet. The default is yes. The color of the border is set in the BorderColor parameter.

ShowUnderscore
A choice of yes or no to whether NewsLine should display a cursor-style underscore at the end of the text during animation. The default setting is No.

ShowHeading
A choice of yes or no to whether you want to display a heading at the left of the applet. The default is yes. If you choose 'no', the entire width of the applet will be used to display the text items, and the parameters that relate to the heading (Heading, HeadingFillColor, HeadingFont, HeadingTextColor, TransparentHeading) will be ignored.

ShowVersion
A yes or no value. This parameter is included in all Cool Focus Flash applets, and its default is no. If set to 'yes', the version number of the applet (and other details) will be shown when the applet starts. This is included only for troubleshooting purposes, to help you determine which version of an applet you're using. It should be set to 'no' (or removed from your datafile) before you publish your page.

Note: If the applet is not registered, this information will always be shown when the applet starts, regardless of the ShowVersion parameter's setting.

SoundClick
Specifies the absolute or relative URL of an MP3 audio file to play when the mouse is clicked on a linking text-item. If you don't want to play a sound for this event, just leave this parameter out of your datafile.

SoundNewItem
Specifies the absolute or relative URL of an MP3 audio file to play each time a text-item begins to be shown. If you don't want to play a sound for this event, just leave this parameter out of your datafile.

SoundRelease
Specifies the absolute or relative URL of an MP3 audio file to play when the mouse is released after clicking a linking text-item. If you don't want to play a sound for this event, just leave this parameter out of your datafile.

Testmode
A yes or no value, with a default of 'no'. This parameter is included in most Cool Focus Flash applets, and is used to help you determine the best width and height for the applet. (Because of this, it's best to use this parameter when you've got everything in the applet the way you want it.) Set this parameter to 'yes', then view the applet in your browser and click anywhere inside the applet. You'll see the minimum width and height displayed in a tooltip message, and you can copy these values into the page's HTML code. When you're done, remember to set the Testmode parameter back to 'no' or delete it from your datafile.

Note: If you've specified a list of font names in the applet's font parameters, it's a good idea to check that the applet will be big enough whichever of those fonts is used: with Testmode set to 'yes', move each font name to the beginning of the list and refresh the page to see if Testmode reports that larger dimensions are needed.

Transparent
A choice of yes or no according to whether you want the applet to be transparent, allowing the HTML background and/or content to be visible behind it. This parameter will only have an effect in compatible browsers. In animated applets like NewsLine, using transparency will make the applet run more slowly and use much more of the computer's CPU power.

TransparentHeading
A yes or no value, with a default of no. If set to 'yes', the HeadingFillColor parameter will be ignored and the background of the Heading area will match the background color of the applet set in your HTML code. (If the applet is transparent, the HTML content behind the applet will be visible in this area instead.)

TransparentItemFill
A yes or no value, with a default of no. If set to 'yes', the ItemFillColor parameter will be ignored and the background of the area where the text items are shown will match the background color of the applet set in your HTML code. (If the applet is transparent, the HTML content behind the applet will be visible in this area instead.)

Items
The parameters below are the most important ones: they set the text items to be displayed by NewsLine, and the URLs each item should link to. You must include at least one Item parameter or NewsLine will display nothing at all!

The parameters all have numbers after their names, and the numbers you use must be consecutive, starting from 1. If you want to show 10 items, but you forget to include an Item7 parameter, NewsLine will stop looking for any more, and will only find items 1 to 6.

Item1, Item2, ..., Item_n
These parameters specify the text you want NewsLine to display. The items will displayed in numerical order, starting from 1, and you can include as many items as you like.

URL1, URL2, ..., URL_n
The optional URL to which the text-item with the same number should link when clicked. If you don't want the item to act as a link, don't include a URL parameter for it. To make items behave like links in all respects except linking somewhere (which can be useful for testing), use a dollar sign ($, or when encoded, %24) as the first character of the URL.

Target1, Target2, ..., Target_n
The name of the frame or window into which the URL with the same number should open. If you don't include this parameter, the frame name set in the DefaultTarget parameter will be used.

TextColor1, TextColor2, ..., TextColor_n
Specifies an individual color to use for the text-item with the same number. If you don't include a TextColor parameter for an item, the color set in the default TextColor parameter will be used.