~ubuntu-branches/ubuntu/saucy/solfege/saucy

<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>The chord module</title><link rel="stylesheet" href="../style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="index.html" title="GNU Solfege 3.14.5 Руководство пользователя"><link rel="up" href="extending-solfege.html" title="Глава 4. Extending GNU Solfege"><link rel="prev" href="lesson-files.html" title="Lesson files"><link rel="next" href="compareintervals-module.html" title="The compareintervals module"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">The <code class="literal">chord</code> module</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="lesson-files.html">Пред.</a> </td><th width="60%" align="center">Глава 4. Extending GNU Solfege</th><td width="20%" align="right"> <a accesskey="n" href="compareintervals-module.html">След.</a></td></tr></table><hr></div><div class="sect1" lang="ru"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="chord-module"></a>The <code class="literal">chord</code> module</h2></div></div></div><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Внимание</h3><p>The chord module has been

superseeded by the <a class="link" href="idproperty-module.html" title="The idproperty module">idproperty</a>

module. This module will not be developed further, and will

eventually be removed from the program. You should modify your lessons to

use the <code class="literal">idproperty</code> module. The chord module will be

removed from the solfege program in the next development series, in

Solfege version 3.11.0.</p><p>

It is easy to do the convert. In Solfege 3.10 the lesson file heading

would contain the following line:

</p><pre class="programlisting">

module = chord

</pre><p>Replace that with this:</p><pre class="programlisting">

module = idproperty

flavour = "chord"

</pre></div><p>

The chord module let you identify different properties of chords, such as

their name, inversion, top tone etc.

</p><p>The properties are defined by the <code class="literal">props</code> variable in

the lesson file header, and there should be a variable

<code class="literal">prop_labels</code> that defines the label to use.

<code class="literal">props</code> and <code class="literal">prop_labels</code> must be lists of

equal length. You only have to define these two variables if you need

other properties than the default ones: <code class="literal">name</code>,

<code class="literal">inversion</code> and <code class="literal">toptone</code>.</p><p>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.</p><pre class="programlisting">

header {

<a class="xref" href="lesson-files.html#lf-module">module</a> = chord

<a class="xref" href="lesson-files.html#lf-title">title</a> = "Minor and major chords"

<a class="xref" href="lesson-files.html#lf-lesson_id">lesson_id</a> = "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

}

</pre><p>The <code class="literal">inversion</code> property is special. If assigned integer

values, like in the example, the integer values will be replaced with strings. So <code class="literal">0</code> is replaced with "root position", <code class="literal">1</code> with "1. inversion" etc.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="lesson-files.html">Пред.</a> </td><td width="20%" align="center"><a accesskey="u" href="extending-solfege.html">Уровень выше</a></td><td width="40%" align="right"> <a accesskey="n" href="compareintervals-module.html">След.</a></td></tr><tr><td width="40%" align="left" valign="top">Lesson files </td><td width="20%" align="center"><a accesskey="h" href="index.html">Начало</a></td><td width="40%" align="right" valign="top"> The <code class="literal">compareintervals</code> module</td></tr></table></div></body></html>

Older »