Jalmus documentation | En / Lessons browse

To create a new lesson you should create an xml file in "lessons" directory of Jalmus. You should use the syntax defined after to specify all levels with their parameters.

By example :

<levels>

<notereading id = '0'>
<message>First we are working slowly on the three notes F G A </message>
<game>learning</game>
<learningduration>15</learningduration>
<clef>treble</clef>
<notes>notes</notes>
<nbnotes>3</nbnotes>
<speed>20</speed>
<startingnote>0</startingnote>
</notereading>

<notereading id = '1'>
<message>Now same notes F G A without help - G correspond to the key
 with a green point</message>
<game>normal</game>
<clef>treble</clef>
<notes>notes</notes>
<nbnotes>3</nbnotes>
<speed>40</speed>
<startingnote>0</startingnote>
</notereading>

</levels>

A. MIDI Options

Not still implemented

B. Note reading

Where n is the number of the level.

All the next markups should be included in the notereading block.

0. Message

Where text is one short sentence appears at the beginning of the

 game. User can pass it by using C3 key (key pink on the keyboard at
 screen).

1. Game type

Where game_type is "normal", "inline" or "learning".

The default game type is "normal".

2. Clef

Where clef_name is "treble", "bass" or "both" for double piano staff

The default clef is "treble".

3. Tonality

<tonality>n#</tonality> or <tonality>nb</tonality> or <tonality>random</tonality>

Where n is the number of alterations between 0 and 7 : 3# is equivalent at A Major or F# min.

4. Type of notes

<notes>notes_type</notes>

Where notes_type could be "notes", "accidentals", "intervals" or "chords"

The default type of notes is "notes".

5. Number of notes to study

Only for notes and accidentals games.

Where int is 3, 5, 7, 9 or 15.

The default number of notes to study is 3.

6. Starting note

Only for notes and accidentals games.

Where int is the number of keys to move according to base note. Positiv for right and negativ for left.

By example "5" for trebleclef give you a base note to E4

<startingnote> should be use after <clef> and <nbnotes> markups for checking the limits (the keyboard length is not yet used for this check).

Starting note default is G3 for treble clef, F2 for bass clef and C2-C4 for piano staff.

7. Interval type

Only for type <notes> intervals.

<intervals>interval_type</intervals> or <intervals>random</intervals>

Where interval_type should be "second", "third", "fourth", "fifth", "sixth", "seventh" or "octave".

The default value is "third"

8. Chord type

Only for type <notes> chords.

<chords>chord_type</chords>

Where chord_type should be root or inversion.

The default value is "root".

9 Learning game duration

Where int should be an integer between 10 and 100 corresponding to the number of notes, intervals or chords in learning game before pass to next level.

The default value is 20.

10. Speed

Where int is an integer between 0 (prestissimo) and 40 (largo).

The speed of the game depends of the computer speed.

The default value is 20 for moderato.

C Rhythm reading