The <window> and </window> tags that begin and end a RealText file, respectively, determine the window type and set attributes such as window height and width. This chapter explains the options you can set.
 |
Note |
|---|
| When you are familiar with the attributes, you can refer to "Summary of Window Tag Attributes". |
You specify attributes within the <window> tag, much as you specify HTML table attributes within the HTML <TABLE> tag. For example:
<window type="tickertape" duration="2:05:00.0" underline_hyperlinks="false">
No attributes are required for the <window> tag, however. If you do not specify an attribute, the attribute's default value applies. When you include an attribute, enclose its value in double quotation marks.
This attribute defines the RealText window type:
The default is type="generic".
 |
Additional Information |
|---|
| For descriptions of the window types, see "Choosing Window Types". |
The duration attribute specifies the time, relative to the start of the presentation, that this RealText stream stops playing. The default is 60 seconds. The RealPlayer timing slider is keyed to this value, which is in 24-hour format, where dd is days, hh is hours, mm is minutes, ss is seconds, x is tenths of seconds, y is hundredths of seconds, and z is milliseconds.
Only the ss value is required. When the time value does not include a decimal point, the last field is read as the seconds. For example, 2:05 means 2 minutes and 5 seconds, whereas 2:05:00 means 2 hours and 5 minutes. You can also specify just the seconds. For example, both of the following values end the text stream 2 hours and 5 minutes after the stream begins:
duration="2:05:00.0"
duration="7500"
 |
Tip |
|---|
| Set a high duration when you start building a RealText presentation. Set the final duration time when you have finished defining the mark-up. |
The width attribute determines the window width in pixels. The default is 500 for TickerTape and Marquee windows, 320 for other window types. SMIL layout tags can specify a playback region width that overrides the width set here. If word wrap is on, the line length for wrapping corresponds to this width value, not the actual region width. Text centering, however, corresponds to the actual region width set in the SMIL file.
|
|
Additional Information |
|---|
| See RealSystem G2 Production Guide available at http://service.real.com/help/library/encoders.html for information about SMIL. |
The height attribute sets the window height in pixels. The default is 30 for TickerTape and Marquee windows, 180 for other window types. SMIL layout tags can specify a window height that overrides the height set here. This typically does not adversely affect the presentation, however.
This attribute determines the window's background color. The default is black for TickerTape windows and white for all other window types. See "Colors" for information on valid colors.
The scrollrate attribute sets the number of pixels per second that the text moves vertically. It has no effect on TickerTape and Marquee windows. The default is 10 for ScrollingNews windows and 0 for all other window types.
|
|
Tip |
|---|
For best results, use a scrollrate under 30. (Best values are
25, 20, 10, 8, 5, 4, 2, and 1.) For rates faster than 30, use
multiples of 20 or 25, such as 40, 50, 60, 75, 80, and so
on.
|
The crawlrate attribute specifies the number of pixels per second that the text moves horizontally. The default is 20 for TickerTape and Marquee windows, 0 for other window types.
|
|
Tip |
|---|
For best results, use a crawlrate under 30. (Best values are
25, 20, 10, 8, 5, 4, 2, and 1.) For rates faster than 30, use
multiples of 20 or 25, such as 40, 50, 60, 75, 80, and so
on.
|
This attribute sets the color of hyperlinks within the text. The default is blue. See "Colors" for other color options.
This attribute determines whether hyperlinks are underlined. The default is true.
This attribute, which defaults to true, specifies whether word wrap is performed. When word wrap is on, text lines longer than the specified window width wrap to the following line. If it is off, long lines are truncated by the window border. This attribute has no effect for windows that have horizontal text motion, such as the TickerTape.
This attribute is available only in TickerTape and Marquee windows, where it defaults to true. When set to true, this attribute tells RealPlayer to buffer all text and redisplay ("loop") it if and when the stream runs dry, which occurs when the text has moved out of the window and no new text has arrived. If the text has looped and new text arrives, the new text displays as soon as the old text has moved out of the window. The new text then becomes part of the loop.
The default value "use" for this variable makes RealText recognize all blank spaces between mark-up tags. If three spaces occur between two words in the RealText file, for example, RealPlayer displays all three spaces. It also recognizes carriage returns and tabs.
If you specify extraspaces="ignore", RealPlayer treats spaces, tabs, line feeds, and carriage returns as does a Web browser, except when they are between the <pre>...</pre> tags. When spaces or carriage returns occur contiguously in the text, RealPlayer interprets them as a single space, no matter how many of them are present. So in this case the three spaces display as one space in RealPlayer. It treats each tab as a single space, though.