Gerhard Raabe

Java Programm: GitarreScales

Beschreibung des Daten-Files für die Tonleitern-Informationen

Datenstruktur
Source-Files:

Die Informationen über die Tonleitern, deren Aufbau und deren Darstellung ist in dem File GitarreScales.xml im Hauptverzeichnis des Programms hinterlegt und kann frei editiert werden. Es wird beim Start des Programms vollständig eingelesen. Änderungen an diesem File sind daher erst nach einem Programmneustart aktiv!

Die Tonleitern (SCALE) werden in Tonleiter-Gruppen (BLOCK) zusammengefaßt. So können z.B. alle Dur-Tonleitern in der Tonleiter-Gruppe "Dur" übersichtlich zusamengefaßt werden. Die Blöcke (BLOCK) sind in einer Block-Liste (BLOCKS) zusammengefaßt. Es können beliebig viele Blocke definiert werden. Jeder Block muß durch einen eindeutigen Namen identifizierbar sein.

Die Blöcke enthält je eine Liste von Tonleitern (SCALES). In dieser Liste können beliebig viele Tonleitern (SCALE) definiert werden. Jede Tonleiter muß einen Namen erhalten, der innerhalb eines Blocks identisch sein muß. Die Datenstruktur für die Tonleitern (SCALE) enthält neben einer Notenliste (NOTES) auch eine Liste, in der verschiedene verschiedene Ausschnitte des Griffbretts definiert werden können (RANGES). So können z.B. die Ausschnitte des Griffbrettes für die verschiedenen Lagenspielweise einer Tonleiter dargestellt werden.

Schematischer Aufbau des Source-Files:

<?xml version="1.0" encoding="UTF-8"?>
<BLOCKS>
       <BLOCK>
             <NAME>Dur</NAME>
             <LABEL>Dur</LABEL>
             <SCALES>
                    <SCALE>
                          <NAME>C-Dur</NAME>
                          <LABEL>C-Dur</LABEL>
                          <NOTES>
                                 <NOTE>
                                       <NAME>E</NAME>
                                       <LABEL>E</LABEL>
                                       <STRING>6</STRING>
                                       <FRET>0</FRET>
                                       <MARKED>Y</MARKED>
                                       <NOTELINE>-9</NOTELINE>
                                       <ACCIDENTAL>A++</ACCIDENTAL>
                                       <MIDINOTE>40</MIDINOTE>
                                 </NOTE>
                                 <NOTE>
                                      .
                                      .
                                      .
                                 </NOTE>
                                .
                                .       // Beliebig viele weitere NOTE-Blöcke für diese Tonleiter
                                .
                          </NOTES>
                          <RANGES>
                                 <RANGE>
                                       <NAME>I</NAME>
                                       <LABEL>I</LABEL>
                                       <STRINGS>
                                              <STRING>
                                                    <NR>1</NR>
                                                    <FRETSTART>0</FRETSTART>
                                                    <FRETEND>5</FRETEND>
                                              </STRING>
                                              <STRING>
                                                   .
                                                   .
                                                   .
                                              </STRING>
                                             .
                                             .       // Für jede Saite kann ein STRING-Block definiert werden
                                             .       // d.h., es werden STRING-Blöcke mit NR = 1..6 unterstützt
                                       </STRINGS>
                                 </RANGE>
                                 <RANGE>
                                      .
                                      .
                                      .
                                 </RANGE>
                                .
                                .       // Beliebig viele weitere RANGE-Blöcke für diese Tonleiter
                                .
                          </RANGES>
                    </SCALE>
                    <SCALE>
                         .
                         .
                         .
                    </SCALE>
                   .
                   .       // Beliebig viele weitere SCALE-Blöcke für diese Tonleitergruppe
                   .
             </SCALES>
       </BLOCK>
       <BLOCK>
             .
             .
             .
       </BLOCK>
      .
      .       // Beliebig viele weitere Tonleitergruppe
      .
</BLOCKS>

Feldbeschreibungen:

BLOCKS
BLOCK

NAME

Name des Blocks

LABEL

Label des Blocks

SCALES

Liste der zu diesem Block gehörigen Tonleitern

BLOCKS
       BLOCK
             SCALES
                    SCALE

NAME

Name der Tonleiter

LABEL

Label der Tonleiter

NOTES

Liste der zu diesem Tonleitern gehörigen Note

RANGES

Liste der Griffbrett-Ausschnitte

BLOCKS
       BLOCK
             SCALES
                    SCALE
                          NOTES
                                 NOTE

NAME

Name der Note

LABEL

Label der Note

STRING

Position der Note auf der Saite

FRET

Position der Note auf der Griffbrett-Lage
(0 = nicht gegriffen)

MARKED

wenn "Y" oder "Yes" wird der Griffpunkt markiert
dargestellt.

NOTELINE

Notelinie im Notensystem
  - g-Linie = 0
  - jede Linie und Zwischenraum zählt
  - oberhalb der g-Linie: +
  - unterhalb der g-Linie: -

ACCIDENTAL

Vorzeichen der Note:	A++	=

	A+	=
	A0	=
	A-	=
	A--	=

MIDINOTE

Notenwert für MIDI

BLOCKS
       BLOCK
             SCALES
                    SCALE
                          RANGES
                                 RANGE

NAME

Name des definierten Anzeigebereichs

LABEL

Label des definierten Anzeigebereichs

STRINGS

Liste der saitenspezifischen Informationen;
unterstützt werden Einträge mit NR = 1..6
wenn für eine Saite kein Eintrag vorhanden ist,
dann werden für diese auch keine Noten dargestellt!

BLOCKS
       BLOCK
             SCALES
                    SCALE
                          RANGES
                                 RANGE
                                       STRINGS
                                              STRING

Nummer der Saite (1..6)

FRETSTART

Erste dargestellte Lage

FRETEND

Letzte dargestellte Lage

##, ## ### #### - ##:##:##