ROE - Revision history

MrZeus: whitespace fixes, codeblocks with XML syntax

2016-06-24T13:56:03Z

whitespace fixes, codeblocks with XML syntax

Silvia at 06:28, 13 April 2009

2009-04-13T06:28:44Z

← Older revision		Revision as of 06:28, 13 April 2009
Line 1:		Line 1:
	= Rich Open multitrack media Exposition (ROE) =		Rich Open multitrack media Exposition (ROE)

Silvia: added title

2009-04-13T06:28:14Z

added title

← Older revision		Revision as of 06:28, 13 April 2009
Line 1:		Line 1:
			= Rich Open multitrack media Exposition (ROE) =


	= Overview =		= Overview =

Mdale: /* ROE in Use */

2008-12-19T16:34:37Z

ROE in Use

← Older revision		Revision as of 16:34, 19 December 2008
Line 12:		Line 12:

	== ROE in Use ==		== ROE in Use ==
	A draft version of the spec is in use in ~~media CMS's such as~~ [http://metavid.org/w/index.php/MetaVidWiki MetaVidWiki]. ~~The Dynamic web request senerio~~ is ~~best illustrated by the mv_embed library~~ remote ~~embedding clips from the metavid archive~~. ~~This can be seen in~~ [http://metavid-mike.blogspot.com/ this blog] ~~demonstrating its usage. If you view source you can see~~ the roe ~~xml that is making ogg, flash~~ video ~~clips available along with multiple timed~~ text ~~tracks in CMML~~.		A draft version of the spec is in use in the mediaWiki extension [http://metavid.org/w/index.php/MetaVidWiki MetaVidWiki]. This runs on the site [http://metavid.org metavid.org] and is used for remote embeding. In [http://metavid-mike.blogspot.com/ this blog] for example all the clips refrence a single roe file to expose multiple video tracks and text transcripts. [http://metavid.org/w/index.php?title=Special:MvExportStream&feed_format=roe&stream_name=House_proceeding_06-09-08_01&t=0%3A01%3A38%2F0%3A10%3A00 Sample ROE output] from metavid

	= The ROE model =		= The ROE model =

Mdale: added usag example

2008-11-04T19:10:36Z

added usag example

← Older revision		Revision as of 19:10, 4 November 2008
Line 11:		Line 11:
	Another use of ROE is in a Web client-server scenario. The Web server uses ROE as a means of representing the different tracks that are available for a multi-track Web resource. A Web client may not require all available tracks to present the resource to the user. It may decide to request the ROE representation first and then request only a subset of tracks from the server, e.g. only the English soundtrack. Or it may directly request particular tracks only. The server will use the request from the client to dynamically compose a multi-track stream with the requested tracks and mandatory tracks and serve this to satisfy the resource request.		Another use of ROE is in a Web client-server scenario. The Web server uses ROE as a means of representing the different tracks that are available for a multi-track Web resource. A Web client may not require all available tracks to present the resource to the user. It may decide to request the ROE representation first and then request only a subset of tracks from the server, e.g. only the English soundtrack. Or it may directly request particular tracks only. The server will use the request from the client to dynamically compose a multi-track stream with the requested tracks and mandatory tracks and serve this to satisfy the resource request.

			== ROE in Use ==
			A draft version of the spec is in use in media CMS's such as [http://metavid.org/w/index.php/MetaVidWiki MetaVidWiki]. The Dynamic web request senerio is best illustrated by the mv_embed library remote embedding clips from the metavid archive. This can be seen in [http://metavid-mike.blogspot.com/ this blog] demonstrating its usage. If you view source you can see the roe xml that is making ogg, flash video clips available along with multiple timed text tracks in CMML.

	= The ROE model =		= The ROE model =

Silvia: made inline attribute have values false/partial/full

2008-03-25T00:05:01Z

made inline attribute have values false/partial/full

← Older revision		Revision as of 00:05, 25 March 2008
Line 97:		Line 97:

	=== Inline XML files ===		=== Inline XML files ===
	Some media source elements are XML documents themselves. These can be represented inline in a ROE file. The purpose of this is to contain all the annotation information of a media resource inside one XML file.		Some media source elements are XML documents themselves. These can be represented inline in a ROE file. The purpose of this is to contain all or some the annotation information of a media resource inside one XML file. Thus, the "inline" attribute can have the values "false", "partial" or "full".

	An example inline XML file is the use of CMML inside a ROE track:		An example inline XML file is the use of CMML inside a ROE track:

	<track id="t1" provides="caption">		<track id="t1" provides="caption">
	<mediaSource id="c" src="http://example.com/cmml1.cmml" inline="~~true~~" content-type="text/cmml" >		<mediaSource id="c" src="http://example.com/cmml1.cmml" inline="partial" content-type="text/cmml" >
	<cmml role="caption" xmlns:cmml="http://www.annodex.org/spec/cmml/cmml40">		<cmml role="caption" xmlns:cmml="http://www.annodex.org/spec/cmml/cmml40">
	<cmml:head>		<cmml:head>
Line 115:		Line 115:
	</mediaSource>		</mediaSource>
	</track>		</track>


	== An example ROE XML file ==		== An example ROE XML file ==

Silvia: added defaults to switch statement

2008-03-22T15:26:47Z

added defaults to switch statement

← Older revision		Revision as of 15:26, 22 March 2008
Line 139:		Line 139:
	<body>		<body>
	<track id="v" provides="video">		<track id="v" provides="video">
	<switch distinction="angle">		<switch distinction="angle" default="v1">
	<mediaSource id="v1" content-type="video/theora" src="http://example.com/angle1.ogv?track=v1&t=t1/t2" />		<mediaSource id="v1" content-type="video/theora" src="http://example.com/angle1.ogv?track=v1&t=t1/t2" />
	<mediaSource id="v2" content-type="video/theora" src="http://example.com/angle2.ogv" />		<mediaSource id="v2" content-type="video/theora" src="http://example.com/angle2.ogv" />
Line 145:		Line 145:
	</track>		</track>
	<track id="a" provides="audio">		<track id="a" provides="audio">
	<switch distinction="Content-Language">		<switch distinction="Content-Language" default="a3">
	<switch distinction="bitrate">		<switch id="a1" distinction="bitrate" default="a1b1">
	<mediaSource id="a1b1" lang="en" content-type="audio/vorbis" src="http://example.com/lang1b1.oga" />		<mediaSource id="a1b1" lang="en" content-type="audio/vorbis" src="http://example.com/lang1b1.oga" />
	<mediaSource id="a1b2" lang="en" content-type="audio/vorbis" src="http://example.com/lang1b2.oga" />		<mediaSource id="a1b2" lang="en" content-type="audio/vorbis" src="http://example.com/lang1b2.oga" />
	</switch>		</switch>
	<mediaSource id="a2" lang="de" content-type="audio/vorbis" src="http://example.com/lang2.oga" />		<mediaSource id="a2" lang="de" content-type="audio/vorbis" src="http://example.com/lang2.oga" />
	<seq>		<seq id="a3">
	<mediaSource id="a3" lang="fr" content-type="audio/vorbis" src="http://example.com/~~lang3~~.oga" />		<mediaSource id="a3a" lang="fr" content-type="audio/vorbis" src="http://example.com/lang3a.oga" />
	<mediaSource id="a4" lang="fr" content-type="audio/vorbis" src="http://example.com/~~lang3a~~.org" />		<mediaSource id="a3b" lang="fr" content-type="audio/vorbis" src="http://example.com/lang3b.org" />
	</seq>		</seq>
	</switch>		</switch>
	</track>		</track>
	<track id="t" provides="text overlay">		<track id="t" provides="text overlay">
	<switch distinction="Content-Language">		<switch distinction="Content-Language" default="t1">
	<mediaSource id="t1" lang="en" content-type="text/cmml" src="http://example.com/transcript1.cmml" />		<mediaSource id="t1" lang="en" content-type="text/cmml" src="http://example.com/transcript1.cmml" />
	<mediaSource id="t2" lang="de" content-type="text/cmml" src="http://example.com/transcript2.cmml" />		<mediaSource id="t2" lang="de" content-type="text/cmml" src="http://example.com/transcript2.cmml" />
Line 164:		Line 164:
	</switch>		</switch>
	</track>		</track>
	<track id="l" provides="logo">		<track id="l" provides="logo" default="O1">
	<seq>		<seq>
	<mediaSource id="O1" content-type="application/ogg" src="http://example.com/mng.ogx?track=1" />		<mediaSource id="O1" content-type="application/ogg" src="http://example.com/mng.ogx?track=1" />

Silvia: /* The Switch Tag */

2008-03-22T15:24:16Z

The Switch Tag

← Older revision		Revision as of 15:24, 22 March 2008
Line 80:		Line 80:
	Example <switch> element:		Example <switch> element:

	<switch distinction="language">		<switch distinction="language" default="a3">
	<switch distinction="bitrate">		<switch id="a1" distinction="bitrate" default="a1b1">
	<mediaSource id="a1b1" lang="en" content-type="audio/vorbis" src="http://example.com/lang1b1.oga" />		<mediaSource id="a1b1" lang="en" content-type="audio/vorbis" src="http://example.com/lang1b1.oga" />
	<mediaSource id="a1b2" lang="en" content-type="audio/vorbis" src="http://example.com/lang1b2.oga" />		<mediaSource id="a1b2" lang="en" content-type="audio/vorbis" src="http://example.com/lang1b2.oga" />
	</switch>		</switch>
	<mediaSource id="a2" lang="de" content-type="audio/vorbis" src="http://example.com/lang2.oga" />		<mediaSource id="a2" lang="de" content-type="audio/vorbis" src="http://example.com/lang2.oga" />
	<seq>		<seq id="a3">
	<mediaSource id="a3" lang="fr" content-type="audio/vorbis" src="http://example.com/~~lang3~~.oga" />		<mediaSource id="a3a" lang="fr" content-type="audio/vorbis" src="http://example.com/lang3a.oga" />
	<mediaSource id="a4" lang="fr" content-type="audio/vorbis" src="http://example.com/~~lang3a~~.oga" />		<mediaSource id="a3b" lang="fr" content-type="audio/vorbis" src="http://example.com/lang3b.oga" />
	</seq>		</seq>
	</switch>		</switch>

Silvia: extended example

2008-03-22T15:14:11Z

extended example

← Older revision		Revision as of 15:14, 22 March 2008
Line 121:		Line 121:
	Putting it all together, here is an example of a ROE XML file:		Putting it all together, here is an example of a ROE XML file:

			<?xml version="1.0"?>
			<xs:schema targetNamespace="http://www.xiph.org/roe1.0"
			xmlns:xs="http://www.w3.org/2001/XMLS
			xmlns:html="http://www.w3.org/1999/xhtml"
			elementFormDefault="qualified"
			attributeFormDefault="unqualified">
	<ROE>		<ROE>
	<head>		<head>
			<link id="html_linkback" rel="alternate" type="text/html" href="http://example.com/full_video.html"/>
			<img id="stream_thumb" src="http://example.com/full_video.jpg"/>
			<title>Example video</title>
	<profile name="director's cut">		<profile name="director's cut">
	<partial track="v" select="v1" />		<partial track="v" select="v1" />

Silvia: added img to head tag

2008-03-22T14:37:37Z

added img to head tag

← Older revision		Revision as of 14:37, 22 March 2008
Line 32:		Line 32:
	* a <title> tag to provide a textual description for the multi-track stream,		* a <title> tag to provide a textual description for the multi-track stream,
	* a set of <link> tags that provide an alternative representation of the multi-track stream, e.g. as a html document,		* a set of <link> tags that provide an alternative representation of the multi-track stream, e.g. as a html document,
			* a <img> tag to provide a representative thumbnail for the multi-track stream,
	* a set of <meta> tags that provide structured name-value annotations of the multi-track stream,		* a set of <meta> tags that provide structured name-value annotations of the multi-track stream,
	* a <base> tag to provide a base URI for resources referred to in the ROE file, and		* a <base> tag to provide a base URI for resources referred to in the ROE file, and