2 ;;; chord-name.scm -- chord name utility functions
4 ;;; source file of the GNU LilyPond music typesetter
6 ;;; (c) 2000--2003 Han-Wen Nienhuys <hanwen@cs.uu.nl>
9 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
10 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
14 ;; after Klaus Ignatzek, Die Jazzmethode fuer Klavier 1.
16 ;; The idea is: split chords into
18 ;; ROOT PREFIXES MAIN-NAME ALTERATIONS SUFFIXES ADDITIONS
20 ;; and put that through a layout routine.
22 ;; the split is a procedural process, with lots of set!.
26 ;; todo: naming is confusing: steps (0 based) vs. steps (1 based).
27 (define (pitch-step p)
28 "Musicological notation for an interval. Eg. C to D is 2."
29 (+ 1 (ly:pitch-steps p)))
31 (define (get-step x ps)
32 "Does PS have the X step? Return that step if it does."
35 (if (= (- x 1) (ly:pitch-steps (car ps)))
37 (get-step x (cdr ps)))
40 (define (replace-step p ps)
41 "Copy PS, but replace the step of P in PS."
46 (t (replace-step p (cdr ps)))
49 (if (= (ly:pitch-steps p) (ly:pitch-steps (car ps)))
55 (define (remove-step x ps)
56 "Copy PS, but leave out the Xth step."
61 (t (remove-step x (cdr ps)))
64 (if (= (- x 1) (ly:pitch-steps (car ps)))
71 (define-public (ignatzek-chord-names
72 in-pitches bass inversion
75 (define (remove-uptil-step x ps)
76 "Copy PS, but leave out everything below the Xth step."
79 (if (< (ly:pitch-steps (car ps)) (- x 1))
80 (remove-uptil-step x (cdr ps))
84 (define name-root (ly:get-context-property context 'chordRootNamer))
86 (let ((nn (ly:get-context-property context 'chordNoteNamer)))
88 ; replacing the next line with name-root gives guile-error...? -rz
90 ;; apparently sequence of defines is equivalent to let, not let* ? -hwn
91 (ly:get-context-property context 'chordRootNamer)
95 (define (is-natural-alteration? p)
96 (= (natural-chord-alteration p) (ly:pitch-alteration p)))
99 (define (ignatzek-format-chord-name
109 "Format for the given (lists of) pitches. This is actually more
110 work than classifying the pitches."
112 (define (filter-main-name p)
113 "The main name: don't print anything for natural 5 or 3."
115 (or (not (ly:pitch? p))
116 (and (is-natural-alteration? p)
117 (or (= (pitch-step p) 5)
118 (= (pitch-step p) 3))))
123 (define (glue-word-to-step word x)
126 (make-simple-markup word)
130 (define (suffix-modifier->markup mod)
131 (if (or (= 4 (pitch-step mod))
132 (= 2 (pitch-step mod)))
133 (glue-word-to-step "sus" mod)
134 (glue-word-to-step "huh" mod)
137 (define (prefix-modifier->markup mod)
138 (if (and (= 3 (pitch-step mod))
139 (= -1 (ly:pitch-alteration mod)))
140 (make-simple-markup "m")
141 (make-simple-markup "huh")
144 (define (filter-alterations alters)
145 "Filter out uninteresting (natural) pitches from ALTERS."
148 (not (is-natural-alteration? p)))
155 (l (filter altered? alters))
156 (lp (last-pair alters))
159 ;; we want the highest also if unaltered
160 (if (and (not (altered? (car lp)))
161 (> (pitch-step (car lp)) 5))
162 (append l (last-pair alters))
166 (define (name-step pitch)
167 (define (step-alteration pitch)
168 (- (ly:pitch-alteration pitch)
169 (natural-chord-alteration pitch)
174 (num-markup (make-simple-markup
175 (number->string (pitch-step pitch))))
176 (args (list num-markup))
177 (total (if (= (ly:pitch-alteration pitch) 0)
178 (if (= (pitch-step pitch) 7)
179 (list (ly:get-context-property context 'majorSevenSymbol))
181 (cons (accidental->markup (step-alteration pitch)) args)
185 (make-line-markup total)))
189 (sep (ly:get-context-property context 'chordNameSeparator))
190 (root-markup (name-root root))
191 (add-markups (map (lambda (x)
192 (glue-word-to-step "add" x))
194 (filtered-alterations (filter-alterations alteration-pitches))
195 (alterations (map name-step filtered-alterations))
196 (suffixes (map suffix-modifier->markup suffix-modifiers))
197 (prefixes (map prefix-modifier->markup prefix-modifiers))
198 (main-markups (filter-main-name main-name))
199 (to-be-raised-stuff (markup-join
205 (base-stuff (if bass-pitch
206 (list sep (name-note bass-pitch))
213 (markup-join prefixes sep)
214 (make-super-markup to-be-raised-stuff))
216 (make-line-markup base-stuff)
222 (root (car in-pitches))
223 (pitches (map (lambda (x) (ly:pitch-diff x root)) (cdr in-pitches)))
224 (exceptions (ly:get-context-property context 'chordNameExceptions))
225 (exception (assoc-get-default pitches exceptions #f))
237 (list (name-root root) exception))
239 (begin ; no exception.
241 ; handle sus4 and sus2 suffix: if there is a 3 together with
242 ; sus2 or sus4, then we explicitly say add3.
245 (if (get-step j pitches)
247 (if (get-step 3 pitches)
249 (set! add-steps (cons (get-step 3 pitches) add-steps))
250 (set! pitches (remove-step 3 pitches))
252 (set! suffixes (cons (get-step j pitches) suffixes))
257 ;; do minor-3rd modifier.
258 (if (and (get-step 3 pitches)
259 (= (ly:pitch-alteration (get-step 3 pitches)) -1))
260 (set! prefixes (cons (get-step 3 pitches) prefixes))
263 ;; lazy bum. Should write loop.
265 ((get-step 7 pitches) (set! main-name (get-step 7 pitches)))
266 ((get-step 6 pitches) (set! main-name (get-step 6 pitches)))
267 ((get-step 5 pitches) (set! main-name (get-step 5 pitches)))
268 ((get-step 4 pitches) (set! main-name (get-step 4 pitches)))
269 ((get-step 3 pitches) (set! main-name (get-step 3 pitches)))
274 (3-diff? (lambda (x y)
275 (= (- (pitch-step y) (pitch-step x)) 2)))
276 (split (split-at-predicate 3-diff? (remove-uptil-step 5 pitches)))
278 (set! alterations (append alterations (car split)))
279 (set! add-steps (append add-steps (cdr split)))
280 (set! alterations (delq main-name alterations))
281 (set! add-steps (delq main-name add-steps))
283 (if (ly:pitch? inversion)
284 (set! bass-note inversion)
288 (set! bass-note bass)
291 ;; chords with natural (5 7 9 11 13) or leading subsequence.
292 ;; etc. are named by the top pitch, without any further
295 (ly:pitch? main-name)
296 (= 7 (pitch-step main-name))
297 (is-natural-alteration? main-name)
298 (pair? (remove-uptil-step 7 alterations))
299 (reduce (lambda (x y) (and x y)) #t
300 (map is-natural-alteration? alterations)))
302 (set! main-name (last alterations))
303 (set! alterations '())
306 (ignatzek-format-chord-name root prefixes main-name alterations add-steps suffixes bass-note)