Spiel, Satz und Sieg

Brahms ist erweiterbar

Der große Vorzug dieser Architektur liegt in der Erweiterbarkeit von Brahms. Es können Erweiterungen (Addons) geschrieben und kompiliert werden, ohne die gesamte Brahms-Applikation neu zu übersetzten – sogar ohne sie neu zu starten. Ein übersichtliches API bietet eine einfache Schnittstelle, über die ein Musikstück mit allen seinen Komponenten bearbeitet werden kann.

Die drei Funktionen Quantize, QuantizeLength und FixedLength (dürfen in keinem Sequencer fehlen) sind als solche Erweiterungen implementiert. Wie andere Operationen sind auch sie umkehrbar, es ist also eine undo-Methode enthalten. Die zurzeit vorhandenen Erweiterungen sind in Tabelle 2 zusammengestellt.

Die

Riemann-Erweiterung ist vorerst noch ein Prototyp und nicht vollständig implementiert. Bemerkenswert an diesem Modul ist, dass es zur Berechnung der Harmonien nicht nur das Tonmaterial zum jeweiligen Zeitpunkt (vertikal) heranzieht, sondern zusätzlich den musikalischen Kontext (horizontal) beachtet. Ein Klang, der aus Fis und C besteht, ist im G-Dur Kontext vermutlich eher als D-Dur mit kleiner Septime aufzufassen und seltener als vermindertes Fis.

Abbildung 17: Die Riemann-Erweiterung führt einen neuen Tonspur-Typ ein

Darüber hinaus zeigt die Riemann-Erweiterung, dass Brahms-Erweiterungen neue Tonspur-Typen (Harmony, durch ein Herz symbolisiert) und neue Ereignis-Typen (RiemannEvents) einführen können. Die Ereignisse werden im unteren Teil des Editors angezeigt. Das Auswahl-Menü, das sonst die Anschlagswerte als einzigen Eintrag enthält, bietet nun auch die Riemann-Werte an (Abbildungen 17 und 18).

Abbildung 18: Die Riemann-Ereignisse lassen sich im unteren Teil des Editors darstellen

Eine Erweiterung wird entweder als Option beim Aufruf von Brahms angegeben

brahms -a dump -a riemann -a stretch

oder zur Laufzeit geladen (Menüpunkt File/Load Addon...). Die zu ladenden Bibliotheken befinden sich nach der Installation im Verzeichnis $KDEDIR/lib und beginnen mit libBrahmsAddon. Ist eine Erweiterung erfolgreich geladen, findet sie sich in den Kontextmenüs des Musikstücks, der Tonspur, des Abschnitts oder im Auswahl-Menü der Editor-Werkzeugleiste wieder (Abbildung 19).

Abbildung 19: Der Zugriff auf die geladenen Erweiterung findet über Kontextmenüs statt

Selbst ist der Musiker

Für diejenigen, die selbst eine Erweiterung schreiben möchten, bietet sich die gut dokumentierte Dump-Erweiterung als Vorlage an. In den Quellen von Brahms befindet sich die Erweiterungen im Verzeichnis brahms/addons. Außerdem ist die API-Dokumentation sehr hilfreich. Sie wird mit Brahms installiert, ist aber auch auf der Brahms-Homepage zu finden.

Ein kleines Beispiel zeigt, wie wenig Arbeit eine solche Erweiterung macht. Neben der Deklaration einiger Formalitäten wie Kontext, Kategorie und Namensgebung besteht der wesentliche Teil der Revert-Erweiterung aus der song()-Methode (siehe Listing 1).

01 void Revert::song(Song @L: * song) {
02   Position endpos = (new SongIterator(song))->endPosition();
03   int sz = song->size();
04   for (int i=0; i<sz; i++) {
05     Track @L: * track = (Track @L: *) song->get(0); if (track==0) return;
06     Part @L: * part   = (Part @L: *) track->first(); if (part==0) return;
07     Track @L: * newTrack = song->createTrack(track->isA(),0);
08     newTrack->setName(strdup(track->name()->getValue()));
09     if (track->isA()==SCORETRACK) {
10       ((ScoreTrack@L: *) newTrack)->setProgram(track->program());
11       ((ScoreTrack@L: *) newTrack)->setChannel(track->channel());
12     }
13     Part @L: * newPart = new Part(newTrack);
14     newPart->setKey(part->key()); newPart->setClef(part->clef());
15     // ——————————————————–
16     for (Iterator i = Iterator(track); !i.done(); i++) {
17       Event @L: * event = (Event@L: *) (@L: *i)->copy();
18       newPart->setStart(event, endpos - i.part()->end(event));
19       newPart->add(event);
20     }
21     newTrack->add(newPart); song->add(newTrack);
22     song->remove(track); delete track;
23   }
24 }

Zunächst ermittelt das Modul die Endposition des Musikstücks. Die äußere Schleife führt durch alle Tonspuren (Zeile 4), die innere Schleife iteriert durch alle Ereignisse (Zeile 16). Die Position eines jeden Ereignisses wird von der Endposition abgezogen und dadurch in der Zeit gespiegelt. Schließlich werden nicht die Ereignisse selbst, sondern Kopien davon bearbeitet und in einer neuen Tonspur mit einem neuen Abschnitt abgelegt (Zeile 19). Sobald eine Spur bearbeitet ist, wird in Zeile 22 das Original entfernt.

tar xzvf brahms-1.02-kde2.tgz
cd Brahms
./configure
make
su
make install

./configure --prefix=/opt/kde2