Info Catalog vcdimager: VCD XML Description vcdimager: VCD XML Description vcdimager: Root

vcdimager: Common Rules

 
 3.1 XML Simplified Rules
 ========================
 
    * All attribute values must be quoted.
 
    * White space within content, including line breaks, is significant.
 
    * All start tags ('<pbc>') must have corresponding end tags
      ('</pbc>').
 
    * Tags without content and those which are empty elements must use
      the '/>'-notation, e.g.: '<next-volume-use-lid2 />'.
 
    * Elements must not overlap; they may be nested, however.
 
    * Element names are case sensitive: '<videocd>' and '<VideoCD>' are
      two different entities.
 
 3.2 DTD Notation Reference
 ==========================
 
 Each section of the description of the Video CD XML format begins with a
 fragment from the Video CD DTD. The following table gives a simplified
 (and incomplete) reference for the notational syntax.
 
 '#PCDATA'
      parsed character data, i.e.  only text without sub-elements allowed
 
 'EMPTY'
      empty, i.e.  no sub-element allowed
 
 '()'
      grouping
 
 'A?'
      A or nothing (A is optional, but at most one A)
 
 'A+'
      one or more A's (at least one)
 
 'A*'
      zero or more A's (A optional, but could be several A's)
 
 '(A | B | C)'
      either A or B or C (but only one)
 
 '(A, B, C)'
      first A, followed by B, then C (all, and in this order)
 
 '(A & B)'
      both A and B, in any order
 
 3.3 Video CD XML Conventions
 ============================
 
 Time Values
 -----------
 
 All time related values--'<wait>', '<autowait>', '<playtime>',
 '<start-time-offset>', '<entry>' and '<auto-pause>'--are given in
 seconds.
 
    For the '<wait>' and '<autowait>' time entries the values given are
 rounded to values of the following set:
 
 '-1'
      meaning an _infinite_ wait time.  Negative values get rounded to
      '-1'.
 
 '0'
      meaning no wait time.
 
 '1'
      ranging from '1' to '60' in steps of 1, representing the time to
      wait in whole seconds.
 
 '60'
      ranging from '60' to '2000' in steps of 10, representing the time
      to wait in whole seconds.
 
 '2000'
      maximum wait time of 2000 seconds (33 minutes 20 seconds).  Values
      larger will be truncated to this maximum wait time.
 
    For '<loop>' and '<playtime>' the value '0' means _repeat forever_
 and _play until end_ accordingly.
 
 Item IDs
 --------
 
 Items and their associated IDs fall into two categories, _play items_
 and _PSD items_.  Every reference to an ID has to be of the right class,
 otherwise the reference can't be resolved, due to a failing look up.  A
 _play item_ can be any of the following:
 
    * play nothing item, (omitted 'ref' attribute, e.g.: '<play-item
      />').
    * sequence item, '<sequence-item>'.
    * entry point into sequence item, '<entry>'.
    * segment item segment play item, '<segment-item>'.
 
 Whereas a _PSD item_ is required to be one of:
 
    * disabled, (omitted 'ref' attribute, e.g.: '<select />').
    * selection list, '<selection>'.
    * play list, '<playlist>'.
    * end list, '<endlist>'.
 

Info Catalog vcdimager: VCD XML Description vcdimager: VCD XML Description vcdimager: Root