Rules for Tools/lengthtostring()
lengthtostring()
SYNOPSIS
void lengthtostring(struct Clip *clip, long time,
long length, char *string)
ARGUMENTS
`struct Clip *clip'
Clip for conversion.
`long time'
Time, in clock ticks.
`long length'
Length, in clock ticks.
`char *string'
String to write in.
DESCRIPTION
`lengthtostring()' converts a time duration in clock ticks into
ascii text in the measure.beat.clocks format. This is slightly
more complex than `timetostring()', which converts an absolute
point in time, because the time signature may change at different
points in the song, so we need to know the time at which the
conversion occurs as well as the duration to convert. Also, to
describe note length, `lengthtostring()' starts counting from
measure and beat 0, rather than measure 1, beat 1.
`lengthtostring()' converts an example 205 clock ticks into the
string, "0.01.13."
`clip' determines the time signature used for the conversion.
SEE
See timetostring(), stringtolength(), stringtotime().