-%%%% predefined-fretboard-init.ly
+%%%% This file is part of LilyPond, the GNU music typesetter.
%%%%
-%%%% source file of the GNU LilyPond music typesetter
+%%%% Copyright (C) 2008--2012 Carl D. Sorensen <c_sorensen@byu.edu>
%%%%
-%%%% (c) 2008 Carl D. Sorensen <c_sorensen@byu.edu>
+%%%% LilyPond is free software: you can redistribute it and/or modify
+%%%% it under the terms of the GNU General Public License as published by
+%%%% the Free Software Foundation, either version 3 of the License, or
+%%%% (at your option) any later version.
+%%%%
+%%%% LilyPond is distributed in the hope that it will be useful,
+%%%% but WITHOUT ANY WARRANTY; without even the implied warranty of
+%%%% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+%%%% GNU General Public License for more details.
+%%%%
+%%%% You should have received a copy of the GNU General Public License
+%%%% along with LilyPond. If not, see <http://www.gnu.org/licenses/>.
-\version "2.11.65"
+\version "2.16.0"
% chord-shape-table is a hash-table of chord shapes
% in the form of diagram-descriptions that can be
% chord-shape-table
addChordShape =
-#(define-music-function (parser location key-symbol tuning shape-definition)
+#(define-void-function (parser location key-symbol tuning shape-definition)
(symbol? pair? string-or-pair?)
- "Add chord shape @code{shape-definition} to the @code{chord-shape-table}
-hash with the key @code{(cons key-symbol tuning)}."
+ (_i "Add chord shape @var{shape-definition} to the @var{chord-shape-table}
+hash with the key @code{(cons @var{key-symbol} @var{tuning})}.")
(hash-set! chord-shape-table
(cons key-symbol tuning)
- shape-definition)
- (make-music 'SequentialMusic 'void #t))
+ shape-definition))
#(define (chord-shape shape-code tuning)
(get-chord-shape shape-code tuning chord-shape-table))
+% scheme function for copying/creating fretboard tables
+
+#(define (make-fretboard-table . rest)
+ "Create a new fretboard table. @code{rest} is an optional table name.
+If present, the new fretboard table starts as a copy of the fretboard
+table @code{rest}."
+ (if (null? rest)
+ (make-hash-table 101)
+ (let ((source-table (car rest)))
+ (hash-fold
+ (lambda (key value tab)
+ (hash-set! tab key value)
+ tab)
+ (make-hash-table 101)
+ source-table))))
+
% music function for adding a predefined diagram to
% fretboard-table
storePredefinedDiagram =
-#(define-music-function (parser location chord tuning diagram-definition)
- (ly:music? pair? string-or-pair?)
- "Add predefined fret diagram defined by @code{diagram-definition}
-for the chord pitches @code{chord} and
-the stringTuning @code{tuning}."
- (let* ((pitches (event-chord-pitches
+#(define-void-function
+ (parser location fretboard-table chord tuning diagram-definition)
+ (hash-table? ly:music? pair? string-or-pair?)
+ (_i "Add predefined fret diagram defined by @var{diagram-definition}
+ for the chord pitches @var{chord} and the stringTuning @var{tuning}.")
+ (let* ((pitches (event-chord-pitches
(car (extract-named-music chord 'EventChord))))
(hash-key (cons tuning pitches))
(verbose-definition (if (string? diagram-definition)
(parse-terse-string diagram-definition)
diagram-definition)))
- (hash-set! fretboard-table
- hash-key
- verbose-definition))
- (make-music 'SequentialMusic 'void #t))
-
+ (hash-set! fretboard-table
+ hash-key
+ verbose-definition)))