The chord module has been
superseeded by the idproperty
module. This module will not be developed further, and will
eventually be removed from the program. You should modify your lessons to
use the idproperty module. The chord module will be
removed from the solfege program in the next development series, in
Solfege version 3.11.0.
It is easy to do the convert. In Solfege 3.10 the lesson file heading would contain the following line:
module = chord
Replace that with this:
module = idproperty flavour = "chord"
The chord module let you identify different properties of chords, such as their name, inversion, top tone etc.
The properties are defined by the props variable in
the lesson file header, and there should be a variable
prop_labels that defines the label to use.
props and prop_labels must be lists of
equal length. You only have to define these two variables if you need
other properties than the default ones: name,
inversion and toptone.
Below is a minimal lesson file. It will create an exercise that will play a minor or major chord and the user answers with two buttons labeled "Minor" and "Major" and two buttons representing the inversion. Notice that unused properties, toptone in this example, are hidden.
header {
module = chord
title = "Minor and major chords"
lesson_id = "e263d40a-d8ff-4000-a7f2-c02ba087bf72"
qprops = "name", "inversion", "toptone"
qprop_labels = _("Chord type"), _("Inversion"), _("Toptone")
}
question {
name = "Major"
music = chord("c' e' g'")
inversion = 0
}
question {
name = "Minor"
music = chord("es' g' c''")
inversion = 1
}
The inversion property is special. If assigned integer
values, like in the example, the integer values will be replaced with strings. So 0 is replaced with "root position", 1 with "1. inversion" etc.