======================
Ukufon 0.61 - Hilfe
======================

Das Programm Ukufon spielt auf einer virtuellen Ukulele Lieder auf Basis
von Textdateien mit Akkorden vor. Dabei können Tempo und Schlagmuster
vorgegeben werden. Dazu braucht man nur eine Textdatei eines Liedes:

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Alle meine Entchen

Alle meine Entchen,
schwimmen auf dem See,
schwimmen auf dem See,
Köpfchen in das Wasser,
Schwänzchen in die Höh.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Dort wird hinter dem Titel (getrennt durch #) auf der ersten Zeile
das Tempo (Grundschläge pro Minute) und das sich immer wiederholende
Schlagmuster als Zeichenfolge angegeben (siehe Liste weiter unten).
Dann die Akkorde in eckigen Klammern einfügen. Vor dem * steht der
Akkord, hinter dem * die Länge bzw. Anzahl der Grundschläge. Bei
einer Länge von 1 kann man die Längenabgabe auch weglassen: [C].

Es werden nur Akkorde gespielt, die auch in der ukufon.ini definiert
sind. Es ist darauf zu achten, dass der Buchstabe immer groß und die
Anhängsel wie "m", "aug" oder "maj7" immer klein geschrieben werden.

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Alle meine Entchen # 160 # D-DU-UDU

[C*8] Alle meine Entchen,
[F*4] schwimmen auf dem [C*4] See,
[F*4] schwimmen auf dem [C*4] See,
[G*4] Köpfchen in das [C*4] Wasser,
[G*4] Schwänzchen in die [C*5] Höh.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Möchte man eine Pause, so schreibt man statt eines Akkordes ein P in die eckigen
Klammern. Der Ausdruck [P*8] würde eine Pause von 8 Grundschlägen bedeuten.

Standardmäßig werden im Schlagmuster 2 Zeichen pro Grundschlag abgearbeitet.
Diese Anzahl kann man ändern, in dem man nach dem Schlagmuster optional ein #
einfügt und dahinter die Anzahl der Zeichen pro Grundschlag angibt. Damit
lassen sich rhythmisch komplizierte Schlagmuster produzieren.

Es ist auch möglich, das Schlagmuster mitten im Lied zu ändern. Dazu kann in
den eckigen Klammern eine optionale dritte Angabe gemacht werden. Der Ausdruck
[C*8*D-DU] würde zum Beispiel das neue Schlagmuster D-DU aktivieren. Dieses neue
Schlagmuster bleibt so lange erhalten, bis wiederum ein neues gesetzt oder mit der
Welle ~ das Standardmuster aus dem Titel wieder geladen wird, z.B. [G7*4*~].
Hier eine Liste der Zeichen, die im Schlagmuster vorkommen dürfen:

D = runter laut
d = runter leise
U = rauf laut
u = rauf leise
x = dämpfen
- = ausklingen lassen

Weitere Möglichkeiten:

- Wenn man auf eine Saite klickt, hört man der Ton der Grundstimmung
- Weitere Ukulelenstimmungen können in der ukufon.ini eingetragen werden
- Weitere Akkorde können in der ukufon.ini eingetragen werden
- Schriftart und Farben können in der ukufon.ini geändert werden

Wer möchte, kann sogar eigene Tonsamples hinzufügen. Dazu einfach unter der
Gruppe [SAMPLE] eine neue Zeile einfügen. Nach dem Namen und dem = folgen
nacheinander durch Komma getrennt folgende Werte:
1. Dateiname eines Samples (wav, mp2, mp3, ogg, raw, aif)
2. Tuning (hoch- oder runterstimmen in Halbtonschritten)
3. Lautstärke für lauten Anschlag D oder U (0.0 - 1.0)
4. Lautstärke für leisen Anschlag d oder u (0.0 - 1.0)
Spielt die angegebene Datei einen 440 Hz Ton und wurde sie mit 44100 Hz
aufgenommen, dann kann der Parameter Tuning = 0 gesetzt werden.

======================

Programmiert mit PureBasic
http://www.purebasic.com/

Verwendet wird das FMOD Sound System
http://www.fmod.org/

Vielen Dank an:
> OleLele aus dem Ukulelenclub für die hilfreichen Tipps
> wwelti aus dem Ukulelenclub für sein Tonsample
> bobobo aus dem PureBasic-Forum für die vielen Ideen

Für Hinweise, Fehler und Kritik: Lebostein@gmx.de

https://www.lebostein.de/ukufon/