1 ;;;; This file is part of LilyPond, the GNU music typesetter.
3 ;;;; Copyright (C) 2004--2011 Han-Wen Nienhuys <hanwen@xs4all.nl>
5 ;;;; LilyPond is free software: you can redistribute it and/or modify
6 ;;;; it under the terms of the GNU General Public License as published by
7 ;;;; the Free Software Foundation, either version 3 of the License, or
8 ;;;; (at your option) any later version.
10 ;;;; LilyPond is distributed in the hope that it will be useful,
11 ;;;; but WITHOUT ANY WARRANTY; without even the implied warranty of
12 ;;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 ;;;; GNU General Public License for more details.
15 ;;;; You should have received a copy of the GNU General Public License
16 ;;;; along with LilyPond. If not, see <http://www.gnu.org/licenses/>.
18 ;; todo: figure out how to make module,
19 ;; without breaking nested ly scopes
21 (define-class <Voice-state> ()
22 (event-list #:init-value '() #:accessor events #:init-keyword #:events)
23 (when-moment #:accessor when #:init-keyword #:when)
24 (tuning #:accessor tuning #:init-keyword #:tuning)
25 (split-index #:accessor split-index)
29 ;; spanner-state is an alist
30 ;; of (SYMBOL . RESULT-INDEX), which indicates where
31 ;; said spanner was started.
32 (spanner-state #:init-value '() #:accessor span-state))
34 (define-method (write (x <Voice-state> ) file)
35 (display (when x) file)
36 (display " evs = " file)
37 (display (events x) file)
38 (display " active = " file)
39 (display (span-state x) file)
42 (define-method (note-events (vs <Voice-state>))
44 (equal? (ly:event-property x 'class) 'note-event))
45 (filter f? (events vs)))
47 (define-method (previous-voice-state (vs <Voice-state>))
48 (let ((i (slot-ref vs 'vector-index))
49 (v (slot-ref vs 'state-vector)))
54 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
56 (define-class <Split-state> ()
57 ;; The automatically determined split configuration
58 (configuration #:init-value '() #:accessor configuration)
59 ;; Allow overriding split configuration, takes precedence over configuration
60 (forced-configuration #:init-value #f #:accessor forced-configuration)
61 (when-moment #:accessor when #:init-keyword #:when)
62 ;; voice-states are states starting with the Split-state or later
64 (is #:init-keyword #:voice-states #:accessor voice-states)
65 (synced #:init-keyword #:synced #:init-value #f #:getter synced?))
68 (define-method (write (x <Split-state> ) f)
71 (display (configuration x) f)
76 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
79 (define (previous-span-state vs)
80 (let ((p (previous-voice-state vs)))
81 (if p (span-state p) '())))
83 (define (make-voice-states evl)
84 (let ((vec (list->vector (map (lambda (v)
88 #:events (map car (cdr v))))
91 ((= i (vector-length vec)) vec)
92 (slot-set! (vector-ref vec i) 'vector-index i)
93 (slot-set! (vector-ref vec i) 'state-vector vec))))
95 (define (make-split-state vs1 vs2)
96 "Merge lists VS1 and VS2, containing Voice-state objects into vector
97 of Split-state objects, crosslinking the Split-state vector and
100 (define (helper ss-idx ss-list idx1 idx2)
101 (let* ((state1 (if (< idx1 (vector-length vs1)) (vector-ref vs1 idx1) #f))
102 (state2 (if (< idx2 (vector-length vs2)) (vector-ref vs2 idx2) #f))
103 (min (cond ((and state1 state2) (moment-min (when state1) (when state2)))
104 (state1 (when state1))
105 (state2 (when state2))
107 (inc1 (if (and state1 (equal? min (when state1))) 1 0))
108 (inc2 (if (and state2 (equal? min (when state2))) 1 0))
112 #:voice-states (cons state1 state2)
113 #:synced (= inc1 inc2))
116 (set! (split-index state1) ss-idx))
118 (set! (split-index state2) ss-idx))
121 (cons ss-object ss-list)
125 (list->vector (reverse! (helper 0 '() 0 0) '())))
127 (define (analyse-spanner-states voice-state-vec)
129 (define (helper index active)
130 "Analyse EVS at INDEX, given state ACTIVE."
132 (define (analyse-tie-start active ev)
133 (if (equal? (ly:event-property ev 'class) 'tie-event)
134 (acons 'tie (split-index (vector-ref voice-state-vec index))
138 (define (analyse-tie-end active ev)
139 (if (equal? (ly:event-property ev 'class) 'note-event)
140 (assoc-remove! active 'tie)
143 (define (analyse-absdyn-end active ev)
144 (if (or (equal? (ly:event-property ev 'class) 'absolute-dynamic-event)
145 (and (equal? (ly:event-property ev 'class) 'crescendo-event)
146 (equal? STOP (ly:event-property ev 'span-direction))))
147 (assoc-remove! (assoc-remove! active 'cresc) 'decr)
150 (define (active<? a b)
151 (cond ((symbol<? (car a) (car b)) #t)
152 ((symbol<? (car b) (car b)) #f)
153 (else (< (cdr a) (cdr b)))))
155 (define (analyse-span-event active ev)
156 (let* ((name (ly:event-property ev 'class))
157 (key (cond ((equal? name 'slur-event) 'slur)
158 ((equal? name 'phrasing-slur-event) 'tie)
159 ((equal? name 'beam-event) 'beam)
160 ((equal? name 'crescendo-event) 'cresc)
161 ((equal? name 'decrescendo-event) 'decr)
163 (sp (ly:event-property ev 'span-direction)))
164 (if (and (symbol? key) (ly:dir? sp))
166 (assoc-remove! active key)
168 (split-index (vector-ref voice-state-vec index))
172 (define (analyse-events active evs)
173 "Run all analyzers on ACTIVE and EVS"
174 (define (run-analyzer analyzer active evs)
176 (run-analyzer analyzer (analyzer active (car evs)) (cdr evs))
178 (define (run-analyzers analyzers active evs)
179 (if (pair? analyzers)
180 (run-analyzers (cdr analyzers)
181 (run-analyzer (car analyzers) active evs)
184 (sort ;; todo: use fold or somesuch.
185 (run-analyzers (list analyse-absdyn-end analyse-span-event
186 ;; note: tie-start/span comes after tie-end/absdyn.
187 analyse-tie-end analyse-tie-start)
191 ;; must copy, since we use assoc-remove!
192 (if (< index (vector-length voice-state-vec))
194 (set! active (analyse-events active (events (vector-ref voice-state-vec index))))
195 (set! (span-state (vector-ref voice-state-vec index))
197 (helper (1+ index) active))))
201 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
202 (define-public (recording-group-emulate music odef)
203 "Interpret @var{music} according to @var{odef}, but store all events
204 in a chronological list, similar to the @code{Recording_group_engraver} in
205 LilyPond version 2.8 and earlier."
208 (now-mom (ly:make-moment 0 0))
209 (global (ly:make-global-context odef))
210 (mom-listener (ly:make-listener
211 (lambda (tev) (set! now-mom (ly:event-property tev 'moment)))))
212 (new-context-listener
216 ((child (ly:event-property sev 'context))
217 (this-moment-list (cons (ly:context-id child) '()))
218 (dummy (set! context-list (cons this-moment-list context-list)))
220 (accumulate-event-listener
221 (ly:make-listener (lambda (ev)
222 (set! acc (cons (cons ev #t) acc)))))
224 (ly:make-listener (lambda (tev)
228 (ly:context-property child 'instrumentTransposition))
229 ;; The accumulate-event-listener above creates
230 ;; the list of events in reverse order, so we
231 ;; have to revert it to the original order again
233 (set-cdr! this-moment-list
234 (cons this-moment (cdr this-moment-list)))
236 (ly:add-listener accumulate-event-listener
237 (ly:context-event-source child) 'StreamEvent)
238 (ly:add-listener save-acc-listener
239 (ly:context-event-source global) 'OneTimeStep))))))
240 (ly:add-listener new-context-listener
241 (ly:context-events-below global) 'AnnounceNewContext)
242 (ly:add-listener mom-listener (ly:context-event-source global) 'Prepare)
243 (ly:interpret-music-expression (make-non-relative-music music) global)
246 (define-public (make-part-combine-music parser music-list)
247 (let* ((m (make-music 'PartCombineMusic))
248 (m1 (make-non-relative-music (context-spec-music (first music-list) 'Voice "one")))
249 (m2 (make-non-relative-music (context-spec-music (second music-list) 'Voice "two")))
250 (listener (ly:parser-lookup parser 'partCombineListener))
251 (evs2 (recording-group-emulate m2 listener))
252 (evs1 (recording-group-emulate m1 listener)))
254 (set! (ly:music-property m 'elements) (list m1 m2))
255 (set! (ly:music-property m 'split-list)
256 (if (and (assoc "one" evs1) (assoc "two" evs2))
257 (determine-split-list (reverse! (assoc-get "one" evs1) '())
258 (reverse! (assoc-get "two" evs2) '()))
262 (define-public (determine-split-list evl1 evl2)
263 "@var{evl1} and @var{evl2} should be ascending."
266 (voice-state-vec1 (make-voice-states evl1))
267 (voice-state-vec2 (make-voice-states evl2))
268 (result (make-split-state voice-state-vec1 voice-state-vec2)))
270 ;; Go through all moments recursively and check if the events of that
271 ;; moment contain a part-combine-force-event override. If so, store its
272 ;; value in the forced-configuration field, which will override. The
273 ;; previous configuration is used to determine non-terminated settings.
274 (define (analyse-forced-combine result-idx prev-res)
276 (define (get-forced-event x)
277 (if (ly:in-event-class? x 'part-combine-force-event)
278 (cons (ly:event-property x 'forced-type) (ly:event-property x 'once))
280 (define (part-combine-events vs)
283 (filter-map get-forced-event (events vs))))
284 ;; end part-combine-events
286 ;; forced-result: Take the previous config and analyse whether
287 ;; any change happened.... Return new once and permanent config
288 (define (forced-result evt state)
289 ;; sanity check, evt should always be (new-state . once)
290 (if (not (and (pair? evt) (pair? state)))
293 ;; Once-event, leave permanent state unchanged
294 (cons (car evt) (cdr state))
295 ;; permanent change, leave once state unchanged
296 (cons (car state) (car evt)))))
297 ;; end forced-combine-result
299 ;; body of analyse-forced-combine:
300 (if (< result-idx (vector-length result))
301 (let* ((now-state (vector-ref result result-idx)) ; current result
302 ;; Extract all part-combine force events
303 (ev1 (part-combine-events (car (voice-states now-state))))
304 (ev2 (part-combine-events (cdr (voice-states now-state))))
305 (evts (append ev1 ev2))
306 ;; result is (once-state permament-state):
307 (state (fold forced-result (cons 'automatic prev-res) evts))
308 ;; Now let once override permanent changes:
309 (force-state (if (equal? (car state) 'automatic)
312 (set! (forced-configuration (vector-ref result result-idx))
314 ;; For the next moment, ignore the once override (car stat)
315 ;; and pass on the permanent override, stored as (cdr state)
316 (analyse-forced-combine (1+ result-idx) (cdr state)))))
317 ;; end analyse-forced-combine
320 (define (analyse-time-step result-idx)
321 (define (put x . index)
322 "Put the result to X, starting from INDEX backwards.
324 Only set if not set previously.
326 (let ((i (if (pair? index) (car index) result-idx)))
328 (not (symbol? (configuration (vector-ref result i)))))
330 (set! (configuration (vector-ref result i)) x)
333 (define (copy-state-from state-vec vs)
334 (define (copy-one-state key-idx)
335 (let* ((idx (cdr key-idx))
336 (prev-ss (vector-ref result idx))
337 (prev (configuration prev-ss)))
340 (map copy-one-state (span-state vs)))
342 (define (analyse-notes now-state)
343 (let* ((vs1 (car (voice-states now-state)))
344 (vs2 (cdr (voice-states now-state)))
345 (notes1 (note-events vs1))
346 (durs1 (sort (map (lambda (x) (ly:event-property x 'duration))
349 (pitches1 (sort (map (lambda (x) (ly:event-property x 'pitch))
352 (notes2 (note-events vs2))
353 (durs2 (sort (map (lambda (x) (ly:event-property x 'duration))
356 (pitches2 (sort (map (lambda (x) (ly:event-property x 'pitch))
359 (cond ((> (length notes1) 1) (put 'apart))
360 ((> (length notes2) 1) (put 'apart))
361 ((= 1 (+ (length notes2) (length notes1))) (put 'apart))
362 ((and (= (length durs1) 1)
364 (not (equal? (car durs1) (car durs2))))
367 (if (and (= (length pitches1) (length pitches2)))
368 (if (and (pair? pitches1)
371 (< chord-threshold (ly:pitch-steps
372 (ly:pitch-diff (car pitches1)
376 (> 0 (ly:pitch-steps (ly:pitch-diff (car pitches1)
380 ;; copy previous split state from spanner state
382 (if (previous-voice-state vs1)
383 (copy-state-from voice-state-vec1
384 (previous-voice-state vs1)))
385 (if (previous-voice-state vs2)
386 (copy-state-from voice-state-vec2
387 (previous-voice-state vs2)))
388 (if (and (null? (span-state vs1)) (null? (span-state vs2)))
389 (put 'chords)))))))))
391 (if (< result-idx (vector-length result))
392 (let* ((now-state (vector-ref result result-idx))
393 (vs1 (car (voice-states now-state)))
394 (vs2 (cdr (voice-states now-state))))
396 (cond ((not vs1) (put 'apart))
397 ((not vs2) (put 'apart))
399 (let ((active1 (previous-span-state vs1))
400 (active2 (previous-span-state vs2))
401 (new-active1 (span-state vs1))
402 (new-active2 (span-state vs2)))
404 (display (list (when now-state) result-idx
405 active1 "->" new-active1
406 active2 "->" new-active2
408 (if (and (synced? now-state)
409 (equal? active1 active2)
410 (equal? new-active1 new-active2))
411 (analyse-notes now-state)
413 ;; active states different:
416 ;; go to the next one, if it exists.
417 (analyse-time-step (1+ result-idx)))))))
419 (define (analyse-a2 result-idx)
420 (if (< result-idx (vector-length result))
421 (let* ((now-state (vector-ref result result-idx))
422 (vs1 (car (voice-states now-state)))
423 (vs2 (cdr (voice-states now-state))))
424 (if (and (equal? (configuration now-state) 'chords)
426 (let ((notes1 (note-events vs1))
427 (notes2 (note-events vs2)))
428 (cond ((and (= 1 (length notes1))
429 (= 1 (length notes2))
430 (equal? (ly:event-property (car notes1) 'pitch)
431 (ly:event-property (car notes2) 'pitch)))
432 (set! (configuration now-state) 'unisono))
433 ((and (= 0 (length notes1))
434 (= 0 (length notes2)))
435 (set! (configuration now-state) 'unisilence)))))
436 (analyse-a2 (1+ result-idx)))))
438 (define (analyse-solo12 result-idx)
440 (define (previous-config vs)
441 (let* ((pvs (previous-voice-state vs))
442 (spi (if pvs (split-index pvs) #f))
443 (prev-split (if spi (vector-ref result spi) #f)))
445 (configuration prev-split)
448 (define (put-range x a b)
449 ;; (display (list "put range " x a b "\n"))
452 (set! (configuration (vector-ref result i)) x)))
455 ;; (display (list "putting " x "\n"))
456 (set! (configuration (vector-ref result result-idx)) x))
458 (define (current-voice-state now-state voice-num)
459 (define vs ((if (= 1 voice-num) car cdr)
460 (voice-states now-state)))
461 (if (or (not vs) (equal? (when now-state) (when vs)))
463 (previous-voice-state vs)))
465 (define (try-solo type start-idx current-idx)
466 "Find a maximum stretch that can be marked as solo. Only set
467 the mark when there are no spanners active.
469 return next idx to analyse.
471 (if (< current-idx (vector-length result))
472 (let* ((now-state (vector-ref result current-idx))
473 (solo-state (current-voice-state now-state (if (equal? type 'solo1) 1 2)))
474 (silent-state (current-voice-state now-state (if (equal? type 'solo1) 2 1)))
475 (silent-notes (if silent-state (note-events silent-state) '()))
476 (solo-notes (if solo-state (note-events solo-state) '())))
477 ;; (display (list "trying " type " at " (when now-state) solo-state silent-state "\n"))
478 (cond ((not (equal? (configuration now-state) 'apart))
480 ((> (length silent-notes) 0) start-idx)
482 (put-range type start-idx current-idx)
485 (null? (span-state solo-state)))
488 ;; This includes rests. This isn't a problem: long rests
489 ;; will be shared with the silent voice, and be marked
490 ;; as unisilence. Therefore, long rests won't
491 ;; accidentally be part of a solo.
493 (put-range type start-idx current-idx)
494 (try-solo type (1+ current-idx) (1+ current-idx)))
496 (try-solo type start-idx (1+ current-idx)))))
500 (define (analyse-moment result-idx)
501 "Analyse 'apart starting at RESULT-IDX. Return next index."
502 (let* ((now-state (vector-ref result result-idx))
503 (vs1 (current-voice-state now-state 1))
504 (vs2 (current-voice-state now-state 2))
505 ;; (vs1 (car (voice-states now-state)))
506 ;; (vs2 (cdr (voice-states now-state)))
507 (notes1 (if vs1 (note-events vs1) '()))
508 (notes2 (if vs2 (note-events vs2) '()))
510 (n2 (length notes2)))
511 ;; (display (list "analyzing step " result-idx " moment " (when now-state) vs1 vs2 "\n"))
513 ;; we should always increase.
514 (cond ((and (= n1 0) (= n2 0))
518 (equal? (when vs1) (when now-state))
519 (null? (previous-span-state vs1)))
520 (try-solo 'solo1 result-idx result-idx))
522 (equal? (when vs2) (when now-state))
523 (null? (previous-span-state vs2)))
524 (try-solo 'solo2 result-idx result-idx))
526 (else (1+ result-idx)))
530 (if (< result-idx (vector-length result))
531 (if (equal? (configuration (vector-ref result result-idx)) 'apart)
532 (analyse-solo12 (analyse-moment result-idx))
533 (analyse-solo12 (1+ result-idx))))) ; analyse-solo12
535 (analyse-spanner-states voice-state-vec1)
536 (analyse-spanner-states voice-state-vec2)
539 (display voice-state-vec1)
541 (display voice-state-vec2)
546 ;; Extract all forced combine strategies, i.e. events inserted by
547 ;; \partcombine(Apart|Automatic|SoloI|SoloII|Chords)[Once]
548 ;; They will in the end override the automaically determined ones.
549 ;; Initial state for both voices is no override
550 (analyse-forced-combine 0 #f)
551 ;; Now go through all time steps in a loop and find a combination strategy
552 ;; based only on the events of that one moment (i.e. neglecting longer
553 ;; periods of solo/apart, etc.)
554 (analyse-time-step 0)
556 ;; Check for unisono or unisilence moments
562 ;; forced-configuration overrides, if it is set
563 (lambda (x) (cons (when x) (or (forced-configuration x) (configuration x))))
564 (vector->list result)))
570 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
572 (define-public (add-quotable parser name mus)
573 (let* ((tab (eval 'musicQuotes (current-module)))
574 (context-list (recording-group-emulate (context-spec-music mus 'Voice)
575 (ly:parser-lookup parser 'partCombineListener))))
576 (if (pair? context-list)
578 ;; cdr : skip name string
579 (list->vector (reverse! (cdar context-list)