Contents page

Rules for Tools/nextrhythmbeat()

SYNOPSIS
     struct NoteEvent *nextrhythmbeat(struct Clip *clip,
                                 long starttime,
                                 long *beattime)

ARGUMENTS
    `struct Clip  *clip'
          Clip with rhythm list.

    `long starttime'
          Time to start search.

    `long *beattime'
          Returns beat time.

DESCRIPTION
     `nextrhythmbeat()' searches the rhythm list in clip for the first
     beat after `starttime'.  If it finds a beat, it returns a pointer
     to the note in the rhythm's note list that describes the beat.
     Because rhythms usually loop, the note doesn't carry the actual
     time of the beat.  Instead, the beat time is returned in the
     variable beattime.

SEE
     See noteinrhythm().