timings

fun timings(passage: Passage, tokenizer: WordTokenizer): List<WordTiming>(source)

Associates the supplied times with the words of a passage.

The alignment carries the words it was built from. If the passage changes after timing, this method refuses it instead of shifting every later highlight. Words are compared by canonical equivalence, so a letter written with a combining mark matches its precomposed spelling, and each timing carries the passage's spelling.

Throws

when the passage's words are not the aligned words.