+
+
+@node Predefined fret diagrams
+@unnumberedsubsubsec Predefined fret diagrams
+
+
+@cindex Bunddiagramme
+@cindex Akkord-Diagramme
+
+@funindex FretBoards
+@funindex stringTunings
+
+Bunddiagramme können mit dem @code{FretBoards}-Kontext angezeigt
+werden. Standardmäßig zeigt der @code{FretBoards}-Kontext
+Bunddiagramme an, die in einer Tabelle definiert sind:
+
+@lilypond[verbatim, ragged-right, quote]
+\include "predefined-guitar-fretboards.ly"
+\context FretBoards {
+ \chordmode {
+ c1 d
+ }
+}
+@end lilypond
+
+Die vordefinierten Diagramme sind in der Datei
+@code{predefined-guitar-fretboards.ly} enthalten. Sie werden
+basierend auf der Tonhöhe eines Akkordes und dem Wert von
+@code{stringTunings} (Saitenstimmung), der gerade benutzt wird,
+gespeichert. @code{predefined-guitar-fretboards.ly} beinhaltet
+vordefinierte Diagramme für die Gitarrenstimmtung (@code{guitar-tuning}).
+Anhand der Beispiele in dieser Datei können auch für andere
+Instrumente oder Stimmungen Diagramme definiert werden.
+
+Tonhöhen von Akkorden können entweder als Akkordkonstrukte
+oder im Akkordmodus notiert werden (siehe auch
+@ref{Chord mode overview}).
+
+@lilypond[verbatim, ragged-right,quote]
+\include "predefined-guitar-fretboards.ly"
+\context FretBoards {
+ \chordmode {c1}
+ <c' e' g'>1
+}
+@end lilypond
+
+@cindex Akkordbezeichnungen und Bunddiagramme
+@cindex Bunddiagramme und Akkordbezeichnungen
+
+@funindex ChordNames
+@funindex chordmode
+@funindex \chordmode
+
+Oft wird sowohl eine Akkordbezeichnung als ein Bunddiagramm
+notiert. Das kann erreicht werden, indem ein
+@code{ChordNames}-Kontext parallel mit einem @code{FretBoards}-Kontext
+gesetzt wird und beiden Kontexten die gleichen Noten zugewiesen
+werden.
+
+@lilypond[verbatim, ragged-right, quote]
+\include "predefined-guitar-fretboards.ly"
+mychords = \chordmode{
+ c1 f g
+}
+
+<<
+ \context ChordNames {
+ \mychords
+ }
+ \context FretBoards {
+ \mychords
+ }
+>>
+@end lilypond
+
+@cindex Transposition von Bunddiagrammen
+@cindex Bunddiagramme, Transposition
+
+Vordefinierte Bunddiagramme können transponiert werden, solange
+ein Diagramm für den transponierten Akkord in der Bunddiagramm-Tabelle
+vorhanden ist.
+
+@lilypond[verbatim, ragged-right, quote]
+\include "predefined-guitar-fretboards.ly"
+mychords = \chordmode{
+ c1 f g
+}
+
+mychordlist = {
+ \mychords
+ \transpose c e { \mychords}
+}
+<<
+ \context ChordNames {
+ \mychordlist
+ }
+ \context FretBoards {
+ \mychordlist
+ }
+>>
+@end lilypond
+
+Die Tabelle der vordefinierten Bunddiagramme enthält sieben
+Akkorde (Dur, Moll, übermäßig, vermindert, Dominantseptakkord,
+große Septime und kleine Septime) für alle 17 Tonarten. Eine
+vollständige Liste der vordefinierten Bunddiagramme findet sich
+in @ref{Predefined fret diagrams}. Wenn in der Tabelle für
+einen Akkord kein Wert steht, wird ein Bunddiagramm vom
+@code{FretBoards}-Engraver errechnet, wobei die automatische
+Bunddiagrammfunktion zu Anwendung kommt. Siehe hierzu
+@ref{Automatic fret diagrams}.
+
+@lilypond[verbatim, ragged-right, quote]
+\include "predefined-guitar-fretboards.ly"
+mychords = \chordmode{
+ c1 c:9
+}
+
+<<
+ \context ChordNames {
+ \mychords
+ }
+ \context FretBoards {
+ \mychords
+ }
+>>
+@end lilypond
+
+@cindex Bunddiagramme, eigene definieren
+@cindex Definieren von eigenen Bunddiagrammen
+@cindex Eigene Bunddiagramme definieren
+
+Bunddiagramme können zu der Tabelle hinzugefügt werden. Um ein
+Diagramm hinzuzufügen, muss der Akkord des Diagramms, die Stimmung
+und die Diagramm-Definition angegeben werden. Die Diagramm-Definition
+kann entweder eine @code{fret-diagram-terse}-Definition oder eine
+@code{fret-diagram-verbose}-Liste sein.
+
+@lilypond[verbatim, ragged-right, quote]
+\include "predefined-guitar-fretboards.ly"
+
+\storePredefinedDiagram \chordmode {c:9}
+ #guitar-tuning
+ #"x;3-2;2-1;3-3;3-4;x;"
+
+mychords = \chordmode{
+ c1 c:9
+}
+
+<<
+ \context ChordNames {
+ \mychords
+ }
+ \context FretBoards {
+ \mychords
+ }
+>>
+@end lilypond
+
+Unterschiedliche Bunddiagramme für den selben Akkord können
+gespeichert werden, indem unterschiedliche Oktaven für die
+Tonhöhe benutzt werden.
+
+@lilypond[verbatim, ragged-right, quote]
+\include "predefined-guitar-fretboards.ly"
+
+\storePredefinedDiagram \chordmode {c'}
+ #guitar-tuning
+ #(offset-fret 2 (chord-shape 'bes guitar-tuning))
+
+mychords = \chordmode{
+ c1 c'
+}
+
+<<
+ \context ChordNames {
+ \mychords
+ }
+ \context FretBoards {
+ \mychords
+ }
+>>
+@end lilypond
+
+@cindex Bundinstrumente, Akkordformen
+@cindex Akkordformen für Bundinstrumente
+
+@funindex \addChordShape
+@funindex add ChordShape
+@funindex storePredefinedDiagram
+@funindex \storePredefinedDiagram
+
+Zusätzlich zu Bunddiagrammen speichert LilyPond auch eine interne
+Liste an Akkordformen. Die Akkordformen sind Bunddiagramme,
+die am Hals entlang verschoben werden können und dabei unterschiedliche
+Akkorde ergeben. Akkordformen können zu der internen Liste
+hinzugefügt werden und dann benutzt werden, um vordefinierte
+Bunddiagramme zu definieren. Weil sie auf verschiedenen Positionen
+auf dem Steg gelegt werden können, beinhalten vordefinierte
+Akkord üblicherweise keine leeren Saiten. Wie Bunddiagramme können auch
+Akkordformen entweder als @code{fret-diagram-terse}-Definition
+oder als @code{fret-diagram-verbose}-Liste erstellt werden.
+
+@lilypond[verbatim, ragged-right, quote]
+\include "predefined-guitar-fretboards.ly"
+
+% add a new chord shape
+
+\addChordShape #'powerf #guitar-tuning #"1-1;3-3;3-4;x;x;x;"
+
+% add some new chords based on the power chord shape
+
+\storePredefinedDiagram \chordmode {f'}
+ #guitar-tuning
+ #(chord-shape 'powerf guitar-tuning)
+\storePredefinedDiagram \chordmode {g'}
+ #guitar-tuning
+ #(offset-fret 2 (chord-shape 'powerf guitar-tuning))
+
+mychords = \chordmode{
+ f1 f' g g'
+}
+
+<<
+ \context ChordNames {
+ \mychords
+ }
+ \context FretBoards {
+ \mychords
+ }
+>>
+@end lilypond
+
+Die graphische Form eines Bunddiagramms kann entsprechend den
+eigenen Wünschen verändert werden, indem man die Eigenschaften
+der @code{fret-diagram-interface}-Schnittstellt verändert.
+Einzelheiten hierzu in @rinternals{fret-diagram-interface}. Die
+Schnittstelleneigenschaften eines vordefinierten Bunddiagrammes
+gehören dem @code{FretBoards.FretBoard}-Kontext an.
+
+@snippets
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{customizing-fretboard-fret-diagrams.ly}
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{defining-predefined-fretboards-for-other-instruments.ly}
+
+