Documentation
Alphabetic list of elements (v1.0)

Duration and tuplet_ratio

<!ELEMENT duration (tuplet_ratio?)> <!ATTLIST duration    num CDATA #REQUIRED    den CDATA #REQUIRED> <!ELEMENT tuplet_ratio (tuplet_ratio*)> <!ATTLIST tuplet_ratio    enter_num CDATA #REQUIRED    enter_den CDATA #REQUIRED    enter_dots CDATA #IMPLIED    in_num CDATA #REQUIRED    in_den CDATA #REQUIRED    in_dots CDATA #IMPLIED>

Element duration defines rhythmical values, by using a fraction notation. The value encoded is the one appearing in the score, without considering additional information such as augmentation dots or ties.

Attributes

• num, a mandatory attribute that defines the numerator of the fraction.
• den, a mandatory attribute that defines the denominator of the fraction.

Element tuplet_ratio defines rhythmic values of notes within tuplets. However, the graphical rhythmic value is encoded in the previous duration element (e.g., for a triplet of eigths, each eigths has <duration num="1" den="8" />). On the other hand, the meaning of this sub-element corresponds to the number of tuplet subdivisions in a given number of real subdivisions, according to the sentence "enter x values in y values" (e.g., for a triplet of eighths that takes the place of two eighths, each eighth has <tuplet_ratio enter_num="3" enter_den="8" in_num="2" in_den="8" />).

Attributes

• enter_num, a mandatory attribute that defines the numerator of the fraction representing the number of tuplet values.
• enter_den, a mandatory attribute that defines the denominator of the fraction representing the number of tuplet values.
• enter_dots, an optional attribute to support dotted values in tuplet values.
• in_num, a mandatory attribute that defines the numerator of the fraction representing the number of actual values in the current time signature.
• in_den, a mandatory attribute that defines the denominator of the fraction representing the number of actual values in the current time signature.
• in_dots, an optional attribute to support dotted values in actual values.

Examples

<chord event_ref="event_01">    <duration num="1" den="4">       <tuplet_ratio enter_num="3" enter_den="4" in_num="2" in_den="4" />    </duration>    <notehead>       <pitch step="C" octave="6" />    </notehead> </chord> <chord event_ref="event_02">    <duration num="1" den="8">       <tuplet_ratio enter_num="3" enter_den="4" in_num="2" in_den="4">          <tuplet_ratio enter_num="5" enter_den="8" in_num="1" in_den="4" />       </tuplet_ratio>    </duration>    <notehead>       <pitch step="D" octave="6" />    </notehead> </chord> ...