2 ;;; chord-name.scm -- Compile chord name
4 ;;; source file of the GNU LilyPond music typesetter
6 ;;; (c) 2000 Jan Nieuwenhuizen <janneke@gnu.org>
12 ;; urg, these two only to guess if a '/' is needed to separate
13 ;; user-chord-name and additions/subtractions
19 ;; (octave notename accidental)
23 ;; text: scm markup text -- see font.scm and input/test/markup.ly
28 ;; * clean split of base/banter/american stuff
29 ;; * text definition is rather ad-hoc
30 ;; * do without format module
31 ;; * finish and check american names
32 ;; * make notename (tonic) configurable from lilypond
33 ;; * fix append/cons stuff in inner-name-banter
37 (define chord::names-alist-banter '())
38 (set! chord::names-alist-banter
44 (((0 . 0) (2 . 0)) . #f)
46 (((0 . 0) (2 . -1)) . ("m"))
48 (((0 . 0) (1 . 0) (4 . 0)) . (super "2"))
50 (((0 . 0) (3 . 0) (4 . 0)) . (super "4"))
52 (((0 . 0) (2 . -1) (4 . -1)) . ("dim"))
55 (((0 . 0) (2 . -1) (4 . -1) (6 . -2)) . (super "o"))
57 (((0 . 0) (2 . -1) (4 . -1) (6 . -2) (1 . -1)) . ("dim" (super "9")))
58 (((0 . 0) (2 . -1) (4 . -1) (6 . -2) (1 . -1) (3 . -1)) . ("dim" (super "11")))
60 chord::names-alist-banter))
63 ;; NOTE: Duplicates of chord names defined elsewhere occur in this list
64 ;; in order to prevent spurious superscripting of various chord names,
65 ;; such as maj7, maj9, etc.
67 ;; See input/test/american-chords.ly
69 ;; James Hammons, <jlhamm@pacificnet.net>
72 ;; DONT use non-ascii characters, even if ``it works'' in Windows
74 (define chord::names-alist-american '())
76 (set! chord::names-alist-american
80 (((0 . 0) (2 . 0)) . #f)
82 (((0 . 0) (4 . 0)) . ("5"))
84 (((0 . 0) (2 . -1)) . ("m"))
85 (((0 . 0) (3 . 0) (4 . 0)) . ("sus"))
86 (((0 . 0) (2 . -1) (4 . -1)) . ("dim"))
87 ;Alternate: (((0 . 0) (2 . -1) (4 . -1)) . ((super "o")))
88 (((0 . 0) (2 . 0) (4 . 1)) . ("aug"))
89 ;Alternate: (((0 . 0) (2 . 0) (4 . 1)) . ("+"))
90 (((0 . 0) (1 . 0) (4 . 0)) . ("2"))
91 ;; Common seventh chords
92 (((0 . 0) (2 . -1) (4 . -1) (6 . -2)) . (rows (super "o") "7"))
93 (((0 . 0) (2 . 0) (4 . 0) (6 . 0)) . ("maj7"))
94 (((0 . 0) (2 . -1) (4 . 0) (6 . -1)) . ("m7"))
95 (((0 . 0) (2 . 0) (4 . 0) (6 . -1)) . ("7"))
96 (((0 . 0) (2 . -1) (4 . 0) (6 . 0)) . ("m(maj7)"))
97 ;jazz: the delta, see jazz-chords.ly
98 ;;(((0 . 0) (2 . -1) (4 . -1) (6 . -2)) . (super ((font-family . math) "N"))
100 (((0 . 0) (2 . -1) (4 . -1) (6 . -1)) . (rows ((raise . 1) "o") ((raise . 0.5) ((kern . -0.5) ((font-relative-size . -3) "/"))) "7")) ; slashed o
101 (((0 . 0) (2 . 0) (4 . 1) (6 . -1)) . ("aug7"))
102 (((0 . 0) (2 . 0) (4 . -1) (6 . 0)) . (rows "maj7" ((font-relative-size . -2) ((raise . 0.2) (music (named "accidentals--1")))) "5"))
103 (((0 . 0) (2 . 0) (4 . -1) (6 . -1)) . (rows "7" ((font-relative-size . -2) ((raise . 0.2) (music (named "accidentals--1")))) "5"))
104 (((0 . 0) (3 . 0) (4 . 0) (6 . -1)) . ("7sus4"))
105 ;; Common ninth chords
106 (((0 . 0) (2 . 0) (4 . 0) (5 . 0) (1 . 0)) . ("6/9")) ;; we don't want the '/no7'
107 (((0 . 0) (2 . 0) (4 . 0) (5 . 0)) . ("6"))
108 (((0 . 0) (2 . -1) (4 . 0) (5 . 0)) . ("m6"))
109 (((0 . 0) (2 . 0) (4 . 0) (1 . 0)) . ("add9"))
110 (((0 . 0) (2 . 0) (4 . 0) (6 . 0) (1 . 0)) . ("maj9"))
111 (((0 . 0) (2 . 0) (4 . 0) (6 . -1) (1 . 0)) . ("9"))
112 (((0 . 0) (2 . -1) (4 . 0) (6 . -1) (1 . 0)) . ("m9"))
115 chord::names-alist-american))
117 ;; Jazz chords, by Atte Andr'e Jensen <atte@post.com>
118 ;; NBs: This uses the american list as a base.
119 ;; Some defs take up more than one line,
120 ;; be carefull when messing with ;'s!!
125 ;; This is getting out-of hand? Only exceptional chord names that
126 ;; cannot be generated should be here.
127 ;; Maybe we should have inner-jazz-name and inner-american-name functions;
131 ;; DONT use non-ascii characters, even if ``it works'' in Windows
133 (define chord::names-alist-jazz '())
134 (set! chord::names-alist-jazz
138 ; major sixth chord = 6
139 (((0 . 0) (2 . 0) (4 . 0) (5 . 0)) . (((raise . 0.5) "6")))
140 ; major seventh chord = triangle
141 (((0 . 0) (2 . 0) (4 . 0) (6 . 0)) . (((raise . 0.5)((font-family . "math") "M"))))
142 ; major chord add nine = add9
143 (((0 . 0) (2 . 0) (4 . 0) (1 . 0)) . (((raise . 0.5) "add9")))
144 ; major sixth chord with nine = 6/9
145 (((0 . 0) (2 . 0) (4 . 0) (5 . 0) (1 . 0)) . (((raise . 0.5) "6/9")))
148 ; minor sixth chord = m6
149 (((0 . 0) (2 . -1) (4 . 0) (5 . 0)) . (rows("m")((raise . 0.5) "6")))
150 ; minor major seventh chord = m triangle
151 (((0 . 0) (2 . -1) (4 . 0) (6 . 0)) . (rows ("m") ((raise . 0.5)((font-family . "math") "M"))))
152 ; minor seventh chord = m7
153 (((0 . 0) (2 . -1) (4 . 0) (6 . -1)) . (rows("m")((raise . 0.5) "7")))
154 ; minor sixth nine chord = m6/9
155 (((0 . 0) (2 . -1) (4 . 0) (5 . 0) (1 . 0)) . (rows("m")((raise . 0.5) "6/9")))
156 ; minor with added nine chord = madd9
157 (((0 . 0) (2 . -1) (4 . 0) (1 . 0)) . (rows("m")((raise . 0.5) "add9")))
158 ; minor ninth chord = m9
159 (((0 . 0) (2 . -1) (4 . 0) (6 . -1) (1 . 0)) . (rows("m")((raise . 0.5) "9")))
162 ; dominant seventh = 7
163 (((0 . 0) (2 . 0) (4 . 0) (6 . -1)) . (((raise . 0.5) "7")))
164 ; augmented dominant = +7
165 ;(((0 . 0) (2 . 0) (4 . +1) (6 . -1)) . (((raise . 0.5) "+7"))) ; +7 with both raised
166 (((0 . 0) (2 . 0) (4 . +1) (6 . -1)) . (rows("+")((raise . 0.5) "7"))) ; +7 with 7 raised
167 ;(((0 . 0) (2 . 0) (4 . +1) (6 . -1)) . (rows((raise . 0.5) "7(")
168 ; ((raise . 0.3)(music (named ("accidentals-1"))))
169 ; ((raise . 0.5) "5)"))); 7(#5)
170 ; dominant flat 5 = 7(b5)
171 (((0 . 0) (2 . 0) (4 . -1) (6 . -1)) . (rows((raise . 0.5) "7(")
172 ((raise . 0.3)(music (named ("accidentals--1"))))
173 ((raise . 0.5) "5)")))
175 (((0 . 0) (2 . 0) (4 . 0) (6 . -1) (1 . 0)) . (((raise . 0.8)"7(9)")))
176 ; dominant flat 9 = 7(b9)
177 (((0 . 0) (2 . 0) (4 . 0) (6 . -1) (1 . -1)) . (
179 ((raise . 0.3)(music (named ("accidentals--1"))))
180 ((raise . 0.8)"9)")))
181 ; dominant sharp 9 = 7(#9)
182 (((0 . 0) (2 . 0) (4 . 0) (6 . -1) (1 . +1)) . (
184 ((raise . 0.3)(music (named ("accidentals-1"))))
185 ((raise . 0.8)"9)")))
186 ; dominant 13 = 7(13)
187 (((0 . 0) (2 . 0) (4 . 0) (6 . -1) (5 . 0)) . (((raise . 0.8)"7(13)")))
188 ; dominant flat 13 = 7(b13)
189 (((0 . 0) (2 . 0) (4 . 0) (6 . -1) (5 . -1)) . (
191 ((raise . 0.3)(music (named ("accidentals--1"))))
192 ((raise . 0.8)"13)")))
193 ; dominant 9, 13 = 7(9,13)
194 (((0 . 0) (2 . 0) (4 . 0) (6 . -1) (1 . 0) (5 . 0)) . (((raise . 0.8)"7(9, 13)")))
195 ; dominant flat 9, 13 = 7(b9,13)
196 (((0 . 0) (2 . 0) (4 . 0) (6 . -1) (1 . -1) (5 . 0)) . (
198 ((raise . 0.3)(music (named ("accidentals--1"))))
199 ((raise . 0.8)"9, 13)")))
200 ; dominant sharp 9, 13 = 7(#9,13)
201 (((0 . 0) (2 . 0) (4 . 0) (6 . -1) (1 . +1) (5 . 0)) . (
203 ((raise . 0.3)(music (named ("accidentals-1"))))
204 ((raise . 0.8)"9, 13)")))
205 ; dominant 9, flat 13 = 7(9,b13)
206 (((0 . 0) (2 . 0) (4 . 0) (6 . -1) (1 . 0) (5 . -1)) . (
207 ((raise . 0.8)"7(9, ")
208 ((raise . 0.3)(music (named ("accidentals--1"))))
209 ((raise . 0.8)"13)")))
210 ; dominant flat 9, flat 13 = 7(b9,b13)
211 (((0 . 0) (2 . 0) (4 . 0) (6 . -1) (1 . -1) (5 . -1)) . (
213 ((raise . 0.3)(music (named ("accidentals--1"))))
215 ((raise . 0.3)(music (named ("accidentals--1"))))
216 ((raise . 0.8)"13)")))
217 ; dominant sharp 9, flat 13 = 7(#9,b13)
218 (((0 . 0) (2 . 0) (4 . 0) (6 . -1) (1 . +1) (5 . -1)) . (
220 ((raise . 0.3)(music (named ("accidentals-1"))))
222 ((raise . 0.3)(music (named ("accidentals--1"))))
223 ((raise . 0.8)"13)")))
225 ;; diminished chord(s)
226 ; diminished seventh chord = o
229 ;; DONT use non-ascii characters, even if ``it works'' in Windows
231 ;;(((0 . 0) (2 . -1) (4 . -1) (6 . -2)) . (((raise . 0.8)"o"))); works, but "o" is a little big
232 (((0 . 0) (2 . -1) (4 . -1) (6 . -2)) . ((raise . 0.8) (size . -2) ("o")))
234 ;; half diminshed chords
235 ; half diminished seventh chord = slashed o
236 (((0 . 0) (2 . -1) (4 . -1) (6 . -1)) . (((raise . 0.8)"/o")))
237 ; half diminished seventh chord with major 9 = slashed o cancelation 9
238 (((0 . 0) (2 . -1) (4 . -1) (6 . -1) (1 . 0)) . (
240 ((raise . 0.3)(music (named ("accidentals-0"))))
241 ((raise . 0.8)"9)")));
243 ;; Missing jazz chord definitions go here (note new syntax: see american for hints)
246 chord::names-alist-american))
251 (define (pitch->note-name pitch)
252 (cons (cadr pitch) (caddr pitch)))
254 (define (pitch->text pitch)
256 (make-string 1 (integer->char (+ (modulo (+ (cadr pitch) 2) 7) 65)))
257 (if (= (caddr pitch) 0)
264 (append '((font-relative-size . -2))
265 (list (append '((raise . 0.6))
267 (string-append "accidentals-"
268 (number->string (caddr pitch)))))))))))))))
270 (define (step->text pitch)
272 (number->string (+ (cadr pitch) (if (= (car pitch) 0) 1 8)))
280 (define (pitch->text-banter pitch)
283 (define (step->text-banter pitch)
284 (if (= (cadr pitch) 6)
293 (define pitch::semitone-vec (list->vector '(0 2 4 5 7 9 11)))
295 (define (pitch::semitone pitch)
296 (+ (* (car pitch) 12)
297 (vector-ref pitch::semitone-vec (modulo (cadr pitch) 7))
300 (define (pitch::transpose pitch delta)
301 (let ((simple-octave (+ (car pitch) (car delta)))
302 (simple-notename (+ (cadr pitch) (cadr delta))))
303 (let ((octave (+ simple-octave (quotient simple-notename 7)))
304 (notename (modulo simple-notename 7)))
305 (let ((accidental (- (+ (pitch::semitone pitch) (pitch::semitone delta))
306 (pitch::semitone `(,octave ,notename 0)))))
307 `(,octave ,notename ,accidental)))))
309 (define (pitch::diff pitch tonic)
310 (let ((simple-octave (- (car pitch) (car tonic)))
311 (simple-notename (- (cadr pitch) (cadr tonic))))
312 (let ((octave (+ simple-octave (quotient simple-notename 7)
313 (if (< simple-notename 0) -1 0)))
314 (notename (modulo simple-notename 7)))
315 (let ((accidental (- (pitch::semitone pitch)
316 (pitch::semitone tonic)
317 (pitch::semitone `(,octave ,notename 0)))))
318 `(,octave ,notename ,accidental)))))
320 (define (pitch::note-pitch pitch)
321 (+ (* (car pitch) 7) (cadr pitch)))
323 (define (chord::step tonic pitch)
324 (- (pitch::note-pitch pitch) (pitch::note-pitch tonic)))
326 ;; text: list of word
327 ;; word: string + optional list of property
328 ;; property: align, kern, font (?), size
330 (define chord::minor-major-vec (list->vector '(0 -1 -1 0 -1 -1 0)))
332 ;; compute the relative-to-tonic pitch that goes with 'step'
333 (define (chord::step-pitch tonic step)
334 ;; urg, we only do this for thirds
335 (if (= (modulo step 2) 0)
337 (let loop ((i 1) (pitch tonic))
341 pitch `(0 2 ,(vector-ref chord::minor-major-vec
342 ;; -1 (step=1 -> vector=0) + 7 = 6
343 (modulo (+ i 6) 7)))))))))
345 ;; find the pitches that are not part of `normal' chord
346 (define (chord::additions chord-pitches)
347 (let ((tonic (car chord-pitches)))
348 ;; walk the chord steps: 1, 3, 5
349 (let loop ((step 1) (pitches chord-pitches) (additions '()))
351 (let* ((pitch (car pitches))
352 (p-step (+ (- (pitch::note-pitch pitch)
353 (pitch::note-pitch tonic))
355 ;; pitch is an addition if
357 ;; it comes before this step or
359 ;; its step is even or
360 (= (modulo p-step 2) 0)
361 ;; has same step, but different accidental or
363 (not (equal? pitch (chord::step-pitch tonic step))))
364 ;; is the last of the chord and not one of base thirds
366 (= (length pitches) 1)))
367 (loop step (cdr pitches) (cons pitch additions))
369 (loop step (cdr pitches) additions)
370 (loop (+ step 2) pitches additions))))
371 (reverse additions)))))
373 ;; find the pitches that are missing from `normal' chord
374 (define (chord::subtractions chord-pitches)
375 (let ((tonic (car chord-pitches)))
376 (let loop ((step 1) (pitches chord-pitches) (subtractions '()))
378 (let* ((pitch (car pitches))
379 (p-step (+ (- (pitch::note-pitch pitch)
380 (pitch::note-pitch tonic))
382 ;; pitch is an subtraction if
383 ;; a step is missing or
385 (loop (+ step 2) pitches
386 (cons (chord::step-pitch tonic step) subtractions))
387 ;; there are no pitches left, but base thirds are not yet done and
389 (= (length pitches) 1))
390 ;; present pitch is not missing step
392 (loop (+ step 2) pitches subtractions)
393 (loop (+ step 2) pitches
394 (cons (chord::step-pitch tonic step) subtractions)))
396 (loop (+ step 2) (cdr pitches) subtractions)
397 (loop step (cdr pitches) subtractions)))))
398 (reverse subtractions)))))
400 ;; combine tonic, user-specified chordname,
401 ;; additions, subtractions and base or inversion to chord name
403 (define (chord::inner-name-banter tonic user-name additions subtractions base-and-inversion)
406 (pitch->text-banter tonic)
407 (if user-name user-name '())
408 ;; why does list->string not work, format seems only hope...
409 (if (and (string-match "super" (format "~s" user-name))
410 (or (pair? additions)
411 (pair? subtractions)))
414 (let loop ((from additions) (to '()))
416 (let ((p (car from)))
420 (list 'super (step->text-banter p))
421 (if (or (pair? (cdr from))
422 (pair? subtractions))
426 (let loop ((from subtractions) (to '()))
428 (let ((p (car from)))
433 (list 'super (step->text-banter p))
434 (if (pair? (cdr from))
438 (if (and (pair? base-and-inversion)
439 (or (car base-and-inversion)
440 (cdr base-and-inversion)))
442 (if (car base-and-inversion)
444 (car base-and-inversion))
446 (cdr base-and-inversion)))
451 (define (chord::name-banter tonic user-name pitches base-and-inversion)
452 (let ((additions (chord::additions pitches))
453 (subtractions (chord::subtractions pitches)))
454 (chord::inner-name-banter tonic user-name additions subtractions base-and-inversion)))
456 ;; american chordnames use no "no",
457 ;; but otherwise very similar to banter for now
458 (define (chord::name-american tonic user-name pitches base-and-inversion)
459 (let ((additions (chord::additions pitches))
461 (chord::inner-name-banter tonic user-name additions subtractions base-and-inversion)))
463 ;; Jazz style--basically similar to american with minor changes
464 (define (chord::name-jazz tonic user-name pitches base-and-inversion)
465 (let ((additions (chord::additions pitches))
467 (chord::inner-name-banter tonic user-name additions subtractions base-and-inversion)))
469 (define (new-to-old-pitch p)
471 (list (pitch-octave p) (pitch-notename p) (pitch-alteration p))
479 ;; Check for each subset of chord, full chord first, if there's a
480 ;; user-override. Split the chord into user-overridden and to-be-done
481 ;; parts, complete the missing user-override matched part with normal
482 ;; chord to be name-calculated.
484 ;; CHORD: (pitches (base . inversion))
485 (define (default-chord-name-function style chord)
486 (let* ((pitches (map new-to-old-pitch (car chord)))
487 (modifiers (cdr chord))
488 (base-and-inversion (if (pair? modifiers)
489 (cons (new-to-old-pitch (car modifiers))
490 (new-to-old-pitch (cdr modifiers)))
492 (diff (pitch::diff '(0 0 0) (car pitches)))
494 (ly-eval (string->symbol (string-append "chord::name-" style))))
496 (ly-eval (string->symbol (string-append "chord::names-alist-" style)))))
497 (let loop ((note-names (reverse pitches))
500 (if (pair? note-names)
504 (pitch->note-name (pitch::transpose x diff)))
508 ;; urg? found: break loop
509 (loop '() chord (cdr entry))
510 (loop (cdr note-names) (cons (car note-names) chord) #f)))
511 (let* ((transposed (if pitches
512 (map (lambda (x) (pitch::transpose x diff)) chord)
514 (matched (if (= (length chord) 0)
516 (- (length pitches) (length chord))))
518 (append (do ((i matched (- i 1))
519 (base '() (cons `(0 ,(* (- i 1) 2) 0) base)))
523 (name-func (car pitches) user-name completed base-and-inversion))))))