previous next

Appendix E: RealText Tag Reference

Use this appendix for reference when writing RealText files. For complete information on RealText, see Chapter 6. In the tables throughout this appendix, an asterisk (*) denotes a required attribute. Ellipses (...) indicate where nonessential information has been left out of examples.

Window Tag Attributes

The <window> tag that starts each RealText clip can use the attributes specified in the following table to set the overall clip parameters.

RealText <window> Tag Attributes
Attribute Possible Values Default Function Reference
bgcolor name|#RRGGBB|transparent black (tickertape)
white (all others)		 Sets the window color. click here
crawlrate pixels per second 20 (tickertape)
20 (marquee)
0 (all others)		 Sets the horizontal text speed. click here
duration hh:mm:ss.xy 60 seconds Specifies presentation length. click here
extraspaces use|ignore use Recognizes or ignores extra spaces in text. click here
height pixels 30 (tickertape)
30 (marquee)
180 (all others)		 Sets the window pixel height. click here
link name|#RRGGBB blue Specifies the hyperlink color. click here
loop true|false true (tickertape)
true (marquee)
false (all others)		 Turns text looping on or off. click here
scrollrate pixels per second 10 (scrollingnews)
0 (all others)		 Sets the vertical text speed. click here
type generic|tickertape|
marquee|scrollingnews|
teleprompter		 generic Sets the window type. click here
underline_hyperlinks true|false true Determines whether hyperlinks are underlined. click here
version 1.0|1.2|1.4|1.5 1.0 Specifies RealText version. Required for some character sets. click here
width pixels 500 (tickertape)
500 (marquee)
320 (all others)		 Sets the window pixel width. click here
wordwrap true|false true Turns word wrap on or off. click here

Example 

<window type="scrollingnews" width="218" height="420" bgcolor="green" version="1.5" duration="180.5" underline_hyperlinks="false" link="red">
...all clip text...
</window>

Time and Position Tags

The tags in the following table let you time and position the text in a RealText clip.

RealText Time and Position Tags
Tag Attributes Default Function Reference
<clear/> (none) (none) Clears all text from the window. click here
<pos/> x="pixels"|y="pixels" (none) Positions text. click here
<required>...</required> (none) (none) Ensures that text is delivered. click here
<time/> begin="hh:mm:ss.xy"|
end="hh:mm:ss.xy"		 (none) Sets time when text appears or disappears. click here
<tl>...</tl> color="name|#RRGGBB" green Place text at bottom of ticker tape. click here
<tu>...</tu> color="name|#RRGGBB" white Place text at bottom of ticker tape. click here

Examples 

<time begin="10"/>Display at 10 seconds after clip starts.
<time begin="15"/><clear/>Clear previous text and display at 15 seconds after clip starts.

<tu color="yellow">DJIA</tu>
<tl color="blue">7168.35 +36.52 </tl>

Layout and Appearance Tags

The following RealText tags affect the layout and appearance of text.

RealText Layout and Apperance Tags
Tag Function Reference
<b>...</b> Bolds the enclosed text. click here
<br/> Creates a line break and displays text one line down. click here
<center>...</center> Centers the enclosed text. click here
<hr/> Acts like two <br/> tags, but does not create a horizontal rule. Provided for HTML compatibility. click here
<i>...</i> Italicizes the enclosed text. click here
<li>...</li> Acts like a <br/> tag. Provided for HTML compatibility. click here
<ol>...</ol> Indents text, but does not number it. Provided for HTML compatibility. click here
<p>...</p> Creates a text paragraph. click here
<pre>...</pre> Displays text in a monospace font and preserves extra spaces. Works the same as in HTML. click here
<s>...</s> Strikes through the enclosed text. click here
<u>...</u> Underlines the enclosed text. click here
<ul>...</ul> Indents text, but does not add bullets to it. Provided for HTML compatibility. click here

Examples 

<center>This is centered text.</center>

This is <b>bolded</b> text.

This is <u>underlined</u> text.

Font Tag Attributes

The <font> tag lets you select fonts and character sets.

RealText <font> Tag Attributes
Attribute Possible Values Default Function Reference
bgcolor name|#RRGGBB transparent Sets the text background color. click here
charset us-ascii|iso-8859-1|
mac-roman|x-sjis|
gb2312|big5|iso-2022-kr		 iso-8859-1 Specifies character set used to display text. click here
color name|#RRGGBB (none) Controls font color, except for TickerTape window. click here
face (see font tables) Times New Roman Sets the text face. click here
size -2|-1|+0|+1|+2|+3|+4
or
1|2|3|4|5|6|7		 +0 Sets the font size. click here

Examples 

<font color="red" bgcolor="green">This is red text against a green background.</font>

<font size="+1">This text is one size larger than the preceding text.</font>

<font face="Verdana">This text is in the Verdana font.</font>

<font charset="iso-2022-kr" face="BatangChe">...Korean text...</font>

Hyperlinking Commands

You can use <a> and </a> tags to create a link out of enclosed text. The link can open a URL in RealONE Player or the viewer's browser, open an e-mail message, or issue a RealONE Player command.

RealText <a> Tag Attributes
Attribute Possible Values Function Reference
href="command" target="_player" command:seek(time)
command:pause()
command:play()		 Creates hyperlink that issues a command. click here
href="command:openwindow()" name|URL|
zoomlevel		 Opens new, named media windows for URL click here
href="mailto:address" email address Opens e-mail message. click here
href="URL" target="_player" Creates hyperlink to URL. click here

Examples 

<a href="mailto:a@b.com">send e-mail</a>

<a href="rtsp://realserver.example.com/video2.smil target="_player">Play Next Clip</a>

<a href="http://realguide.real.com">Visit RealGuide</a>

<a href="aim:goim?screenname=[name]">Send Me an Instant Message</a>

<a href="command:seek(1:35.4)" target="_player">Seek</a>

<a href="command:play()" target="_player">Play</a>

<a href="command:openwindow(feature, rtsp://realserver.example.com/comedy.rm, zoomlevel=double)">Comedy Hour</a>

RealNetworks, Inc. ©2001 RealNetworks, Inc. All rights reserved.
For more information, visit RealNetworks
Click here if the Table of Contents frame is not visible at the left side of your screen.
previous next