previous next

Appendix D: SMIL Tag Summary

Intended for advanced users, this appendix provides a reference to SMIL 2.0 tags and attributes. Be sure to familiarize yourself with "Conventions Used in this Guide", which explains the typographical conventions used in this appendix.

<smil>...</smil>

The <smil> and </smil> tags must start and end the SMIL markup. The SMIL 2.0 namespace declaration is required. You must declare the RealNetworks extension namespace if your SMIL file includes a customized attribute that uses the rn: prefix.

SMIL 2.0 <smil> Tag Namespaces
Namespace Features Defined Reference
xmlns="http://www.w3.org/2001/SMIL20/Language" SMIL 2 Language Profile click here
xmlns:rn="http://features.real.com/2001/SMIL20/Extensions" RealNetworks extensions click here
xmlns:cv="http://features.real.com/systemComponent" version checking click here

Example

<smil xmlns="http://www.w3.org/2001/SMIL20/Language" 
xmlns:rn="http://features.real.com/2001/SMIL20/Extensions">
...all additional SMIL 2.0 markup...
</smil>

Header Tags

The SMIL file header, created between <head> and </head> tags, contains tags that let you define the presentation's layout, information, transitions, and other features. For basic information about defining the SMIL file header, see "Header and Body Sections".

<meta/>

The header region's <meta/> tags provide presentation information. A <meta/> tag can also set a base URL for source clips in the SMIL file. The content and name attributes are required for each <meta/> tag. For basic information about the <meta/> tag, see "Defining Information for the SMIL Presentation".

SMIL 2.0 <meta/> Tag Attributes
Attribute Value Function Reference
content text|URL Provides the content for the name attribute. click here
name abstract Gives the presentation abstract. click here
author Lists the presentation author's name. click here
base Sets the base URL for the source clips. click here
copyright Supplies the presentation copyright. click here
title Gives the presentation title. click here

Examples

<meta name="author" content="Jane Morales"/>
<meta name="title" content="Multimedia My Way"/>
<meta name="copyright" content="(c)2001 Jane Morales"/>
<meta name="base" content="rtsp://helixserver.example.com/"/>

<layout>...</layout>

The <layout> and </layout> tags within the SMIL header contain other tags that define the layout of visual clips. Within the layout section, you define a root-layout area and separate regions for clips. You can also define secondary media windows.

<root-layout/>

Within the layout section, a single <root-layout/> tag sets the overall size of the main media playback pane. Clips play in regions created within the root-layout area. They do not play in the root-layout area directly. The height and width attributes are required for the <root-layout/> tag. For basic information about the <root-layout/> tag, see "Defining the Main Media Playback Pane".

SMIL 2.0 <root-layout/> Tag Attributes
Attribute Value Default Function Reference
backgroundColor color_value black Sets the window background color. click here
rn:contextWindow auto|openAtStart auto Sets when related info pane opens. click here
height pixels 0 Sets the main window height. click here
rn:resizeBehavior percentOnly|zoom zoom Controls whether regions resize. click here
width pixels 0 Sets the main window width. click here

Example

<layout>
<root-layout backgroundColor="maroon" width="320" height="240"/>
<region ...playback region defined.../>
<region ...playback region defined.../>
</layout>

<topLayout>...</topLayout>

Following <root-layout/>, <topLayout>...</topLayout> tags can define the overall size of a secondary media window that is detached from the main media playback pane. You assign clips to play in regions within this window. You cannot assign clips directly to a <topLayout> window. The height and width attributes are required for the <topLayout> tag. For basic information about the <topLayout> tag, see "Creating Secondary Media Playback Windows".

SMIL 2.0 <topLayout/> Tag Attributes
Attribute Value Default Function Reference
backgroundColor color_value black Sets the background color. click here
close onRequest|whenNotActive onRequest Determines when the window closes. click here
height pixels (none) Sets the window height. click here
open onStart|whenActive onStart Controls when the window opens. click here
rn:resizeBehavior percentOnly|zoom zoom Controls whether regions resize. click here
width pixels (none) Sets the window width. click here

Example

<layout>
<root-layout.../>
...main media playback pane regions defined...
<topLayout width="180" height="120" open="whenActive" close="whenNotActive">
...secondary media playback window regions defined...
</topLayout>
</layout>

<region/>

Following <root-layout/>, or between <topLayout> and </topLayout>, <region/> tags define the size, placement (relative to the pane or window), and properties of each region used to play clips. A unique id attribute is required for each <region/> tag. For basic information about the <region/> tag, see "Defining Playback Regions".

SMIL 2.0 <region/> Tag Attributes
Attribute Value Default Function Reference
backgroundColor inherit|transparent|
color_value
transparent Sets the region background color. click here
bottom auto|pixels|
percentage
auto Sets the region's offset from the bottom of the window. click here
fit fill|hidden|meet|
scroll|slice
hidden Controls how clips fit the region. click here
height auto|pixels|
percentage
auto Sets the region's height. click here
id name (none) Creates an ID for assigning clips. click here
left auto|pixels|
percentage
auto Sets the region's offset from the window's left side. click here
rn:opacity percentage 100% Reduces background opacity. click here
regionName name (none) Provides a name for certain features. click here
right auto|pixels|
percentage
auto Sets the region's offset from the window's right side. click here
showBackground always|whenActive always Determines when the background color appears. click here
soundLevel percentage 100% Cuts or boosts a clip's audio volume. click here
top auto|pixels|
percentage
auto Sets the region's offset from the top of the window. click here
width auto|pixels|
percentage
auto Defines the region's width. click here
z-index number 0 Sets the stacking order when the region overlaps another region. click here

Example

The following example defines both a region and a subregion:

<layout>
<root-layout .../>
<region id="video_region" top="5" left="5" width="240" height="180"z-index="3" backgroundColor="blue" showBackground="whenActive">
<region id="logo_region" bottom="10%" right="15%" fit="fill"/>
</region>
</layout>

<regPoint/>

Between the <layout> and </layout> tags, <regPoint/> tags define registration points that determine where and how clips are placed in regions. The id attribute is required for the <regPoint/> tag. For basic information about the <regPoint/> tag, see "Positioning Clips in Regions".

SMIL 2.0 <regPoint/> Tag Attributes
Attribute Value Default Function Reference
bottom auto|pixels|
percentage
auto Sets the point's offset from the region's bottom border. click here
id name (none) Creates an ID for assigning the point to clips. click here
left auto|pixels|
percentage
auto Sets the point's offset from the region's left side. click here
right auto|pixels|
percentage
auto Sets the point's offset from the region's right side. click here
top auto|pixels|
percentage
auto Sets the point's offset from the region's top border. click here
regAlign topLeft|topMid|
topRight|midLeft|
center|midRight|
bottomLeft|bottomMid|
bottomRight
topLeft Specifies how clips align to the point. click here

Example

<layout>
...windows and regions defined...
<regPoint id="middle" left="50%" top="50%" regAlign="center"/>
</layout>

<transition/>

Following the layout section, <transition/> tags define transition effects that occur when clips start or stop. The id and type attributes are required for the <transition/> tag. For basic information about the <transition/> tag, see "Defining Transition Types".

SMIL 2.0 <transition/> Tag Attributes
Attribute Value Default Function Reference
borderColor blend|color_value black Specifies a border color or a blended border. click here
borderWidth pixels 0 Specifies a border width. click here
fadeColor color_value black Sets a color for fades. click here
direction forward|reverse forward Specifies the transition direction. click here
dur time_value 1s Defines the length of the transition effect. click here
endProgress 0.0-1.0 1.0 Ends the effect before it completes fully. click here
horzRepeat integer 1 Sets a number of horizontal repetitions. click here
id name (none) Creates an ID for assigning the effect. click here
startProgress 0.0-1.0 0.0 Starts the effect at a midway point. click here
subtype subtype_name (varies) Defines an optional subtype for each type. click here
type type_name (none) Specifies the main transition type. click here
vertRepeat integer 1 Sets a number of vertical repetitions. click here

Example

<layout>
...windows, regions, and registration points defined...
</layout>
<transition id="sixteenBoxes" type="fourBoxWipe" subtype="cornersOut" horzRepeat="2"
vertRepeat="2" dur="2s"/>

Clip Source Tags

You add clips to a presentation with one of the following source tags:

<animation/> animation clip such as Macromedia Flash
<audio/> audio clip such as RealAudio
<brush/> color block used in place of a media clip
<img/> image file in GIF, JPEG, or PNG format
<ref/> any type of clip not covered by the other tags
<text/> static text file
<textstream/> streaming text clip such as RealText
<video/> video clip such as RealVideo

Except for <brush/>, the choice of tag does not affect playback. All clip source tags can use <ref/>, for example. The src attribute is required for all clip source tags except <brush/>. For basic information about the clip souce tags, see "Creating Clip Source Tags".

Streaming and Information

The following clip source tag attributes set basic streaming characteristics, and supply information about the clip.

SMIL 2.0 Streaming and Informational Clip Tag Attributes
Attribute Value Default Function Reference
abstract text (none) Provides a clip abstract. click here
alt text (none) Provides alternate text. click here
author text (none) Lists the clip's author. click here
bitrate bits_per_second 12288 Sets a static clip's streaming speed. Use in a <param/> tag. click here
copyright text (none) Lists the copyright for the clip. click here
rn:delivery client|server client Specifies server-side or client-side action. Use in a <param/> tag. click here
id name (none) Names clip for reference by other elements, such as animations. click here
longdesc text (none) Provides a long description. click here
readIndex integer 0 Determines how assistive devices read clip information. click here
reliable false|true false Ensures reliable transmission. click here
src URL (none) Provides a full or relative URL for the clip. Not used with <brush/>. click here
title text (none) Provides a title for the clip. click here

Examples

<audio id="audio1" src="rtsp://helixserver.example.com/media/music.rm"/>
<video src="rtsp://helixserver.example.com/media/clip1.rm" title="Bob Expounds His View" 
author="RealNetworks Media Services" copyright="(c)2002 RealNetworks, Inc."/>
<img id="image1" src="http://www.example.com/poster.jpg" region="image_region" dur="15s">
<param name="bitrate" value="5000" rn:delivery="server"/>
</img>

Timing and Layout

The following table lists attributes that control clip timing and layout.

SMIL 2.0 Timing and Layout Clip Tag Attributes
Attribute Value Default Function Reference
begin time_value 0s Delays normal playback time. See also "Advanced Timing Attributes" below. click here
clipBegin time_value 0s Specifies the clip's internal timing mark where playback begins. click here
clipEnd time_value (none) Specifies the clip's internal timing mark where playback ends. click here
dur time_value|media|
indefinite
media Sets the total time the clip or one of its repeating cycles plays. click here
end time_value (none) Sets the end time for the clip. See also "Advanced Timing Attributes" below. click here
erase never|whenDone whenDone Specifies if the clip remains when its fill period expires. click here
fill auto|default|freeze|
hold|remove|transition
auto|
default
Determines the fill state when the clip is no longer active. click here
fillDefault auto|freeze|hold|
inherit|remove|
transition
inherit Sets a default fill for contained elements, such as animations. click here
mediaRepeat strip|preserve preserve Strips out native repetitions. click here
regAlign topLeft|topMid|
topRight|midLeft|
center|midRight|
bottomLeft|bottomMid|
bottomRight
topLeft Specifies which part of the clip aligns to the registration point. click here
region region_ID (none) Assigns the clip to a region. click here
regPoint regPont_ID|
topLeft|topMid|
topRight|midLeft|
center|midRight|
bottomLeft|bottomMid|
bottomRight
(none) Assigns the clip to a predefined registration point, or specifies a point on the region. click here
repeatCount integer|indefinite|
fractional_value
0 Repeats the clip the specified number of times, or indefinitely. click here
repeatDur time_value|indefinite 0s Repeats the clip the specified amount of time. click here
restart always|default|never|
whenNotActive
always Determines if the clip can replay. click here
syncBehavior canSlip|default|
independent|locked
default Sets how the clip synchronizes to its group. click here
transIn <transition/> ID (none) Assigns a starting transition effect. click here
transOut <transition/> ID (none) Assigns an ending transition effect. click here

Examples

<video id="video1" src="rtsp://helixserver.example.com/media/video2.rm" region="video_region"
begin="40s" clipBegin="5100ms"clipEnd="4.5min" fill="freeze"/>
<audio id="audio1" src="rtsp://helixserver.example.com/media/music.rm"
dur="10.5s" repeatCount="5"/>

Advanced Timing Attributes

The following table summarizes the advanced event values you can use with the begin and end timing attributes. Most event values require an ID value that identifies the element trigger.

Advanced Timing Values for begin and end Attributes
Value Event Type Function Reference
accesskey(key) interactive Start or stop an element on a keypress. click here
ID.activateEvent interactive Start or stop an element on a mouse click. click here
ID.begin scheduled Start or stop a clip when another element begins. click here
ID.beginEvent interactive Start or stop a clip when another element begins. click here
ID.end scheduled Start or stop a clip when another element ends. click here
ID.endEvent interactive Start or stop a clip when another element ends. click here
ID.focusInEvent interactive Start or stop an element through keyboard focus. click here
ID.focusOutEvent interactive Start or stop an element through keyboard focus. click here
ID.inBoundsEvent interactive Start or stop an element on cursor movement. click here
ID.marker(name) scheduled Start or stop an element when a marker is reached. click here
ID.outOfBoundsEvent interactive Start or stop an element on cursor movement. click here
ID.repeat(integer) scheduled Start or stop an element on a clip loop cycle. click here
ID.repeatEvent interactive Start or stop an element on a clip repetition. click here
ID.topLayoutCloseEvent interactive or scheduled Start or stop an element when a secondary media playback window closes. click here
ID.topLayoutOpenEvent interactive or scheduled Start or stop an element when a secondary media playback window opens. click here
ID.wallclock(time) scheduled Start or stop an element with an external clock. click here

Examples

<img src="http://www.example.com/button1.gif" id="button" dur="30s" region="button_1"/>...
<video src="rtsp://helixserver.example.com/video1.rm" begin="button.activateEvent".../>
<img src="http://www.example.com/image.png" id="image1" region="image_region" dur="1min">
<set targetElement="image_region" attributeName="backgroundColor" to="red"
begin="image1.inBoundsEvent" end="image1.outOfBoundsEvent"/>
</img>

Color and Transparency

The following attributes affect colors and the use of transparency. Attributes that use a rn: prefix require that you declare the RealNetworks extensions namespace.

SMIL 2.0 Clip Color and Transparency Tag Attributes
Attribute Value Default Function Reference
rn:backgroundOpacity percentage 100% Adjusts background opacity. click here
bgcolor color_value (none) Substitutes color for transparency. Use in a <param/> tag. click here
rn:chromaKey color_value (none) Turns selected color transparent. click here
rn:chromaKeyOpacity percentage 0% Adds opacity to rn:chromaKey. click here
rn:chromaKeyTolerance #nnnnnn (none) Widens range of rn:chromaKey. click here
color color_value black Sets color in a <brush/> tag. click here
rn:mediaOpacity percentage 100% Adjusts overall transparency. click here

Examples

<img src="http://www.example.com/button.gif" rn:backgroundOpacity="50%" region="region1"/>
<img src="http://www.example.com/picture.jpg" rn:chromaKey="#808080" 
rn:chromaKeyOpacity="50%"/>

Text Characteristics

With plain text files or inline text clips, which are described in "Adding Text to a SMIL Presentation", you can use the following parameters to specify the text font, size, color, alignment and so on. Each parameter must appear in a separate <param/> tag.

Text Parameters for Plain Text and Inline Text
Name Values Default Function Reference
backgroundColor name|#RRGGBB white Sets the background color. click here
charset character_set computer default Defines the character set. click here
expandTabs true|false true Replaces tabs with spaces. click here
fontBackgroundColor name|#RRGGBB white Sets the color behind the text. click here
fontColor name|#RRGGBB black Selects the font color. click here
fontFace font_name computer default Determines the font used. click here
fontPtSize point_size (none) Sets a specific point size. click here
fontSize -2|-1|+0|+1|+2|+3|+4
or
1|2|3|4|5|6|7
+0 Sets the font relative or absolute size. click here
fontStyle italic|normal normal Italicizes text. click here
fontWeight 100-900|bold|normal normal Turns text bold. click here
hAlign left|center|right left Aligns text horizontally. click here
vAlign top|center|bottom top Aligns text vertically. click here
wordWrap true|false true Turns off word wrapping. click here

Example

<text src="data:,This%20is%20inline%20text." region="text_region" dur="8s">
<param name="charset" value="iso-8859-1"/>
<param name="fontFace" value="System"/>
<param name="fontColor" value="yellow"/>
<param name="backgroundColor" value="blue"/>
</text>

<prefetch/>

Chapter 19 describes the <prefetch/> tag, which lets you download clip data before the clip plays. The <prefetch/> tag can use many SMIL timing attributes to set limits on prefetching. It also has its own attributes that control the data download. The id attribute is required.

SMIL 2.0 <prefetch> Tag Attributes
Attribute Value Default Function Reference
bandwidth bits_per_second|
percentage
100% Sets the bandwidth used to get data. click here
begin time_value 0s Delays the prefetch start. click here
clipBegin time_value 0s Specifies the clip's internal timing mark where prefetching begins. click here
clipEnd time_value (none) Specifies the clip's internal timing mark where prefetching ends. click here
dur time_value|media|
indefinite
media Sets the duration for prefetching. click here
end time_value (none) Sets the end time for prefetching. click here
id name (none) Names prefetching element for reference by other SMIL elements. click here
mediaSize bytes|percentage 100% Sets how much data to fetch based on clip size. Overrides mediaTime. click here
mediaTime time_value|percentage 100% Specifies the amount of data to fetch based on the clip's duration. click here
restart always|default|never|
whenNotActive
always Determines if prefetching can restart. click here
src URL (none) Gives the URL to the prefetched clip. click here
syncBehavior canSlip|default|
independent|locked
default Sets how <prefetch/> synchronizes to its group. click here

Group Tags

Chapter 11 explains the group tags that you can use to create the superstructure for your presentation's timeline.

<seq>...</seq>

The <seq> and </seq> tags play the enclosed clips in sequence. No attributes are required for a <seq> tag, which is described in "Playing Clips in Sequence".

SMIL 2.0 <seq> Tag Attributes
Attribute Value Default Function Reference
begin time_value 0s Delays the normal group playback. click here
dur time_value|media|
indefinite
media Sets the total time the group plays. click here
end time_value (none) Sets an end time for the group. click here
fill freeze|hold|remove remove Determines the fill state when the group is no longer active. click here
fillDefault auto|freeze|hold|
inherit|remove|
transition
inherit Sets a default fill for contained clips. click here
id name (none) Names the group for reference by other elements. click here
repeatCount integer|indefinite|
fractional_value
0 Repeats the group the specified number of times, or indefinitely. click here
repeatDur time_value|indefinite 0s Repeats the group the specified amount of time. click here
restart always|default|never|
whenNotActive
always Determines if the group can restart. click here
restartDefault always|inherit|never|
whenNotActive
inherit Specifies a restart value the group passes to its elements. click here
syncBehavior canSlip|default|
independent|locked
default Determines how the group synchronizes to its containing group. click here
syncBehaviorDefault canSlip|independent|
inherit|locked
inherit Sets the default syncBehavior value for the elements the group contains. click here
syncTolerance time_value|
inherit
inherit Creates a tolerance value for locked elements in the group. click here
syncToleranceDefault time_value (none) Sets a tolerance value inherited by other groups the group contains. click here

Example

<seq repeatDur="30min">
<audio src="rtsp://helixserver.example.com/one.rm"/>
<audio src="rtsp://helixserver.example.com/two.rm"/>
</seq>

<par>...</par>

The <par> and </par> tags make enclosed clips play at the same time. No attributes are required for a <par> tag, which is described in "Playing Clips in Parallel".

SMIL 2.0 <par> Tag Attributes
Attribute Value Default Function Reference
abstract text (none) Provides an abstract for the group. click here
author text (none) Lists an author for the group. click here
begin time_value 0s Delays the normal playback time. click here
copyright text (none) Lists the copyright for the group. click here
dur time_value|media|
indefinite
media Sets the total time the group plays. click here
end time_value (none) Sets an end time for the group. click here
endsync all|first|ID|last|
media
last Determines when the group ends. click here
fill freeze|hold|remove remove Determines the fill state when the group is no longer active. click here
fillDefault auto|freeze|hold|
inherit|remove|
transition
inherit Sets a default fill for contained clips. click here
id name (none) Names the group for reference by other elements. click here
repeatCount integer|indefinite|
fractional_value
0 Repeats the group the specified number of times, or indefinitely. click here
repeatDur time_value|indefinite 0s Repeats the group the specified amount of time. click here
restart always|default|never|
whenNotActive
always Determines if the group can restart. click here
restartDefault always|inherit|never|
whenNotActive
inherit Specifies a restart value the group passes to its elements. click here
syncBehavior canSlip|default|
independent|locked
default Determines how the group synchronizes to its containing group. click here
syncBehaviorDefault canSlip|independent|
inherit|locked
inherit Sets the default syncBehavior value for the elements the group contains. click here
syncTolerance time_value|
inherit
inherit Creates a tolerance value for locked elements in the group. click here
syncToleranceDefault time_value (none) Sets a tolerance value inherited by other groups the group contains. click here
title text (none) Lists a title for the group. click here

Example

<par endsync="text" repeatCount="2" begin="4s">
<video src="rtsp://helixserver.example.com/newsong.rm" region="video_region"/>
<textstream id="text" src="rtsp://helixserver.example.com/newsong.rt" region="text_region"/>
</par>

<excl>...</excl>

The <excl> and </excl> tags create an exclusive group in which only one clip can play at a time. A duration is required for the <excl> tag if all elements in the group use interactive timing. For basic information on this tag, see "Creating an Exclusive Group".

SMIL 2.0 <excl> Tag Attributes
Attribute Value Default Function Reference
begin time_value 0s Delays the normal playback time. click here
dur time_value|media|
indefinite
media Sets the total time the group plays. click here
end time_value (none) Sets an end time for the group. click here
endsync all|first|ID|last|
media
last Determines when the group ends. click here
fill freeze|hold|remove remove Determines the fill state when the group is no longer active. click here
fillDefault auto|freeze|hold|
inherit|remove|
transition
inherit Sets a default fill for contained clips. click here
id name (none) Names the group for reference by other elements. click here
repeatCount integer|indefinite|
fractional_value
0 Repeats the group the specified number of times, or indefinitely. click here
repeatDur time_value|indefinite 0s Repeats the group the specified amount of time. click here
restart always|default|never|
whenNotActive
always Determines if the group can restart. click here
restartDefault always|inherit|never|
whenNotActive
inherit Specifies a restart value the group passes to its elements. click here
syncBehavior canSlip|default|
independent|locked
default Determines how the group synchronizes to its containing group. click here
syncBehaviorDefault canSlip|independent|
inherit|locked
inherit Sets the default syncBehavior value for the elements the group contains. click here
syncTolerance time_value|
inherit
inherit Creates a tolerance value for locked elements in the group. click here
syncToleranceDefault time_value (none) Sets a tolerance value inherited by other groups the group contains. click here

Example

<excl dur="indefinite">
<video src="video1.rm" begin="button1.activateEvent" region="video_region"/>
<video src="video2.rm" begin="button2.activateEvent" region="video_region"/>
<video src="video3.rm" begin="button3.activateEvent" region="video_region"/>
</excl>

<priorityClass>...</priorityClass>

These tags create a priority class within an exclusive group. Each priority class, which is described in "Modifying Clip Interruption Behavior", defines the interruption behavior of clips within the exclusive group. No attributes are required for a <priorityClass> tag.

SMIL 2.0 <priorityClass> Tag Attributes
Attribute Value Default Function Reference
higher pause|stop pause Sets class behavior on interruption by clips with higher priority. click here
id name (none) Names the group for reference by other elements. click here
lower defer|never defer Specifies how interrupting clips with lower priority behave. click here
pauseDisplay disable|hide|
show
show Sets a clip's appearance if the clip is paused. click here
peers defer|never|
pause|stop
stop Controls how clips in the same class interrupt each other. click here

Example

<excl>
<priorityClass peers="pause">
<video src="video1.rm" begin="button1.activateEvent" region="video_region"/>
<video src="video2.rm" begin="button2.activateEvent" region="video_region"/>
<video src="video3.rm" begin="button3.activateEvent" region="video_region"/>
</priorityClass>
</excl>

<switch>...</switch>

The <switch> and </switch> tags, described in "Understanding Switching", specify elements that RealOne Player chooses between based on certain criteria. No attributes are required for the <switch> tag.

SMIL 2.0 <switch> Tag Attributes
Attribute Value Function Reference
id name Names the group as a link target for other SMIL files. click here

Test Attributes

Elements within a <switch> group must include a test attribute, such as systemBitrate or systemLanguage. You can add a test attribute to any clip source tag, as well as <a/>, <area/>, <layout>, <region/>, <prefetch/>, <excl>, <par>, <seq>, <animate/>, <animateColor/>, <animateMotion/>, and <set/> tags.

SMIL 2.0 Test Attributes for Switching
Attribute Value Function Reference
systemAudioDesc on|off Tests for an audio descriptions preference. click here
systemBitrate bits_per_second Tests for the bit rate. click here
systemCaptions on|off Tests for a captions preference. click here
systemComponent component Checks for a component or a version number. click here
systemLanguage language_code Tests for a language preference. click here
systemOperatingSystem OS_name Tests for the operating system. click here
systemOverdubOrSubtitle overdub|subtitle Tests for an overdub or subtitle preference. click here
systemRequired prefix Verifies namespace support. click here
systemScreenDepth 1|4|8|24|32 Tests for the monitor color depth. click here
systemScreenSize pixel_heightX
pixel_width
Tests for the monitor size. click here

Examples

<switch>
<audio src="rtsp://helixserver.example.com/seattle_french.rm" systemLanguage="fr"/>
<audio src="rtsp://helixserver.example.com/seattle_german.rm" systemLanguage="de"/>
<audio src="rtsp://helixserver.example.com/seattle_english.rm"/>
</switch>
<switch>
<ref src="rtsp://helixserver.example.com/slides1.rp" systemBitrate="80000"/>
<ref src="rtsp://helixserver.example.com/slides2.rp" systemBitrate="20000"/>
</switch>

Hyperlink Tags

<a>...</a>

The <a>...</a> tags turn the enclosed clip source tag into a hyperlink. For basic information about these tags, see "Creating a Simple Link". The href attribute is required for the <a> tag.

SMIL 2.0 <a> Tag Attributes
Attribute Value Default Function Reference
accesskey key (none) Sets a keystroke that opens the link. click here
actuate onLoad|onRequest onRequest Determines whether or not the link requires user activation. click here
alt text (none) Supplies alternate text for the link. click here
destinationLevel percentage 100% Specifies the audio level of the target. click here
destinationPlaystate pause|play play Sets the play state of the target when the link opens. click here
external false|true false Sends the link to the browser if true. click here
href URL (none) Gives the link URL. click here
show new|replace replace Sets the current or a new media playback window as the target. click here
sourceLevel percentage 100% Sets the audio level of the source. click here
sourcePlaystate pause|play|stop pause|play Sets the play state of the source. click here
tabindex integer 0 Sets the tabbing order for links. click here
target name (current window) Identifies a window or a SMIL region. click here
click here

Example

<a href="http://www.real.com" external="true" sourcePlaystate="pause"> 
<video src="video.rm" region="video_region"/>
</a>

<area/>

An <area/> tag can define a hot spot hyperlink that can be temporal as well as spatial. It fits within a clip source tag pair:

<video ...>
<area .../>
</video>

The following table lists possible <area/> tag attributes. No attributes are required for this tag, but href is typically included. For basic information about the <area/> tag, see "Using the <area/> Tag".

SMIL 2.0 <area/> Tag Attributes
Attribute Value Default Function Reference
accesskey key (none) Sets a keystroke that opens the link. click here
actuate onLoad|onRequest onRequest Determines whether or not the link requires user activation. click here
alt text (none) Supplies alternate text for the link. click here
begin time_value 0s Sets when the link becomes active. click here
coords pixels|percentage (none) Defines the hot spot size and location. click here
destinationLevel percentage 100% Specifies the audio level of the target. click here
destinationPlaystate pause|play play Sets the play state of the target when the link opens. click here
dur time_value (none) Sets the total time the link is active. click here
end time_value (none) Sets when the link deactivates. click here
external false|true false Sends the link to the browser if true. click here
height pixels media height Sets related info pane height in <rn:param>. click here
href URL (none) Gives the link URL. click here
id name (none) Defines the element ID. click here
nohref (none) (none) Indicates that the link has no URL. click here
rn:sendTo _osdefaultbrowser|
_rpbrowser|
_rpcontextwin
(none) Specifies a browser window that opens the HTML page. click here
click here
shape rect|circle|poly rect Sets the hotspot shape. click here
show new|replace replace Sets the current or a new media playback window as the target. click here
sourceLevel percentage 100% Sets the audio level of the source. click here
sourcePlaystate pause|play|stop pause|play Sets the play state of the source. click here
tabindex integer 0 Sets the tabbing order for links. click here
target name current window Identifies a window or a SMIL region. click here
click here
width pixels 330 Sets pane width in <rn:param>. click here

Examples

<video src="video.rm" region="video_region">
<area href="http://www.example.com/context.html" external="true" rn:sendTo="_rpcontextwin"
sourcePlaystate="play">
<rn:param name="width" value="320"/>
<rn:param name="height" value="240"/>
</area>
</video>
<video src="video.rm" region="video_region">
<area href="rtsp://helixserver.example.com/video2.rm" shape="circle" coords="80,60,30"
begin="5s" end="45s" show="new" sourcePlaystate="play" destinationPlaystate="play"/>
</video>

Animation Tags

<animate/>

The <animate/> tag is the basic animation tag. Other animation tags are variations of <animate/>. The targetElement and attributeName attributes are generally required, as well as one of the to, by, or values attributes. For more on this tag, see "Creating Basic Animations".

SMIL 2.0 <animate/> Tag Attributes
Attribute Value Default Function Reference
accumulate none|sum none Makes a repeating animation build with each iteration when set to sum. click here
additive replace|sum replace Adds the animation value to the existing attribute value if set to sum. click here
attributeName attribute_name (none) Selects the attribute to animate. click here
begin time_value 0s Delays normal playback time. click here
by pixels|percentage|
color_value
(none) Animates the element by a certain amount. Do not use with to. click here
calcMode discrete|linear|
paced
linear Controls the flow of an animation. click here
dur time_value|indefinite media Sets the total time the animation or one of its repeating cycles plays. click here
end time_value (none) Sets the end time for the animation. click here
fill auto|default|freeze|
hold|remove
auto|
default
Determines the fill state when the animation is no longer active. click here
from pixels|percentage|
color_value
(none) Sets a starting point for the animation. Use with to or by. click here
id name (none) Names the animation for reference by other elements. click here
repeatCount integer|indefinite|
fractional_value
0 Repeats the animation the specified number of times, or indefinitely. click here
repeatDur time_value|indefinite 0s Repeats the animation the specified amount of time. click here
restart always|default|never|
whenNotActive
always Determines if the animation can restart. click here
targetElement ID (none) Identifies the tag that contains the animated attribute. click here
to pixels|percentage|
color_value
(none) Sets an end point for the animation. Do not use with by. click here
values pixels|percentage|
color_value
(none) Defines a list of values applied to the animated attribute. click here

Examples

<animate targetElement="video_region" attributeName="width" to="380" dur="3s"/>
<animate targetElement="image_region" attributeName="width" dur="2s" by="16" accumulate="sum" 
repeatCount="4" calcMode="discrete"/>

<animateColor/>

The <animateColor/> tag is similar to <animate/>, but it works for color animations only. The targetElement and attributeName attributes are generally required, as well as one of the to, by, or values atttributes. For more on this tag, see "Animating Colors".

SMIL 2.0 <animateColor/> Tag Attributes
Attribute Value Default Function Reference
attributeName attribute_name (none) Selects the attribute to animate. click here
begin time_value 0s Delays normal playback time. click here
by pixels|percentage|
color_value
(none) Animates the element by a certain amount. Do not use with to. click here
calcMode discrete|linear|
paced
linear Controls the flow of an animation. click here
dur time_value|indefinite media Sets the total time the animation or one of its repeating cycles plays. click here
end time_value (none) Sets the end time for the animation. click here
fill auto|default|freeze|
hold|remove
auto|
default
Determines the fill state when the animation is no longer active. click here
from pixels|percentage|
color_value
(none) Sets a starting point for the animation. Use with to or by. click here
id name (none) Names the animation for reference by other elements. click here
restart always|default|never|
whenNotActive
always Determines if the animation can restart. click here
targetElement ID (none) Identifies the tag that contains the animated attribute. click here
to pixels|percentage|
color_value
(none) Sets an end point for the animation. Do not use with by. click here
values pixels|percentage|
color_value
(none) Defines a list of values applied to the animated attribute. click here

Example

<animateColor targetElement="image_region" attributeName="backgroundColor" 
values="red;blue;yellow" calcMode="discrete" begin="1s" dur="12s" fill="freeze"/>

<animateMotion/>

The <animateMotion/> tag can move an element both horizontally and vertically. The targetElement attribute is generally required, as well as one of the to, by, or values atttributes. For more on this tag, see "Creating Horizontal and Vertical Motion".

SMIL 2.0 <animateMotion/> Tag Attributes
Attribute Value Default Function Reference
accumulate none|sum none Makes a repeating animation build with each iteration when set to sum. click here
additive replace|sum replace Adds the animation value to the existing attribute value when set to sum. click here
begin time_value 0s Delays normal playback time. click here
by pixels|percentage|
color_value
(none) Animates the element by a certain amount. Do not use with to. click here
calcMode discrete|linear|
paced
paced Controls the flow of an animation. click here
dur time_value|indefinite media Sets the total time the animation or one of its repeating cycles plays. click here
end time_value (none) Sets the end time for the animation. click here
fill auto|default|freeze|
hold|remove
auto|
default
Determines the fill state when the animation is no longer active. click here
from pixels|percentage|
color_value
(none) Sets a starting point for the animation. Use with to or by. click here
id name (none) Names the animation for reference by other elements. click here
repeatCount integer|indefinite|
fractional_value
0 Repeats the animation the specified number of times, or indefinitely. click here
repeatDur time_value|indefinite 0s Repeats the animation the specified amount of time. click here
restart always|default|never|
whenNotActive
always Determines if the animation can restart. click here
targetElement ID (none) Identifies the tag that contains the animated attribute. click here
to pixels|percentage|
color_value
(none) Sets an end point for the animation. Do not use with by. click here
values pixels|percentage|
color_value
(none) Defines a list of values applied to the animated attribute. click here

Example

<animateMotion targetElement="image_region" values="180,180;60,340;125,95" 
calcMode="discrete" begin="7s" dur="5s" fill="freeze"/>

<set/>

The <set/> tag sets an attribute to a specified value. The targetElement, attributeName, and to attributes are required. For more on this tag, see "Setting an Attribute Value".

SMIL 2.0 <set/> Tag Attributes
Attribute Value Default Function Reference
attributeName attribute_name (none) Selects the attribute to animate. click here
begin time_value 0s Delays normal playback time. click here
dur time_value|indefinite media Sets the total time the animation or one of its repeating cycles plays. click here
end time_value (none) Sets the end time for the animation. click here
fill auto|default|freeze|
hold|remove
auto|
default
Determines the fill state when the animation is no longer active. click here
id name (none) Names the animation for reference by other elements. click here
restart always|default|never|
whenNotActive
always Determines if the animation can restart. click here
targetElement ID (none) Identifies the tag that contains the animated attribute. click here
to pixels|percentage|
color_value
(none) Sets the attribute value. click here

Example

<set targetElement="video_region" attributeName="backgroundColor" to="blue" dur="30s"/>


RealNetworks, Inc. ©2002 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