Create TOC file only if we have a TOC at all
[orchestrallily.git] / orchestrallily.ily
blobd55fc58bb344154b62f56b093cffc739bb016891
1 \version "2.11.41"
3 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
4 % OrchestralLily
5 % ==============
6 % Desciption:  Lilypond package to make writing large orchestral scores easier.
7 % Documentation: http://wiki.kainhofer.com/lilypond/orchestrallily
8 % Version: 0.02, 2008-03-06
9 % Author: Reinhold Kainhofer, reinhold@kainhofer.com
10 % Copyright: (C) 2008 by Reinhold Kainhofer
11 % License: GPL v3.0, http://www.gnu.org/licenses/gpl.html
13 % Version History:
14 % 0.01 (2008-03-02): Initial Version
15 % 0.02 (2008-03-06): Added basic MIDI support (*MidiInstrument and \setCreateMIDI)
16 % 0.03 (2008-07-xx): General staff/voice types, title pages, etc.
17 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
19 #(use-modules (ice-9 match))
22 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
23 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
24 %%%%%   SCORE STRUCTURE AND AUTOMATIC GENERATION
25 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
26 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
31 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
32 % Helper functions
33 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
35 % Helper function to filter all non-null entries
36 #(define (not-null? x) (not (null? x)))
38 % Helper function to extract a given variable, built from [Piece][Instrument]Identifier
39 #(define (namedPieceInstrObject piece instr name)
40   (let* (
41          (fullname  (string->symbol (string-append piece instr name)))
42          (instrname (string->symbol (string-append instr name)))
43          (piecename (string->symbol (string-append piece name)))
44         )
45     (cond
46       ((defined? fullname) (primitive-eval fullname))
47       ((defined? instrname) (primitive-eval instrname))
48       ((defined? piecename) (primitive-eval piecename))
49       (else '())
50     )
51   )
54 %% Print text as a justified paragraph, taken from the lilypond Notation Reference
55 #(define-markup-list-command (paragraph layout props args) (markup-list?)
56    (let ((indent (chain-assoc-get 'par-indent props 2)))
57      (interpret-markup-list layout props
58        (make-justified-lines-markup-list (cons (make-hspace-markup indent)
59                                                args)))))
61 conditionalBreak = #(define-music-function (parser location) ()
62    #{ \tag #'instrumental-score \pageBreak #}
65 #(define (oly:piece-title-markup title) (markup #:column (#:line (#:fontsize #'3 #:bold title))) )
67 #(define-markup-command (piece-title layout props title) (markup?)
68      (interpret-markup layout props (oly:piece-title-markup title))
71 #(define (oly:generate_object_name piece instr obj )
72   (if (and (string? piece) (string? instr) (string? obj))
73     (string-append piece instr obj)
74     #f
75   )
77 #(define (oly:generate_staff_name piece instr) (oly:generate_object_name piece instr "St"))
79 #(define (set-context-property context property value)
80   (set! (ly:music-property context property) value)
84 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
85 % Score structure and voice types
86 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
88 #(define oly:orchestral_score_structure '())
90 #(define (oly:set_score_structure struct)
91   (if (list? struct)
92     (set! oly:orchestral_score_structure struct)
93     (ly:warning (_ "oly:set_score_structure needs an association list as argument!"))
94   )
97 orchestralScoreStructure = #(define-music-function (parser location structure) (list?) 
98   (oly:set_score_structure structure)
99   (make-music 'Music 'void #t)
102 #(define oly:voice_types '())
104 #(define (oly:set_voice_types types)
105   (if (list? types)
106     (set! oly:voice_types types)
107     (ly:warning (_ "oly:set_voice_types needs an association list as argument!"))
108   )
111 orchestralVoiceTypes = #(define-music-function (parser location types) (list?)
112   (oly:set_voice_types types)
113   (make-music 'Music 'void #t)
117 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
118 % Automatic staff and group generation
119 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
121 % Retrieve all music definitions for the given 
122 #(define (oly:get_music_object piece instrument)
123   (namedPieceInstrObject piece instrument "Music")
125 #(define (oly:get_music_objects piece instruments)
126   (filter not-null? (map (lambda (i) (oly:get_music_object piece i)) instruments))
129 % Given a property name and the extensions, either generate the pair to set 
130 % the property or an empty list, if no pre-defined variable could be found
131 #(define (oly:generate_property_pair prop piece instr type)
132   (let* ((val (namedPieceInstrObject piece instr type)))
133     (if (not-null? val) (list 'assign prop val) '() )
134   )
136   
137 #(define (oly:staff_type type)
138   (cond 
139     ((string? type) (string->symbol type))
140     ((symbol? type) type)
141     (else 'Staff)
142   )
145 #(define (oly:extractPitch music)
146   (let* (
147          (elems  (if (ly:music? music) (ly:music-property music 'elements)))
148          (note   (if (pair? elems) (car elems)))
149          (pitch  (if (ly:music? note) (ly:music-property note 'pitch)))
150         )
151     (if (and (not-null? music) (not (ly:pitch? pitch))) 
152       (ly:warning "Unable to interpret as a pitch!")
153     )
154     pitch
155   )
158 #(define (oly:extractTranspositionPitch piece name)
159   (let* (
160          (trpFromPitch (oly:extractPitch (namedPieceInstrObject piece name "TransposeFrom")))
161          (trpToPitch   (oly:extractPitch (namedPieceInstrObject piece name "TransposeTo")))
162         )
163     (if (ly:pitch? trpFromPitch)
164       (if (ly:pitch? trpToPitch)
165         ; Both pitches
166         (ly:pitch-diff trpFromPitch trpToPitch)
167         (ly:pitch-diff trpFromPitch (ly:make-pitch 0 0 0))
168       )
169       (if (ly:pitch? trpToPitch)
170         (ly:pitch-diff (ly:make-pitch 0 0 0) trpToPitch)
171         #f
172       )
173     )
174   )
177 #(define (oly:musiccontent_for_voice parser piece name music additional)
178   (let* ((musiccontent additional))
179     
180     ; Append the settings, key and clef (if defined)
181     (map 
182       (lambda (type) 
183         (let* ((object (namedPieceInstrObject piece name type)))
184           (if (ly:music? object)
185             (set! musiccontent (append musiccontent (list (ly:music-deep-copy object))))
186             (if (not-null? object) (ly:warning (_ "Wrong type (no ly:music) for ~S for instrument ~S in piece ~S") type name piece))
187           )
188         )
189       )
190       ; TODO: Does the "Tempo" work here???
191       '("Settings" "Key" "Clef" "TimeSignature" ;"Tempo"
192       )
193     )
195     (if (ly:music? music)
196       (begin
197         (set! musiccontent (make-simultaneous-music (append musiccontent (list music))))
198         ;(ly:message "Generating staff for ~a" name)
199         (let* ((trpPitch (oly:extractTranspositionPitch piece name)))
200           (if (ly:pitch? trpPitch) 
201             (set! musiccontent (ly:music-transpose musiccontent trpPitch))
202           )
203         )
204         musiccontent
205       )
206       ; For empty music, return empty 
207       '()
208     )
209   )
211 #(define (oly:voice_handler_internal parser piece name type music)
212   (let* (
213          (lyrics   (namedPieceInstrObject piece name "Lyrics"))
214          (additional '())
215         )
216     
217     (if (ly:music? lyrics)
218       (set! additional (list dynamicUp))
219       (if (not-null? lyrics) (ly:warning (_ "Wrong type (no lyrics) for lyrics for instrument ~S in piece ~S") name piece))
220     )
222     (if (ly:music? music)
223       (let* ((musiccontent (oly:musiccontent_for_voice parser piece name music additional))
224              (voicename  (oly:generate_object_name piece name "Voice" ))
225              (voicetype  (oly:staff_type type))
226              (voice      (context-spec-music musiccontent voicetype voicename))
227              (staffcont  (list voice))
228             )
229         ; If we have lyrics, create a lyrics context containing LyricCombineMusic 
230         ; and add that as second element to the staff's elements list...
231         (if (ly:music? lyrics)
232           (let* (
233                  (lyricsname (oly:generate_object_name piece name "Lyrics" ))
234                  (lyricscont (make-music 'LyricCombineMusic 'element lyrics 'associated-context voicename))
235                 )
236             (set! staffcont (append staffcont 
237               (list (context-spec-music lyricscont 'Lyrics lyricsname))))
238           )
239         )
240         staffcont
241       )
242       ; For empty music, return empty 
243       '()
244     )
245   )
248 #(define (oly:voice_handler parser piece name type)
249   (let* ((music (oly:get_music_object piece name))
250         )
251     (oly:voice_handler_internal parser piece name type music)
252   )
256 #(define (oly:staff_handler_internal parser piece name type voices)
257   (if (not-null? voices)
258     (let* (
259            (staffname  (oly:generate_staff_name piece name))
260            (stafftype  (oly:staff_type type))
261            (staff      (make-simultaneous-music voices))
262            (propops    (oly:staff_handler_properties piece name))
263           )
264       (case stafftype
265         ((SimultaneousMusic ParallelMusic) #f)
266         (else (set! staff (context-spec-music staff stafftype staffname)))
267       )
268       (if (not-null? propops)
269         (set! (ly:music-property staff 'property-operations) propops)
270       )
271       staff
272     )
273     ; For empty music, return empty 
274     '()
275   )
278 #(define (oly:staff_handler parser piece name type children)
279   (let* ((c (if (not-null? children) children (list name)))
280          (voices (apply append (map (lambda (v) (oly:create_voice parser piece v)) c)) ) 
281         )
282     (if (not-null? voices)
283       (oly:staff_handler_internal parser piece name type voices)
284       '()
285     )
286   )
288   
289 #(define (oly:parallel_voices_staff_handler parser piece name type children) 
290   (let* (
291          (voices (map (lambda (i) (oly:create_voice parser piece i)) children))
292          ; get the list of non-empty voices and flatten it!
293          (nonemptyvoices (apply append (filter not-null? voices)))
294         )
295     (if (not-null? nonemptyvoices)
296       (oly:staff_handler_internal parser piece name "Staff" nonemptyvoices)
297       '()
298     )
299   )
302 #(define (oly:part_combined_staff_handler parser piece name type children) 
303   (let* ((rawmusic (map (lambda (c) (oly:musiccontent_for_voice parser piece name (oly:get_music_object piece c) '())) children))
304          (music (filter not-null? rawmusic)))
305   (cond
306       ((and (pair? music) (ly:music? (car music)) (not-null? (cdr music)) (ly:music? (cadr music)))
307           ;(ly:message "Part-combine with two music expressions")
308           (oly:staff_handler_internal parser piece name "Staff" (list (make-part-combine-music parser music))))
309       ((null? music) 
310           (ly:warning "Part-combine without any music expressions")
311           '())
312       ; exactly one is a music expression, simply use that by joining 
313       ((list? music) 
314           (ly:message "Part-combine with only one music expressions")
315           (oly:staff_handler_internal parser piece name "Staff" (list (apply append music))))
316       (else 
317           ;(ly:message "make_part_combined_staff: ~S ~S ~a" piece instr instruments) 
318           '() )
319     )
320   )
323 % Generate the properties for the staff for piece and instr. Typically, these
324 % are the instrument name and the short instrument name (if defined).
325 % return a (possibly empty) list of all assignments.
326 #(define (oly:staff_handler_properties piece instr)
327   (let* (
328          (mapping '( 
329               (instrumentName . "InstrumentName") 
330               (shortInstrumentName . "ShortInstrumentName")
331               (midiInstrument . "MidiInstrument")
332             ))
333          (assignments (map 
334              (lambda (pr) 
335                  (oly:generate_property_pair (car pr) piece instr (cdr pr))
336              )
337              mapping))
338          (props (filter not-null? assignments))
339         )
340     props
341   )
343   
344 % Figured bass is a special case, as it can be voice- or staff-type. When
345 % given as a staff type, simply call the voice handler, instead
347 #(define (oly:figured_bass_staff_handler parser piece name type children)
348   (let* ((c (if (not-null? children) children (list name)))
349          (voice  (oly:voice_handler parser piece (car c) type)))
350     (if (pair? voice) (car voice) ())
351   )
353   
355 #(define (oly:staff_group_handler parser piece name type children)
356   (let* (
357          (staves (map (lambda (i) (oly:create_staff_or_group parser piece i)) children))
358          (nonemptystaves (filter not-null? staves))
359         )
360     (if (not-null? nonemptystaves)
361       (let* (
362              (musicexpr (if (= 1 (length nonemptystaves)) 
363                           (car nonemptystaves) 
364                           (make-simultaneous-music nonemptystaves)))
365              (groupname (oly:generate_staff_name piece name))
366              (grouptype (oly:staff_type type))
367              (group     musicexpr)
368              (propops   (oly:staff_handler_properties piece name))
369             )
370         (case grouptype
371           ((SimultaneousMusic ParallelMusic) #f)
372           (else (set! group (context-spec-music group grouptype groupname)))
373         )
374         (set! (ly:music-property group 'property-operations) propops)
375         group
376       )
377       ; Return empty list if no staves are generated
378       '()
379     )
380   )
383 #(define (oly:create_voice parser piece name)
384   (let* ( (voice (namedPieceInstrObject piece name "Voice"))
385           (type (assoc-ref oly:voice_types name)) )
386     (if (not-null? voice)
387       ; Explicit voice variable, use that
388       voice
389       
390       (if (not type)
391         ; No entry in structure found => simple voice
392         (oly:voice_handler parser piece name "Voice")
393         ; Entry found in structure => use the handler for the given type
394         (let* (
395                (voicetype (car type))
396                (handler (assoc-ref oly:voice_handlers voicetype))
397               )
398           (if handler
399             ((primitive-eval handler) parser piece name voicetype)
400             (begin
401               (ly:warning "No handler found for voice type ~a, using default voice handler" voicetype)
402               (oly:voice_handler parser piece name voicetype)
403             )
404           )
405         )
406       )
407     )
408   )
411 #(define (oly:create_staff_or_group parser piece name)
412   (let* ( (staff (namedPieceInstrObject piece name "Staff"))
413           (type_from_structure (assoc-ref oly:orchestral_score_structure name)) )
414     ;(if (not-null? staff)
415     ;  (ly:message "Found staff variable for instrument ~a in piece ~a"  instr piece)
416     ;  (ly:message "Staff variable for instrument ~a in piece ~a NOT FOUND"  instr piece)
417     ;)
418     (if (not-null? staff)
419       ; Explicit staff variable, use that
420       staff
421       
422       (if (not (list? type_from_structure)) 
423         ; No entry in structure found => simple staff
424         (oly:staff_handler parser piece name "Staff" '())
425         
426         ; Entry found in structure => use the handler for the given type
427         (let* ((type (car type_from_structure))
428                (handler (assoc-ref oly:staff_handlers type))
429                (children (cadr type_from_structure))
430               )
431           (if handler
432             ((primitive-eval handler) parser piece name type children)
433             (begin
434               (ly:warning "No handler found for staff type ~a, using default staff handler" type)
435               (oly:staff_handler parser piece name type children)
436             )
437           )
438         )
439       )
440     )
441   )
444 #(define oly:staff_handlers
445   (list
446     ; staff group types
447     '("GrandStaff" . oly:staff_group_handler )
448     '("PianoStaff" . oly:staff_group_handler )
449     '("ChoirStaff" . oly:staff_group_handler )
450     '("StaffGroup" . oly:staff_group_handler )
451     '("InnerChoirStaff" . oly:staff_group_handler )
452     '("InnerStaffGroup" . oly:staff_group_handler )
453     '("ParallelMusic" . oly:staff_group_handler )
454     '("SimultaneousMusic" . oly:staff_group_handler )
455     ; staff types
456     '("Staff" . oly:staff_handler )
457     '("DrumStaff" . oly:staff_handler )
458     '("RhythmicStaff" . oly:staff_handler )
459     '("TabStaff" . oly:staff_handler )
460     '("GregorianTranscriptionStaff" . oly:staff_handler )
461     '("MensuralStaff" . oly:staff_handler )
462     '("VaticanaStaff" . oly:staff_handler )
463     ; staves with multiple voices
464     '("PartCombinedStaff" . oly:part_combined_staff_handler )
465     '("ParallelVoicesStaff" . oly:parallel_voices_staff_handler )
466     ; special cases: Figured bass can be staff or voice type!
467     '("FiguredBass" . oly:figured_bass_staff_handler )
468   )
471 #(define oly:voice_handlers
472   (list
473     ; voice types
474     '("Voice" . oly:voice_handler )
475     '("CueVoice" . oly:voice_handler )
476     '("DrumVoice" . oly:voice_handler )
477     '("FiguredBass" . oly:voice_handler )
478     '("GregorianTranscriptionVoice" . oly:voice_handler )
479     '("NoteNames" . oly:voice_handler )
480     '("TabVoice" . oly:voice_handler )
481     '("VaticanaVoice" . oly:voice_handler )
482     ;'("Dynamics" . oly:dynamics_handler )
483   )
487 #(define (oly:register_staff_type_handler type func)
488 ;  (ly:message "Registering staff handler ~a for type ~a" func type)
489   (set! oly:staff_handlers (assoc-set! oly:staff_handlers type func))
492 #(define (oly:register_voice_type_handler type func)
493 ;  (ly:message "Registering voice type handler ~a for type ~a" func type)
494   (set! oly:voice_handlers (assoc-set! oly:voice_handlers type func))
497 % handlers for deprecated API
498 #(oly:register_staff_type_handler 'StaffGroup 'oly:staff_group_handler)
499 #(oly:register_staff_type_handler 'GrandStaff 'oly:staff_group_handler)
500 #(oly:register_staff_type_handler 'PianoStaff 'oly:staff_group_handler)
501 #(oly:register_staff_type_handler 'ChoirStaff 'oly:staff_group_handler)
502 #(oly:register_staff_type_handler 'Staff 'oly:staff_handler )
503 #(oly:register_staff_type_handler 'ParallelMusic 'oly:staff_group_handler)
504 #(oly:register_staff_type_handler 'SimultaneousMusic 'oly:staff_group_handler)
505 #(oly:register_staff_type_handler #t 'oly:part_combined_staff_handler )
506 #(oly:register_staff_type_handler #f 'oly:parallel_voices_staff_handler )
508     
510 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
511 % Automatic score generation
512 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
514 % \setUseBook ##t/##f sets a flag to determine whether the calls to createScore
515 % are from within a book block or not
516 % #(define oly:score_handler collect-scores-for-book)
517 #(define oly:score_handler toplevel-score-handler)
518 #(define oly:music_handler toplevel-music-handler)
519 #(define oly:text_handler toplevel-text-handler)
521 setUseBook = #(define-music-function (parser location usebook) (boolean?) 
522   (if usebook
523     (begin
524       (set! oly:score_handler book-score-handler)
525       (set! oly:music_handler book-music-handler)
526       (set! oly:text_handler book-text-handler)
527     )
528     (begin
529       (set! oly:score_handler toplevel-score-handler)
530       (set! oly:music_handler toplevel-music-handler)
531       (set! oly:text_handler toplevel-text-handler)
532     )
533   )
534   (make-music 'Music 'void #t)
538 % Two functions to handle midi-blocks: Either don't set one, or set an empty 
539 % one so that MIDI is generated
540 #(define (oly:set_no_midi_block score) '())
541 #(define (oly:set_midi_block score) 
542   (let* ((midiblock (if (defined? '$defaultmidi) 
543                         (ly:output-def-clone $defaultmidi) 
544                         (ly:make-output-def))))
545     (ly:output-def-set-variable! midiblock 'is-midi #t)
546     (ly:score-add-output-def! score midiblock)
547   )
550 % \setCreateMidi ##t/##f sets a flag to determine wheter MIDI output should
551 % be generated
552 #(define oly:apply_score_midi oly:set_no_midi_block)
553 setCreateMIDI = #(define-music-function (parser location createmidi) (boolean?)
554   (if createmidi
555     (set! oly:apply_score_midi oly:set_midi_block)
556     (set! oly:apply_score_midi oly:set_no_midi_block)
557   )
558   (make-music 'Music 'void #t)
562 % Two functions to handle layout-blocks: Either don't set one, or set an empty 
563 % one so that a PDF is generated
564 #(define (oly:set_no_layout_block score) '())
565 #(define (oly:set_layout_block score) 
566   (let* ((layoutblock (if (defined? '$defaultlayout) 
567                         (ly:output-def-clone $defaultlayout) 
568                         (ly:make-output-def))))
569     (ly:output-def-set-variable! layoutblock 'is-layout #t)
570     (ly:score-add-output-def! score layoutblock)
571   )
574 % \setCreatePDF ##t/##f sets a flag to determine wheter PDF output should
575 % be generated
576 #(define oly:apply_score_layout oly:set_no_layout_block)
577 setCreatePDF = #(define-music-function (parser location createlayout) (boolean?)
578   (if createlayout
579     (set! oly:apply_score_layout oly:set_layout_block)
580     (set! oly:apply_score_layout oly:set_no_layout_block)
581   )
582   (make-music 'Music 'void #t)
586 % Set the piece title in a new header block.
587 #(define (oly:set_piece_header score piecename)
588   (if (not-null? piecename)
589     (let* ((header (make-module)))
590       (module-define! header 'piece piecename)
591       (ly:score-set-header! score header)
592     )
593   )
597 % post-filter functions. By default, no filtering is done. However,
598 % for the *NoCues* function, the cue notes should be killed
599 identity = #(define-music-function (parser location music) (ly:music?) music)
600 cuefilter = #(define-music-function (parser location music) (ly:music?)
601   ((ly:music-function-extract removeWithTag) parser location 'cued ((ly:music-function-extract killCues) parser location music))
605 #(define (oly:create-toc-file layout pages)
606   (let* ((label-table (ly:output-def-lookup layout 'label-page-table)))
607     (if (not (null? label-table))
608       (let* ((format-line (lambda (toc-item)
609              (let* ((label (car toc-item))
610                     (text  (caddr toc-item))
611                     (label-page (and (list? label-table) 
612                                      (assoc label label-table)))
613                     (page (and label-page (cdr label-page))))
614                (format #f "~a, section, 1, {~a}, ~a" page text label))))
615              (formatted-toc-items (map format-line (toc-items)))
616              (whole-string (string-join formatted-toc-items ",\n"))
617              (output-name (ly:parser-output-name parser))
618              (outfilename (format "~a.toc" output-name))
619              (outfile (open-output-file outfilename)))
620         (if (output-port? outfile)
621             (display whole-string outfile)
622             (ly:warning (_ "Unable to open output file ~a for the TOC information") outfilename))
623         (close-output-port outfile)))))
626 #(define-public (oly:add-toc-item parser markup-symbol text)
627   (oly:music_handler parser (add-toc-item! markup-symbol text)))
630 #(define (oly:add-score parser score piecename)
631   (if (not-null? piecename)
632     (oly:add-toc-item parser 'tocItemMarkup piecename))
633   (oly:score_handler parser score)
635 % The helper function to build a score.
636 #(define (oly:createScoreHelper parser location piece children func)
637   (let* (
638          (staves    (oly:staff_group_handler parser piece "" "SimultaneousMusic" children))
639          (music     (if (not-null? staves)
640                         ((ly:music-function-extract func) parser location staves)
641                         '()
642                     ))
643          (score     '())
644          (piecename (namedPieceInstrObject piece (car children) "PieceName"))
645          (piecenametacet (namedPieceInstrObject piece (car children) "PieceNameTacet"))
646          (header    '())
647         )
648     (if (null? music)
649       ; No staves, print tacet
650       (begin 
651         (if (not-null? piecenametacet) (set! piecename piecenametacet))
652         (if (not-null? piecename)
653           (oly:add-score parser (list (oly:piece-title-markup piecename)) piecename)
654           (ly:warning (_ "No music and no score title found for part ~a and instrument ~a") piece children)
655         )
656       )
657       ; we have staves, apply the piecename to the score and add layout/midi blocks if needed
658       (begin
659         (set! score (scorify-music music parser))
660         (oly:set_piece_header score piecename)
661         (oly:apply_score_midi score)
662         (oly:apply_score_layout score)
663         ; Schedule the score for typesetting
664         (oly:add-score parser score piecename)
665       )
666     )
667   )
668   ; This is a void function, the score has been schedulled for typesetting already
669   (make-music 'Music 'void #t)
672 createScore = #(define-music-function (parser location piece children) (string? list?)
673   (oly:createScoreHelper parser location piece children identity)
675 createNoCuesScore = #(define-music-function (parser location piece children) (string? list?)
676   (oly:createScoreHelper parser location piece children cuefilter)
679 createHeadline = #(define-music-function (parser location headline) (string?)
680   (oly:add-toc-item parser 'tocItemMarkup headline)
681   (oly:score_handler parser (list (oly:piece-title-markup headline)))
682   (make-music 'Music 'void #t)
687 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
688 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
689 %%%%%   CUE NOTES
690 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
691 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
693 newInstrument = #(define-music-function (parser location instr) (string?)
695   \set Voice.instrumentCueName = #$(string-join (list "+" instr))
698 cueText = #(define-music-function (parser location instr) (string?)
700   \set Voice.instrumentCueName = $instr
704 % generate a cue music section with instrument names
705 % Parameters: \namedCueDuring NameOfQuote CueDirection CueInstrument OriginalInstrument music
706 %                 -) NameOfQuote CueDirection music are the parameters for \cueDuring
707 %                 -) CueInstrument and OriginalInstrument are the displayed instrument names
708 % typical call:
709 % \namedCueDuring #"vIQuote" #UP #"V.I" #"Sop." { R1*3 }
710 %      This adds the notes from vIQuote (defined via \addQuote) to three measures, prints "V.I" at
711 %      the beginning of the cue notes and "Sop." at the end
712 namedCueDuring = #(define-music-function (parser location cuevoice direction instrcue instr cuemusic) (string? number? string? string? ly:music?)
713    #{
714      \cueDuring #$cuevoice #$direction { \tag #'cued \cueText #$instrcue $cuemusic \tag #'cued \cueText #$instr }
715 %      \tag #'uncued $cuemusic
716    #}
718 namedTransposedCueDuring = #(define-music-function (parser location cuevoice direction instrcue instr trans cuemusic) (string? number? string? string? ly:music? ly:music?)
719    #{
720      \transposedCueDuring #$cuevoice #$direction $trans { \tag #'cued \cueText #$instrcue $cuemusic \tag #'cued \cueText #$instr }
721 %      \tag #'uncued $cuemusic
722    #}
725 % set the cue instrument name and clef
726 setClefCue = #(define-music-function (parser location instr clef) 
727                                                      (string? ly:music?)
728    #{
729      \once \override Staff.Clef #'font-size = #-3 $clef
730      \set Voice.instrumentCueName = $instr
731    #} )
733 % generate a cue music section with instrument names and clef changes
734 % Parameters: \cleffedCueDuring NameOfQuote CueDirection CueInstrument CueClef OriginalInstrument OriginalClef music
735 %                 -) NameOfQuote CueDirection music are the parameters for \cueDuring
736 %                 -) CueInstrument and OriginalInstrument are the displayed instrument names
737 %                 -) CueClef and OriginalClef are the clefs for the the cue notes and the clef of the containing voice
738 % typical call:
739 % \cleffedCueDuring #"vIQuote" #UP #"V.I" #"treble" #"Basso" #"bass" { R1*3 }
740 %      This adds the notes from vIQuote (defined via \addQuote) to three measures, prints "V.I" at
741 %      the beginning of the cue notes and "Basso" at the end. The clef is changed to treble at the 
742 %      beginning of the cue notes and reset to bass at the end
743 cleffedCueDuring = #(define-music-function (parser location cuevoice direction instrcue clefcue instr clefinstr cuemusic) 
744                                                         (string? number? string? ly:music? string? ly:music? ly:music?)
745    #{
746      \cueDuring #$cuevoice #$direction { \tag #'cued \setClefCue #$instrcue $clefcue $cuemusic \tag #'cued \setClefCue #$instr $clefinstr }
747 %      \tag #'uncued $cuemusic
748    #}
754 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
755 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
756 %%%%%   DYNAMICS
757 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
758 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
761 dynamicsX = #(define-music-function (parser location offset) (number?)
763     \once \override DynamicText #'X-offset = $offset
764     \once \override DynamicLineSpanner #'Y-offset = #0
767 % Move the dynamic sign inside the staff to a fixed staff-relative position 
768 % posY (where 0 means vertically starts at the middle staff line)
769 dynamicsAllInside = #(define-music-function (parser location offsetX posY)
770 (number? number?)
772   % Invalid y-extent -> hidden from skyline calculation and collisions
773   \once \override DynamicLineSpanner #'Y-extent = #(cons +0 -0.01)
774   % move by X offset and to fixed Y-position (use Y-offset of parent!)
775   \once \override DynamicText #'X-offset = $offsetX
776   \once \override DynamicText #'Y-offset =
777     $(lambda (grob)
778        (let* ((head (ly:grob-parent grob Y))
779               (offset (ly:grob-property head 'Y-offset)))
780          (- posY  offset (- 0.6))))
781   \once \override DynamicLineSpanner #'Y-offset = $posY
784 dynamicsUpInside = #(define-music-function (parser location offsetX) (number?)
785   ((ly:music-function-extract dynamicsAllInside) parser location offsetX 1.5)
788 dynamicsDownInside = #(define-music-function (parser location offsetX) (number?)
789   ((ly:music-function-extract dynamicsAllInside) parser location offsetX -3.5)
792 hairpinOffset = #(define-music-function (parser location posY) (number?)
794   \once \override DynamicLineSpanner #'Y-offset = $posY
795   \once \override DynamicLineSpanner #'Y-extent = #(cons +0 -0.01)
798 #(define ((line-break-offset before after) grob)
799   (let* ((orig (ly:grob-original grob))
800          ; All siblings if line-broken:
801          (siblings (if (ly:grob? orig) (ly:spanner-broken-into orig) '() )))
802     (if (>= (length siblings) 2)
803       ; We have been line-broken
804       (if (eq? (car (last-pair siblings)) grob)
805         ; Last sibling:
806         (ly:grob-set-property! grob 'Y-offset after)
807         ; Others get the before value:
808         (ly:grob-set-property! grob 'Y-offset before)
809       )
810     )
811   )
814 ffz = #(make-dynamic-script "ffz")
815 pf = #(make-dynamic-script "pf")
816 sempp = #(make-dynamic-script (markup #:line( #:with-dimensions '(0 . 0) 
817 '(0 . 0) #:right-align #:normal-text #:italic "sempre" #:dynamic "pp")))
818 parenf = #(make-dynamic-script (markup #:line(#:normal-text #:italic #:fontsize 2 "(" #:dynamic "f" #:normal-text #:italic #:fontsize 2 ")" )))
819 parenp = #(make-dynamic-script (markup #:line(#:normal-text #:italic #:fontsize 2 "(" #:dynamic "p" #:normal-text #:italic #:fontsize 2 ")" )))
820 pdolce = #(make-dynamic-script (markup #:line(#:dynamic "p" #:with-dimensions '(0 . 0) '(0 . 0) #:normal-text #:italic "dolce"  )))
824 cresc = #(make-music 'CrescendoEvent 'span-direction START 'crescendoSpanner 'text 'crescendoText "cresc.")
825 endcresc =  #(make-span-event 'CrescendoEvent STOP)
826 dim = #(make-music 'DecrescendoEvent 'span-direction START 'decrescendoSpanner 'text 'decrescendoText "dim.")
827 enddim =  #(make-span-event 'DecrescendoEvent STOP)
828 decresc = #(make-music 'DecrescendoEvent 'span-direction START 'decrescendoSpanner 'text 'decrescendoText "decresc.")
829 enddecresc =  #(make-span-event 'DecrescendoEvent STOP)
831 setCresc = {}
832 setDecresc = {}
833 setDim = {}
835 newOrOldClef = #(define-music-function (parser location new old ) (string? string?)
836     (if (ly:get-option 'old-clefs) #{ \clef $old #} #{ \clef $new #}) 
841 %%% Thanks to "Gilles THIBAULT" <gilles.thibault@free.fr>, there is a way
842 %   to remove also the fermata from R1-\fermataMarkup: By filtering the music
843 %   and removing the corresponding events.
844 %   Documented as an LSR snippet: http://lsr.dsi.unimi.it/LSR/Item?id=372
845 #(define (filterOneEventsMarkup event)
846 ( let ( (eventname (ly:music-property  event 'name)) )
847  (not
848   (or     ;; add here event name you do NOT want
849    (eq? eventname 'MultiMeasureTextEvent)
850    (eq? eventname 'AbsoluteDynamicEvent)
851    (eq? eventname 'TextScriptEvent)
852    (eq? eventname 'ArticulationEvent)
853    (eq? eventname 'CrescendoEvent)
854    (eq? eventname 'DecrescendoEvent)
855   )
859 filterArticulations = #(define-music-function (parser location music) (ly:music?)
860   Â (music-filter filterOneEventsMarkup music)
873 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
874 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
875 %%%%%   REST COMBINATION
876 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
877 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
881 %% REST COMBINING, TAKEN FROM http://lsr.dsi.unimi.it/LSR/Item?id=336
883 %% Usage:
884 %%   \new Staff \with {
885 %%     \override RestCollision #'positioning-done = #merge-rests-on-positioning
886 %%   } << \somevoice \\ \othervoice >>
887 %% or (globally):
888 %%   \layout {
889 %%     \context {
890 %%       \Staff
891 %%       \override RestCollision #'positioning-done = #merge-rests-on-positioning
892 %%     }
893 %%   } 
895 %% Limitations:
896 %% - only handles two voices
897 %% - does not handle multi-measure/whole-measure rests
899 #(define (rest-score r)
900   (let ((score 0)
901   (yoff (ly:grob-property-data r 'Y-offset))
902   (sp (ly:grob-property-data r 'staff-position)))
903     (if (number? yoff)
904   (set! score (+ score 2))
905   (if (eq? yoff 'calculation-in-progress)
906       (set! score (- score 3))))
907     (and (number? sp)
908    (<= 0 2 sp)
909    (set! score (+ score 2))
910    (set! score (- score (abs (- 1 sp)))))
911     score))
913 #(define (merge-rests-on-positioning grob)
914   (let* ((can-merge #f)
915    (elts (ly:grob-object grob 'elements))
916    (num-elts (and (ly:grob-array? elts)
917       (ly:grob-array-length elts)))
918    (two-voice? (= num-elts 2)))
919     (if two-voice?
920   (let* ((v1-grob (ly:grob-array-ref elts 0))
921          (v2-grob (ly:grob-array-ref elts 1))
922          (v1-rest (ly:grob-object v1-grob 'rest))
923          (v2-rest (ly:grob-object v2-grob 'rest)))
924     (and
925      (ly:grob? v1-rest)
926      (ly:grob? v2-rest)          
927      (let* ((v1-duration-log (ly:grob-property v1-rest 'duration-log))
928       (v2-duration-log (ly:grob-property v2-rest 'duration-log))
929       (v1-dot (ly:grob-object v1-rest 'dot))
930       (v2-dot (ly:grob-object v2-rest 'dot))
931       (v1-dot-count (and (ly:grob? v1-dot)
932              (ly:grob-property v1-dot 'dot-count -1)))
933       (v2-dot-count (and (ly:grob? v2-dot)
934              (ly:grob-property v2-dot 'dot-count -1))))
935        (set! can-merge
936        (and 
937         (number? v1-duration-log)
938         (number? v2-duration-log)
939         (= v1-duration-log v2-duration-log)
940         (eq? v1-dot-count v2-dot-count)))
941        (if can-merge
942      ;; keep the rest that looks best:
943      (let* ((keep-v1? (>= (rest-score v1-rest)
944               (rest-score v2-rest)))
945       (rest-to-keep (if keep-v1? v1-rest v2-rest))
946       (dot-to-kill (if keep-v1? v2-dot v1-dot)))
947        ;; uncomment if you're curious of which rest was chosen:
948        ;;(ly:grob-set-property! v1-rest 'color green)
949        ;;(ly:grob-set-property! v2-rest 'color blue)
950        (ly:grob-suicide! (if keep-v1? v2-rest v1-rest))
951        (if (ly:grob? dot-to-kill)
952            (ly:grob-suicide! dot-to-kill))
953        (ly:grob-set-property! rest-to-keep 'direction 0)
954        (ly:rest::y-offset-callback rest-to-keep)))))))
955     (if can-merge
956   #t
957   (ly:rest-collision::calc-positioning-done grob))))
963 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
964 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
965 %%%%%   TABLE OF CONTENTS
966 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
967 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
970 contentsTitle = "Inhalt / Contents"
972 \paper {
973   tocTitleMarkup = \markup \fill-line{ 
974     \null 
975     \column {
976       \override #(cons 'line-width (* 7 cm)) 
977       \line{ \fill-line {\piece-title {\contentsTitle} \null }}
978       \hspace #1
979     }
980     \null 
981   }
982   tocItemMarkup = \markup \fill-line { 
983     \null 
984     \column {
985       \override #(cons 'line-width (* 7 cm )) 
986       \line { \fill-line{\fromproperty #'toc:text \fromproperty #'toc:page }}
987     }
988     \null
989   }
993 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
994 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
995 %%%%%   TITLE PAGE / HEADER
996 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
997 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
999 #(define-markup-command (when-property layout props symbol markp) (symbol? markup?)
1000   (if (chain-assoc-get symbol props)
1001       (interpret-markup layout props markp)
1002       (ly:make-stencil '()  '(1 . -1) '(1 . -1))))
1004 #(define-markup-command (vspace layout props amount) (number?)
1005   "This produces a invisible object taking vertical space."
1006   (let ((amount (* amount 3.0)))
1007     (if (> amount 0)
1008         (ly:make-stencil "" (cons -1 1) (cons 0 amount))
1009         (ly:make-stencil "" (cons -1 1) (cons amount amount)))))
1013 titlePageMarkup = \markup \abs-fontsize #10 \when-property #'header:title \column {
1014     \vspace #4
1015     \fill-line { \fontsize #8 \fromproperty #'header:composer }
1016     \vspace #1
1017     \fill-line { \fontsize #8 \fromproperty #'header:poet }
1018     \vspace #4
1019     \fill-line { \fontsize #10 \bold \fromproperty #'header:titlepagetitle }
1020     \vspace #1
1021     \fontsize #2 \when-property #'header:titlepagesubtitle { 
1022       \fill-line { \fromproperty #'header:titlepagesubtitle }
1023       \vspace #1
1024     }
1025     \fill-line { \postscript #"-20 0 moveto 40 0 rlineto stroke" }
1026     \vspace #8
1027     \fill-line { \fontsize #5 \fromproperty #'header:ensemble }
1028     \vspace #0.02
1029     \fill-line { \fontsize #2 \fromproperty #'header:instruments }
1030     \vspace #9
1031     \fill-line { \fontsize #5 \fromproperty #'header:date }
1032     \vspace #1
1033     \fill-line { \fontsize #5 \fromproperty #'header:scoretype }
1034     \vspace #8
1035     \fontsize #2 \when-property #'header:enteredby { 
1036       \fill-line { "Herausgegeben von: / Edited by:"}
1037       \vspace #0.
1038       \fill-line { \fromproperty #'header:enteredby }
1039     }
1040     \fill-line {
1041       \when-property #'header:arrangement \column {
1042         \vspace #8
1043         \fill-line { \fontsize #3 \fromproperty #'header:arrangement }
1044       }
1045     }
1048 titleHeaderMarkup = \markup {
1049   \override #'(baseline-skip . 3.5)
1050   \column {
1051     \override #'(baseline-skip . 3.5)
1052     \column {
1053       \huge \larger \bold
1054       \fill-line {
1055         \larger \fromproperty #'header:title
1056       }
1057       \fill-line {
1058         \large \smaller \bold
1059         \larger \fromproperty #'header:subtitle
1060       }
1061       \fill-line {
1062         \smaller \bold
1063         \fromproperty #'header:subsubtitle
1064       }
1065       \fill-line {
1066         { \large \bold \fromproperty #'header:instrument }
1067       }
1068       \fill-line {
1069         \fromproperty #'header:poet
1070         \fromproperty #'header:composer
1071       }
1072       \fill-line {
1073         \fromproperty #'header:meter
1074         \fromproperty #'header:arranger
1075       }
1076     }
1077   }
1080 titleScoreMarkup = \markup \piece-title \fromproperty #'header:piece
1082 \paper {
1083   scoreTitleMarkup = \titleScoreMarkup
1084   bookTitleMarkup = \titleHeaderMarkup
1089 %%%%%%%%%%%%%% headers and footers %%%%%%%%%%%%%%%%%%%%%%%%%%
1091 #(define (first-score-page layout props arg)
1092   (let* ((label 'first-score-page)
1093          (table (ly:output-def-lookup layout 'label-page-table))
1094          (label-page (and (list? table) (assoc label table)))
1095          (page-number (and label-page (cdr label-page)))
1096         )
1097     (if (eq? (chain-assoc-get 'page:page-number props -1) page-number)
1098       (interpret-markup layout props arg)
1099       empty-stencil)))
1101 #(define no-header-table '())
1102 thisPageNoHeader = #(define-music-function (parser location) ()
1103   (let* ((label (gensym "header")))
1104     (set! no-header-table (cons label no-header-table))
1105     (make-music 'Music 
1106       'page-marker #t
1107       'page-label label)))
1110 % TODO: Use the no-header-table!
1111 #(define (is-header-page layout props arg)
1112   (let* ((page-number (chain-assoc-get 'page:page-number props -1))
1113         )
1114     ;(if (and (> page-number 2) (!= page-number 7))
1115     (if (> page-number 1)
1116       (interpret-markup layout props arg)
1117       empty-stencil)))
1119 #(define no-footer-table '())
1120 thisPageNoFooter = #(define-music-function (parser location) ()
1121   (let* ((label (gensym "footer")))
1122     (set! no-footer-table (cons label no-footer-table))
1123     (make-music 'Music 
1124       'page-marker #t
1125       'page-label label)))
1127 % TODO: Use the no-footer-table!
1128 #(define (is-footer-page layout props arg)
1129   (let* ((page-number (chain-assoc-get 'page:page-number props -1))
1130          (label 'first-score-page)
1131          (table (ly:output-def-lookup layout 'label-page-table))
1132          (label-page (and (list? table) (assoc label table)))
1133          ;(page-number (and label-page (cdr label-page)))
1134         )
1135     (if (and (> page-number 1))
1136       (interpret-markup layout props arg)
1137       empty-stencil)))
1140 #(define copyright-footer-table '())
1141 thisPageCopyrightFooter = #(define-music-function (parser location) ()
1142   (let* ((label (gensym "copyrightfooter")))
1143     (set! copyright-footer-table (cons label copyright-footer-table))
1144     (make-music 'Music 
1145       'page-marker #t
1146       'page-label label)))
1148 #(define copyright-pg 1)
1149 #(define (set-copyright-page page)
1150   (set! copyright-pg page)
1153 % TODO: Use the copyright-footer-table!
1154 #(define (copyright-page layout props arg)
1155     (if (= (chain-assoc-get 'page:page-number props -1) copyright-pg)
1156       (interpret-markup layout props arg)
1157       empty-stencil))
1160 \paper {
1161   oddHeaderMarkup = \markup \fill-line {
1162     %% force the header to take some space, otherwise the
1163     %% page layout becomes a complete mess.
1164     " "
1165     \on-the-fly #is-header-page \fromproperty #'header:title
1166     \on-the-fly #is-header-page \fromproperty #'page:page-number-string
1167   }
1168   evenHeaderMarkup = \markup \fill-line {
1169     \on-the-fly #is-header-page \fromproperty #'page:page-number-string
1170     \on-the-fly #is-header-page \fromproperty #'header:composer
1171     " "
1172   }
1174   oddFooterMarkup = \markup {
1175     \column {
1176       \fill-line {
1177         %% publisher header field only on title page.
1178         \on-the-fly #first-page \fromproperty #'header:publisher
1179       }
1180       \fill-line {
1181         %% copyright on the first real score page
1182         \on-the-fly #copyright-page \fromproperty #'header:copyright
1183         \on-the-fly #copyright-page \null
1184       }
1185       \fill-line {
1186         %% All other pages get the number of the edition centered
1187         \on-the-fly #is-footer-page \fromproperty #'header:scorenumber
1188       }
1189     }
1190   }
1204 % Interpret the given markup with the header fields added to the props. 
1205 % This way, one can re-use the same functions (using fromproperty 
1206 % #'header:field) in the header block and as top-level markup.
1208 % This function is originally copied from mark-up-title (file scm/titling.scm), 
1209 % which is lilypond's internal function to handle the title markups. I needed 
1210 % to replace the scopes and manually add the $defaultheader (which is internally 
1211 % done in paper-book.cc before calling mark-up-title. Also, I don't extract the 
1212 % markup from the header block, but use the given markup.
1214 % I'm not sure if I really need the page properties in props, too... But I 
1215 % suppose it does not hurt, either.
1216 #(define-markup-command (markupWithHeader layout props markup) (markup?)
1217   "Interpret the given markup with the header fields added to the props. 
1218    This way, one can re-use the same functions (using fromproperty 
1219    #'header:field) in the header block and as top-level markup."
1220   (let* (
1221       ; TODO: If we are inside a score, add the score's local header block, too!
1222       ; Currently, I only use the global header block, stored in $defaultheader
1223       (scopes (list $defaultheader))
1224       (alists (map ly:module->alist scopes))
1225   
1226       (prefixed-alist
1227         (map (lambda (alist)
1228           (map (lambda (entry)
1229             (cons
1230               (string->symbol (string-append "header:" (symbol->string (car entry))))
1231               (cdr entry)))
1232             alist))
1233           alists))
1234       (props (append prefixed-alist
1235               props
1236               (layout-extract-page-properties layout)))
1237     )
1238     (interpret-markup layout props markup)
1239   )
1247 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1248 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1249 %%%%%   Equally spacing multiple columns (e.g. for translations)
1250 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1251 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1253 % Credits: Nicolas Sceaux on the lilypond-user mailinglist
1254 #(define-markup-command (columns layout props args) (markup-list?)
1255    (let ((line-width (/ (chain-assoc-get 'line-width props
1256                          (ly:output-def-lookup layout 'line-width))
1257                         (max (length args) 1))))
1258      (interpret-markup layout props
1259        (make-line-markup (map (lambda (line)
1260                                 (markup #:pad-to-box `(0 . ,line-width) '(0 . 0)
1261                                   #:override `(line-width . ,line-width)
1262                                   line))
1263                                args)))))
1269 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1270 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1271 %%%%%   SCORE (HEADER / LAYOUT) SETTINGS
1272 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1273 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
1275 \paper {
1276 %   left-margin = 2\cm
1277 %   right-margin = 2\cm
1278 %   line-width = 17\cm
1279 %   bottom-margin = 1\cm
1280 %   top-margin = 1\cm
1281 %   after-title-space = 0.5\cm
1282   ragged-right = ##f
1283   ragged-last = ##f
1284   ragged-bottom = ##f
1285   ragged-last-bottom = ##f
1287 \layout {
1288   \context {
1289     \ChoirStaff 
1290     % If only one non-empty staff in a system exists, still print the backet
1291     \override SystemStartBracket #'collapse-height = #1
1292     \consists "Instrument_name_engraver"
1293   }
1294   \context {
1295     \StaffGroup
1296     % If only one non-empty staff in a system exists, still print the backet
1297     \override SystemStartBracket #'collapse-height = #1
1298     \consists "Instrument_name_engraver"
1299   }
1300   \context {
1301     \GrandStaff
1302     \override SystemStartBracket #'collapse-height = #1
1303     \consists "Instrument_name_engraver"
1304   }
1305   \context {
1306     \PianoStaff
1307 %     \override VerticalAxisGroup #'keep-fixed-while-stretching = ##t
1308   }
1309   \context {
1310     \FiguredBass
1311 %     \override VerticalAxisGroup #'keep-fixed-while-stretching = ##t
1312     \override VerticalAxisGroup #'minimum-Y-extent  = #'(0 . 1)
1313     \override VerticalAxisGroup #'padding = #0
1314   }
1315   \context {
1316     \Score
1317     % Force multi-measure rests to be written as one span
1318     \override MultiMeasureRest #'expand-limit = #3
1319     skipBars = ##t
1320     autoBeaming = ##f
1321 %     hairpinToBarline = ##f
1322     \override BarNumber #'break-visibility = #end-of-line-invisible
1323     \override CombineTextScript #'avoid-slur = #'outside
1324     barNumberVisibility = #(every-nth-bar-number-visible 5)
1325     \override DynamicTextSpanner #'dash-period = #-1.0
1326     \override InstrumentSwitch #'font-size = #-1
1328     % Rest collision
1329     \override RestCollision #'positioning-done = #merge-rests-on-positioning
1330     % Auto-Accidentals: Use modern-cautionary style...
1331     extraNatural = ##f
1332     autoAccidentals = #`(Staff  ,(make-accidental-rule 'same-octave 0))
1333     autoCautionaries = #`(Staff ,(make-accidental-rule 'any-octave 0)
1334                                 ,(make-accidental-rule 'same-octave 1))
1335     printKeyCancellation = ##t
1336   }
1337   \context {
1338     \RemoveEmptyStaffContext 
1339   }
1340   \context {
1341     \Lyrics
1342     \override VerticalAxisGroup #'minimum-Y-extent = #'(0.5 . 0.5)
1343   }
1348 \layout {
1349   \context {
1350     \type "Engraver_group"
1351     \name Dynamics
1352     % So that \cresc works, for example.
1353     \alias Voice
1354     \consists "Output_property_engraver"
1355     
1356     \override VerticalAxisGroup #'minimum-Y-extent = #'(-1 . 1)
1357     pedalSustainStrings = #'("Ped." "*Ped." "*")
1358     pedalUnaCordaStrings = #'("una corda" "" "tre corde")
1359     
1360     \consists "Piano_pedal_engraver"
1361     \consists "Script_engraver"
1362     \consists "Dynamic_engraver"
1363     \consists "Text_engraver"
1364     
1365     \override TextScript #'font-size = #2
1366     \override TextScript #'font-shape = #'italic
1367     \override DynamicText #'extra-offset = #'(0 . 2.5)
1368     \override Hairpin #'extra-offset = #'(0 . 2.5)
1369     
1370     \consists "Skip_event_swallow_translator"
1371     
1372     \consists "Axis_group_engraver"
1373   }
1374   \context {
1375     \PianoStaff
1376     \accepts Dynamics
1377 %     \override VerticalAlignment #'forced-distance = #7
1378   }