Rules for Tools/timetomeasure()
long timetomeasure(struct Clip *clip,long time)
`struct Clip *clip'
Clip for conversion.
Time in clock ticks.
`timetomeasure()' translates from raw clock ticks (time) into a
measure number. Because different Tracks can have different time
signatures, the conversion is dependent on a specific time
signature, as defined by clip (each Track has a Clip.) If you'd
rather use the master Song Parameters time signature, set clip to
Using `timetomeasure()' and its partner, `measuretotime', to
perform time operations based on measures, rather than clocks. For
example, to move a Note Event to the start of the next measure:
struct NoteEvent *note;
measure = (*functions->timetomeasure)(0,note->time);
note->time = (*functions->measuretotime)(0,measure);