oggdsf/docs/CMML_4_Dummies.txt

   1 ELEMENT HIERARCHY\r
   2 =================\r
   3 \r
   4 cmml element\r
   5         FIRST           OPTIONALLY ONE          stream element\r
   6         SECOND          EXACTLY ONE             head element\r
   7         THIRD           ZERO OR MORE            clip elements\r
   8 \r
   9 stream element\r
  10                         ZERO OR MORE            import elements\r
  11 \r
  12 \r
  13 import element\r
  14                         ZERO OR MORE            param elements\r
  15 \r
  16 param element\r
  17         EMPTY\r
  18 \r
  19 head element\r
  20         ANY ORDER       EXACTLY ONE             title element\r
  21         ANY ORDER       OPTIONALLY ONE          base element\r
  22         ANY ORDER       ZERO OR MORE            meta elements\r
  23 \r
  24 title element\r
  25         TEXT STRING\r
  26 \r
  27 base element\r
  28         EMPTY\r
  29 \r
  30 meta element\r
  31         EMPTY\r
  32 \r
  33 clip element\r
  34         ANY ORDER       OPTIONALLY ONE          a element\r
  35         ANY ORDER       OPTIONALLY ONE          img element\r
  36         ANY ORDER       OPTIONALLY ONE          desc element\r
  37         ANY ORDER       ZERO OR MORE            meta elements\r
  38 \r
  39 a element\r
  40         TEXT STRING (URI)\r
  41 \r
  42 img element\r
  43         EMPTY\r
  44 \r
  45 \r
  46 desc element\r
  47         TEXT STRING\r
  48 \r
  49 \r
  50 ----------------------------------------------------------------\r
  51 \r
  52 ATTRIBUTES\r
  53 ==========\r
  54 cmml element\r
  55                                 lang            A language code\r
  56                                 dir             A language direction.\r
  57         IMPLIED                 id              An identifier for the element\r
  58         REQUIRED                xmlns           "http://www.annodex.net/cmml"\r
  59 \r
  60 stream element\r
  61         IMPLIED                 id              An identifier for the element\r
  62         DEFAULT="0"             timebase        The time at which the stream starts relative to cmml\r
  63         OPTIONAL                utc             A 20 byte UTC string    \r
  64 \r
  65 import element\r
  66         IMPLIED                 id              An identifier for the element\r
  67         IMPLIED                 granulerate     An a/b string, can be determined from media.\r
  68         IMPLIED                 contenttype     A mime type. Can be determined from media.\r
  69         REQUIRED                src             A URI for the source of the media.\r
  70         DEFAULT="0"             start           The relative start time.\r
  71         IMPLIED                 end             Relative end time, can be inferred from media.\r
  72         OPTIONAL                title           Free text for rough notes on stream.\r
  73 \r
  74 param element\r
  75         IMPLIED                 id              An identifier for the element\r
  76         REQUIRED                name            Key for a mapped name/value pair.\r
  77         REQUIRED                value           Value for a mapped name/value pair.\r
  78 \r
  79 head element\r
  80         IMPLIED                 id              An identifier for the element\r
  81                                 lang            A language code\r
  82                                 dir             A language direction.\r
  83         OPTIONAL                profile         Space seperated URI for meta tag schemes.\r
  84         \r
  85 \r
  86 title element\r
  87         IMPLIED                 id              An identifier for the element\r
  88                                 lang            A language code\r
  89                                 dir             A language direction.\r
  90 \r
  91 base element\r
  92         IMPLIED                 id              An identifier for the element\r
  93         REQUIRED                href            Base URI for stream. If base tag omitted, inferred.\r
  94         \r
  95 meta element\r
  96         IMPLIED                 id              An identifier for the element\r
  97                                 lang            A language code\r
  98                                 dir             A language direction.\r
  99         REQUIRED                name            Key for key/value pair\r
 100         REQUIRED                content         Value for key/value pair\r
 101         IMPLIED                 scheme          Scheme for meta tag. Can be inferred from profile.\r
 102 \r
 103 \r
 104 clip element\r
 105         IMPLIED                 id              An identifier for the element\r
 106                                 lang            A language code\r
 107                                 dir             A language direction.\r
 108         DEFAULT="default"       track           The track of data it belongs to\r
 109         REQUIRED                start           The time to start this clip\r
 110         OPTIONAL                end             The time to end this clip\r
 111 \r
 112 a element\r
 113         IMPLIED                 id              An identifier for the element\r
 114                                 lang            A language code\r
 115                                 dir             A language direction.\r
 116         OPTIONAL                class           Style sheets\r
 117         REQUIRED                href            The link for this clip.\r
 118 \r
 119 \r
 120 img element\r
 121         IMPLIED                 id              An identifier for the element\r
 122                                 lang            A language code\r
 123                                 dir             A language direction.\r
 124         REQUIRED                src             URI of image.\r
 125         OPTIONAL                alt             Alternate image text.\r
 126 \r
 127 \r
 128 desc element\r
 129         IMPLIED                 id              An identifier for the element\r
 130                                 lang            A language code\r
 131                                 dir             A language direction.\r