M3F - Revision history

MrZeus: fix code blocks, pretty XML colouring

2016-06-24T11:52:15Z

fix code blocks, pretty XML colouring

Martin.leese: /* Describing related texts (lyrics and subtitles) */ Typo (moved space)

2012-05-08T16:23:58Z

Describing related texts (lyrics and subtitles): Typo (moved space)

← Older revision		Revision as of 16:23, 8 May 2012
Line 164:		Line 164:

	=====Describing related texts (lyrics and subtitles)=====		=====Describing related texts (lyrics and subtitles)=====
	The ‘texts’ element links media resources with CMML text resources such as song lyrics and film subtitles in the stream. The required ‘uri’ must point to another resource's id attribute or an external web URL resource. The optional ‘type’ attribute specifies the MIME type of external resource. )It is not encouraged to use the type nor URL option. Keep things in the stream, so to speak.)		The ‘texts’ element links media resources with CMML text resources such as song lyrics and film subtitles in the stream. The required ‘uri’ must point to another resource's id attribute or an external web URL resource. The optional ‘type’ attribute specifies the MIME type of external resource.) It is not encouraged to use the type nor URL option. Keep things in the stream, so to speak.)

	<code><pre><texts uri="#example-text-resource" /></pre></code>		<code><pre><texts uri="#example-text-resource" /></pre></code>

Saoshyant at 16:05, 2 June 2008

2008-06-02T16:05:28Z

← Older revision		Revision as of 16:05, 2 June 2008
Line 213:		Line 213:

	The optional ‘link’ child element can point to any URI via it's ‘uri’ attribute where a full version of the license is available. This means it can be pointed to a ‘resource’ element via it's ‘id’ attribute as well!		The optional ‘link’ child element can point to any URI via it's ‘uri’ attribute where a full version of the license is available. This means it can be pointed to a ‘resource’ element via it's ‘id’ attribute as well!
	<rights>		<code><pre><rights>
	<link type="text/html" uri="http://licenses.record-company.com/artist.html" />		<link type="text/html" uri="http://licenses.record-company.com/artist.html" />
	</rights>		</rights></pre></code>

	=====Describing titles, subtitles, and taglines=====		=====Describing titles, subtitles, and taglines=====

Saoshyant at 16:04, 2 June 2008

2008-06-02T16:04:45Z

← Older revision		Revision as of 16:04, 2 June 2008
Line 3:		Line 3:
	See other [[Metadata\|suggested metadata methods]].		See other [[Metadata\|suggested metadata methods]].

	This document describes the '''proposed''' ''Multimedia Metadata Format'' (M3F) for the Ogg container. The format is built on the Extensible Markup Language (XML). It is intended to describe any kind of multimedia (audio, video, text, images, …) that can reside in an [[Ogg\|Ogg container]].		This document describes the '''proposed''' ''Multimedia Metadata Format'' (M3F) for the Ogg container. The format is built on the Extensible Markup Language (XML). It is intended to describe any kind of multimedia (audio, video, text, images, etc) that can reside in the [[Ogg\|Ogg container]].

	==Format description==		==Format description==
Line 213:		Line 213:

	The optional ‘link’ child element can point to any URI via it's ‘uri’ attribute where a full version of the license is available. This means it can be pointed to a ‘resource’ element via it's ‘id’ attribute as well!		The optional ‘link’ child element can point to any URI via it's ‘uri’ attribute where a full version of the license is available. This means it can be pointed to a ‘resource’ element via it's ‘id’ attribute as well!
			<rights>
	~~<code><pre>~~<rights>
	<link type="text/html" uri="http://licenses.record-company.com/artist.html" />		<link type="text/html" uri="http://licenses.record-company.com/artist.html" />
	</rights~~></pre></code~~>		</rights>

	=====Describing titles, subtitles, and taglines=====		=====Describing titles, subtitles, and taglines=====
	The ‘title’ element describes the resource's title.		The ‘title’ element describes the resource's title.

	~~<code><pre>~~<title>Awesome Audio Track</title~~></pre></code~~>		<title>Awesome Audio Track</title>

	The ‘subtitle’ element describes secondary title.		The ‘subtitle’ element describes secondary title.

	~~<code><pre>~~<subtitle>The Sound of Music</subtitle~~></pre></code~~>		<subtitle>The Sound of Music</subtitle>

	The ‘tagline’ element describes promotional taglines and slogans.		The ‘tagline’ element describes promotional taglines and slogans.

	~~<code><pre>~~<tagline>Get to the real sound!</tagline~~></pre></code~~>		<tagline>Get to the real sound!</tagline>

	==Examples==		==Examples==
Line 237:		Line 236:
	==History==		==History==
	* 2007-11-25 – Began work with simplifying the format.		* 2007-11-25 – Began work with simplifying the format.
	* 2007-09-08 – Wiki page created based on original format and ~~suggestsion~~ from the ~~email~~ list.		* 2007-09-08 – Wiki page created based on original format and suggestions from the mailing list.
	* 2007-09-06 – Format ~~suggested~~ on ~~Xiph's~~ ogg-dev ~~email~~ list by [[User:Aleksandersen\|Daniel Aleksandersen]].		* 2007-09-06 – Format proposed on the ogg-dev mailing list by [[User:Aleksandersen\|Daniel Aleksandersen]].

Aleksandersen: /* Examples */

2008-02-26T11:34:56Z

Examples

← Older revision		Revision as of 11:34, 26 February 2008
Line 233:		Line 233:
	==Examples==		==Examples==

	See [[M3F example]]Multimedia Metadata Format example page]].		See [[M3F example\|Multimedia Metadata Format example page]].

	==History==		==History==

Aleksandersen: Added a link to the example page.

2008-02-26T11:34:42Z

Added a link to the example page.

← Older revision		Revision as of 11:34, 26 February 2008
Line 230:		Line 230:

	<code><pre><tagline>Get to the real sound!</tagline></pre></code>		<code><pre><tagline>Get to the real sound!</tagline></pre></code>

			==Examples==

			See [[M3F example]]Multimedia Metadata Format example page]].

	==History==		==History==

Aleksandersen: /* Addressing the media resource */ id attribute changed to xml:id

2008-02-26T11:11:06Z

Addressing the media resource: id attribute changed to xml:id

← Older revision		Revision as of 11:11, 26 February 2008
Line 44:		Line 44:
	The ‘uri’ attribute may be used in stead of ‘oggserial’. For ogg serials the URI would be ‘urn:oggserial:#0×EXAMPLE’. (Other container and native file formats may specify any URI that works with that format.)		The ‘uri’ attribute may be used in stead of ‘oggserial’. For ogg serials the URI would be ‘urn:oggserial:#0×EXAMPLE’. (Other container and native file formats may specify any URI that works with that format.)

	Resource elements can also have an optional unique ~~‘id’~~ attribute. The ~~‘id’~~ attribute is used as a label when the resource needs to be addressed by another resource element.		Resource elements can also have an optional unique ‘xml:id’ attribute. The ‘xml:id’ attribute is used as a label when the resource needs to be addressed by another resource element.

	<code><pre><resource id="unique-resource-id" […]>		<code><pre><resource xml:id="unique-resource-id" […]>
	[…]</resource></pre></code>		[…]</resource></pre></code>

Aleksandersen: /* Describing recordings */ Major changes to duratinon.

2008-01-26T22:43:06Z

Describing recordings: Major changes to duratinon.

← Older revision		Revision as of 22:43, 26 January 2008
Line 185:		Line 185:
	<duration>::07:04:54</duration>		<duration>::07:04:54</duration>
	</recording></pre></code>		</recording></pre></code>

			Note: When displaying durations in players; it might be better to convert days to hours, and visa versa. This recommendation does not specify in which cases this should be done. Duration and time is presented in different ways according to local variation (and user preference). Though displaying a shortened (lave out the null values) full time according to local variations will provably be the best way. Example: ‘2 days, 23 hours, and 18 seconds.’ OR a converted to days ‘2,96 days.’ Displaying ‘2:23::18:’ (same value as previous examples) may be confusing to users who are not used to this format. Even though it is the shortest way to display the full duration.

	The optional ‘location’ child element describes when the recording was made in a human readable-way. The optional ‘lat’ and ‘long’ attributes are the machine-readable latitude and longitude position of the recording.		The optional ‘location’ child element describes when the recording was made in a human readable-way. The optional ‘lat’ and ‘long’ attributes are the machine-readable latitude and longitude position of the recording.

Aleksandersen: /* Describing titles, subtitles, and taglines */

2008-01-26T22:16:29Z

Describing titles, subtitles, and taglines

← Older revision		Revision as of 22:16, 26 January 2008
Line 228:		Line 228:

	<code><pre><tagline>Get to the real sound!</tagline></pre></code>		<code><pre><tagline>Get to the real sound!</tagline></pre></code>

	~~Below are media type specific children of the ‘resource’ element. The elements are grouped by the media type they describe.~~

	==History==		==History==

Aleksandersen: /* Describing performers */

2008-01-26T22:12:17Z

Describing performers

← Older revision		Revision as of 22:12, 26 January 2008
Line 153:		Line 153:

	======Other and organisations======		======Other and organisations======
	The ~~optional ‘role’ attribute is a space separated list of roles~~ in ~~films with one or more~~ of the ~~following values ‘actor’, ‘director’, and ‘producer’. '''(NEEDS WORK)'''~~. The optional ~~‘as’~~ attribute describes the ~~name of the character as whom the performer played in a film~~.		Optional person elements can contain ‘director’, ‘produser‘, and ‘writer’.
			<code><pre><performers>
			<person>
			<name>Michel Gondry</name>
			<director /></person></performers></pre></code>

			The ‘organisation’ child element describes organisations involved in the production of the resource. The optional ‘uri’ attribute describes the organisation using an (unique?) URI.
			<code><pre><performers>
			<organisation uri="http://partizan.com/">Partizan</organisation></performers></pre></code>

	=====Describing related texts (lyrics and subtitles)=====		=====Describing related texts (lyrics and subtitles)=====