Changeset 1055

Show
Ignore:
Timestamp:
2005-03-05 19:21:16 (4 years ago)
Author:
silvia
Message:

Fixed cmml serialisation and mapping into ogg.

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

  • standards/draft-pfeiffer-cmml-02.xml

    r1054 r1055  
    735735      clip in its "id" attribute. This name can be used in URIs that 
    736736      point either to the CMML file or the Annodex bitstream created 
    737       from it, and allow to point straight at the clip. This may 
     737      from it, and allows to point straight at the clip. This may 
    738738      either be done as a URI fragment or URI query specification. 
    739739      </t> 
    …… 
    819819        html page or another Annodex bitstream clip or an image 
    820820        etc. An "a" element without a "href" attribute is illegal and 
    821         should be flagged or ignored. 
     821        MUST be flagged or ignored. 
    822822        </t> 
    823823 
    824824        <t>The text contained in an "a" element (i.e. the anchor text) 
    825         gives a short textual description of the link specified 
     825        provides a short textual description of the link specified 
    826826        through the "href" attribute. It explains why the connection 
    827827        between the current clip and the destination URI is made. It 
    …… 
    843843        clip. This image may be used to visually summarise the content 
    844844        of the clip when a link to it is displayed, e.g. by a search 
    845         engine or in a table of contents.  The "img" element 
     845        engine or in a table of clips.  The "img" element 
    846846        definition is very closely related to the xhtml "img" element 
    847847        definition with a reduced number of attributes as they make 
    …… 
    898898 
    899899        <t>For extracting a short text from the "desc" element as 
    900         needs to be displayed in a table of contents or as caption, 
     900        needs to be displayed in a table of clips or as caption, 
    901901        the first few characters of the description will be taken. It 
    902902        is therefore recommended to place a short meaningful summary 
    …… 
    906906 
    907907        <t>The internationalisation attributes specify the language of 
    908         the text in the description snf the "id" attribute a unique identifier 
    909         for the element. 
     908        the text in the description and the "id" attribute a unique 
     909        identifier for the element. 
    910910        </t> 
    911911 
    …… 
    920920    <section title="Serialising CMML"> 
    921921 
    922       <t>CMML is an annotation language that is meant to markup any 
     922      <t>CMML is an annotation language that is meant to mark up any 
    923923      time-continuous data and be interleaved in a time-synchronous 
    924924      fashion with other time-continuous bitstreams. Therefore, CMML 
    …… 
    930930      set up the CMML decoding environment, and contain header type 
    931931      information. The content of a CMML bitstream then consists of 
    932       "clip" tags. The "stream" tag is not represented in the CMML 
    933       bitstream as it controls the authoring of the bitstream that is 
    934       created by interleaving the CMML with the media streams listed 
    935       in the "stream" tag. Its information is meant to be stored in the 
    936       encapsulation format. 
     932      "clip" tags. The "stream" tag is not copied into the CMML 
     933      bitstream as it controls the authoring of the Annodex bitstream. 
     934      Its information can be used in the encapsulation format. 
    937935      </t> 
    938936 
    …… 
    10101008        <t>The CMML secondary headers are a sequence of 
    10111009        two packets that contain the CMML and XML "setup" information: 
    1012           <list typs="symbols"> 
     1010          <list type="symbols"> 
    10131011            <t>one packet with the CMML xml preamble and "cmml" tag.</t> 
    10141012            <t>one packet with the CMML "head" tag.</t> 
    …… 
    11631161        </t> 
    11641162 
    1165         <t>The additional fields in an CMML ident header packet for Ogg 
     1163        <t>The additional fields in a CMML ident header packet for Ogg 
    11661164        have the following meaning: 
    11671165        </t> 
    …… 
    11871185        </list> 
    11881186 
    1189         <t>A default granule rate for CMML is: 1/1000. The default 
     1187        <t>The default granule rate for CMML is: 1/1000. The default 
    11901188        granule shift used is 32, which halfs the granule position to 
    1191         allow for the backwards pointer to be public. 
     1189        allow for the backwards pointer. 
    11921190        </t> 
    11931191 
    …… 
    12101208        mapped always to 0 and utc time mappings cannot be represented. 
    12111209        It also loses all the message header fields which contain 
    1212         machine-readable meta information on the physical bitstream. 
     1210        machine-readable meta information about the physical bitstream. 
    12131211        </t> 
    12141212 
    …… 
    12461244          </t> 
    12471245 
    1248           <t>"Timebase numerator &amp; denominator": if the "timebase" 
     1246          <t>"Basetime numerator &amp; denominator": if the "timebase" 
    12491247          attribute is given in a CMML instance document, it MUST be 
    12501248          represented in the skeleton ident header in the fields 
    1251           "Timebase numerator" and "Timebase denominator". It is converted 
     1249          "Basetime numerator" and "Basetime denominator". It is converted 
    12521250          from a possible NPT or SMPTE representation to a rational number 
    1253           to be stored in these fishead fields. 
     1251          to be stored in these fishead fields. Note the name change from 
     1252          timebase to basetime with Annodex version 3.0, which further 
     1253          versions of CMML will also mirror. 
    12541254          </t> 
    12551255 
    1256           <t>"Presentationtime numerator &amp; denominator": if the "timebase" 
    1257           attribute is given in a CMML instance document, it also 
    1258           determines the presentation time of the interleaved bitstream and 
    1259           the "Timebase numerator" and "Timebase denominator" MUST be 
    1260           copied to the "Presentationtime numerator" and "Presentationtime 
    1261           denominator" fields of the skeleton ident header. 
     1256          <t>"Presentationtime numerator &amp; denominator": to be filled 
     1257          by the muxer appropriately, e.g. reusing the timebase values. 
    12621258          </t> 
    12631259 
    1264           <t>"UTC": if the "utc" attribute is given in a CMML instance document, 
    1265           it MUST be represented in the skeleton ident header in the "UTC" field. 
     1260          <t>"UTC": if the "utc" attribute is given in a CMML instance 
     1261          document, it MUST be represented in the skeleton ident header 
     1262          in the "UTC" field. 
    12661263          </t> 
    12671264 
    …… 
    12821279          fields "Granulerate numerator" and "Granulerate denominator". 
    12831280          The encoder MUST however ascertain that the values are sensible, 
    1284           and if it knows the accurate granule rate for a logical bitstrea 
     1281          and if it knows the accurate granule rate for a logical bitstream 
    12851282          overrun the user input with the one that was used during creation 
    12861283          of the interleaved bitstream. 
    …… 
    12881285 
    12891286          <t>"Content-type" message header field: this attribute MUST be 
    1290           represented in the respective skeleton fisbone packet as a message header 
    1291           field with name "Content-type", as it signifies the MIME type 
     1287          represented in the respective skeleton fisbone packet as a message 
     1288          header field with name "Content-type", as it signifies the MIME type 
    12921289          of the media bitstream, providing for a decoding hint. If the user 
    12931290          does not specify the "contenttype" attribute, the encoder 
    …… 
    13041301          <t>User specified message header fields: if "name" and "value" 
    13051302          attributes are specified in the "param" tags of the "import" tag, 
    1306           these MAY be represented in the skeleton fisbone packet of the respective 
    1307           media bitstream as a message header field with the given name-value pair. 
    1308           These fields are highly dependent on the type of media bitstream 
    1309           handled and it therefore depends on the encoding tool to make 
    1310           a selection of the parameters acquired. For example, an 
    1311           audio bitstream that contains speech in a specific language may 
    1312           be identified during CMML authoring through a param element with 
    1313           "Content-Language" name, and acquired into the media bitstream 
    1314           message header field of the same name. 
     1303          these SHOULD be represented in the skeleton fisbone packet of the 
     1304          respective media bitstream as a message header field with the 
     1305          given name-value pair. These fields are highly dependent on the 
     1306          type of media bitstream handled and it therefore depends on the 
     1307          encoding tool to make a selection of the parameters acquired. For 
     1308          example, an audio bitstream that contains speech in a specific 
     1309          language may be identified during CMML authoring through a param 
     1310          element with "Content-Language" name, and acquired into the 
     1311          media bitstream message header field of the same name. 
    13151312          </t> 
    13161313 
    …… 
    13311328          </t> 
    13321329 
    1333           <t>"Granulerate numerator &amp; denominator": if the "granulerate" 
    1334           attribute is present in the "cmml" tag, it MUST be represented  
    1335           in the fisbone header in the fields "Granulerate numerator" and 
    1336           "Granulerate denominator". The encoder MUST however ascertain 
    1337           that the values are sensible. The value defaults to "1/1000" if 
    1338           it is not specified by the user. 
     1330          <t>"Granulerate numerator &amp; denominator": is fixed to the 
     1331          default value of "1/1000". 
    13391332          </t> 
    13401333 
    13411334          <t>"Content-type" message header field: the content type for 
    13421335          the fisbone packet that describes the CMML logical bitstream is 
    1343           fixed at "text/x-cmml" (or "text/cmml" after IANA registration 
    1344           of the MIME type. 
     1336          fixed at "text/x-cmml". 
    13451337          </t> 
    13461338 
    13471339          <t>"charset": if the xml processing directive contains an "encoding" 
    1348           attribute, this MUST be represented in the CMML fisbone packet as an 
    1349           addendum to the message header field "Content-type" as a charset. For 
    1350           example: "Content-type: text/x-cmml; charset=UTF-8". 
     1340          attribute, this MUST be represented in the CMML fisbone packet as 
     1341          an addendum to the message header field "Content-type" as a 
     1342          charset. For example: "Content-type: text/x-cmml; charset=UTF-8". 
    13511343          </t> 
    13521344 
    …… 
    13611353          the "lang" and "dir" attributes are given in a "cmml" tag, they 
    13621354          MUST be represented in the fishbone packet of the CMML bitstream 
    1363           as message header fields with name "Content-Language" and "Content-Dir". 
     1355          as message header fields with name "Content-Language" and 
     1356          "Content-Dir". 
    13641357          </t> 
    13651358 
    …… 
    13701363          <t>Here is a list of the attribute values of the 
    13711364          "stream" tag and how they are being used: 
    1372           <list> 
     1365          <list type="symbols"> 
    13731366            <t>id: not used, as this attribute is only used to enable  
    13741367            addressing of the stream tag the XML way (e.g. XPath). 
    …… 
    13891382          <t>Here is a list of the attribute values of the 
    13901383          "import" tag and how they are being used: 
    1391           <list> 
     1384          <list type="symbols"> 
    13921385            <t>id: this attribute may be represented as a message header field 
    13931386            in the respective skeleton fisbone packet. 
    …… 
    14241417          <t>Here is a list of the attribute values of the 
    14251418          "param" tag list and how they are being used: 
    1426           <list> 
     1419          <list type="symbols"> 
    14271420            <t>id: not used, as this attribute is only used to enable  
    14281421            addressing of the param tag the XML way (e.g. XPath). 

  • standards/draft-pfeiffer-cmml-current.xml

    r1053 r1055  
    977977      in the "id" attribute. This name can be used in URIs that point 
    978978      either to the CMML file or the Annodex bitstream created from it, 
    979       and allow to point straight at the clip. This may either be done 
     979      and allows to point straight at the clip. This may either be done 
    980980      as a URI fragment or URI query specification. The "class" attribute 
    981981      provides a space-separated list of style sheet classes, and the 
    …… 
    10691069        html page or another Annodex bitstream clip or an image 
    10701070        etc. An "a" element without a "href" attribute is illegal and 
    1071         should be flagged or ignored. 
     1071        MUST be flagged or ignored. 
    10721072        </t> 
    10731073 
    10741074        <t>The text contained in an "a" element (i.e. the anchor text) 
    1075         gives a short textual description of the link specified 
     1075        provides a short textual description of the link specified 
    10761076        through the "href" attribute. It explains why the connection 
    10771077        between the current clip and the destination URI is made. It 
    …… 
    10931093        clip. This image may be used to visually summarise the content 
    10941094        of the clip when a link to it is displayed, e.g. by a search 
    1095         engine or in a table of contents.  The "img" element 
     1095        engine or in a table of clips.  The "img" element 
    10961096        definition is very closely related to the xhtml "img" element 
    10971097        definition with a reduced number of attributes as they make 
    …… 
    11511151        for the element, the "class" attribute a style-sheet mapping, and 
    11521152        the "title" attribute a brief description to be displayed in e.g. 
    1153         a table of contents or as caption. 
     1153        a table of clips or as caption. 
    11541154        </t> 
    11551155 
    …… 
    11641164    <section title="Serialising CMML"> 
    11651165 
    1166       <t>CMML is an annotation language that is meant to markup any 
     1166      <t>CMML is an annotation language that is meant to mark up any 
    11671167      time-continuous data and be interleaved in a time-synchronous 
    11681168      fashion with other time-continuous bitstreams. Therefore, CMML 
    …… 
    11741174      set up the CMML decoding environment, and contain header type 
    11751175      information. The content of a CMML bitstream then consists of 
    1176       "clip" tags. The "stream" tag is not represented in the CMML 
    1177       bitstream as it controls the authoring of the bitstream that is 
    1178       created by interleaving the CMML with the media streams listed 
    1179       in the "stream" tag. Its information is meant to be stored in the 
    1180       encapsulation format. 
     1176      "clip" tags. The "stream" tag is not copied into the CMML 
     1177      bitstream as it controls the authoring of the Annodex bitstream. 
     1178      Its information can be used in the encapsulation format. 
    11811179      </t> 
    11821180 
    …… 
    12161214 
    12171215  
    1218         <t>The fields in an CMML ident header packet have the following 
     1216        <t>The fields in a CMML ident header packet have the following 
    12191217        meaning: 
    12201218        </t> 
    …… 
    12541252        <t>The CMML secondary headers are a sequence of 
    12551253        two packets that contain the CMML and XML "setup" information: 
    1256           <list typs="symbols"> 
     1254          <list type="symbols"> 
    12571255            <t>one packet with the CMML xml preamble and "cmml" tag.</t> 
    12581256            <t>one packet with the CMML "head" tag.</t> 
    …… 
    14311429        </list> 
    14321430 
    1433         <t>A default granule rate for CMML is: 1/1000. The default 
     1431        <t>The default granule rate for CMML is: 1/1000. The default 
    14341432        granule shift used is 32, which halfs the granule position to 
    1435         allow for the backwards pointer to be public. 
     1433        allow for the backwards pointer. 
    14361434        </t> 
    14371435 
    …… 
    14541452        mapped always to 0 and utc time mappings cannot be represented. 
    14551453        It also loses all the message header fields which contain 
    1456         machine-readable meta information on the physical bitstream. 
     1454        machine-readable meta information about the physical bitstream. 
    14571455        </t> 
    14581456 
    …… 
    15061504          </t> 
    15071505 
    1508           <t>"UTC": if the "utc" attribute is given in a CMML instance document, 
    1509           it MUST be represented in the skeleton ident header in the "UTC" field. 
     1506          <t>"UTC": if the "utc" attribute is given in a CMML instance 
     1507          document, it MUST be represented in the skeleton ident header 
     1508          in the "UTC" field. 
    15101509          </t> 
    15111510 
    …… 
    15261525          fields "Granulerate numerator" and "Granulerate denominator". 
    15271526          The encoder MUST however ascertain that the values are sensible, 
    1528           and if it knows the accurate granule rate for a logical bitstrea 
     1527          and if it knows the accurate granule rate for a logical bitstream 
    15291528          overrun the user input with the one that was used during creation 
    15301529          of the interleaved bitstream. 
    …… 
    15321531 
    15331532          <t>"Content-type" message header field: this attribute MUST be 
    1534           represented in the respective skeleton fisbone packet as a message header 
    1535           field with name "Content-type", as it signifies the MIME type 
     1533          represented in the respective skeleton fisbone packet as a message 
     1534          header field with name "Content-type", as it signifies the MIME type 
    15361535          of the media bitstream, providing for a decoding hint. If the user 
    15371536          does not specify the "contenttype" attribute, the encoder 
    …… 
    15481547          <t>User specified message header fields: if "name" and "value" 
    15491548          attributes are specified in the "param" tags of the "import" tag, 
    1550           these MAY be represented in the skeleton fisbone packet of the respective 
    1551           media bitstream as a message header field with the given name-value pair. 
    1552           These fields are highly dependent on the type of media bitstream 
    1553           handled and it therefore depends on the encoding tool to make 
    1554           a selection of the parameters acquired. For example, an 
    1555           audio bitstream that contains speech in a specific language may 
    1556           be identified during CMML authoring through a param element with 
    1557           "Content-Language" name, and acquired into the media bitstream 
    1558           message header field of the same name. 
     1549          these SHOULD be represented in the skeleton fisbone packet of the 
     1550          respective media bitstream as a message header field with the 
     1551          given name-value pair. These fields are highly dependent on the 
     1552          type of media bitstream handled and it therefore depends on the 
     1553          encoding tool to make a selection of the parameters acquired. For 
     1554          example, an audio bitstream that contains speech in a specific 
     1555          language may be identified during CMML authoring through a param 
     1556          element with "Content-Language" name, and acquired into the 
     1557          media bitstream message header field of the same name. 
    15591558          </t> 
    15601559 
    …… 
    15901589 
    15911590          <t>"charset": if the xml processing directive contains an "encoding" 
    1592           attribute, this MUST be represented in the CMML fisbone packet as an 
    1593           addendum to the message header field "Content-type" as a charset. For 
    1594           example: "Content-type: text/x-cmml; charset=UTF-8". 
     1591          attribute, this MUST be represented in the CMML fisbone packet as 
     1592          an addendum to the message header field "Content-type" as a 
     1593          charset. For example: "Content-type: text/x-cmml; charset=UTF-8". 
    15951594          </t> 
    15961595 
    …… 
    16051604          the "lang" and "dir" attributes are given in a "cmml" tag, they 
    16061605          MUST be represented in the fishbone packet of the CMML bitstream 
    1607           as message header fields with name "Content-Language" and "Content-Dir". 
     1606          as message header fields with name "Content-Language" and 
     1607          "Content-Dir". 
    16081608          </t> 
    16091609 
    …… 
    16141614          <t>Here is a list of the attribute values of the 
    16151615          "stream" tag and how they are being used: 
    1616           <list> 
     1616          <list type="symbols"> 
    16171617            <t>id: not used, as this attribute is only used to enable  
    16181618            addressing of the stream tag the XML way (e.g. XPath). 
    …… 
    16331633          <t>Here is a list of the attribute values of the 
    16341634          "import" tag and how they are being used: 
    1635           <list> 
     1635          <list type="symbols"> 
    16361636            <t>id: this attribute may be represented as a message header field 
    16371637            in the respective skeleton fisbone packet. 
    …… 
    16681668          <t>Here is a list of the attribute values of the 
    16691669          "param" tag list and how they are being used: 
    1670           <list> 
     1670          <list type="symbols"> 
    16711671            <t>id: not used, as this attribute is only used to enable  
    16721672            addressing of the param tag the XML way (e.g. XPath).