1 ;;; define-music-display-methods.scm -- data for displaying music
2 ;;; expressions using LilyPond notation.
4 ;;; Copyright (C) 2005--2011 Nicolas Sceaux <nicolas.sceaux@free.fr>
7 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
9 ;;; Display method implementation
12 (define-module (scm display-lily))
17 (define (scheme-expr->lily-string scm-arg)
18 (cond ((or (number? scm-arg)
20 (format #f "~s" scm-arg))
21 ((or (symbol? scm-arg)
23 (format #f "'~s" scm-arg))
26 (or (procedure-name scm-arg)
27 (with-output-to-string
29 (pretty-print (procedure-source scm-arg)))))))
32 (with-output-to-string
34 (display-scheme-music scm-arg)))))))
39 (define-public (markup->lily-string markup-expr)
40 "Return a string describing, in LilyPond syntax, the given markup
42 (define (proc->command proc)
43 (let ((cmd-markup (symbol->string (procedure-name proc))))
44 (substring cmd-markup 0 (- (string-length cmd-markup)
45 (string-length "-markup")))))
46 (define (arg->string arg)
49 ((markup? arg) ;; a markup
50 (markup->lily-string-aux arg))
51 ((and (pair? arg) (every markup? arg)) ;; a markup list
52 (format #f "{~{ ~a~}}" (map-in-order markup->lily-string-aux arg)))
53 (else ;; a scheme argument
54 (format #f "#~a" (scheme-expr->lily-string arg)))))
55 (define (markup->lily-string-aux expr)
58 (let ((cmd (car expr))
60 (if (eqv? cmd simple-markup) ;; a simple markup
61 (format #f "~s" (car args))
62 (format #f "\\~a~{ ~a~}"
64 (map-in-order arg->string args))))))
65 (cond ((string? markup-expr)
66 (format #f "~s" markup-expr))
67 ((eqv? (car markup-expr) simple-markup)
68 (format #f "~s" (second markup-expr)))
70 (format #f "\\markup ~a"
71 (markup->lily-string-aux markup-expr)))))
77 ;; It is a pity that there is no rassoc in Scheme.
78 (define* (rassoc item alist #:optional (test equal?))
79 (do ((alist alist (cdr alist))
81 ((or result (null? alist)) result)
82 (if (and (car alist) (test item (cdar alist)))
83 (set! result (car alist)))))
85 (define-public (note-name->lily-string ly-pitch parser)
86 ;; here we define a custom pitch= function, since we do not want to
87 ;; test whether octaves are also equal. (otherwise, we would be using equal?)
88 (define (pitch= pitch1 pitch2)
89 (and (= (ly:pitch-notename pitch1) (ly:pitch-notename pitch2))
90 (= (ly:pitch-alteration pitch1) (ly:pitch-alteration pitch2))))
91 (let ((result (rassoc ly-pitch (ly:parser-lookup parser 'pitchnames) pitch=)))
96 (define-public (octave->lily-string pitch)
97 (let ((octave (ly:pitch-octave pitch)))
99 (make-string (1+ octave) #\'))
101 (make-string (1- (* -1 octave)) #\,))
107 (define*-public (duration->lily-string ly-duration #:key (prev-duration (*previous-duration*))
108 (force-duration (*force-duration*))
109 (time-factor-numerator (*time-factor-numerator*))
110 (time-factor-denominator (*time-factor-denominator*)))
111 (let ((log2 (ly:duration-log ly-duration))
112 (dots (ly:duration-dot-count ly-duration))
113 (num+den (ly:duration-factor ly-duration)))
114 (if (or force-duration (not prev-duration) (not (equal? ly-duration prev-duration)))
115 (string-append (case log2
119 (else (number->string (expt 2 log2))))
120 (make-string dots #\.)
121 (let ((num? (not (or (= 1 (car num+den))
122 (and time-factor-numerator
123 (= (car num+den) time-factor-numerator)))))
124 (den? (not (or (= 1 (cdr num+den))
125 (and time-factor-denominator
126 (= (cdr num+den) time-factor-denominator))))))
128 (format #f "*~a/~a" (car num+den) (cdr num+den)))
130 (format #f "*~a" (car num+den)))
139 (make-music-type-predicate
140 'AbsoluteDynamicEvent
154 'MultiMeasureTextEvent
169 (define* (event-direction->lily-string event #:optional (required #t))
170 (let ((direction (ly:music-property event 'direction)))
171 (cond ((or (not direction) (null? direction) (= CENTER direction))
172 (if required "-" ""))
173 ((= UP direction) "^")
174 ((= DOWN direction) "_")
177 (define-macro (define-post-event-display-method type vars direction-required str)
178 `(define-display-method ,type ,vars
180 (event-direction->lily-string ,(car vars) ,direction-required)
183 (define-macro (define-span-event-display-method type vars direction-required str-start str-stop)
184 `(define-display-method ,type ,vars
186 (event-direction->lily-string ,(car vars) ,direction-required)
187 (if (= START (ly:music-property ,(car vars) 'span-direction))
191 (define-display-method HyphenEvent (event parser)
193 (define-display-method ExtenderEvent (event parser)
195 (define-display-method TieEvent (event parser)
197 (define-display-method BeamForbidEvent (event parser)
199 (define-display-method StringNumberEvent (event parser)
200 (format #f "\\~a" (ly:music-property event 'string-number)))
203 (define-display-method TremoloEvent (event parser)
204 (let ((tremolo-type (ly:music-property event 'tremolo-type)))
205 (format #f ":~a" (if (= 0 tremolo-type)
209 (define-post-event-display-method ArticulationEvent (event parser) #t
210 (let ((articulation (ly:music-property event 'articulation-type)))
211 (case (string->symbol articulation)
215 ((staccatissimo) "|")
219 (else (format #f "\\~a" articulation)))))
221 (define-post-event-display-method FingeringEvent (event parser) #t
222 (ly:music-property event 'digit))
224 (define-post-event-display-method TextScriptEvent (event parser) #t
225 (markup->lily-string (ly:music-property event 'text)))
227 (define-post-event-display-method MultiMeasureTextEvent (event parser) #t
228 (markup->lily-string (ly:music-property event 'text)))
230 (define-post-event-display-method BendAfterEvent (event parser) #t
231 (format #f "\\bendAfter #~a" (ly:music-property event 'delta-step)))
233 (define-post-event-display-method HarmonicEvent (event parser) #f "\\harmonic")
234 (define-post-event-display-method GlissandoEvent (event parser) #t "\\glissando")
235 (define-post-event-display-method ArpeggioEvent (event parser) #t "\\arpeggio")
236 (define-post-event-display-method AbsoluteDynamicEvent (event parser) #f
237 (format #f "\\~a" (ly:music-property event 'text)))
239 (define-span-event-display-method BeamEvent (event parser) #f "[" "]")
240 (define-span-event-display-method SlurEvent (event parser) #f "(" ")")
241 (define-span-event-display-method CrescendoEvent (event parser) #f "\\<" "\\!")
242 (define-span-event-display-method DecrescendoEvent (event parser) #f "\\>" "\\!")
243 (define-span-event-display-method EpisemaEvent (event parser) #f "\\episemInitium" "\\episemFinis")
244 (define-span-event-display-method PhrasingSlurEvent (event parser) #f "\\(" "\\)")
245 (define-span-event-display-method SustainEvent (event parser) #f "\\sustainOn" "\\sustainOff")
246 (define-span-event-display-method SostenutoEvent (event parser) #f "\\sostenutoOn" "\\sostenutoOff")
247 (define-span-event-display-method TextSpanEvent (event parser) #f "\\startTextSpan" "\\stopTextSpan")
248 (define-span-event-display-method TrillSpanEvent (event parser) #f "\\startTrillSpan" "\\stopTrillSpan")
249 (define-span-event-display-method StaffSpanEvent (event parser) #f "\\startStaff" "\\stopStaff")
250 (define-span-event-display-method NoteGroupingEvent (event parser) #f "\\startGroup" "\\stopGroup")
251 (define-span-event-display-method UnaCordaEvent (event parser) #f "\\unaCorda" "\\treCorde")
257 (define-display-method GraceMusic (expr parser)
258 (format #f "\\grace ~a"
259 (music->lily-string (ly:music-property expr 'element) parser)))
261 ;; \acciaccatura \appoggiatura \grace
262 ;; TODO: it would be better to compare ?start and ?stop
263 ;; with startAppoggiaturaMusic and stopAppoggiaturaMusic,
264 ;; using a custom music equality predicate.
265 (define-extra-display-method GraceMusic (expr parser)
266 "Display method for appoggiatura."
267 (with-music-match (expr (music
274 ;; we check whether ?start and ?stop look like
275 ;; startAppoggiaturaMusic stopAppoggiaturaMusic
276 (and (with-music-match (?start (music
282 duration (ly:make-duration 0 0 0 1))
285 span-direction START))))))
287 (with-music-match (?stop (music
293 duration (ly:make-duration 0 0 0 1))
296 span-direction STOP))))))
297 (format #f "\\appoggiatura ~a" (music->lily-string ?music parser))))))
300 (define-extra-display-method GraceMusic (expr parser)
301 "Display method for acciaccatura."
302 (with-music-match (expr (music
309 ;; we check whether ?start and ?stop look like
310 ;; startAcciaccaturaMusic stopAcciaccaturaMusic
311 (and (with-music-match (?start (music
317 duration (ly:make-duration 0 0 0 1))
320 span-direction START)))
325 grob-property-path '(stroke-style)
329 (with-music-match (?stop (music
335 grob-property-path '(stroke-style)
341 duration (ly:make-duration 0 0 0 1))
344 span-direction STOP))))))
345 (format #f "\\acciaccatura ~a" (music->lily-string ?music parser))))))
347 (define-extra-display-method GraceMusic (expr parser)
348 "Display method for grace."
349 (with-music-match (expr (music
356 ;; we check whether ?start and ?stop look like
357 ;; startGraceMusic stopGraceMusic
358 (and (null? (ly:music-property ?start 'elements))
359 (null? (ly:music-property ?stop 'elements))
360 (format #f "\\grace ~a" (music->lily-string ?music parser)))))
366 (define-display-method SequentialMusic (seq parser)
367 (let ((force-line-break (and (*force-line-break*)
369 (> (length (ly:music-property seq 'elements))
370 (*max-element-number-before-break*))))
371 (elements (ly:music-property seq 'elements))
372 (chord? (make-music-type-predicate 'EventChord))
373 (cluster? (make-music-type-predicate 'ClusterNoteEvent))
374 (note? (make-music-type-predicate 'NoteEvent)))
375 (format #f "~a~a{~v%~v_~{~a ~}~v%~v_}"
378 (any cluster? (ly:music-property e 'elements))))
382 (if (*explicit-mode*)
383 ;; if the sequence contains EventChord which contains figures ==> figuremode
384 ;; if the sequence contains EventChord which contains lyrics ==> lyricmode
385 ;; if the sequence contains EventChord which contains drum notes ==> drummode
386 (cond ((any (lambda (chord)
387 (any (make-music-type-predicate 'BassFigureEvent)
388 (ly:music-property chord 'elements)))
389 (filter chord? elements))
391 ((any (lambda (chord)
392 (any (make-music-type-predicate 'LyricEvent)
393 (ly:music-property chord 'elements)))
394 (filter chord? elements))
396 ((any (lambda (chord)
399 (not (null? (ly:music-property event 'drum-type)))))
400 (ly:music-property chord 'elements)))
401 (filter chord? elements))
403 (else ;; TODO: other modes?
406 (if force-line-break 1 0)
407 (if force-line-break (+ 2 (*indent*)) 1)
408 (parameterize ((*indent* (+ 2 (*indent*))))
409 (map-in-order (lambda (music)
410 (music->lily-string music parser))
412 (if force-line-break 1 0)
413 (if force-line-break (*indent*) 0))))
415 (define-display-method SimultaneousMusic (sim parser)
416 (parameterize ((*indent* (+ 3 (*indent*))))
417 (format #f "<< ~{~a ~}>>"
418 (map-in-order (lambda (music)
419 (music->lily-string music parser))
420 (ly:music-property sim 'elements)))))
422 (define-extra-display-method SimultaneousMusic (expr parser)
423 "If `sim' is an \afterGrace expression, return \"\\afterGrace ...\".
424 Otherwise, return #f."
425 ;; TODO: do something with afterGraceFraction?
426 (with-music-match (expr (music 'SimultaneousMusic
427 elements (?before-grace
428 (music 'SequentialMusic
429 elements ((music 'SkipMusic)
432 (format #f "\\afterGrace ~a ~a"
433 (music->lily-string ?before-grace parser)
434 (music->lily-string ?grace parser))))
440 (define-display-method EventChord (chord parser)
441 ;; event_chord : simple_element post_events
443 ;; | note_chord_element
445 ;; TODO : tagged post_events
446 ;; post_events : ( post_event | tagged_post_event )*
447 ;; tagged_post_event: '-' \tag embedded_scm post_event
449 (let* ((elements (ly:music-property chord 'elements))
450 (simple-elements (filter (make-music-type-predicate
451 'NoteEvent 'ClusterNoteEvent 'RestEvent
452 'MultiMeasureRestEvent 'SkipEvent 'LyricEvent)
454 (if ((make-music-type-predicate 'StaffSpanEvent 'BreathingEvent) (car elements))
455 ;; first, a special case: StaffSpanEvent (\startStaff, \stopStaff)
456 ;; and BreathingEvent (\breathe)
457 (music->lily-string (car elements) parser)
458 (if (and (not (null? simple-elements))
459 (null? (cdr simple-elements))
460 ;; special case: if this simple_element has a HarmonicEvent in its
461 ;; 'articulations list, it should be interpreted instead as a
462 ;; note_chord_element, since \harmonic only works inside chords,
463 ;; even for single notes, e.g., < c\harmonic >
464 (null? (filter (make-music-type-predicate 'HarmonicEvent)
465 (ly:music-property (car simple-elements) 'articulations))))
466 ;; simple_element : note | figure | rest | mmrest | lyric_element | skip
467 (let* ((simple-element (car simple-elements))
468 (duration (ly:music-property simple-element 'duration))
469 (lily-string (format #f "~a~a~a~{~a ~}"
470 (music->lily-string simple-element parser)
471 (duration->lily-string duration)
472 (if (and ((make-music-type-predicate 'RestEvent) simple-element)
473 (ly:pitch? (ly:music-property simple-element 'pitch)))
476 (map-in-order (lambda (music)
477 (music->lily-string music parser))
478 (filter post-event? elements)))))
479 (*previous-duration* duration)
481 (let ((chord-elements (filter (make-music-type-predicate
482 'NoteEvent 'ClusterNoteEvent 'BassFigureEvent)
484 (post-events (filter post-event? elements)))
485 (if (not (null? chord-elements))
486 ;; note_chord_element : '<' (notepitch | drumpitch)* '>" duration post_events
487 (let ((lily-string (format #f "< ~{~a ~}>~a~{~a ~}"
488 (map-in-order (lambda (music)
489 (music->lily-string music parser))
491 (duration->lily-string (ly:music-property (car chord-elements)
493 (map-in-order (lambda (music)
494 (music->lily-string music parser))
496 (*previous-duration* (ly:music-property (car chord-elements) 'duration))
499 (format #f "~{~a ~}" (map-in-order (lambda (music)
500 (music->lily-string music parser))
503 (define-display-method MultiMeasureRestMusic (mmrest parser)
504 (let* ((dur (ly:music-property mmrest 'duration))
505 (ly (format #f "R~a~{~a ~}"
506 (duration->lily-string dur)
507 (map-in-order (lambda (music)
508 (music->lily-string music parser))
509 (ly:music-property mmrest 'articulations)))))
510 (*previous-duration* dur)
513 (define-display-method SkipMusic (skip parser)
514 (format #f "\\skip ~a" (duration->lily-string (ly:music-property skip 'duration) #:force-duration #t)))
516 (define-display-method OttavaMusic (ottava parser)
517 (format #f "\\ottava #~a" (ly:music-property ottava 'ottava-number)))
520 ;;; Notes, rests, skips...
523 (define (simple-note->lily-string event parser)
524 (format #f "~a~a~a~a~{~a~}" ; pitchname octave !? octave-check articulations
525 (note-name->lily-string (ly:music-property event 'pitch) parser)
526 (octave->lily-string (ly:music-property event 'pitch))
527 (let ((forced (ly:music-property event 'force-accidental))
528 (cautionary (ly:music-property event 'cautionary)))
529 (cond ((and (not (null? forced))
531 (not (null? cautionary))
534 ((and (not (null? forced)) forced) "!")
536 (let ((octave-check (ly:music-property event 'absolute-octave)))
537 (if (not (null? octave-check))
538 (format #f "=~a" (cond ((>= octave-check 0)
539 (make-string (1+ octave-check) #\'))
541 (make-string (1- (* -1 octave-check)) #\,))
544 (map-in-order (lambda (event)
545 (music->lily-string event parser))
546 (ly:music-property event 'articulations))))
548 (define-display-method NoteEvent (note parser)
549 (cond ((not (null? (ly:music-property note 'pitch))) ;; note
550 (simple-note->lily-string note parser))
551 ((not (null? (ly:music-property note 'drum-type))) ;; drum
552 (format #f "~a" (ly:music-property note 'drum-type)))
556 (define-display-method ClusterNoteEvent (note parser)
557 (simple-note->lily-string note parser))
559 (define-display-method RestEvent (rest parser)
560 (if (not (null? (ly:music-property rest 'pitch)))
561 (simple-note->lily-string rest parser)
564 (define-display-method MultiMeasureRestEvent (rest parser)
567 (define-display-method SkipEvent (rest parser)
570 (define-display-method RepeatedChord (chord parser)
571 (music->lily-string (ly:music-property chord 'element) parser))
573 (define-display-method MarkEvent (mark parser)
574 (let ((label (ly:music-property mark 'label)))
577 (format #f "\\mark ~a" (markup->lily-string label)))))
579 (define-display-method KeyChangeEvent (key parser)
580 (let ((pitch-alist (ly:music-property key 'pitch-alist))
581 (tonic (ly:music-property key 'tonic)))
582 (if (or (null? pitch-alist)
585 (let ((c-pitch-alist (ly:transpose-key-alist pitch-alist
586 (ly:pitch-diff (ly:make-pitch 0 0 0) tonic))))
587 (format #f "\\key ~a \\~a~a"
588 (note-name->lily-string (ly:music-property key 'tonic) parser)
591 (equal? (ly:parser-lookup parser mode) c-pitch-alist))
592 (symbol->string mode)
594 '(major minor ionian locrian aeolian mixolydian lydian phrygian dorian))
595 (new-line->lily-string))))))
597 (define-display-method RelativeOctaveCheck (octave parser)
598 (let ((pitch (ly:music-property octave 'pitch)))
599 (format #f "\\octaveCheck ~a~a"
600 (note-name->lily-string pitch parser)
601 (octave->lily-string pitch))))
603 (define-display-method VoiceSeparator (sep parser)
606 (define-display-method LigatureEvent (ligature parser)
607 (if (= START (ly:music-property ligature 'span-direction))
611 (define-display-method BarCheck (check parser)
612 (format #f "|~a" (new-line->lily-string)))
614 (define-display-method PesOrFlexaEvent (expr parser)
617 (define-display-method BassFigureEvent (figure parser)
618 (let ((alteration (ly:music-property figure 'alteration))
619 (fig (ly:music-property figure 'figure))
620 (bracket-start (ly:music-property figure 'bracket-start))
621 (bracket-stop (ly:music-property figure 'bracket-stop)))
623 (format #f "~a~a~a~a"
624 (if (null? bracket-start) "" "[")
625 (cond ((null? fig) "_")
626 ((markup? fig) (second fig)) ;; fig: (<number-markup> "number")
628 (if (null? alteration)
631 ((= alteration DOUBLE-FLAT) "--")
632 ((= alteration FLAT) "-")
633 ((= alteration NATURAL) "!")
634 ((= alteration SHARP) "+")
635 ((= alteration DOUBLE-SHARP) "++")
637 (if (null? bracket-stop) "" "]"))))
639 (define-display-method LyricEvent (lyric parser)
640 (let ((text (ly:music-property lyric 'text)))
641 (if (or (string? text)
642 (eqv? (first text) simple-markup))
643 ;; a string or a simple markup
644 (let ((string (if (string? text)
647 (if (string-match "(\"| |[0-9])" string)
648 ;; TODO check exactly in which cases double quotes should be used
649 (format #f "~s" string)
651 (markup->lily-string text))))
653 (define-display-method BreathingEvent (event parser)
660 (define-display-method AutoChangeMusic (m parser)
661 (format #f "\\autochange ~a"
662 (music->lily-string (ly:music-property m 'element) parser)))
664 (define-display-method ContextChange (m parser)
665 (format #f "\\change ~a = \"~a\""
666 (ly:music-property m 'change-to-type)
667 (ly:music-property m 'change-to-id)))
671 (define-display-method TimeScaledMusic (times parser)
672 (let* ((num (ly:music-property times 'numerator))
673 (den (ly:music-property times 'denominator))
674 (nd-gcd (gcd num den)))
675 (parameterize ((*force-line-break* #f)
676 (*time-factor-numerator* (/ num nd-gcd))
677 (*time-factor-denominator* (/ den nd-gcd)))
678 (format #f "\\times ~a/~a ~a"
681 (music->lily-string (ly:music-property times 'element) parser)))))
683 (define-display-method RelativeOctaveMusic (m parser)
684 (music->lily-string (ly:music-property m 'element) parser))
686 (define-display-method TransposedMusic (m parser)
687 (music->lily-string (ly:music-property m 'element) parser))
693 (define (repeat->lily-string expr repeat-type parser)
694 (format #f "\\repeat ~a ~a ~a ~a"
696 (ly:music-property expr 'repeat-count)
697 (music->lily-string (ly:music-property expr 'element) parser)
698 (let ((alternatives (ly:music-property expr 'elements)))
699 (if (null? alternatives)
701 (format #f "\\alternative { ~{~a ~}}"
702 (map-in-order (lambda (music)
703 (music->lily-string music parser))
706 (define-display-method VoltaRepeatedMusic (expr parser)
707 (repeat->lily-string expr "volta" parser))
709 (define-display-method UnfoldedRepeatedMusic (expr parser)
710 (repeat->lily-string expr "unfold" parser))
712 (define-display-method PercentRepeatedMusic (expr parser)
713 (repeat->lily-string expr "percent" parser))
715 (define-display-method TremoloRepeatedMusic (expr parser)
716 (let* ((count (ly:music-property expr 'repeat-count))
717 (dots (if (= 0 (modulo count 3)) 0 1))
718 (shift (- (log2 (if (= 0 dots)
721 (element (ly:music-property expr 'element))
723 (if (eqv? (ly:music-property element 'name) 'SequentialMusic)
725 (set! shift (1- shift))
726 (set! den-mult (length (ly:music-property element 'elements)))))
727 (music-map (lambda (m)
728 (let ((duration (ly:music-property m 'duration)))
729 (if (ly:duration? duration)
730 (let* ((dlog (ly:duration-log duration))
731 (ddots (ly:duration-dot-count duration))
732 (dfactor (ly:duration-factor duration))
734 (dden (cdr dfactor)))
735 (set! (ly:music-property m 'duration)
736 (ly:make-duration (- dlog shift)
737 ddots ;;(- ddots dots) ; ????
739 (/ dden den-mult))))))
742 (format #f "\\repeat tremolo ~a ~a"
744 (music->lily-string element parser))))
750 (define-display-method ContextSpeccedMusic (expr parser)
751 (let ((id (ly:music-property expr 'context-id))
752 (create-new (ly:music-property expr 'create-new))
753 (music (ly:music-property expr 'element))
754 (operations (ly:music-property expr 'property-operations))
755 (ctype (ly:music-property expr 'context-type)))
756 (format #f "~a ~a~a~a ~a"
757 (if (and (not (null? create-new)) create-new)
763 (format #f " = ~s" id))
764 (if (null? operations)
766 (format #f " \\with {~{~a~}~%~v_}"
767 (parameterize ((*indent* (+ (*indent*) 2)))
769 (format #f "~%~v_\\~a ~s"
775 (parameterize ((*current-context* ctype))
776 (music->lily-string music parser)))))
778 ;; special cases: \figures \lyrics \drums
779 (define-extra-display-method ContextSpeccedMusic (expr parser)
780 (with-music-match (expr (music 'ContextSpeccedMusic
782 property-operations ?op
783 context-type ?context-type
786 (parameterize ((*explicit-mode* #f))
789 (format #f "\\figures ~a" (music->lily-string ?sequence parser)))
791 (format #f "\\lyrics ~a" (music->lily-string ?sequence parser)))
793 (format #f "\\drums ~a" (music->lily-string ?sequence parser)))
798 ;;; Context properties
800 (define-extra-display-method ContextSpeccedMusic (expr parser)
801 (let ((element (ly:music-property expr 'element))
802 (property-tuning? (make-music-type-predicate 'PropertySet
806 (sequence? (make-music-type-predicate 'SequentialMusic)))
807 (if (and (ly:music? element)
808 (or (property-tuning? element)
809 (and (sequence? element)
810 (every property-tuning? (ly:music-property element 'elements)))))
811 (parameterize ((*current-context* (ly:music-property expr 'context-type)))
812 (music->lily-string element parser))
815 (define (property-value->lily-string arg parser)
816 (cond ((ly:music? arg)
817 (music->lily-string arg parser))
819 (format #f "#~s" arg))
821 (markup->lily-string arg))
823 (format #f "#~a" (scheme-expr->lily-string arg)))))
825 (define-display-method PropertySet (expr parser)
826 (let ((property (ly:music-property expr 'symbol))
827 (value (ly:music-property expr 'value))
828 (once (ly:music-property expr 'once)))
829 (format #f "~a\\set ~a~a = ~a~a"
830 (if (and (not (null? once)))
833 (if (eqv? (*current-context*) 'Bottom)
835 (format #f "~a . " (*current-context*)))
837 (property-value->lily-string value parser)
838 (new-line->lily-string))))
840 (define-display-method PropertyUnset (expr parser)
841 (format #f "\\unset ~a~a~a"
842 (if (eqv? (*current-context*) 'Bottom)
844 (format #f "~a . " (*current-context*)))
845 (ly:music-property expr 'symbol)
846 (new-line->lily-string)))
848 ;;; Layout properties
850 (define-display-method OverrideProperty (expr parser)
851 (let* ((symbol (ly:music-property expr 'symbol))
852 (property-path (ly:music-property expr 'grob-property-path))
853 (properties (if (pair? property-path)
855 (list (ly:music-property expr 'grob-property))))
856 (value (ly:music-property expr 'grob-value))
857 (once (ly:music-property expr 'once)))
859 (format #f "~a\\override ~a~a #'~a = ~a~a"
864 (if (eqv? (*current-context*) 'Bottom)
866 (format #f "~a . " (*current-context*)))
868 (if (null? (cdr properties))
871 (property-value->lily-string value parser)
872 (new-line->lily-string))))
874 (define-display-method RevertProperty (expr parser)
875 (let ((symbol (ly:music-property expr 'symbol))
876 (properties (ly:music-property expr 'grob-property-path)))
877 (format #f "\\revert ~a~a #'~a~a"
878 (if (eqv? (*current-context*) 'Bottom)
880 (format #f "~a . " (*current-context*)))
882 (if (null? (cdr properties))
885 (new-line->lily-string))))
887 (define-display-method TimeSignatureMusic (expr parser)
888 (let* ((num (ly:music-property expr 'numerator))
889 (den (ly:music-property expr 'denominator))
890 (structure (ly:music-property expr 'beat-structure)))
891 (if (null? structure)
895 (new-line->lily-string))
897 "#(set-time-signature ~a ~a '~a)~a"
899 (new-line->lily-string)))))
901 ;;; \melisma and \melismaEnd
902 (define-extra-display-method ContextSpeccedMusic (expr parser)
903 "If expr is a melisma, return \"\\melisma\", otherwise, return #f."
904 (with-music-match (expr (music 'ContextSpeccedMusic
905 element (music 'PropertySet
907 symbol 'melismaBusy)))
910 (define-extra-display-method ContextSpeccedMusic (expr parser)
911 "If expr is a melisma end, return \"\\melismaEnd\", otherwise, return #f."
912 (with-music-match (expr (music 'ContextSpeccedMusic
913 element (music 'PropertyUnset
914 symbol 'melismaBusy)))
918 ;;; Check for all three different syntaxes of tempo:
919 ;;; \tempo string duration=note, \tempo duration=note and \tempo string
920 (define-extra-display-method ContextSpeccedMusic (expr parser)
921 "If expr is a tempo, return \"\\tempo x = nnn\", otherwise return #f."
922 (or (with-music-match (expr (music 'ContextSpeccedMusic
923 element (music 'SequentialMusic
924 elements ((music 'PropertySet
928 symbol 'tempoWholesPerMinute)
931 symbol 'tempoUnitDuration)
934 symbol 'tempoUnitCount)))))
935 (format #f "\\tempo ~a ~a = ~a"
936 (scheme-expr->lily-string ?unit-text)
937 (duration->lily-string ?unit-duration #:force-duration #t)
938 (if (number-pair? ?unit-count)
939 (format #f "~a ~~ ~a"
943 (with-music-match (expr (music 'ContextSpeccedMusic
944 element (music 'SequentialMusic
945 elements ((music 'PropertyUnset
948 symbol 'tempoWholesPerMinute)
951 symbol 'tempoUnitDuration)
954 symbol 'tempoUnitCount)))))
955 (format #f "\\tempo ~a = ~a"
956 (duration->lily-string ?unit-duration #:force-duration #t)
957 (if (number-pair? ?unit-count)
958 (format #f "~a ~~ ~a"
962 (with-music-match (expr (music 'ContextSpeccedMusic
963 element (music 'SequentialMusic
964 elements ((music 'PropertySet
966 symbol 'tempoText)))))
967 (format #f "\\tempo ~a" (scheme-expr->lily-string ?tempo-text)))))
970 (define clef-name-alist #f)
971 (define-public (memoize-clef-names clefs)
972 "Initialize @code{clef-name-alist}, if not already set."
973 (if (not clef-name-alist)
974 (set! clef-name-alist
975 (map (lambda (name+vals)
976 (cons (cdr name+vals)
980 (define-extra-display-method ContextSpeccedMusic (expr parser)
981 "If @var{expr} is a clef change, return \"\\clef ...\".
982 Otherwise, return @code{#f}."
983 (with-music-match (expr (music 'ContextSpeccedMusic
985 element (music 'SequentialMusic
986 elements ((music 'PropertySet
990 symbol 'middleCClefPosition)
993 symbol 'clefPosition)
995 value ?clef-octavation
996 symbol 'clefOctavation)
998 procedure ly:set-middle-C!)))))
999 (let ((clef-name (assoc-get (list ?clef-glyph ?clef-position 0)
1002 (format #f "\\clef \"~a~{~a~a~}\"~a"
1004 (cond ((= 0 ?clef-octavation)
1006 ((> ?clef-octavation 0)
1007 (list "^" (1+ ?clef-octavation)))
1009 (list "_" (- 1 ?clef-octavation))))
1010 (new-line->lily-string))
1014 (define-extra-display-method ContextSpeccedMusic (expr parser)
1015 "If `expr' is a bar, return \"\\bar ...\".
1016 Otherwise, return #f."
1017 (with-music-match (expr (music 'ContextSpeccedMusic
1018 context-type 'Timing
1019 element (music 'PropertySet
1022 (format #f "\\bar \"~a\"~a" ?bar-type (new-line->lily-string))))
1026 (define-extra-display-method ContextSpeccedMusic (expr parser)
1027 "If `expr' is a partial measure, return \"\\partial ...\".
1028 Otherwise, return #f."
1029 (with-music-match (expr (music
1030 'ContextSpeccedMusic
1032 'ContextSpeccedMusic
1033 context-type 'Timing
1036 partial-duration ?duration))))
1039 (format #f "\\partial ~a"
1040 (duration->lily-string ?duration #:force-duration #t)))))
1045 (define-display-method ApplyOutputEvent (applyoutput parser)
1046 (let ((proc (ly:music-property applyoutput 'procedure))
1047 (ctx (ly:music-property applyoutput 'context-type)))
1048 (format #f "\\applyOutput #'~a #~a"
1050 (or (procedure-name proc)
1051 (with-output-to-string
1053 (pretty-print (procedure-source proc))))))))
1055 (define-display-method ApplyContext (applycontext parser)
1056 (let ((proc (ly:music-property applycontext 'procedure)))
1057 (format #f "\\applyContext #~a"
1058 (or (procedure-name proc)
1059 (with-output-to-string
1061 (pretty-print (procedure-source proc))))))))
1064 (define-display-method PartCombineMusic (expr parser)
1065 (format #f "\\partcombine ~{~a ~}"
1066 (map-in-order (lambda (music)
1067 (music->lily-string music parser))
1068 (ly:music-property expr 'elements))))
1070 (define-extra-display-method PartCombineMusic (expr parser)
1071 (with-music-match (expr (music 'PartCombineMusic
1072 elements ((music 'UnrelativableMusic
1073 element (music 'ContextSpeccedMusic
1076 element ?sequence1))
1077 (music 'UnrelativableMusic
1078 element (music 'ContextSpeccedMusic
1081 element ?sequence2)))))
1082 (format #f "\\partcombine ~a~a~a"
1083 (music->lily-string ?sequence1 parser)
1084 (new-line->lily-string)
1085 (music->lily-string ?sequence2 parser))))
1087 (define-display-method UnrelativableMusic (expr parser)
1088 (music->lily-string (ly:music-property expr 'element) parser))
1091 (define-display-method QuoteMusic (expr parser)
1092 (or (with-music-match (expr (music
1094 quoted-voice-direction ?quoted-voice-direction
1095 quoted-music-name ?quoted-music-name
1096 quoted-context-id "cue"
1097 quoted-context-type 'Voice
1099 (format #f "\\cueDuring #~s #~a ~a"
1101 ?quoted-voice-direction
1102 (music->lily-string ?music parser)))
1103 (format #f "\\quoteDuring #~s ~a"
1104 (ly:music-property expr 'quoted-music-name)
1105 (music->lily-string (ly:music-property expr 'element) parser))))
1110 (define-display-method LineBreakEvent (expr parser)
1111 (if (null? (ly:music-property expr 'break-permission))
1115 (define-display-method PageBreakEvent (expr parser)
1116 (if (null? (ly:music-property expr 'break-permission))
1120 (define-display-method PageTurnEvent (expr parser)
1121 (if (null? (ly:music-property expr 'break-permission))
1125 (define-extra-display-method EventChord (expr parser)
1126 (with-music-match (expr (music 'EventChord
1127 elements ((music 'LineBreakEvent
1128 break-permission 'force)
1129 (music 'PageBreakEvent
1130 break-permission 'force))))
1133 (define-extra-display-method EventChord (expr parser)
1134 (with-music-match (expr (music 'EventChord
1135 elements ((music 'LineBreakEvent
1136 break-permission 'force)
1137 (music 'PageBreakEvent
1138 break-permission 'force)
1139 (music 'PageTurnEvent
1140 break-permission 'force))))
1148 (define-display-method LyricCombineMusic (expr parser)
1149 (format #f "\\lyricsto ~s ~a"
1150 (ly:music-property expr 'associated-context)
1151 (parameterize ((*explicit-mode* #f))
1152 (music->lily-string (ly:music-property expr 'element) parser))))
1155 (define-extra-display-method SimultaneousMusic (expr parser)
1156 (with-music-match (expr (music 'SimultaneousMusic
1157 elements ((music 'ContextSpeccedMusic
1160 element ?note-sequence)
1161 (music 'ContextSpeccedMusic
1162 context-type 'Lyrics
1164 element (music 'LyricCombineMusic
1165 associated-context ?associated-id
1166 element ?lyric-sequence)))))
1167 (if (string=? ?id ?associated-id)
1168 (format #f "~a~a \\addlyrics ~a"
1169 (music->lily-string ?note-sequence parser)
1170 (new-line->lily-string)
1171 (parameterize ((*explicit-mode* #f))
1172 (music->lily-string ?lyric-sequence parser)))
1175 ;; Silence internal event sent at end of each lyrics block
1176 (define-display-method CompletizeExtenderEvent (expr parser)