previous next

<window> Tag Attributes

The <window> tag that begins a RealText file determines the window type and sets attributes such as window height and width. You specify attributes within the 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. Enclose all attribute values in double quotes.

Note
When you are familiar with the attributes, you can refer to "Summary of <window> Tag Attributes".

type="window type"

This attribute defines the RealText window type:

The default is type="generic".

Additional Information
For descriptions of the window types, see "Choosing Window Types".

duration="dd:hh:mm:ss.xyz"

The duration attribute specifies the time, relative to the start of the presentation, that this 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"

width="pixels"

The width attribute determines the window width in pixels. The default is 500 for TickerTape and Marquee windows, 320 for other window types.

Note
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 RealMedia Production Guide available at http:// www.real.com for information about creating a SMIL file.

height="pixels"

The height attribute sets the window height in pixels. The default is 30 for TickerTape and Marquee windows, 180 for other window types.

Note
SMIL layout tags can specify a window height that overrides the height set here. This does not adversely affect the presentation, however.

bgcolor="color"

This attribute determines the window's background color. The default is black for TickerTape windows and white for all other window types. See "Color Options" for information on valid colors.

scrollrate="pixels per second"

The scrollrate attribute sets the number of pixels per second that the text moves vertically. It has no effect on TickerTape or Marquee windows. The default is 10 for ScrollingNews windows and 0 for all other window types.

crawlrate="pixels per second"

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.

link="color"

This attribute sets the color of hyperlinks within the text. The default is blue. See "Color Options" for other color options.

underline_hyperlinks="true|false"

This attribute determines whether hyperlinks are underlined. The default is true.

wordwrap="true|false"

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.

loop="true|false"

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 text that loops.


Copyright © 1998 RealNetworks
For technical support on RealNetworks products, visit http://service.real.com/.
Comments on this document? Contact techpubs@real.com.
This file last updated on 05/20/98 at 16:39:41.
previous next