[www] r471 - trunk/www.matroska.org/data/technical/specs/tagging

[email protected]
Newsgroups gmane.comp.multimedia.matroska.cvs
Message-ID <[email protected]>
Author: robux4
Date: 2004-08-20 15:35:16 +0400 (Fri, 20 Aug 2004)
New Revision: 471

Modified:
   trunk/www.matroska.org/data/technical/specs/tagging/example-audio.html
   trunk/www.matroska.org/data/technical/specs/tagging/index.html
Log:
First attempt at defining the TargetTypes with some generic values added

Modified: trunk/www.matroska.org/data/technical/specs/tagging/example-audio.html
===================================================================
--- trunk/www.matroska.org/data/technical/specs/tagging/example-audio.html	2004-08-20 10:47:26 UTC (rev 470)
+++ trunk/www.matroska.org/data/technical/specs/tagging/example-audio.html	2004-08-20 11:35:16 UTC (rev 471)
@@ -150,7 +150,7 @@
 		<ul>
 			<li>Targets (<em>no target means the whole content of the file, otherwise you can put all ChapterUIDs</em>)
 			<ul>
-				<li><em>TargetType = &quot;ALBUM&quot;</em></li>
+				<li><em>TargetType = &quot;MEDIUM&quot;</em></li>
 			</ul>
 			</li>
 			<li>SimpleTag
@@ -182,7 +182,7 @@
 
 		<li>Tag
 		<ul>
-			<li>Targets (<em>include all chapters that match the first 4 tracks, there can't be a PART_NUMBER here since it wouldn't match the TOTAL_PARTS in the ALBUM</em>)
+			<li>Targets (<em>include all chapters that match the first 4 tracks, there can't be a PART_NUMBER here since it wouldn't match the TOTAL_PARTS in the MEDIUM</em>)
 			<ul>
 				<li>ChapterUID = 123456</li>
 				<li>ChapterUID = 234567</li>
@@ -423,7 +423,7 @@
 		<ul>
 			<li>Targets (no target means the whole content of the file, otherwise you can put all ChapterUIDs)
 			<ul>
-				<li>TargetType = &quot;ALBUM&quot;</li>
+				<li>TargetType = &quot;MEDIUM&quot;</li>
 			</ul>
 			</li>
 			<li>SimpleTag
@@ -488,7 +488,7 @@
 		<ul>
 			<li>Targets (no target means the whole content of the file, otherwise you can put all ChapterUIDs)
 			<ul>
-				<li>TargetType = &quot;ALBUM&quot;</li>
+				<li>TargetType = &quot;MEDIUM&quot;</li>
 			</ul>
 			</li>
 			<li>SimpleTag
@@ -559,7 +559,7 @@
 		<ul>
 			<li>Targets (no target means the whole content of the file, otherwise you can put all ChapterUIDs)
 			<ul>
-				<li>TargetType = &quot;ALBUM&quot;</li>
+				<li>TargetType = &quot;MEDIUM&quot;</li>
 			</ul>
 			</li>
 			<li>SimpleTag
@@ -725,7 +725,7 @@
 		<ul>
 			<li>Targets (no target means the whole content of the file, otherwise you can put all ChapterUIDs)
 			<ul>
-				<li>TargetType = &quot;ALBUM&quot;</li>
+				<li>TargetType = &quot;MEDIUM&quot;</li>
 			</ul>
 			</li>
 			<li>SimpleTag

Modified: trunk/www.matroska.org/data/technical/specs/tagging/index.html
===================================================================
--- trunk/www.matroska.org/data/technical/specs/tagging/index.html	2004-08-20 10:47:26 UTC (rev 470)
+++ trunk/www.matroska.org/data/technical/specs/tagging/index.html	2004-08-20 11:35:16 UTC (rev 471)
@@ -236,13 +236,13 @@
 <h2>Tag translations</h2>
 <p>To be able to save tags from other systems to Matroska we need to translate them to our system. There is a translation table <a href="othertagsystems/comparetable.html">on our site</a> and <a href="http://hobba.hobba.nl/audio/tag_frame_reference.html">one done by Prodoc</a> that will hopefully be featured here soon.</p>
 
-<h1>Tag Formatting</h1>
+<h2>Tag Formatting</h2>
 <ul>
-  <li>The TagName should always be written in all capital letters.</li>
+  <li>The TagName should always be written in all capital letters and contain no space.</li>
   <li><a name="time"/>The fields with dates should have the following&nbsp;format:&nbsp;YYYY-MM-DD
     HH:MM:SS.MSS YYYY = Year, -MM = Month, -DD = Days, HH = Hours, :MM = Minutes,
     :SS = Seconds, :MSS = Milliseconds. To store less accuracy, you remove items
-    starting from the left. To store only the year, you would use, &quot;2004&quot;.
+    starting from the right. To store only the year, you would use, &quot;2004&quot;.
     To store a specific day such as May 1st, 2003, you would use &quot;2003-05-01&quot;.
   </li>
   <li><a name="float"/>Fields that require a Float should use the &quot;.&quot;
@@ -253,6 +253,26 @@
     numbers, no letters or symbols other than &quot;.&quot;. For instance, you
     would store &quot;15.59&quot; instead of &quot;$15.59USD&quot;.</li>
 </ul>
+
+<h2><a name="targettypes"/>Target types</h2>
+
+<p>The TargetType element allows tagging of different parts that are inside or outside a given file. For example in an audio file with one track you could have informations about the CD it comes from and even the CD set even if it's not found in the file.</p>
+
+<p>For application to know what kind of information (like TITLE) relates to a certain level (CD title or track title), we also need a set of official TargetType names. For now audio and video will have different names. That also means the same tag can have different meanings depending on where it is (otherwise we would end up with 15 TITLE_ tags).</p>
+
+<table class="techdef">
+<tr><th>Level</th><th>Audio TargetType</th><th>Video TargetType</th><th>Comment</th></tr>
+<tr><td>-</td><td>VOLUME</td><td>SEASON</td><td>a high hierarchy when many sets or media are related to each other</td></tr>
+<tr><td>SET</td><td>SET</td><td>SET</td><td>the collection of different medium</td></tr>
+<tr><td>MEDIUM</td><td>MEDIUM</td><td>MEDIUM</td><td>the physical medium (when it exists) like a CD or a DVD</td></tr>
+<tr><td>SIDE</td><td>SIDE</td><td>SIDE</td><td>when the original medium (LP/DVD) has different sides</td></tr>
+<tr><td>-</td><td>TRACK</td><td>EPISODE</td><td></td></tr>
+<tr><td>-</td><td>MOVEMENT</td><td>CHAPTER</td><td></td></tr>
+<tr><td>-</td><td>INDEX</td><td>SCENE</td><td>the lowest hierarchy found in music or movies</td></tr>
+</table>
+
+<h2><a name="tags"/>Official tags</h2>
+
 <p>The following is a complete list of the supported Matroska
   Tags. While it is possible to use Tag names that are not listed below, this
   is not reccommended as compatability will be compromised. If you find that there
@@ -267,41 +287,13 @@
     <th title="Defines if either TagString or TagBinary is used">Type</th>
     <th>Description</th>
   </tr>
-<!--  <tr>
-    <th colspan="5"><a name="Levels">Levels</a></th>
-  </tr>
   <tr>
-    <td>MEDIA</td>
-    <td>UTF-8</td>
-    <td>Refers to a single medium. (e.g. a CD, a DVD or a tape)</td>
-  </tr>
-  <tr>
-    <td>MEDIA_SET</td>
-    <td>UTF-8</td>
-    <td>Refers to a set of several media. (e.g. a multi CD set or a DVD pack)</td>
-  </tr>
-  <tr>
-    <td>MEDIA_PART</td>
-    <td>UTF-8</td>
-    <td>Refers to a part of a media. (e.g. a track of an audio CD or a chapter of a DVD)</td>
-  </tr>
-  <tr>
-    <td>MEDIA_SUBPART</td>
-    <td>UTF-8</td>
-    <td>Refers to a sub part of a media. (e.g. an index of a CD track or a scene of a DVD chapter)</td>
-  </tr>-->
-  <tr>
     <th colspan="5"><a name="Organizational">Organizational Information</a></th>
   </tr>
-<!--  <tr>
-    <td>LEVEL_TYPE</td>
-    <td>UTF-8</td>
-    <td>Specifies the type of the current level. (e.g. MEDIA_SET or MEDIA_PART). LEVEL_TYPE is a mandatory for EditionUID. <A href="examples.html" target="_blank">Check this for more information</A> </td>
-  </tr>-->
   <tr>
     <td>TOTAL_PARTS</td>
     <td>UTF-8</td>
-    <td>Total number of parts of the current level. (e.g. if level is MEDIA, the total number of tracks of an audio CD)</td>
+    <td>Total number of parts of the current level. (e.g. if TargetType is ALBUM, the total number of tracks of an audio CD)</td>
   </tr>
   <tr>
     <td>PART_NUMBER</td>
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.