Logo
HomeBücherNotenbuchInteraktivGitarreScalesKleinanzeigenLinksDownloadsGästebuchKontaktImpressumAGB
Login  
  GitarreScales: Dokumentation
 
  GitarreScales   GitarreScales (Übersicht)  
      Programm zur grafischen Darstellung von Tonleitern auf der Gitarre (Übersicht)  
 
  Applet   Applet (Online-Programmstart)  
      Online-Programmstart von GitarreScales (Java-Applet)  
 
  Manuel   Bedienungsanleitung  
      Bedienungsanleitung und Screenshots  
 
  Dcuumentation   Dokumentation  
      Technische Dokumentation  
 
  Download   Download  
      Download Gitarrescales  
 
 
Goto to Sector   Beschreibung des Daten-Files für die Tonleitern-Informationen
Goto to Sector   Enthaltene Klassen
Goto to Sector   Images
 
Back to top  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 
 NR   Nummer der Saite (1..6)
 FRETSTART   Erste dargestellte Lage
 FRETEND   Letzte dargestellte Lage
Back to top  Enthaltene Klassen
FingerBoard.Structure.CBlock
FingerBoard.Structure.CBlocks
FingerBoard.Structure.CNote
FingerBoard.Structure.CNotes
FingerBoard.Structure.CRange
FingerBoard.Structure.CRanges
FingerBoard.Structure.CRangeString
FingerBoard.Structure.CScale
FingerBoard.Structure.CScales
FingerBoard.Structure.CXML

FingerBoard.CFingerBoard
FingerBoard.CFingerBoardNotes
FingerBoard.CGrafikComp
FingerBoard.CGrafikPanel

GitarreScales.Child.Comp.Config.CChildConfigFingerBoard
GitarreScales.Child.Comp.Config.CChildConfigFingerBoardNotes

GitarreScales.Child.Comp.Select.CChildSelectScale

GitarreScales.Child.Grafik.CChildFingerBoard
GitarreScales.Child.Grafik.CChildFingerBoardNotes
GitarreScales.Child.Grafik.CChildGrafik

Grafik.GIFEncoder.CBitFile
Grafik.GIFEncoder.CBitUtils
Grafik.GIFEncoder.CGIFEncoder
Grafik.GIFEncoder.CImageDescriptor
Grafik.GIFEncoder.CLZWCompressor
Grafik.GIFEncoder.CLZWStringTable
Grafik.GIFEncoder.CScreenDescriptor

IniFile.CIniFile
IniFile.CIniFileSection
IniFile.CIniFileKey

Print.PrintImages.CPrintImageDialog
Print.PrintImages.CPrintImagePreview
Print.PrintImages.CPrintImagePrinterAdapter
Print.PrintImages.CPrintImageZoomAdapter
Print.PrintImages.CPrintImages
Print.PrintImages.CPrintImage
Print.PrintImages.CPrintGrafik
Print.PrintImages.CPrintGrafikText

Sound.CSound
Sound.CChannel
Sound.CConfigMIDIDialog
Sound.CConfigNoteDialog
Sound.CPiano

CGitarreScalesApplet
Back to top  Images
Die zur Anzeige der grafischen Darstellung verwendeten Images befinden sich im GIF-Format im Verzeichnis Images:

   Filename:  Preview:
 Bund:  Bridge.gif
 Saiten:  1. Saite:  String_1.gif
 2. Saite:  String_2.gif
 3. Saite:  String_3.gif
 4. Saite:  String_4.gif
 5. Saite:  String_5.gif
 6. Saite:  String_6.gif
 Griffpunkte:  1. Saite:  Point_1.gif
 2. Saite:  Point_2.gif
 3. Saite:  Point_3.gif
 4. Saite:  Point_4.gif
 5. Saite:  Point_5.gif
 6. Saite:  Point_6.gif
 Griffpunkte:
 (markiert)
 1. Saite:  Point_Marked_1.gif 
 2. Saite:  Point_Marked_2.gif 
 3. Saite:  Point_Marked_3.gif 
 4. Saite:  Point_Marked_4.gif 
 5. Saite:  Point_Marked_5.gif 
 6. Saite:  Point_Marked_6.gif 
 Notenschlüsssel:  Clef.gif
 Noten:  1. Saite:  Note_1.gif
 2. Saite:  Note_2.gif
 3. Saite:  Note_3.gif
 4. Saite:  Note_4.gif
 5. Saite:  Note_5.gif
 6. Saite:  Note_6.gif
 Vorzeichen :  1. Saite:  A++_1.gif
 2. Saite:  A++_2.gif
 3. Saite:  A++_3.gif
 4. Saite:  A++_4.gif
 5. Saite:  A++_5.gif
 6. Saite:  A++_6.gif
 Vorzeichen :  1. Saite:  A+_1.gif
 2. Saite:  A+_2.gif
 3. Saite:  A+_3.gif
 4. Saite:  A+_4.gif
 5. Saite:  A+_5.gif
 6. Saite:  A+_6.gif
 Vorzeichen :  1. Saite:  A0_1.gif
 2. Saite:  A0_2.gif
 3. Saite:  A0_3.gif
 4. Saite:  A0_4.gif
 5. Saite:  A0_5.gif
 6. Saite:  A0_6.gif
 Vorzeichen :  1. Saite:  A-_1.gif
 2. Saite:  A-_2.gif
 3. Saite:  A-_3.gif
 4. Saite:  A-_4.gif
 5. Saite:  A-_5.gif
 6. Saite:  A-_6.gif
 Vorzeichen :  1. Saite:  A--_1.gif
 2. Saite:  A--_2.gif
 3. Saite:  A--_3.gif
 4. Saite:  A--_4.gif
 5. Saite:  A--_5.gif
 6. Saite:  A--_6.gif
   905272 Besucher - seit dem 01.02.2005 - 1 Besucher online ##, ## ### #### - ##:##:##   
   © 2004-2016 by Gerhard Raabe • Mail:  Gerhard.Raabe@Musiklehre-fuer-Gitarre.de