The dictation module

The `dictation` module
Antaŭen | Ĉapitro 4. Extending GNU Solfege | Sekven

## The `dictation` module

Example:

    header {
      module = dictation
      lesson_id = "a265df62-e007-4a1b-9057-cd05397e88a2"
      title = _("Norwegian children songs")
      version = "2.1.10"
    }

    question {
     name = "Bæ, bæ, lille lam"
     tempo = 130/4
     breakpoints = 2/1, 4/1, 8/1, 10/1, 12/1, 14/1
     music = rvoice("""
        \time 4/4
        c'2 g' | e4 e c2 | d4 d g, g | c1 |
        c2 g' | e4 e c2 | d4 d g, g | c1 |
        a'4 f f f | g2. e4 | f d d d | e2. c4 |
        a'2 f | g e4 e | f b, b b | c1 |
     """)
    }
    question {
     # this tempo definition overrides the global
     tempo = 160/4
     name = "Lisa gikk til skolen"
     breakpoints = 2/1, 4/1, 6/1
     music = rvoice("""
       \time 4/4
       c' d e f | g2 g2 | a4 a a a | g1 |
       f4 f f f | e2 e | d4 d d d | c1
     """)
    }

    question {
     name = "Det satt to katter på et bord..."
     tempo = 96/4
     music = rvoice("""
         \key g \major \time 2/4
         d'8 | [g g] [fis e] | [fis g] a4 | [d,16 d d d] [e8 fis] | g2 """)
    }

By default, the dictation exercise will show the first column of music, and then the user should write the rest. But if the first column is not good enough, for example if there are only rests on the first beat, these two variables can tell the program how much music to display:

`clue_end`

  The following example will display the music on all staffs in the first quarter note:

      clue_end=1/4

`clue_music`

  This is an alternative to `clue_end`. The music assigned to `clue_music` will be shown to the user when he should start the dictation. You should not use both `clue_end` and `clue_music` in the same question.

`breakpoints`

  Set breakpoints in the music, so you can hear the music in parts when doing the dictation.

Antaŭen | Supren | Sekven
The `compareintervals` module | Hejmen | The `elembuilder` module