======================
Ukufon 0.42 - Hilfe
======================

Das Programm Ukufon spielt auf einer virtuellen Ukulele Lieder auf Basis
von Textdateien mit Akkorden vor. Dabei knnen 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,
Kpfchen in das Wasser,
Schwnzchen in die Hh.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Dort wird hinter dem Titel (getrennt durch #) auf der ersten Zeile
das Tempo (Grundschlge pro Minute) und das sich immer wiederholende
Schlagmuster als Zeichenfolge angegeben (siehe Liste weiter unten).
Dann die Akkorde in eckigen Klammern einfgen. Vor dem * steht der
Akkord, hinter dem * die Lnge bzw. Anzahl der Grundschlge. Bei
einer Lnge von 1 kann man die Lngenabgabe 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
Anhngsel 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] Kpfchen in das [C*4] Wasser,
[G*4] Schwnzchen in die [C*5] Hh.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Mchte man eine Pause, so schreibt man statt eines Akkordes ein P in die eckigen
Klammern. Der Ausdruck [P*8] wrde eine Pause von 8 Grundschlgen bedeuten.

Standardmig werden im Schlagmuster 2 Zeichen pro Grundschlag abgearbeitet.
Diese Anzahl kann man ndern, in dem man nach dem Schlagmuster optional ein #
einfgt und dahinter die Anzahl der Zeichen pro Grundschlag angibt. Damit
lassen sich rhythmisch komplizierte Schlagmuster produzieren.

Es ist auch mglich, 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] wrde 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 drfen:

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

Weitere Mglichkeiten:

- Wenn man auf eine Saite klickt, hrt man der Ton der Grundstimmung
- Weitere Ukulelenstimmungen knnen in der ukufon.ini eingetragen werden
- Weitere Akkorde knnen in der ukufon.ini eingetragen werden
- Schriftart und Farben knnen in der ukufon.ini gendert werden

Wer mchte, kann sogar eigene Tonsamples hinzufgen. Dazu einfach unter der
Gruppe [SAMPLE] eine neue Zeile einfgen. Nach dem Namen und dem = folgen
nacheinander durch Komma getrennt folgende Werte:
1. Dateiname ("default" oder eine Datei: *.wav, *.mp2, *.mp3, *.ogg, *.raw)
2. Tuning (hoch- oder runterstimmen in Halbtonschritten)
3. Lautstrke1 (0-255, lauter Anschlag: D oder U)
4. Lautstrke2 (0-255, leiser Anschlag: d oder u)
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 fr die hilfreichen Tipps
> wwelti aus dem Ukulelenclub fr sein Tonsample
> bobobo aus dem PureBasic-Forum fr die vielen Ideen

Fr Hinweise, Fehler und Kritik: Lebostein@gmx.de

http://www.lebostein.de/tomysoft/ukufon/
