MML: Values

Time Values
Value conventions
Range and rate of change values

Values can be specified either in absolute or relative terms.

Time Values

Absolute values

Absolute values are specified in terms of some or other standard.

Minute: m
Second: s
Millisecond: ms
Beats per minute: BPM

Relative values

Relative values are specified in relation to events such as time events (bar, beat or tick).

Value conventions

Number values are indicated in this format

n.n

where n is a number from 0 to 9999. Decimal numbers are allowed where applicable.

Range and rate of change values

The MML values 0.0... 9.99 translate into 1000 possible values. Whole numbers 0...9 refer to coarse settings, while the decimal 0...99 refer to finer settings. In most cases a value from 0...9 would be sufficient.

There is no one-to-one correlation between MML and MIDI values. A look-up table may provide approximate correlations, or the user agent may do calculations.

A set consisting of two values can be used for most of the MIDI Continuous Controllers, one for the range, and on for the rate of change. To avoid unnecesary repetition, the range value is listed first, separated from the next value (the rate) with a colon.

Example

The format nn.nn is used. In this format 00.00 is obviously zero and 99.99 is the maximum depression of the foot pedal. For the foot attribute the time it takes for the depression to reach the goal value is also important. This time is indicated in seconds, and immediately follows the increased value, separated with a colon.

<channel chanid="4" foot="4.64:0.5">

 ...

 </channel>

This means that for channel 4 the foot pedal's value is increased to 4.64 and that it takes 0.5 seconds until it reaches that value from the previous value.

Top