required

var sagscroller1=new sagscroller({
id: 'mysagscroller'
})

This is the only required "option" that must be defined when calling sagscroller(). The HTML markup of your SAG scroller should be a DIV with a unique ID plus a regular UL list containing the contents you want to show:

<div id="mysagscroller" class="sagscroller">

<ul>
<li>Message 1</li>
<li>Message 2</li>
<li>Message 3</li>
<li>Message 4</li>
<li>Message 5</li>
</ul>

</div>

v1.3 feature

• In "stunted": the script is initialized immediately, without pre-fetching the heights of each LI content within the scroller. As the user requests a particular content, the script gets the height of that content at that time. The advantage of this method is faster initialization times. The disadvantage is that if your contents do not have explicit heights defined and one hasn't loaded fully at the time of request, the script may miscalculate that content's height and scroll to an incorrect position.
   
• In "onload": the script is initialized when the page has fully loaded. The advantage of this method is that it minimizes any chances of the script retrieving the incorrect heights of each LI content. The disadvantage is higher initialization time.

In general the "stunted" method can be used safely as long as you make sure any image(s) within your LI contents are given explicit width and height attributes, or alternatively, the LIs themselves via CSS.

var sagscroller1=new sagscroller({
id: 'mysagscroller',
mode: 'auto',
pause: 2000
})

var sagscroller1=new sagscroller({
id: 'mysagscroller',
ajaxsource: 'files/sagcontent.txt',
mode: 'auto',
pause: 2000
})

Here's an example of a sample txt file, which as mentioned should just be a regular UL containing the contents you wish to show each as an LI element. The script will use Ajax to dynamically fetch and populate the scroller DIV with the retrieved UL, replacing anything originally in the DIV with it. As such, your SAG DIV should initially be empty on the page:

<div id="mysagscroller" class="sagscroller">

<!--This should be empty!-->

</div>

v1.3 feature

rssdata:{
 feeds: [
  ['Feed Label 1', 'feed_URL1'],
  ['Feed Label 2', 'feed_URL2']
  etc //<--no comma following last feed array!
 ],
 linktarget: '_new',
 displayoptions: 'datetime label snippet',
 entries: 2, //entries to show per feed
 groupbylabel: true //<--no comma following last option
},

For full instructions, please see the supplementary page "Displaying RSS feeds using SAG Scroller".

v1.3 feature

var sagscroller1=new sagscroller({
id: 'mysagscroller',
ajaxsource: 'files/sagcontent.txt',
mode: 'auto',
refreshsecs: 300,
pause: 2000
})

In other words, "sagcontent.txt" is re-requested every 5 minutes, and should the file change during that time, the scroller will show the updated content.

Warning: Do not set this value to too low a value, such as 5. It could mean unnecessary trips to the server, and in the case of the RSS option, may cause you to violate Google's TOS (too many requests to Google Ajax API in such a short time period).