]> git.donarmstrong.com Git - lilypond.git/blob - scm/define-grobs.scm
Doc-fr: updates input.itely
[lilypond.git] / scm / define-grobs.scm
1 ;;;; This file is part of LilyPond, the GNU music typesetter.
2 ;;;;
3 ;;;; Copyright (C) 1998--2011 Han-Wen Nienhuys <hanwen@xs4all.nl>
4 ;;;;                 Jan Nieuwenhuizen <janneke@gnu.org>
5 ;;;;
6 ;;;; LilyPond is free software: you can redistribute it and/or modify
7 ;;;; it under the terms of the GNU General Public License as published by
8 ;;;; the Free Software Foundation, either version 3 of the License, or
9 ;;;; (at your option) any later version.
10 ;;;;
11 ;;;; LilyPond is distributed in the hope that it will be useful,
12 ;;;; but WITHOUT ANY WARRANTY; without even the implied warranty of
13 ;;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14 ;;;; GNU General Public License for more details.
15 ;;;;
16 ;;;; You should have received a copy of the GNU General Public License
17 ;;;; along with LilyPond.  If not, see <http://www.gnu.org/licenses/>.
18
19 ;;;; distances are given in line-thickness (thicknesses) and
20 ;;;; staff-space (distances)
21
22 ;;;; WARNING: the meta field should be the last one.
23 ;;;; WARNING: don't use anonymous functions for initialization.
24
25 ;; TODO: junk the meta field in favor of something more compact?
26
27 (define-public all-grob-descriptions
28   `(
29     (Accidental
30      . (
31         (alteration . ,accidental-interface::calc-alteration)
32         (avoid-slur . inside)
33         (glyph-name-alist . ,standard-alteration-glyph-name-alist)
34         (stencil . ,ly:accidental-interface::print)
35         (X-extent . ,ly:accidental-interface::width)
36         (Y-extent . ,ly:accidental-interface::height)
37         (meta . ((class . Item)
38                  (interfaces . (accidental-interface
39                                 inline-accidental-interface
40                                 font-interface))))))
41
42     (AccidentalCautionary
43      . (
44         (alteration . ,accidental-interface::calc-alteration)
45         (avoid-slur . inside)
46         (glyph-name-alist . ,standard-alteration-glyph-name-alist)
47         (parenthesized . #t)
48         (stencil . ,ly:accidental-interface::print)
49         (Y-extent . ,ly:accidental-interface::height)
50         (meta . ((class . Item)
51                  (interfaces . (accidental-interface
52                                 inline-accidental-interface
53                                 font-interface))))))
54
55     (AccidentalPlacement
56      . (
57         (direction .  ,LEFT)
58         (positioning-done . ,ly:accidental-placement::calc-positioning-done)
59
60         ;; this is quite small, but it is very ugly to have
61         ;; accs closer to the previous note than to the next one.
62         (right-padding . 0.15)
63
64         ;; for horizontally stacked scripts.
65         (script-priority .  -100)
66
67         (X-extent . ,ly:axis-group-interface::width)
68         (meta . ((class . Item)
69                  (interfaces . (accidental-placement-interface))))))
70
71     (AccidentalSuggestion
72      . (
73         (alteration . ,accidental-interface::calc-alteration)
74         (direction . ,UP)
75         (font-size . -2)
76         (glyph-name-alist . ,standard-alteration-glyph-name-alist)
77         (outside-staff-priority . 0)
78         (script-priority . 0)
79         (self-alignment-X . ,CENTER)
80         (side-axis . ,Y)
81         (staff-padding . 0.25)
82         (stencil . ,ly:accidental-interface::print)
83         (X-extent . ,ly:accidental-interface::width)
84         (X-offset . ,(ly:make-simple-closure
85                       `(,+
86                         ,(ly:make-simple-closure
87                           (list ly:self-alignment-interface::centered-on-x-parent))
88                         ,(ly:make-simple-closure
89                           (list ly:self-alignment-interface::x-aligned-on-self)))))
90         (Y-extent . ,ly:accidental-interface::height)
91         (Y-offset . ,ly:side-position-interface::y-aligned-side)
92         (meta . ((class . Item)
93                  (interfaces . (accidental-interface
94                                 accidental-suggestion-interface
95                                 font-interface
96                                 script-interface
97                                 self-alignment-interface
98                                 side-position-interface))))))
99
100     (Ambitus
101      . (
102         (axes . (,X ,Y))
103         (break-align-symbol . ambitus)
104         (break-visibility . ,begin-of-line-visible)
105         (non-musical . #t)
106         (space-alist . (
107                         (cue-end-clef . (extra-space . 0.5))
108                         (clef . (extra-space . 0.5))
109                         (cue-clef . (extra-space . 0.5))
110                         (key-signature . (extra-space . 0.0))
111                         (staff-bar . (extra-space . 0.0))
112                         (time-signature . (extra-space . 0.0))
113                         (first-note . (fixed-space . 0.0))))
114         (X-extent . ,ly:axis-group-interface::width)
115         (Y-extent . ,ly:axis-group-interface::height)
116         (meta . ((class . Item)
117                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
118                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
119                  (interfaces . (ambitus-interface
120                                 axis-group-interface
121                                 break-aligned-interface))))))
122
123     (AmbitusAccidental
124      . (
125         (direction . ,LEFT)
126         (glyph-name-alist . ,standard-alteration-glyph-name-alist)
127         (padding . 0.5)
128         (side-axis . ,X)
129         (stencil . ,ly:accidental-interface::print)
130         (X-offset . ,ly:side-position-interface::x-aligned-side)
131         (Y-extent . ,ly:accidental-interface::height)
132         (meta . ((class . Item)
133                  (interfaces . (accidental-interface
134                                 break-aligned-interface
135                                 font-interface
136                                 side-position-interface))))))
137
138     (AmbitusLine
139      . (
140         (gap . 0.35)
141         (stencil . ,ambitus::print)
142         (thickness . 2)
143         (X-offset . ,ly:self-alignment-interface::centered-on-x-parent)
144         (meta . ((class . Item)
145                  (interfaces . (ambitus-interface
146                                 font-interface))))))
147
148     (AmbitusNoteHead
149      . (
150         (duration-log . 2)
151         (glyph-name . ,note-head::calc-glyph-name)
152         (stencil . ,ly:note-head::print)
153         (Y-offset . ,ly:staff-symbol-referencer::callback)
154         (meta . ((class . Item)
155                  (interfaces . (ambitus-interface
156                                 font-interface
157                                 ledgered-interface
158                                 note-head-interface
159                                 rhythmic-head-interface
160                                 staff-symbol-referencer-interface))))))
161
162     (Arpeggio
163      . (
164         (direction . ,LEFT)
165         (padding . 0.5)
166         (positions . ,ly:arpeggio::calc-positions)
167         (script-priority . 0)
168         (side-axis . ,X)
169         (staff-position . 0.0)
170         (stencil . ,ly:arpeggio::print)
171         (X-extent . ,ly:arpeggio::width)
172         (X-offset . ,ly:side-position-interface::x-aligned-side)
173         (Y-offset . ,ly:staff-symbol-referencer::callback)
174         (meta . ((class . Item)
175                  (interfaces . (arpeggio-interface
176                                 font-interface
177                                 side-position-interface
178                                 staff-symbol-referencer-interface))))))
179
180     (BalloonTextItem
181      . (
182         (annotation-balloon . #t)
183         (annotation-line . #t)
184         (stencil . ,ly:balloon-interface::print)
185         (text . ,(grob::calc-property-by-copy 'text))
186         (X-offset . ,(grob::calc-property-by-copy 'X-offset))
187         (Y-offset . ,(grob::calc-property-by-copy 'Y-offset))
188         (meta . ((class . Item)
189                  (interfaces . (balloon-interface
190                                 font-interface
191                                 text-interface))))))
192
193     (BarLine
194      . (
195         (allow-span-bar . #t)
196         (bar-extent . ,ly:bar-line::calc-bar-extent)
197         (break-align-anchor . ,ly:bar-line::calc-anchor)
198         (break-align-symbol . staff-bar)
199         (break-visibility . ,bar-line::calc-break-visibility)
200         (gap . 0.4)
201         (glyph . "|")
202         (glyph-name . ,bar-line::calc-glyph-name)
203
204         ;;
205         ;; Ross. page 151 lists other values, we opt for a leaner look
206         ;;
207         ;; TODO:
208         ;; kern should scale with line-thickness too.
209         (kern . 3.0)
210         (thin-kern . 3.0)
211         (hair-thickness . 1.9)
212         (thick-thickness . 6.0)
213
214         (layer . 0)
215         (non-musical . #t)
216         (space-alist . (
217                         (time-signature . (extra-space . 0.75))
218                         (custos . (minimum-space . 2.0))
219                         (clef . (minimum-space . 1.0))
220                         (key-signature . (extra-space . 1.0))
221                         (key-cancellation . (extra-space . 1.0))
222                         (first-note . (fixed-space . 1.3))
223                         (next-note . (semi-fixed-space . 0.9))
224                         (right-edge . (extra-space . 0.0))))
225         (stencil . ,ly:bar-line::print)
226         (meta . ((class . Item)
227                  (interfaces . (bar-line-interface
228                                 break-aligned-interface
229                                 font-interface))))))
230
231     (BarNumber
232      . (
233         (after-line-breaking . ,ly:side-position-interface::move-to-extremal-staff)
234         ;; want the bar number before the clef at line start.
235         (break-align-symbols . (left-edge staff-bar))
236
237         (break-visibility . ,begin-of-line-visible)
238         (direction . ,UP)
239         (font-family . roman)
240         (font-size . -2)
241         (non-musical . #t)
242         (outside-staff-priority . 100)
243         (padding . 1.0)
244         (self-alignment-X . ,RIGHT)
245         (side-axis . ,Y)
246         (stencil . ,ly:text-interface::print)
247         (X-offset . ,(ly:make-simple-closure
248                       `(,+
249                         ,(ly:make-simple-closure
250                           (list ly:break-alignable-interface::self-align-callback))
251                         ,(ly:make-simple-closure
252                           (list ly:self-alignment-interface::x-aligned-on-self)))))
253         (Y-offset . ,ly:side-position-interface::y-aligned-side)
254         (meta .
255               ((class . Item)
256                (interfaces . (break-alignable-interface
257                               font-interface
258                               self-alignment-interface
259                               side-position-interface
260                               text-interface))))))
261
262     (BassFigure
263      . (
264         (stencil . ,ly:text-interface::print)
265         (meta . ((class . Item)
266                  (interfaces . (bass-figure-interface
267                                 font-interface
268                                 rhythmic-grob-interface
269                                 text-interface))))))
270
271     (BassFigureAlignment
272      . (
273         (axes . (,Y))
274         (padding . 0.2)
275         (positioning-done . ,ly:align-interface::align-to-minimum-distances)
276         (stacking-dir . ,DOWN)
277         (Y-extent . ,ly:axis-group-interface::height)
278         (meta . ((class . Spanner)
279                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
280                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
281                  (interfaces . (align-interface
282                                 axis-group-interface
283                                 bass-figure-alignment-interface))))))
284
285     (BassFigureAlignmentPositioning
286      . (
287         (axes . (,Y))
288         (direction . ,UP)
289         (padding . 0.5)
290         (side-axis . ,Y)
291         (staff-padding . 1.0)
292         (Y-extent . ,ly:axis-group-interface::height)
293         (Y-offset . ,ly:side-position-interface::y-aligned-side)
294         (meta . ((class . Spanner)
295                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
296                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
297                  (interfaces . (axis-group-interface
298                                 side-position-interface))))))
299
300     (BassFigureBracket
301      . (
302         (edge-height . (0.2 . 0.2))
303         (stencil . ,ly:enclosing-bracket::print)
304         (X-extent . ,ly:enclosing-bracket::width)
305         (meta . ((class . Item)
306                  (interfaces . (enclosing-bracket-interface))))))
307
308     (BassFigureContinuation
309      . (
310         (stencil . ,ly:figured-bass-continuation::print)
311         (Y-offset . ,ly:figured-bass-continuation::center-on-figures)
312         (meta . ((class . Spanner)
313                  (interfaces . (figured-bass-continuation-interface))))))
314
315     (BassFigureLine
316      . (
317         (adjacent-pure-heights . ,ly:axis-group-interface::adjacent-pure-heights)
318         (axes . (,Y))
319         (vertical-skylines . ,ly:axis-group-interface::calc-skylines)
320         (Y-extent . ,ly:axis-group-interface::height)
321         (meta . ((class . Spanner)
322                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
323                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
324                  (interfaces . (axis-group-interface))))))
325
326
327     (Beam
328      . (
329         ;; todo: clean this up a bit: the list is getting
330         ;; rather long.
331         (auto-knee-gap . 5.5)
332         (beam-thickness . 0.48) ; in staff-space
333
334         ;; We have some unreferenced problems here.
335         ;;
336         ;; If we shorten beamed stems less than normal stems (1 staff-space),
337         ;; or high order less than 8th beams, patterns like
338         ;;     c''4 [c''8 c''] c''4 [c''16 c]
339         ;; are ugly (different stem lengths).
340         ;;
341         ;; But if we shorten 16th beams as much as 8th beams, a single
342         ;; forced 16th beam looks *very* short.
343
344         ;; We choose to shorten 8th beams the same as single stems,
345         ;; and high order beams less than 8th beams, so that all
346         ;; isolated shortened beams look nice and a bit shortened,
347         ;; sadly possibly breaking patterns with high order beams.
348         (beamed-stem-shorten . (1.0 0.5 0.25))
349
350         (beaming . ,ly:beam::calc-beaming)
351         (clip-edges . #t)
352         (collision-interfaces . (beam-interface
353                                  clef-interface
354                                  inline-accidental-interface
355                                  key-signature-interface
356                                  note-head-interface
357                                  stem-interface
358                                  time-signature-interface))
359         (concaveness . ,ly:beam::calc-concaveness)
360         (cross-staff . ,ly:beam::calc-cross-staff)
361         (damping . 1)
362         (details
363          .(
364            (secondary-beam-demerit . 10)
365            (stem-length-demerit-factor . 5)
366            (region-size . 2)
367            (beam-eps . 0.001)
368            (stem-length-limit-penalty . 5000)
369            (damping-direction-penalty . 800)
370            (hint-direction-penalty . 20)
371            (musical-direction-factor . 400)
372            (ideal-slope-factor . 10)
373            (collision-penalty . 500)
374            (collision-padding . 0.35)
375            (round-to-zero-slope . 0.02)))
376         (direction . ,ly:beam::calc-direction)
377
378         (normalized-endpoints . ,ly:spanner::calc-normalized-endpoints)
379         ;; only for debugging.
380         (font-family . roman)
381
382         (gap . 0.8)
383         (neutral-direction . ,DOWN)
384         (positions .  ,(ly:make-simple-closure
385                         (ly:make-simple-closure
386                          (list chain-grob-member-functions
387                            `(,cons 0 0)
388                            ly:beam::calc-least-squares-positions
389                            ly:beam::slope-damping
390                            ly:beam::shift-region-to-valid
391                            ly:beam::quanting
392                            ))))
393
394         ;; this is a hack to set stem lengths, if positions is set.
395         (quantized-positions . ,ly:beam::set-stem-lengths)
396
397         (shorten . ,ly:beam::calc-stem-shorten)
398         (stencil . ,ly:beam::print)
399
400         (meta . ((class . Spanner)
401                  (object-callbacks . ((normal-stems . ,ly:beam::calc-normal-stems)))
402                  (interfaces . (beam-interface
403                                 font-interface
404                                 staff-symbol-referencer-interface
405                                 unbreakable-spanner-interface))))))
406
407     (BendAfter
408      . (
409         (minimum-length . 0.5)
410         (stencil . ,bend::print)
411         (thickness . 2.0)
412         (meta . ((class . Spanner)
413                  (interfaces . (bend-after-interface
414                                 spanner-interface))))))
415
416     (BreakAlignGroup
417      . (
418         (axes . (,X))
419         (break-align-anchor . ,ly:break-aligned-interface::calc-average-anchor)
420         (break-visibility . ,ly:break-aligned-interface::calc-break-visibility)
421         (X-extent . ,ly:axis-group-interface::width)
422         (meta . ((class . Item)
423                  (interfaces . (axis-group-interface
424                                 break-aligned-interface))))))
425
426     (BreakAlignment
427      . (
428         (axes . (,X))
429         (break-align-orders . ;; end of line
430                             #((
431                                left-edge
432                                cue-end-clef
433                                ambitus
434                                breathing-sign
435                                clef
436                                cue-clef
437                                staff-bar
438                                key-cancellation
439                                key-signature
440                                time-signature
441                                custos)
442
443                               ;; unbroken
444                               (
445                                left-edge
446                                cue-end-clef
447                                ambitus
448                                breathing-sign
449                                clef
450                                cue-clef
451                                staff-bar
452                                key-cancellation
453                                key-signature
454                                time-signature
455                                custos)
456
457                               ;; begin of line
458                               (
459                                left-edge
460                                ambitus
461                                breathing-sign
462                                clef
463                                key-cancellation
464                                key-signature
465                                staff-bar
466                                time-signature
467                                cue-clef
468                                custos)))
469         (non-musical . #t)
470         (positioning-done . ,ly:break-alignment-interface::calc-positioning-done)
471         (stacking-dir . 1)
472         (X-extent . ,ly:axis-group-interface::width)
473         (meta . ((class . Item)
474                  (interfaces . (axis-group-interface
475                                 break-alignment-interface))))))
476
477     (BreathingSign
478      . (
479         (break-align-symbol . breathing-sign)
480         (break-visibility . ,begin-of-line-invisible)
481         (non-musical . #t)
482         (space-alist . (
483                         (ambitus . (extra-space . 2.0))
484                         (custos . (minimum-space . 1.0))
485                         (key-signature . (minimum-space . 1.5))
486                         (time-signature . (minimum-space . 1.5))
487                         (staff-bar . (minimum-space . 1.5))
488                         (clef . (minimum-space . 2.0))
489                         (cue-clef . (minimum-space . 2.0))
490                         (cue-end-clef . (minimum-space . 2.0))
491                         (first-note . (fixed-space . 1.0)) ;huh?
492                         (right-edge . (extra-space . 0.1))))
493         (stencil . ,ly:text-interface::print)
494         (text . ,(make-musicglyph-markup "scripts.rcomma"))
495         (Y-offset . ,ly:breathing-sign::offset-callback)
496         (meta . ((class . Item)
497                  (interfaces . (break-aligned-interface
498                                 breathing-sign-interface
499                                 font-interface
500                                 text-interface))))))
501
502     (ChordName
503      . (
504         (after-line-breaking . ,ly:chord-name::after-line-breaking)
505         (font-family . sans)
506         (font-size . 1.5)
507         (stencil . ,ly:text-interface::print)
508         (extra-spacing-height . (0.2 . -0.2))
509         (word-space . 0.0)
510         (meta . ((class . Item)
511                  (interfaces . (chord-name-interface
512                                 font-interface
513                                 rhythmic-grob-interface
514                                 text-interface))))))
515
516     (Clef
517      . (
518         (avoid-slur . inside)
519         (break-align-anchor . ,ly:break-aligned-interface::calc-extent-aligned-anchor)
520         (break-align-symbol . clef)
521         (break-visibility . ,begin-of-line-visible)
522         (glyph-name . ,ly:clef::calc-glyph-name)
523         (non-musical . #t)
524         (space-alist . ((cue-clef . (extra-space . 2.0))
525                         (staff-bar . (extra-space . 0.7))
526                         (key-cancellation . (minimum-space . 3.5))
527                         (key-signature . (minimum-space . 3.5))
528                         (time-signature . (minimum-space . 4.2))
529                         (first-note . (minimum-fixed-space . 5.0))
530                         (next-note . (extra-space . 0.5))
531                         (right-edge . (extra-space . 0.5))))
532         (stencil . ,ly:clef::print)
533         (Y-offset . ,ly:staff-symbol-referencer::callback)
534         (meta . ((class . Item)
535                  (interfaces . (break-aligned-interface
536                                 clef-interface
537                                 font-interface
538                                 staff-symbol-referencer-interface))))))
539
540     (ClusterSpanner
541      . (
542         (cross-staff . ,ly:cluster::calc-cross-staff)
543         (minimum-length . 0.0)
544         (padding . 0.25)
545         (springs-and-rods . ,ly:spanner::set-spacing-rods)
546         (stencil . ,ly:cluster::print)
547         (style . ramp)
548         (meta . ((class . Spanner)
549                  (interfaces . (cluster-interface))))))
550
551     (ClusterSpannerBeacon
552      . (
553         (Y-extent . ,ly:cluster-beacon::height)
554         (meta . ((class . Item)
555                  (interfaces . (cluster-beacon-interface
556                                 rhythmic-grob-interface))))))
557
558     (CombineTextScript
559      . (
560         (avoid-slur . outside)
561         (baseline-skip . 2)
562         (direction . ,UP)
563         (extra-spacing-width . (+inf.0 . -inf.0))
564         (font-series . bold)
565         (outside-staff-priority . 450)
566         (padding . 0.5)
567         (script-priority . 200)
568         (side-axis . ,Y)
569         (staff-padding . 0.5)
570         ;; todo: add X self alignment?
571         (stencil . ,ly:text-interface::print)
572         (X-offset . ,ly:self-alignment-interface::x-aligned-on-self)
573         (Y-offset . ,ly:side-position-interface::y-aligned-side)
574         (meta . ((class . Item)
575                  (interfaces . (font-interface
576                                 side-position-interface
577                                 text-interface
578                                 text-script-interface))))))
579
580     (CueClef
581      . (
582         (avoid-slur . inside)
583         (break-align-anchor . ,ly:break-aligned-interface::calc-extent-aligned-anchor)
584         (break-align-symbol . cue-clef)
585         (break-visibility . ,begin-of-line-visible)
586         (font-size . -4)
587         (glyph-name . ,ly:clef::calc-glyph-name)
588         (non-musical . #t)
589         (full-size-change . #t)
590         (space-alist . ((staff-bar . (minimum-space . 2.7))
591                         (key-cancellation . (minimum-space . 3.5))
592                         (key-signature . (minimum-space . 3.5))
593                         (time-signature . (minimum-space . 4.2))
594                         (custos . (minimum-space . 0.0))
595                         (first-note . (minimum-fixed-space . 3.0))
596                         (next-note . (extra-space . 0.5))
597                         (right-edge . (extra-space . 0.5))))
598         (stencil . ,ly:clef::print)
599         (Y-offset . ,ly:staff-symbol-referencer::callback)
600         (meta . ((class . Item)
601                  (interfaces . (break-aligned-interface
602                                 clef-interface
603                                 font-interface
604                                 staff-symbol-referencer-interface))))))
605
606     (CueEndClef
607      . (
608         (avoid-slur . inside)
609         (break-align-anchor . ,ly:break-aligned-interface::calc-extent-aligned-anchor)
610         (break-align-symbol . cue-end-clef)
611         (break-visibility . ,begin-of-line-invisible)
612         (font-size . -4)
613         (glyph-name . ,ly:clef::calc-glyph-name)
614         (non-musical . #t)
615         (full-size-change . #t)
616         (space-alist . ((clef . (extra-space . 0.7))
617                         (cue-clef . (extra-space . 0.7))
618                         (staff-bar . (extra-space . 0.7))
619                         (key-cancellation . (minimum-space . 3.5))
620                         (key-signature . (minimum-space . 3.5))
621                         (time-signature . (minimum-space . 4.2))
622                         (first-note . (minimum-fixed-space . 5.0))
623                         (next-note . (extra-space . 0.5))
624                         (right-edge . (extra-space . 0.5))))
625         (stencil . ,ly:clef::print)
626         (Y-offset . ,ly:staff-symbol-referencer::callback)
627         (meta . ((class . Item)
628                  (interfaces . (break-aligned-interface
629                                 clef-interface
630                                 font-interface
631                                 staff-symbol-referencer-interface))))))
632
633     (Custos
634      . (
635         (break-align-symbol . custos)
636         (break-visibility . ,end-of-line-visible)
637         (neutral-direction . ,DOWN)
638         (non-musical . #t)
639         (space-alist . (
640                         (first-note . (minimum-fixed-space . 0.0))
641                         (right-edge . (extra-space . 0.1))))
642         (stencil . ,ly:custos::print)
643         (style . vaticana)
644         (Y-offset . ,ly:staff-symbol-referencer::callback)
645         (meta . ((class . Item)
646                  (interfaces  . (break-aligned-interface
647                                  custos-interface
648                                  font-interface
649                                  staff-symbol-referencer-interface))))))
650
651     (DotColumn
652      . (
653         (axes . (,X))
654         (direction . ,RIGHT)
655         (positioning-done . ,ly:dot-column::calc-positioning-done)
656         (X-extent . ,ly:axis-group-interface::width)
657         (meta . ((class . Item)
658                  (interfaces . (axis-group-interface
659                                 dot-column-interface))))))
660
661     (Dots
662      . (
663         (dot-count . ,dots::calc-dot-count)
664         (staff-position . ,dots::calc-staff-position)
665         (stencil . ,ly:dots::print)
666         (extra-spacing-height . (-0.5 . 0.5))
667         (meta . ((class . Item)
668                  (interfaces . (dots-interface
669                                 font-interface
670                                 staff-symbol-referencer-interface))))))
671
672     (DoublePercentRepeat
673      . (
674         (break-align-symbol . staff-bar)
675         (break-visibility . ,begin-of-line-invisible)
676         (dot-negative-kern . 0.75)
677         (font-encoding . fetaMusic)
678         (non-musical . #t)
679         (slash-negative-kern . 1.6)
680         (slope . 1.0)
681         (stencil . ,ly:percent-repeat-item-interface::double-percent)
682         (thickness . 0.48)
683         (meta . ((class . Item)
684                  (interfaces . (break-aligned-interface
685                                 font-interface
686                                 percent-repeat-interface
687                                 percent-repeat-item-interface))))))
688
689     (DoublePercentRepeatCounter
690      . (
691         (direction . ,UP)
692         (font-encoding . fetaText)
693         (font-size . -2)
694         (padding . 0.2)
695         (self-alignment-X . ,CENTER)
696         (side-axis . ,Y)
697         (staff-padding . 0.25)
698         (stencil . ,ly:text-interface::print)
699         (X-offset . ,(ly:make-simple-closure
700                       `(,+
701                         ,(ly:make-simple-closure
702                           (list ly:self-alignment-interface::centered-on-y-parent))
703                         ,(ly:make-simple-closure
704                           (list ly:self-alignment-interface::x-aligned-on-self)))))
705         (Y-offset . ,ly:side-position-interface::y-aligned-side)
706         (meta . ((class . Item)
707                  (interfaces . (font-interface
708                                 percent-repeat-interface
709                                 percent-repeat-item-interface
710                                 self-alignment-interface
711                                 side-position-interface
712                                 text-interface))))))
713
714     (DoubleRepeatSlash
715      . (
716         (dot-negative-kern . 0.75)
717         (font-encoding . fetaMusic)
718         (slash-negative-kern . 1.6)
719         (slope . 1.0)
720         (stencil . ,ly:percent-repeat-item-interface::beat-slash)
721         (thickness . 0.48)
722         (meta . ((class . Item)
723                  (interfaces . (font-interface
724                                 percent-repeat-interface
725                                 percent-repeat-item-interface
726                                 rhythmic-grob-interface))))))
727
728     (DynamicLineSpanner
729      . (
730         (axes . (,Y))
731         (cross-staff . ,ly:side-position-interface::calc-cross-staff)
732         (direction . ,DOWN)
733         (minimum-space . 1.2)
734         (outside-staff-priority . 250)
735         (padding . 0.6)
736         (side-axis . ,Y)
737         (slur-padding . 0.3)
738         (staff-padding . 0.1)
739         (X-extent . ,ly:axis-group-interface::width)
740         (Y-extent . ,ly:axis-group-interface::height)
741         (Y-offset . ,ly:side-position-interface::y-aligned-side)
742         (meta . ((class . Spanner)
743                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
744                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
745                  (interfaces . (axis-group-interface
746                                 dynamic-interface
747                                 dynamic-line-spanner-interface
748                                 side-position-interface))))))
749
750     (DynamicText
751      . (
752
753         ;; todo.
754
755         (direction . ,ly:script-interface::calc-direction)
756         (extra-spacing-width . (+inf.0 . -inf.0))
757         (font-encoding . fetaText)
758         (font-series . bold)
759         (font-shape . italic)
760         (outside-staff-priority . 250)
761         (positioning-done . ,ly:script-interface::calc-positioning-done)
762         (right-padding . 0.5)
763         (self-alignment-X . ,CENTER)
764         (self-alignment-Y . ,CENTER)
765         (stencil . ,ly:text-interface::print)
766         (X-offset . ,ly:self-alignment-interface::x-aligned-on-self)
767         (Y-offset . ,ly:self-alignment-interface::y-aligned-on-self)
768         (meta . ((class . Item)
769                  (interfaces . (dynamic-interface
770                                 dynamic-text-interface
771                                 font-interface
772                                 script-interface
773                                 self-alignment-interface
774                                 text-interface))))))
775
776     (DynamicTextSpanner
777      . (
778         (before-line-breaking . ,dynamic-text-spanner::before-line-breaking)
779         (bound-details . ((right . ((attach-dir .  ,LEFT)
780                                     (Y . 0)
781                                     (padding . 0.75)
782                                     ))
783                           (right-broken . ((attach-dir .  ,RIGHT)
784                                     (padding . 0.0)
785                                     ))
786
787                           (left . ((attach-dir .  ,LEFT)
788                                    (Y . 0)
789                                    (stencil-offset . (-0.75 . -0.5))
790                                    (padding . 0.75)
791                                    ))
792                           (left-broken . ((attach-dir .  ,RIGHT)
793                                    ))
794                           ))
795         (dash-fraction . 0.2)
796         (dash-period . 3.0)
797
798         ;; rather ugh with NCSB
799         ;; (font-series . bold)
800         (font-shape . italic)
801
802         ;; need to blend with dynamic texts.
803         (font-size . 1)
804
805         (left-bound-info . ,ly:line-spanner::calc-left-bound-info-and-text)
806
807         (minimum-length . 2.0)
808         ;; make sure the spanner doesn't get too close to notes
809         (minimum-Y-extent . (-1 . 1))
810
811         (right-bound-info . ,ly:line-spanner::calc-right-bound-info)
812         (springs-and-rods . ,ly:spanner::set-spacing-rods)
813         (stencil . ,ly:line-spanner::print)
814         (style . dashed-line)
815         (meta . ((class . Spanner)
816                  (interfaces . (dynamic-interface
817                                 dynamic-text-spanner-interface
818                                 font-interface
819                                 line-interface
820                                 line-spanner-interface
821                                 spanner-interface
822                                 text-interface))))))
823
824
825     (Episema
826      . (
827         (bound-details . ((left . ((Y . 0)
828                                    (padding . 0)
829                                    (attach-dir . ,LEFT)
830                                    ))
831                           (right . ((Y . 0)
832                                     (padding . 0)
833                                     (attach-dir . ,RIGHT)
834                                     ))
835                           ))
836         (direction . ,UP)
837         (left-bound-info . ,ly:line-spanner::calc-left-bound-info)
838         (quantize-position . #t)
839         (right-bound-info . ,ly:line-spanner::calc-right-bound-info)
840         (side-axis . ,Y)
841         (stencil . ,ly:line-spanner::print)
842         (style . line)
843         (Y-offset . ,ly:side-position-interface::y-aligned-side)
844         (meta . ((class . Spanner)
845                  (interfaces . (episema-interface
846                                 font-interface
847                                 line-interface
848                                 line-spanner-interface
849                                 side-position-interface))))))
850
851
852     (Fingering
853      . (
854
855         ;; sync with TextScript (?)
856
857         (avoid-slur . around)
858         (cross-staff . ,ly:side-position-interface::calc-cross-staff)
859         (direction . ,ly:script-interface::calc-direction)
860         (font-encoding . fetaText)
861         (font-size . -5)                ; don't overlap when next to heads.
862         (padding . 0.5)
863         (positioning-done . ,ly:script-interface::calc-positioning-done)
864         (script-priority . 100)
865         (self-alignment-X . ,CENTER)
866         (self-alignment-Y . ,CENTER)
867         (slur-padding . 0.2)
868         (staff-padding . 0.5)
869         (stencil . ,ly:text-interface::print)
870         (text . ,fingering::calc-text)
871         (meta . ((class . Item)
872                  (interfaces . (finger-interface
873                                 font-interface
874                                 self-alignment-interface
875                                 side-position-interface
876                                 text-interface
877                                 text-script-interface))))))
878
879     (FootnoteItem
880      . (
881         (annotation-balloon . #f)
882         (annotation-line . #t)
883         (break-visibility . ,inherit-y-parent-visibility)
884         (footnote-text . ,(grob::calc-property-by-copy 'footnote-text))
885         (stencil . ,ly:balloon-interface::print)
886         (text . ,(grob::calc-property-by-copy 'text))
887         (X-extent . #f)
888         (Y-extent . #f)
889         (X-offset . ,(grob::calc-property-by-copy 'X-offset))
890         (Y-offset . ,(grob::calc-property-by-copy 'Y-offset))
891         (meta . ((class . Item)
892                  (interfaces . (balloon-interface
893                                 footnote-interface
894                                 font-interface
895                                 text-interface))))))
896
897     (FootnoteSpanner
898      . (
899         (annotation-balloon . #f)
900         (annotation-line . #t)
901         (footnote-text . ,(grob::calc-property-by-copy 'footnote-text))
902         (spanner-placement . ,LEFT)
903         (stencil . ,ly:balloon-interface::print-spanner)
904         (text . ,(grob::calc-property-by-copy 'text))
905         (X-extent . #f)
906         (Y-extent . #f)
907         (X-offset . ,(grob::calc-property-by-copy 'X-offset))
908         (Y-offset . ,(grob::calc-property-by-copy 'Y-offset))
909         (meta . ((class . Spanner)
910                  (interfaces . (balloon-interface
911                                 footnote-interface
912                                 footnote-spanner-interface
913                                 font-interface
914                                 text-interface))))))
915
916     (FretBoard
917      . (
918         (after-line-breaking . ,ly:chord-name::after-line-breaking)
919         (fret-diagram-details . ((finger-code . below-string)))
920         (stencil . ,fret-board::calc-stencil)
921         (extra-spacing-height . (0.2 . -0.2))
922         (meta . ((class . Item)
923                  (interfaces . (chord-name-interface
924                                 font-interface
925                                 fret-diagram-interface
926                                 rhythmic-grob-interface))))))
927
928
929     (Glissando
930      . (
931         (after-line-breaking . ,ly:spanner::kill-zero-spanned-time)
932         (bound-details . ((right . ((attach-dir .  ,CENTER)
933                                     (padding . 1.5)
934                                       ))
935                           (left . ((attach-dir .  ,CENTER)
936                                    (padding . 1.5)
937                                       ))
938                           ))
939         (gap . 0.5)
940         (left-bound-info . ,ly:line-spanner::calc-left-bound-info)
941         (normalized-endpoints . ,ly:spanner::calc-normalized-endpoints)
942         (right-bound-info . ,ly:line-spanner::calc-right-bound-info)
943         (simple-Y . #t)
944         (stencil . ,ly:line-spanner::print)
945         (style . line)
946         (X-extent . #f)
947         (Y-extent . #f)
948         (zigzag-width . 0.75)
949         (meta . ((class . Spanner)
950                  (interfaces . (glissando-interface
951                                 line-interface
952                                 line-spanner-interface
953                                 unbreakable-spanner-interface))))))
954
955     (GraceSpacing
956      . (
957         (common-shortest-duration . ,grace-spacing::calc-shortest-duration)
958         (shortest-duration-space . 1.6)
959         (spacing-increment . 0.8)
960         (meta . ((class . Spanner)
961                  (interfaces . (grace-spacing-interface
962                                 spacing-options-interface
963                                 spanner-interface))))))
964
965     (GridLine
966      . (
967         (layer . 0)
968         (self-alignment-X . ,CENTER)
969         (stencil . ,ly:grid-line-interface::print)
970         (X-extent  . ,ly:grid-line-interface::width)
971         (X-offset . ,(ly:make-simple-closure
972                       `(,+
973                         ,(ly:make-simple-closure
974                           (list ly:self-alignment-interface::centered-on-x-parent))
975                         ,(ly:make-simple-closure
976                           (list ly:self-alignment-interface::x-aligned-on-self)))))
977         (meta . ((class . Item)
978                  (interfaces . (grid-line-interface
979                                 self-alignment-interface))))))
980
981     (GridPoint
982      . (
983         (X-extent . (0 . 0))
984         (Y-extent . (0 . 0))
985         (meta . ((class . Item)
986                  (interfaces . (grid-point-interface))))))
987
988
989     (Hairpin
990      . (
991         (after-line-breaking . ,ly:spanner::kill-zero-spanned-time)
992         (bound-padding . 1.0)
993         (circled-tip . #f)
994         (grow-direction . ,hairpin::calc-grow-direction)
995         (height . 0.6666)
996         (minimum-length . 2.0)
997         (self-alignment-Y . ,CENTER)
998         (springs-and-rods . ,ly:spanner::set-spacing-rods)
999         (stencil . ,ly:hairpin::print)
1000         (thickness . 1.0)
1001         (to-barline . #t)
1002         (Y-offset . ,ly:self-alignment-interface::y-aligned-on-self)
1003         (meta . ((class . Spanner)
1004                  (interfaces . (dynamic-interface
1005                                 hairpin-interface
1006                                 line-interface
1007                                 self-alignment-interface
1008                                 spanner-interface))))))
1009
1010     (HorizontalBracket
1011      . (
1012         (bracket-flare . (0.5 . 0.5))
1013         (connect-to-neighbor . ,ly:tuplet-bracket::calc-connect-to-neighbors)
1014         (direction . ,DOWN)
1015         (padding . 0.2)
1016         (side-axis . ,Y)
1017         (staff-padding . 0.2)
1018         (stencil . ,ly:horizontal-bracket::print)
1019         (thickness . 1.0)
1020         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1021         (meta . ((class . Spanner)
1022                  (interfaces . (horizontal-bracket-interface
1023                                 line-interface
1024                                 side-position-interface
1025                                 spanner-interface))))))
1026
1027
1028     (InstrumentName
1029      . (
1030         (direction . ,LEFT)
1031         (padding . 0.3)
1032         (self-alignment-X . ,CENTER)
1033         (self-alignment-Y . ,CENTER)
1034         (stencil . ,system-start-text::print)
1035         (X-offset . ,system-start-text::calc-x-offset)
1036         (Y-offset . ,system-start-text::calc-y-offset)
1037         (meta . ((class . Spanner)
1038                  (interfaces . (font-interface
1039                                 self-alignment-interface
1040                                 side-position-interface
1041                                 system-start-text-interface))))))
1042
1043     (InstrumentSwitch
1044      . (
1045         (direction . ,UP)
1046         (extra-spacing-width . (+inf.0 . -inf.0))
1047         (outside-staff-priority . 500)
1048         (padding . 0.5)
1049         (self-alignment-X . ,LEFT)
1050         (side-axis . ,Y)
1051         (staff-padding . 0.5)
1052         (stencil . ,ly:text-interface::print)
1053         (X-offset . ,ly:self-alignment-interface::x-aligned-on-self)
1054         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1055         (meta . ((class . Item)
1056                  (interfaces . (font-interface
1057                                 self-alignment-interface
1058                                 side-position-interface
1059                                 text-interface))))))
1060
1061
1062     (KeyCancellation
1063      . (
1064         (break-align-symbol . key-cancellation)
1065         (break-visibility . ,begin-of-line-invisible)
1066         (glyph-name-alist . ,cancellation-glyph-name-alist)
1067         (non-musical . #t)
1068         (space-alist . (
1069                         (time-signature . (extra-space . 1.25))
1070                         (staff-bar . (extra-space . 0.6))
1071                         (key-signature . (extra-space . 0.5))
1072                         (cue-clef . (extra-space . 0.5))
1073                         (right-edge . (extra-space . 0.5))
1074                         (first-note . (fixed-space . 2.5))))
1075         (stencil . ,ly:key-signature-interface::print)
1076         (extra-spacing-width . (0.0 . 0.5))
1077         (Y-offset . ,ly:staff-symbol-referencer::callback)
1078         (meta . ((class . Item)
1079                  (interfaces . (break-aligned-interface
1080                                 font-interface
1081                                 key-cancellation-interface
1082                                 key-signature-interface
1083                                 staff-symbol-referencer-interface))))))
1084
1085     (KeySignature
1086      . (
1087         (avoid-slur . inside)
1088         (break-align-anchor . ,ly:break-aligned-interface::calc-extent-aligned-anchor)
1089         (break-align-symbol . key-signature)
1090         (break-visibility . ,begin-of-line-visible)
1091         (glyph-name-alist . ,standard-alteration-glyph-name-alist)
1092         (non-musical . #t)
1093         (space-alist . (
1094                         (time-signature . (extra-space . 1.15))
1095                         (staff-bar . (extra-space . 1.1))
1096                         (cue-clef . (extra-space . 0.5))
1097                         (right-edge . (extra-space . 0.5))
1098                         (first-note . (fixed-space . 2.5))))
1099         (stencil . ,ly:key-signature-interface::print)
1100         (extra-spacing-width . (0.0 . 0.5))
1101         (Y-offset . ,ly:staff-symbol-referencer::callback)
1102         (meta . ((class . Item)
1103                  (interfaces . (break-aligned-interface
1104                                 font-interface
1105                                 key-signature-interface
1106                                 staff-symbol-referencer-interface))))))
1107
1108
1109    (LaissezVibrerTie
1110      . (
1111         (control-points . ,ly:semi-tie::calc-control-points)
1112         (details . ((ratio . 0.333)
1113                     (height-limit . 1.0)))
1114         (direction . ,ly:tie::calc-direction)
1115         (head-direction . ,LEFT)
1116         (stencil  . ,laissez-vibrer::print)
1117         (thickness . 1.0)
1118         (extra-spacing-height . (-0.5 . 0.5))
1119         (meta . ((class . Item)
1120                  (interfaces . (semi-tie-interface))))))
1121
1122     (LaissezVibrerTieColumn
1123      . (
1124         (head-direction . ,ly:semi-tie-column::calc-head-direction)
1125         (positioning-done . ,ly:semi-tie-column::calc-positioning-done)
1126         (X-extent . #f)
1127         (Y-extent . #f)
1128         (meta . ((class . Item)
1129                  (interfaces . (semi-tie-column-interface))))))
1130
1131     (LedgerLineSpanner
1132      . (
1133         (layer . 0)
1134         (length-fraction . 0.25)
1135         (minimum-length-fraction . 0.25)
1136         (springs-and-rods . ,ly:ledger-line-spanner::set-spacing-rods)
1137         (stencil . ,ly:ledger-line-spanner::print)
1138         (X-extent . #f)
1139         (Y-extent . #f)
1140         (meta . ((class . Spanner)
1141                  (interfaces . (ledger-line-spanner-interface))))))
1142
1143     (LeftEdge
1144      . (
1145         (break-align-anchor . ,ly:break-aligned-interface::calc-extent-aligned-anchor)
1146         (break-align-symbol . left-edge)
1147         (break-visibility . ,center-invisible)
1148         (non-musical . #t)
1149         (extra-spacing-height . (+inf.0 . -inf.0))
1150         (space-alist . (
1151                         (ambitus . (extra-space . 2.0))
1152                         (breathing-sign . (minimum-space . 0.0))
1153                         (cue-end-clef . (extra-space . 0.8))
1154                         (clef . (extra-space . 0.8))
1155                         (cue-clef . (extra-space . 0.8))
1156                         (staff-bar . (extra-space . 0.0))
1157                         (key-cancellation . (extra-space . 0.0))
1158                         (key-signature . (extra-space . 0.8))
1159                         (time-signature . (extra-space . 1.0))
1160                         (custos . (extra-space . 0.0))
1161                         (first-note . (fixed-space . 2.0))
1162                         (right-edge . (extra-space . 0.0))
1163                         ))
1164         (X-extent . (0 . 0))
1165         (meta . ((class . Item)
1166                  (interfaces . (break-aligned-interface))))))
1167
1168     (LigatureBracket
1169      . (
1170         ;; ugh.  A ligature bracket is totally different from
1171         ;; a tuplet bracket.
1172
1173         (connect-to-neighbor . ,ly:tuplet-bracket::calc-connect-to-neighbors)
1174         (control-points . ,ly:tuplet-bracket::calc-control-points)
1175         (direction . ,UP)
1176         (edge-height . (0.7 . 0.7))
1177         (padding . 2.0)
1178         (positions . ,ly:tuplet-bracket::calc-positions)
1179         (shorten-pair . (-0.2 . -0.2))
1180         (staff-padding . 0.25)
1181         (stencil . ,ly:tuplet-bracket::print)
1182         (thickness . 1.6)
1183         (meta . ((class . Spanner)
1184                  (interfaces . (line-interface
1185                                 tuplet-bracket-interface))))))
1186
1187     (LyricExtender
1188      . (
1189         (minimum-length . 1.5)
1190         (stencil . ,ly:lyric-extender::print)
1191         (thickness . 0.8) ; line-thickness
1192         (Y-extent . (0 . 0))
1193         (meta . ((class . Spanner)
1194                  (interfaces . (lyric-extender-interface
1195                                 lyric-interface))))))
1196
1197     (LyricHyphen
1198      . (
1199         (after-line-breaking . ,ly:spanner::kill-zero-spanned-time)
1200         (dash-period . 10.0)
1201         (height . 0.42)
1202         (length . 0.66)
1203         (minimum-distance . 0.1)
1204         (minimum-length . 0.3)
1205         (padding . 0.07)
1206         (springs-and-rods . ,ly:lyric-hyphen::set-spacing-rods)
1207         (stencil . ,ly:lyric-hyphen::print)
1208         (thickness . 1.3)
1209         (Y-extent . (0 . 0))
1210         (meta . ((class . Spanner)
1211                  (interfaces . (font-interface
1212                                 lyric-hyphen-interface
1213                                 lyric-interface
1214                                 spanner-interface))))))
1215
1216     (LyricSpace
1217      . (
1218         (minimum-distance . 0.45)
1219         (padding . 0.0)
1220         (springs-and-rods . ,ly:lyric-hyphen::set-spacing-rods)
1221         (X-extent . #f)
1222         (Y-extent . #f)
1223         (meta . ((class . Spanner)
1224                  (interfaces . (lyric-hyphen-interface
1225                                 spanner-interface))))))
1226
1227     (LyricText
1228      . (
1229         (extra-spacing-width . (0.0 . 0.0))
1230         ;; Recede in height for purposes of note spacing,
1231         ;; so notes in melismata can be freely spaced above lyrics
1232         (extra-spacing-height . (0.2 . -0.2))
1233         (font-series . medium)
1234         (font-size . 1.0)
1235         (self-alignment-X . ,CENTER)
1236         (stencil . ,lyric-text::print)
1237         (text . ,(grob::calc-property-by-copy 'text))
1238         (word-space . 0.6)
1239         (X-offset . ,ly:self-alignment-interface::aligned-on-x-parent)
1240         (meta . ((class . Item)
1241                  (interfaces . (font-interface
1242                                 lyric-syllable-interface
1243                                 rhythmic-grob-interface
1244                                 self-alignment-interface
1245                                 text-interface))))))
1246
1247
1248     (MeasureGrouping
1249      . (
1250         (direction . ,UP)
1251         (height . 2.0)
1252         (padding . 2)
1253         (side-axis . ,Y)
1254         (staff-padding . 3)
1255         (stencil . ,ly:measure-grouping::print)
1256         (thickness . 1)
1257         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1258         (meta . ((class . Spanner)
1259                  (interfaces . (measure-grouping-interface
1260                                 side-position-interface))))))
1261
1262     (MelodyItem
1263      . (
1264         (neutral-direction . ,DOWN)
1265         (meta . ((class . Item)
1266                  (interfaces . (melody-spanner-interface))))))
1267
1268     (MensuralLigature
1269      . (
1270         (stencil . ,ly:mensural-ligature::print)
1271         (thickness . 1.4)
1272         (meta . ((class . Spanner)
1273                  (interfaces . (font-interface
1274                                 mensural-ligature-interface))))))
1275
1276     (MetronomeMark
1277      . (
1278         (after-line-breaking . ,ly:side-position-interface::move-to-extremal-staff)
1279         (break-visibility . ,end-of-line-invisible)
1280         (direction . ,UP)
1281         (extra-spacing-width . (+inf.0 . -inf.0))
1282         (outside-staff-priority . 1000)
1283         (padding . 0.8)
1284         (side-axis . ,Y)
1285         (stencil . ,ly:text-interface::print)
1286         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1287         (X-offset . ,(ly:make-simple-closure
1288                       `(,+
1289                         ,(ly:make-simple-closure
1290                           (list ly:break-alignable-interface::self-align-callback))
1291                         ,(ly:make-simple-closure
1292                           (list ly:self-alignment-interface::x-aligned-on-self)))))
1293         (self-alignment-X . ,LEFT)
1294         (break-align-symbols . (time-signature))
1295         (non-break-align-symbols . (multi-measure-rest-interface))
1296         (meta . ((class . Item)
1297                  (interfaces . (break-alignable-interface
1298                                 font-interface
1299                                 metronome-mark-interface
1300                                 self-alignment-interface
1301                                 side-position-interface
1302                                 text-interface))))))
1303
1304     (MultiMeasureRest
1305      . (
1306         (expand-limit . 10)
1307         (hair-thickness . 2.0)
1308         (round-up-exceptions . ())
1309         (padding . 1)
1310         (spacing-pair . (break-alignment . break-alignment))
1311         (springs-and-rods . ,ly:multi-measure-rest::set-spacing-rods)
1312         (stencil . ,ly:multi-measure-rest::print)
1313         (thick-thickness . 6.6)
1314         ;; See Wanske pp. 125
1315         (usable-duration-logs . ,(iota 4 -3))
1316         (Y-offset . ,ly:staff-symbol-referencer::callback)
1317         (meta . ((class . Spanner)
1318                  (interfaces . (font-interface
1319                                 multi-measure-interface
1320                                 multi-measure-rest-interface
1321                                 rest-interface
1322                                 staff-symbol-referencer-interface))))))
1323
1324     (MultiMeasureRestNumber
1325      . (
1326         (bound-padding  . 2.0)
1327         (direction . ,UP)
1328         (font-encoding . fetaText)
1329         (padding . 0.4)
1330         (self-alignment-X . ,CENTER)
1331         (side-axis . ,Y)
1332         (springs-and-rods . ,ly:multi-measure-rest::set-text-rods)
1333         (staff-padding . 0.4)
1334         (stencil . ,ly:text-interface::print)
1335         (X-offset . ,(ly:make-simple-closure
1336                       `(,+
1337                         ,(ly:make-simple-closure
1338                           (list ly:self-alignment-interface::x-aligned-on-self))
1339                         ,(ly:make-simple-closure
1340                           (list ly:self-alignment-interface::x-centered-on-y-parent)))))
1341         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1342         (meta . ((class . Spanner)
1343                  (interfaces . (font-interface
1344                                 multi-measure-interface
1345                                 self-alignment-interface
1346                                 side-position-interface
1347                                 text-interface))))))
1348
1349     (MultiMeasureRestText
1350      . (
1351         (direction . ,UP)
1352         (outside-staff-priority . 450)
1353         (padding . 0.2)
1354         (self-alignment-X . ,CENTER)
1355         (staff-padding . 0.25)
1356         (stencil . ,ly:text-interface::print)
1357         (X-offset . ,(ly:make-simple-closure
1358                       `(,+
1359                         ,(ly:make-simple-closure
1360                           (list ly:self-alignment-interface::x-centered-on-y-parent))
1361                         ,(ly:make-simple-closure
1362                           (list ly:self-alignment-interface::x-aligned-on-self)))))
1363         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1364         (meta . ((class . Spanner)
1365                  (interfaces . (font-interface
1366                                 multi-measure-interface
1367                                 self-alignment-interface
1368                                 side-position-interface
1369                                 text-interface))))))
1370
1371
1372     (NonMusicalPaperColumn
1373      . (
1374         (allow-loose-spacing . #t)
1375         (axes . (,X))
1376         (before-line-breaking . ,ly:paper-column::before-line-breaking)
1377         (full-measure-extra-space . 1.0)
1378         (horizontal-skylines . ,ly:separation-item::calc-skylines)
1379         ;; sufficient padding to prevent ledger lines from moving over/under
1380         (skyline-vertical-padding . 0.6)
1381         ;;                    (stencil . ,ly:paper-column::print)
1382
1383         (keep-inside-line . #t)
1384         (line-break-permission . allow)
1385         (non-musical . #t)
1386         (page-break-permission . allow)
1387
1388         ;; debugging stuff: print column number.
1389         ;;               (font-size . -6) (font-name . "sans")  (Y-extent . #f)
1390
1391         (X-extent . ,ly:axis-group-interface::width)
1392         (meta . ((class . Paper_column)
1393                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
1394                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
1395                  (interfaces . (axis-group-interface
1396                                 font-interface
1397                                 paper-column-interface
1398                                 separation-item-interface
1399                                 spaceable-grob-interface))))))
1400
1401     (NoteCollision
1402      . (
1403         (axes . (,X ,Y))
1404         (positioning-done . ,ly:note-collision-interface::calc-positioning-done)
1405         (prefer-dotted-right . #t)
1406         (X-extent . ,ly:axis-group-interface::width)
1407         (Y-extent . ,ly:axis-group-interface::height)
1408         (meta . ((class . Item)
1409                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
1410                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
1411                  (interfaces . (axis-group-interface
1412                                 note-collision-interface))))))
1413
1414     (NoteColumn
1415      . (
1416         (axes . (,X ,Y))
1417         (horizontal-skylines . ,ly:separation-item::calc-skylines)
1418         (skyline-vertical-padding . 0.15)
1419         (X-extent . ,ly:axis-group-interface::width)
1420         (Y-extent . ,ly:axis-group-interface::height)
1421         (meta . ((class . Item)
1422                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
1423                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
1424                  (interfaces . (axis-group-interface
1425                                 note-column-interface
1426                                 separation-item-interface))))))
1427
1428     (NoteHead
1429      . (
1430         (flexa-width . 2.0)
1431         (duration-log . ,note-head::calc-duration-log)
1432         (extra-spacing-height . ,ly:note-head::include-ledger-line-height)
1433         (glyph-name . ,note-head::calc-glyph-name)
1434         (ligature-flexa . #f)
1435         (stem-attachment . ,ly:note-head::calc-stem-attachment)
1436         (stencil . ,ly:note-head::print)
1437         (X-offset . ,ly:note-head::stem-x-shift)
1438         (Y-offset . ,ly:staff-symbol-referencer::callback)
1439         (meta . ((class . Item)
1440                  (interfaces . (font-interface
1441                                 gregorian-ligature-interface
1442                                 ledgered-interface
1443                                 ligature-head-interface
1444                                 mensural-ligature-interface
1445                                 note-head-interface
1446                                 rhythmic-grob-interface
1447                                 rhythmic-head-interface
1448                                 staff-symbol-referencer-interface
1449                                 vaticana-ligature-interface))))))
1450
1451     (NoteName
1452      . (
1453         (stencil . ,ly:text-interface::print)
1454         (meta . ((class . Item)
1455                  (interfaces . (font-interface
1456                                 note-name-interface
1457                                 text-interface))))))
1458
1459     (NoteSpacing
1460      . (
1461         ;; Changed this from 0.75.
1462         ;; If you ever change this back, please document! --hwn
1463         (knee-spacing-correction . 1.0)
1464         (same-direction-correction . 0.25)
1465         (space-to-barline . #t)
1466         (stem-spacing-correction . 0.5)
1467         (meta . ((class . Item)
1468                  (interfaces . (note-spacing-interface
1469                                 spacing-interface))))))
1470
1471
1472     (OctavateEight
1473      . (
1474         (break-visibility . ,inherit-x-parent-visibility)
1475         (font-shape . italic)
1476         (font-size . -4)
1477         (self-alignment-X . ,CENTER)
1478         (staff-padding . 0.2)
1479         (stencil . ,ly:text-interface::print)
1480         (X-offset . ,(ly:make-simple-closure
1481                       `(,+
1482                         ,(ly:make-simple-closure
1483                           (list ly:self-alignment-interface::x-aligned-on-self))
1484                         ,(ly:make-simple-closure
1485                           (list ly:self-alignment-interface::centered-on-x-parent)))))
1486         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1487         (meta . ((class . Item)
1488                  (interfaces . (font-interface
1489                                 self-alignment-interface
1490                                 side-position-interface
1491                                 text-interface))))))
1492
1493     (OttavaBracket
1494      . (
1495         (dash-fraction . 0.3)
1496         (direction . ,UP)
1497         (edge-height . (0 . 1.2))
1498         (font-shape . italic)
1499         (minimum-length . 1.0)
1500         (outside-staff-priority . 400)
1501         (padding . 0.5)
1502         (shorten-pair . (0.0 . -0.6))
1503         (staff-padding . 1.0)
1504         (stencil . ,ly:ottava-bracket::print)
1505         (style . dashed-line)
1506         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1507         (meta . ((class . Spanner)
1508                  (interfaces . (font-interface
1509                                 horizontal-bracket-interface
1510                                 line-interface
1511                                 ottava-bracket-interface
1512                                 side-position-interface
1513                                 text-interface))))))
1514
1515
1516     (PaperColumn
1517      . (
1518         (allow-loose-spacing . #t)
1519         (axes . (,X))
1520         (before-line-breaking . ,ly:paper-column::before-line-breaking)
1521         (horizontal-skylines . ,ly:separation-item::calc-skylines)
1522         (keep-inside-line . #t)
1523         ;; (stencil . ,ly:paper-column::print)
1524         (X-extent . ,ly:axis-group-interface::width)
1525
1526         ;; debugging
1527         ;;                       (font-size . -6) (font-name . "sans") (Y-extent . #f)
1528         (meta . ((class . Paper_column)
1529                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
1530                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
1531                  (interfaces . (axis-group-interface
1532                                 font-interface
1533                                 paper-column-interface
1534                                 separation-item-interface
1535                                 spaceable-grob-interface))))))
1536
1537     (ParenthesesItem
1538      . (
1539         (font-size . -6)
1540         (padding . 0.2)
1541         (stencil . ,parentheses-item::print)
1542         (stencils . ,parentheses-item::calc-parenthesis-stencils)
1543         (meta . ((class . Item)
1544                  (interfaces . (font-interface
1545                                 parentheses-interface))))))
1546
1547     (PercentRepeat
1548      . (
1549         (dot-negative-kern . 0.75)
1550         (font-encoding . fetaMusic)
1551         (slope . 1.0)
1552         (spacing-pair . (break-alignment . staff-bar))
1553         (springs-and-rods . ,ly:multi-measure-rest::set-spacing-rods)
1554         (stencil . ,ly:multi-measure-rest::percent)
1555         (thickness . 0.48)
1556         (meta . ((class . Spanner)
1557                  (interfaces . (font-interface
1558                                 multi-measure-rest-interface
1559                                 percent-repeat-interface))))))
1560
1561     (PercentRepeatCounter
1562      . (
1563         (direction . ,UP)
1564         (font-encoding . fetaText)
1565         (font-size . -2)
1566         (padding . 0.2)
1567         (self-alignment-X . ,CENTER)
1568         (staff-padding . 0.25)
1569         (stencil . ,ly:text-interface::print)
1570         (X-offset . ,(ly:make-simple-closure
1571                       `(,+
1572                         ,(ly:make-simple-closure
1573                           (list ly:self-alignment-interface::x-centered-on-y-parent))
1574                         ,(ly:make-simple-closure
1575                           (list ly:self-alignment-interface::x-aligned-on-self)))))
1576         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1577         (meta . ((class . Spanner)
1578                  (interfaces . (font-interface
1579                                 percent-repeat-interface
1580                                 self-alignment-interface
1581                                 side-position-interface
1582                                 text-interface))))))
1583
1584     (PhrasingSlur
1585      . (
1586         (control-points . ,ly:slur::calc-control-points)
1587         (cross-staff . ,ly:slur::calc-cross-staff)
1588         (details . ,default-slur-details)
1589         (direction . ,ly:slur::calc-direction)
1590         (height-limit . 2.0)
1591         (minimum-length . 1.5)
1592         (ratio . 0.333)
1593         (spanner-id . "")
1594         (springs-and-rods . ,ly:spanner::set-spacing-rods)
1595         (stencil . ,ly:slur::print)
1596         (thickness . 1.1)
1597         (Y-extent . ,ly:slur::height)
1598         (meta . ((class . Spanner)
1599                  (interfaces . (slur-interface))))))
1600
1601     ;; an example of a text spanner
1602     (PianoPedalBracket
1603      . (
1604         (bound-padding . 1.0)
1605         (bracket-flare . (0.5 . 0.5))
1606         (direction . ,DOWN)
1607         (edge-height . (1.0 . 1.0))
1608         (shorten-pair . (0.0 . 0.0))
1609         (stencil . ,ly:piano-pedal-bracket::print)
1610         (style . line)
1611         (thickness .  1.0)
1612         (meta . ((class . Spanner)
1613                  (interfaces . (line-interface
1614                                 piano-pedal-bracket-interface
1615                                 piano-pedal-interface))))))
1616
1617
1618     (RehearsalMark
1619      . (
1620         (after-line-breaking . ,ly:side-position-interface::move-to-extremal-staff)
1621         (baseline-skip . 2)
1622         (break-align-symbols . (staff-bar clef))
1623         (break-visibility . ,end-of-line-invisible)
1624         (direction . ,UP)
1625         (extra-spacing-width . (+inf.0 . -inf.0))
1626         (font-size . 2)
1627         (non-musical . #t)
1628         (outside-staff-priority . 1500)
1629         (padding . 0.8)
1630         (self-alignment-X . ,CENTER)
1631         (stencil . ,ly:text-interface::print)
1632         (X-offset . ,(ly:make-simple-closure
1633                       `(,+
1634                         ,(ly:make-simple-closure
1635                           (list ly:break-alignable-interface::self-align-callback))
1636                         ,(ly:make-simple-closure
1637                           (list ly:self-alignment-interface::x-aligned-on-self)))))
1638         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1639         (meta . ((class . Item)
1640                  (interfaces . (break-alignable-interface
1641                                 font-interface
1642                                 mark-interface
1643                                 self-alignment-interface
1644                                 side-position-interface
1645                                 text-interface))))))
1646
1647     (RepeatSlash
1648      . (
1649         (slash-negative-kern . 0.85)
1650         (slope . 1.7)
1651         (stencil . ,ly:percent-repeat-item-interface::beat-slash)
1652         (thickness . 0.48)
1653         (meta . ((class . Item)
1654                  (interfaces . (percent-repeat-interface
1655                                 percent-repeat-item-interface
1656                                 rhythmic-grob-interface))))))
1657
1658     (RepeatTie
1659      . (
1660         (control-points . ,ly:semi-tie::calc-control-points)
1661         (details . ((ratio . 0.333)
1662                     (height-limit . 1.0)))
1663         (direction . ,ly:tie::calc-direction)
1664         (head-direction . ,RIGHT)
1665         (stencil  . ,ly:tie::print)
1666         (thickness . 1.0)
1667         (extra-spacing-height . (-0.5 . 0.5))
1668         (meta . ((class . Item)
1669                  (interfaces . (semi-tie-interface))))))
1670
1671     (RepeatTieColumn
1672      . (
1673         (direction . ,ly:tie::calc-direction)
1674         (head-direction . ,ly:semi-tie-column::calc-head-direction)
1675         (positioning-done . ,ly:semi-tie-column::calc-positioning-done)
1676         (X-extent . #f)
1677         (Y-extent . #f)
1678         (meta . ((class . Item)
1679                  (interfaces . (semi-tie-column-interface))))))
1680
1681     (Rest
1682      . (
1683         (cross-staff . ,ly:rest::calc-cross-staff)
1684         (duration-log . ,stem::calc-duration-log)
1685         (minimum-distance . 0.25)
1686         (stencil . ,ly:rest::print)
1687         (X-extent . ,ly:rest::width)
1688         (Y-extent . ,ly:rest::height)
1689         (Y-offset . ,ly:rest::y-offset-callback)
1690         (meta . ((class . Item)
1691                  (interfaces . (font-interface
1692                                 rest-interface
1693                                 rhythmic-grob-interface
1694                                 rhythmic-head-interface
1695                                 staff-symbol-referencer-interface))))))
1696
1697     (RestCollision
1698      . (
1699         (minimum-distance . 0.75)
1700         (positioning-done . ,ly:rest-collision::calc-positioning-done)
1701         (meta . ((class . Item)
1702                  (interfaces . (rest-collision-interface))))))
1703
1704
1705     (Script
1706      . (
1707         (add-stem-support . #t)
1708         (cross-staff . ,ly:script-interface::calc-cross-staff)
1709         (direction . ,ly:script-interface::calc-direction)
1710         (font-encoding . fetaMusic)
1711         (positioning-done . ,ly:script-interface::calc-positioning-done)
1712         (side-axis . ,Y)
1713
1714         ;; padding set in script definitions.
1715         (staff-padding . 0.25)
1716
1717         (stencil . ,ly:script-interface::print)
1718         (X-offset . ,script-interface::calc-x-offset)
1719         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1720         (meta . ((class . Item)
1721                  (interfaces . (font-interface
1722                                 script-interface
1723                                 side-position-interface))))))
1724
1725     (ScriptColumn
1726      . (
1727         (before-line-breaking . ,ly:script-column::before-line-breaking)
1728         (meta . ((class . Item)
1729                  (interfaces . (script-column-interface))))))
1730
1731     (ScriptRow
1732      . (
1733         (before-line-breaking . ,ly:script-column::row-before-line-breaking)
1734         (meta . ((class . Item)
1735                  (interfaces . (script-column-interface))))))
1736
1737     (Slur
1738      . (
1739         (avoid-slur . inside)
1740         (control-points . ,ly:slur::calc-control-points)
1741         (cross-staff . ,ly:slur::calc-cross-staff)
1742         (details . ,default-slur-details)
1743         (direction . ,ly:slur::calc-direction)
1744         (height-limit . 2.0)
1745         (line-thickness . 0.8)
1746         (minimum-length . 1.5)
1747         (ratio . 0.25)
1748         (spanner-id . "")
1749         (springs-and-rods . ,ly:spanner::set-spacing-rods)
1750         (stencil . ,ly:slur::print)
1751         (thickness . 1.2)
1752         (Y-extent . ,ly:slur::height)
1753         (meta . ((class . Spanner)
1754                  (interfaces . (slur-interface))))))
1755
1756     (SostenutoPedal
1757      . (
1758         (direction . ,RIGHT)
1759         (extra-spacing-width . (+inf.0 . -inf.0))
1760         (font-shape . italic)
1761         (padding . 0.0) ;; padding relative to SostenutoPedalLineSpanner
1762         (self-alignment-X . ,CENTER)
1763         (stencil . ,ly:text-interface::print)
1764         (X-offset . ,ly:self-alignment-interface::x-aligned-on-self)
1765         (meta . ((class . Item)
1766                  (interfaces . (font-interface
1767                                 piano-pedal-script-interface
1768                                 self-alignment-interface
1769                                 text-interface))))))
1770
1771     (SostenutoPedalLineSpanner
1772      . (
1773         (axes . (,Y))
1774         (direction . ,DOWN)
1775         (minimum-space . 1.0)
1776         (outside-staff-priority . 1000)
1777         (padding . 1.2)
1778         (side-axis . ,Y)
1779         (staff-padding . 1.0)
1780         (X-extent . ,ly:axis-group-interface::width)
1781         (Y-extent . ,ly:axis-group-interface::height)
1782         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1783         (meta . ((class . Spanner)
1784                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
1785                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
1786                  (interfaces . (axis-group-interface
1787                                 piano-pedal-interface
1788                                 side-position-interface))))))
1789
1790     (SpacingSpanner
1791      . (
1792         (average-spacing-wishes . #t)
1793         (base-shortest-duration . ,(ly:make-moment 3 16))
1794         (common-shortest-duration . ,ly:spacing-spanner::calc-common-shortest-duration)
1795         (shortest-duration-space . 2.0)
1796         (spacing-increment . 1.2)
1797         (springs-and-rods . ,ly:spacing-spanner::set-springs)
1798         (meta . ((class . Spanner)
1799                  (interfaces . (spacing-options-interface
1800                                 spacing-spanner-interface))))))
1801
1802     (SpanBar
1803      . (
1804         (allow-span-bar . #t)
1805         (bar-extent . ,ly:axis-group-interface::height)
1806         (before-line-breaking . ,ly:span-bar::before-line-breaking)
1807         (break-align-symbol . staff-bar)
1808         (cross-staff . #t)
1809         (glyph-name . ,ly:span-bar::calc-glyph-name)
1810
1811         ;; ugh duplication! (these 4 properties were copied from Barline)
1812         ;;
1813         ;; Ross. page 151 lists other values, we opt for a leaner look
1814         ;;
1815         (kern . 3.0)
1816         (thin-kern . 3.0)
1817         (hair-thickness . 1.6)
1818         (thick-thickness . 6.0)
1819
1820         (layer . 0)
1821         (non-musical . #t)
1822         (stencil . ,ly:span-bar::print)
1823         (X-extent . ,ly:span-bar::width)
1824         (Y-extent . ,ly:axis-group-interface::height)
1825         (meta . ((class . Item)
1826                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
1827                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
1828                  (interfaces . (bar-line-interface
1829                                 font-interface
1830                                 span-bar-interface))))))
1831
1832     (StaffGrouper
1833      . (
1834         (staff-staff-spacing . ((basic-distance . 9)
1835                                 (minimum-distance . 7)
1836                                 (padding . 1)
1837                                 (stretchability . 5)))
1838         (staffgroup-staff-spacing . ((basic-distance . 10.5)
1839                                      (minimum-distance . 8)
1840                                      (padding . 1)
1841                                      (stretchability . 9)))
1842         (meta . ((class . Spanner)
1843                  (interfaces . (staff-grouper-interface))))))
1844
1845     (StaffSpacing
1846      . (
1847         (non-musical . #t)
1848         (stem-spacing-correction . 0.4)
1849         (meta . ((class . Item)
1850                  (interfaces . (spacing-interface
1851                                 staff-spacing-interface))))))
1852
1853     (StaffSymbol
1854      . (
1855         (layer . 0)
1856         (ledger-line-thickness . (1.0 . 0.1))
1857         (line-count . 5)
1858         (stencil . ,ly:staff-symbol::print)
1859         (Y-extent . ,ly:staff-symbol::height)
1860         (meta . ((class . Spanner)
1861                  (interfaces . (staff-symbol-interface))))))
1862
1863     (StanzaNumber
1864      . (
1865         (direction . ,LEFT)
1866         (font-series . bold)
1867         (padding . 1.0)
1868         (side-axis . ,X)
1869         (stencil . ,ly:text-interface::print)
1870         (X-offset . ,ly:side-position-interface::x-aligned-side)
1871         (meta . ((class . Item)
1872                  (interfaces . (font-interface
1873                                 side-position-interface
1874                                 stanza-number-interface
1875                                 text-interface))))))
1876
1877     (Stem
1878      . (
1879         (beamlet-default-length . (1.1 . 1.1))
1880         (beamlet-max-length-proportion . (0.75 . 0.75))
1881         (cross-staff . ,ly:stem::calc-cross-staff)
1882         (default-direction . ,ly:stem::calc-default-direction)
1883         (details
1884          . (
1885             ;; 3.5 (or 3 measured from note head) is standard length
1886             ;; 32nd, 64th, 128th flagged stems should be longer
1887             (lengths . (3.5 3.5 3.5 4.25 5.0 6.0))
1888
1889             ;; FIXME.  3.5 yields too long beams (according to Ross and
1890             ;; looking at Baerenreiter examples) for a number of common
1891             ;; boundary cases.  Subtracting half a beam thickness fixes
1892             ;; this, but the bug may well be somewhere else.
1893
1894             ;; FIXME this should come from 'lengths
1895             (beamed-lengths . (3.26 3.5 3.6))
1896
1897             ;; The 'normal' minima
1898             (beamed-minimum-free-lengths . (1.83 1.5 1.25))
1899                                         ;(beamed-minimum-free-lengths . (2.0 1.83 1.25))
1900
1901             ;; The 'extreme case' minima
1902             (beamed-extreme-minimum-free-lengths . (2.0 1.25))
1903
1904             ;; Stems in unnatural (forced) direction should be shortened by
1905             ;; one staff space, according to [Roush & Gourlay].
1906             ;; Flagged stems we shorten only half a staff space.
1907             (stem-shorten . (1.0 0.5))
1908
1909             ))
1910
1911         ;; We use the normal minima as minimum for the ideal lengths,
1912         ;; and the extreme minima as abolute minimum length.
1913
1914         (direction . ,ly:stem::calc-direction)
1915         (duration-log . ,stem::calc-duration-log)
1916         (flag . ,ly:stem::calc-flag)
1917         (length . ,ly:stem::calc-length)
1918         (neutral-direction . ,DOWN)
1919         (positioning-done . ,ly:stem::calc-positioning-done)
1920         (stem-begin-position . ,ly:stem::calc-stem-begin-position)
1921         (stem-end-position . ,ly:stem::calc-stem-end-position)
1922         (stem-info . ,ly:stem::calc-stem-info)
1923         (stencil . ,ly:stem::print)
1924         (thickness . 1.3)
1925         (X-extent . ,ly:stem::width)
1926         (X-offset . ,ly:stem::offset-callback)
1927         (Y-extent . ,ly:stem::height)
1928         (Y-offset . ,ly:staff-symbol-referencer::callback)
1929         (meta . ((class . Item)
1930                  (interfaces . (font-interface
1931                                 stem-interface))))))
1932
1933     (StemTremolo
1934      . (
1935         (beam-thickness . 0.48) ; staff-space
1936         (beam-width . ,ly:stem-tremolo::calc-width) ; staff-space
1937         (slope . ,ly:stem-tremolo::calc-slope)
1938         (stencil . ,ly:stem-tremolo::print)
1939         (style . ,ly:stem-tremolo::calc-style)
1940         (X-extent . ,ly:stem-tremolo::width)
1941         (meta . ((class . Item)
1942                  (interfaces . (stem-tremolo-interface))))))
1943
1944     (StringNumber
1945      . (
1946         (avoid-slur . around)
1947         (font-encoding . fetaText)
1948         (font-size . -5)                ; don't overlap when next to heads.
1949         (padding . 0.5)
1950         (script-priority . 100)
1951         (self-alignment-X . ,CENTER)
1952         (self-alignment-Y . ,CENTER)
1953         (staff-padding . 0.5)
1954         (stencil . ,print-circled-text-callback)
1955         (text . ,string-number::calc-text)
1956         (meta . ((class . Item)
1957                  (interfaces . (font-interface
1958                                 self-alignment-interface
1959                                 side-position-interface
1960                                 string-number-interface
1961                                 text-interface
1962                                 text-script-interface))))))
1963
1964     (StrokeFinger
1965      . (
1966         (digit-names . #("p" "i" "m" "a" "x"))
1967         (font-shape . italic)
1968         (font-size . -4)                ; don't overlap when next to heads.
1969         (padding . 0.5)
1970         (script-priority . 100)
1971         (self-alignment-X . ,CENTER)
1972         (self-alignment-Y . ,CENTER)
1973         (staff-padding . 0.5)
1974         (stencil . ,ly:text-interface::print)
1975         (text . ,stroke-finger::calc-text)
1976         (meta . ((class . Item)
1977                  (interfaces . (font-interface
1978                                 self-alignment-interface
1979                                 side-position-interface
1980                                 stroke-finger-interface
1981                                 text-interface
1982                                 text-script-interface))))))
1983
1984     (SustainPedal
1985      . (
1986         (direction . ,RIGHT)
1987         (extra-spacing-width . (+inf.0 . -inf.0))
1988         (padding . 0.0)  ;; padding relative to SustainPedalLineSpanner
1989         (self-alignment-X . ,CENTER)
1990         (stencil . ,ly:sustain-pedal::print)
1991         (X-offset . ,ly:self-alignment-interface::x-aligned-on-self)
1992         (meta . ((class . Item)
1993                  (interfaces . (font-interface
1994                                 piano-pedal-interface
1995                                 piano-pedal-script-interface
1996                                 self-alignment-interface
1997                                 text-interface))))))
1998
1999     (SustainPedalLineSpanner
2000      . (
2001         (axes . (,Y))
2002         (direction . ,DOWN)
2003         (minimum-space . 1.0)
2004         (outside-staff-priority . 1000)
2005         (padding . 1.2)
2006         (side-axis . ,Y)
2007         (staff-padding . 1.2)
2008         (X-extent . ,ly:axis-group-interface::width)
2009         (Y-extent . ,ly:axis-group-interface::height)
2010         (Y-offset . ,ly:side-position-interface::y-aligned-side)
2011         (meta . ((class . Spanner)
2012                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
2013                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
2014                  (interfaces . (axis-group-interface
2015                                 piano-pedal-interface
2016                                 side-position-interface))))))
2017
2018     (System
2019      . (
2020         (adjacent-pure-heights . ,ly:axis-group-interface::adjacent-pure-heights)
2021         (axes . (,X ,Y))
2022         (skyline-horizontal-padding . 0.5)
2023         (vertical-skylines . ,ly:axis-group-interface::calc-skylines)
2024         (X-extent . ,ly:axis-group-interface::width)
2025         (Y-extent . ,ly:system::height)
2026         (meta . ((class . System)
2027                  (object-callbacks . ((pure-relevant-grobs . ,ly:system::calc-pure-relevant-grobs)
2028                                       (pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)))
2029                  (interfaces . (axis-group-interface
2030                                 system-interface))))))
2031
2032     (SystemStartBar
2033      . (
2034         (collapse-height . 5.0)
2035         (direction . ,LEFT)
2036
2037         ;; ugh--hardcoded.
2038         (padding . -0.1)  ;; bar must cover rounded ending of staff line.
2039         (stencil . ,ly:system-start-delimiter::print)
2040         (style . bar-line)
2041         (thickness . 1.6)
2042         (X-offset . ,ly:side-position-interface::x-aligned-side)
2043         (Y-extent . #f)
2044         (meta . ((class . Spanner)
2045                  (interfaces . (side-position-interface
2046                                 system-start-delimiter-interface))))))
2047
2048     (SystemStartBrace
2049      . (
2050         (collapse-height . 5.0)
2051         (direction . ,LEFT)
2052         (font-encoding . fetaBraces)
2053         (padding . 0.3)
2054         (stencil . ,ly:system-start-delimiter::print)
2055         (style . brace)
2056         (X-offset . ,ly:side-position-interface::x-aligned-side)
2057         (Y-extent . #f)
2058         (meta . ((class . Spanner)
2059                  (interfaces . (font-interface
2060                                 side-position-interface
2061                                 system-start-delimiter-interface))))))
2062
2063     (SystemStartBracket
2064      . (
2065         (collapse-height . 5.0)
2066         (direction . ,LEFT)
2067         (padding . 0.8)
2068         (stencil . ,ly:system-start-delimiter::print)
2069         (style . bracket)
2070         (thickness . 0.45)
2071         (X-offset . ,ly:side-position-interface::x-aligned-side)
2072         (Y-extent . #f)
2073         (meta . ((class . Spanner)
2074                  (interfaces . (font-interface
2075                                 side-position-interface
2076                                 system-start-delimiter-interface))))))
2077
2078     (SystemStartSquare
2079      . (
2080         (direction . ,LEFT)
2081         (stencil . ,ly:system-start-delimiter::print)
2082         (style . line-bracket)
2083         (thickness . 1.0)
2084         (X-offset . ,ly:side-position-interface::x-aligned-side)
2085         (Y-extent . #f)
2086         (meta . ((class . Spanner)
2087                  (interfaces . (font-interface
2088                                 side-position-interface
2089                                 system-start-delimiter-interface))))))
2090
2091
2092     (TabNoteHead
2093      . (
2094         (details . ((cautionary-properties . ((angularity . 0.4)
2095                                               (half-thickness . 0.075)
2096                                               (padding . 0)
2097                                               (procedure . ,parenthesize-stencil)
2098                                               (width . 0.25)))
2099                     (head-offset . 3/5)
2100                     (harmonic-properties . ((angularity . 2)
2101                                             (half-thickness . 0.075)
2102                                             (padding . 0)
2103                                             (procedure . ,parenthesize-stencil)
2104                                             (width . 0.25)))
2105                     (repeat-tied-properties . ((note-head-visible . #t)
2106                                                (parenthesize . #t)))
2107                     (tied-properties . ((break-visibility . ,begin-of-line-visible)
2108                                         (parenthesize . #t)))))
2109
2110         (direction . ,CENTER)
2111         (duration-log . ,note-head::calc-duration-log)
2112         (font-series . bold)
2113         (font-size . -2)
2114         (stem-attachment . (0.0 . 1.35))
2115         (stencil . ,tab-note-head::print)
2116         (whiteout . #t)
2117         (X-offset . ,ly:self-alignment-interface::x-aligned-on-self)
2118         (Y-offset . ,ly:staff-symbol-referencer::callback)
2119         (meta . ((class . Item)
2120                  (interfaces  . (font-interface
2121                                  note-head-interface
2122                                  rhythmic-grob-interface
2123                                  rhythmic-head-interface
2124                                  staff-symbol-referencer-interface
2125                                  tab-note-head-interface
2126                                  text-interface))))))
2127
2128     (TextScript
2129      . (
2130         (avoid-slur . around)
2131         (cross-staff . ,ly:script-interface::calc-cross-staff)
2132         (direction . ,DOWN)
2133         (extra-spacing-width . (+inf.0 . -inf.0))
2134         (outside-staff-priority . 450)
2135
2136         ;; sync with Fingering ?
2137         (padding . 0.5)
2138
2139         (script-priority . 200)
2140         (side-axis . ,Y)
2141         (slur-padding . 0.5)
2142         (staff-padding . 0.5)
2143         (stencil . ,ly:text-interface::print)
2144         ;; todo: add X self alignment?
2145         (X-offset . ,ly:self-alignment-interface::x-aligned-on-self)
2146         (Y-offset . ,ly:side-position-interface::y-aligned-side)
2147         (meta . ((class . Item)
2148                  (interfaces . (font-interface
2149                                 instrument-specific-markup-interface
2150                                 self-alignment-interface
2151                                 side-position-interface
2152                                 text-interface
2153                                 text-script-interface))))))
2154
2155     (TextSpanner
2156      . (
2157         (bound-details . ((left . ((Y . 0)
2158                                    (padding . 0.25)
2159                                    (attach-dir . ,LEFT)
2160                                    ))
2161                           (left-broken . ((end-on-note . #t)))
2162                           (right . ((Y . 0)
2163                                     (padding . 0.25)
2164                                     ))
2165                           ))
2166         (dash-fraction . 0.2)
2167         (dash-period . 3.0)
2168         (direction . ,UP)
2169         (font-shape . italic)
2170         (left-bound-info . ,ly:line-spanner::calc-left-bound-info)
2171         (outside-staff-priority . 350)
2172         (right-bound-info . ,ly:line-spanner::calc-right-bound-info)
2173         (side-axis . ,Y)
2174         (staff-padding . 0.8)
2175         (stencil . ,ly:line-spanner::print)
2176         (style . dashed-line)
2177         (Y-offset . ,ly:side-position-interface::y-aligned-side)
2178
2179         (meta . ((class . Spanner)
2180                  (interfaces . (font-interface
2181                                 line-interface
2182                                 line-spanner-interface
2183                                 side-position-interface))))))
2184
2185     (Tie
2186      . (
2187         (avoid-slur . inside)
2188         (control-points . ,ly:tie::calc-control-points)
2189         (details . (
2190                     ;; for a full list, see tie-details.cc
2191                     (ratio . 0.333)
2192                     (center-staff-line-clearance . 0.6)
2193                     (tip-staff-line-clearance . 0.45)
2194                     (note-head-gap . 0.2)
2195                     (stem-gap . 0.35)
2196                     (height-limit . 1.0)
2197                     (horizontal-distance-penalty-factor . 10)
2198                     (same-dir-as-stem-penalty . 8)
2199                     (min-length-penalty-factor . 26)
2200                     (tie-tie-collision-distance . 0.45)
2201                     (tie-tie-collision-penalty . 25.0)
2202                     (intra-space-threshold . 1.25)
2203                     (outer-tie-vertical-distance-symmetry-penalty-factor . 10)
2204                     (outer-tie-length-symmetry-penalty-factor . 10)
2205                     (vertical-distance-penalty-factor . 7)
2206                     (outer-tie-vertical-gap . 0.25)
2207                     (multi-tie-region-size . 3)
2208                     (single-tie-region-size . 4)
2209                     (between-length-limit . 1.0)))
2210
2211         (direction . ,ly:tie::calc-direction)
2212         (font-size . -6)
2213         (line-thickness . 0.8)
2214         (neutral-direction . ,UP)
2215         (springs-and-rods . ,ly:spanner::set-spacing-rods)
2216         (stencil . ,ly:tie::print)
2217         (thickness . 1.2)
2218         (meta . ((class . Spanner)
2219                  (interfaces . (tie-interface))))))
2220
2221     (TieColumn
2222      . (
2223         (before-line-breaking . ,ly:tie-column::before-line-breaking)
2224         (positioning-done . ,ly:tie-column::calc-positioning-done)
2225         (X-extent . #f)
2226         (Y-extent . #f)
2227         (meta . ((class . Spanner)
2228                  (interfaces . (tie-column-interface))))))
2229
2230     (TimeSignature
2231      . (
2232         (avoid-slur . inside)
2233         (break-align-anchor
2234          . ,ly:break-aligned-interface::calc-extent-aligned-anchor)
2235         (break-align-symbol . time-signature)
2236         (break-align-anchor-alignment . ,LEFT)
2237         (break-visibility . ,all-visible)
2238         (extra-spacing-height . (-1.0 . 1.0))
2239         (non-musical . #t)
2240         (space-alist . (
2241                         (cue-clef . (extra-space . 1.5))
2242                         (first-note . (fixed-space . 2.0))
2243                         (right-edge . (extra-space . 0.5))
2244                         (staff-bar . (minimum-space . 2.0))))
2245         (stencil . ,ly:time-signature::print)
2246         (style . C)
2247         (meta . ((class . Item)
2248                  (interfaces . (break-aligned-interface
2249                                 font-interface
2250                                 time-signature-interface))))))
2251
2252     (TrillPitchAccidental
2253      . (
2254         (direction . ,LEFT)
2255         (font-size . -4)
2256         (glyph-name-alist . ,standard-alteration-glyph-name-alist)
2257         (padding . 0.2)
2258         (side-axis . ,X)
2259         (stencil . ,ly:accidental-interface::print)
2260         (X-offset . ,ly:side-position-interface::x-aligned-side)
2261         (Y-extent . ,ly:accidental-interface::height)
2262         (meta . ((class . Item)
2263                  (interfaces . (accidental-interface
2264                                 font-interface
2265                                 inline-accidental-interface
2266                                 side-position-interface
2267                                 trill-pitch-accidental-interface))))))
2268
2269     (TrillPitchGroup
2270      . (
2271         (axes . (,X))
2272         (direction . ,RIGHT)
2273         (font-size . -4)
2274         (padding . 0.3)
2275         (side-axis . ,X)
2276         (stencil . ,parenthesize-elements)
2277         (stencils . ,parentheses-item::calc-parenthesis-stencils)
2278         (X-offset . ,ly:side-position-interface::x-aligned-side)
2279         (meta . ((class . Item)
2280                  (interfaces . (axis-group-interface
2281                                 font-interface
2282                                 note-head-interface
2283                                 parentheses-interface
2284                                 side-position-interface))))))
2285
2286     (TrillPitchHead
2287      . (
2288         (duration-log . 2)
2289         (font-size . -4)
2290         (stencil . ,ly:note-head::print)
2291         (Y-offset . ,ly:staff-symbol-referencer::callback)
2292         (meta . ((class . Item)
2293                  (interfaces . (font-interface
2294                                 ledgered-interface
2295                                 pitched-trill-interface
2296                                 rhythmic-head-interface
2297                                 staff-symbol-referencer-interface))))))
2298
2299     (TrillSpanner
2300      . (
2301         (after-line-breaking . ,ly:spanner::kill-zero-spanned-time)
2302         (bound-details . ((left . ((text . ,(make-musicglyph-markup "scripts.trill"))
2303                                    (Y . 0)
2304                                    (stencil-offset . (-0.5 . -1))
2305                                    (padding . 0.5)
2306                                    (attach-dir . ,CENTER)
2307                                    ))
2308                           (left-broken . ((end-on-note . #t)))
2309                           (right . ((Y . 0)))
2310                           ))
2311         (direction . ,UP)
2312         (left-bound-info . ,ly:line-spanner::calc-left-bound-info)
2313         (outside-staff-priority . 50)
2314         (padding . 0.5)
2315         (right-bound-info . ,ly:line-spanner::calc-right-bound-info)
2316         (side-axis . ,Y)
2317         (staff-padding . 1.0)
2318         (stencil . ,ly:line-spanner::print)
2319         (style . trill)
2320         (Y-offset . ,ly:side-position-interface::y-aligned-side)
2321         (meta . ((class . Spanner)
2322                  (interfaces . (font-interface
2323                                 line-interface
2324                                 line-spanner-interface
2325                                 side-position-interface
2326                                 trill-spanner-interface))))))
2327
2328     (TupletBracket
2329      . (
2330         (connect-to-neighbor . ,ly:tuplet-bracket::calc-connect-to-neighbors)
2331         (control-points . ,ly:tuplet-bracket::calc-control-points)
2332         (cross-staff . ,ly:tuplet-bracket::calc-cross-staff)
2333         (direction  . ,ly:tuplet-bracket::calc-direction)
2334         (edge-height . (0.7 . 0.7))
2335         (full-length-to-extent . #t)
2336         (padding . 1.1)
2337         (positions . ,ly:tuplet-bracket::calc-positions)
2338         (shorten-pair . (-0.2 . -0.2))
2339         (staff-padding . 0.25)
2340         (stencil . ,ly:tuplet-bracket::print)
2341         (thickness . 1.6)
2342
2343         (meta . ((class . Spanner)
2344                  (interfaces . (line-interface
2345                                 tuplet-bracket-interface))))))
2346
2347     (TupletNumber
2348      . (
2349         (avoid-slur . inside)
2350         (cross-staff . ,ly:tuplet-number::calc-cross-staff)
2351         (direction . ,tuplet-number::calc-direction)
2352         (font-shape . italic)
2353         (font-size . -2)
2354         (stencil . ,ly:tuplet-number::print)
2355         (text . ,tuplet-number::calc-denominator-text)
2356         (meta . ((class . Spanner)
2357                  (interfaces . (font-interface
2358                                 text-interface
2359                                 tuplet-number-interface))))))
2360
2361
2362     (UnaCordaPedal
2363      . (
2364         (direction . ,RIGHT)
2365         (extra-spacing-width . (+inf.0 . -inf.0))
2366         (font-shape . italic)
2367         (padding . 0.0)  ;; padding relative to UnaCordaPedalLineSpanner
2368         (self-alignment-X . ,CENTER)
2369         (stencil . ,ly:text-interface::print)
2370         (X-offset . ,ly:self-alignment-interface::x-aligned-on-self)
2371         (meta . ((class . Item)
2372                  (interfaces . (font-interface
2373                                 piano-pedal-script-interface
2374                                 self-alignment-interface
2375                                 text-interface))))))
2376
2377     (UnaCordaPedalLineSpanner
2378      . (
2379         (axes . (,Y))
2380         (direction . ,DOWN)
2381         (minimum-space . 1.0)
2382         (outside-staff-priority . 1000)
2383         (padding . 1.2)
2384         (side-axis . ,Y)
2385         (staff-padding . 1.2)
2386         (X-extent . ,ly:axis-group-interface::width)
2387         (Y-extent . ,ly:axis-group-interface::height)
2388         (Y-offset . ,ly:side-position-interface::y-aligned-side)
2389         (meta . ((class . Spanner)
2390                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
2391                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
2392                  (interfaces . (axis-group-interface
2393                                 piano-pedal-interface
2394                                 side-position-interface))))))
2395
2396
2397     (VaticanaLigature
2398      . (
2399         (flexa-width . 2.0)
2400         (stencil . ,ly:vaticana-ligature::print)
2401         (thickness . 0.6)
2402         (meta . ((class . Spanner)
2403                  (interfaces . (font-interface
2404                                 vaticana-ligature-interface))))))
2405
2406     (VerticalAlignment
2407      . (
2408         (axes . (,Y))
2409         (positioning-done . ,ly:align-interface::align-to-ideal-distances)
2410         (stacking-dir . -1)
2411         (vertical-skylines . ,ly:axis-group-interface::combine-skylines)
2412         (X-extent . ,ly:axis-group-interface::width)
2413         (Y-extent . ,ly:axis-group-interface::height)
2414         (meta . ((class . Spanner)
2415                  (object-callbacks . ((Y-common . ,ly:axis-group-interface::calc-y-common)
2416                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)
2417                                       (pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)))
2418                  (interfaces . (align-interface
2419                                 axis-group-interface))))))
2420
2421     (VerticalAxisGroup
2422      . (
2423         (adjacent-pure-heights . ,ly:axis-group-interface::adjacent-pure-heights)
2424         (axes . (,Y))
2425         (default-staff-staff-spacing . ((basic-distance . 9)
2426                                         (minimum-distance . 8)
2427                                         (padding . 1)))
2428         (nonstaff-unrelatedstaff-spacing . ((padding . 0.5)))
2429         (staff-staff-spacing . ,ly:axis-group-interface::calc-staff-staff-spacing)
2430         (stencil . ,ly:axis-group-interface::print)
2431         (vertical-skylines . ,ly:hara-kiri-group-spanner::calc-skylines)
2432         (X-extent . ,ly:axis-group-interface::width)
2433         (Y-extent . ,ly:hara-kiri-group-spanner::y-extent)
2434         (Y-offset . ,ly:hara-kiri-group-spanner::force-hara-kiri-callback)
2435         (meta . ((class . Spanner)
2436                  (object-callbacks . (
2437                                       (X-common . ,ly:axis-group-interface::calc-x-common)
2438                                       (pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
2439                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
2440
2441                  (interfaces . (axis-group-interface
2442                                 hara-kiri-group-spanner-interface))))))
2443
2444     (VoiceFollower
2445      . (
2446         (after-line-breaking . ,ly:spanner::kill-zero-spanned-time)
2447         (bound-details . ((right . ((attach-dir .  ,CENTER)
2448                                     (padding . 1.5)
2449                                       ))
2450                           (left . ((attach-dir .  ,CENTER)
2451                                    (padding . 1.5)
2452                                       ))
2453                           ))
2454         (gap . 0.5)
2455         (left-bound-info . ,ly:line-spanner::calc-left-bound-info)
2456         (non-musical . #t)
2457         (right-bound-info . ,ly:line-spanner::calc-right-bound-info)
2458         (stencil . ,ly:line-spanner::print)
2459         (style . line)
2460         (X-extent . #f)
2461         (Y-extent . #f)
2462         (meta . ((class . Spanner)
2463                  (interfaces . (line-interface
2464                                 line-spanner-interface))))))
2465
2466     (VoltaBracket
2467      . (
2468         (direction . ,UP)
2469         (edge-height . (2.0 . 2.0)) ;; staff-space;
2470         (font-encoding . fetaText)
2471         (font-size . -4)
2472         (stencil . ,ly:volta-bracket-interface::print)
2473         (thickness . 1.6) ;; line-thickness
2474         (word-space . 0.6)
2475         (meta . ((class . Spanner)
2476                  (interfaces . (font-interface
2477                                 horizontal-bracket-interface
2478                                 line-interface
2479                                 side-position-interface
2480                                 text-interface
2481                                 volta-bracket-interface
2482                                 volta-interface))))))
2483
2484     (VoltaBracketSpanner
2485      . (
2486         (after-line-breaking . ,ly:side-position-interface::move-to-extremal-staff)
2487         (axes . (,Y))
2488         (direction . ,UP)
2489         (no-alignment . #t)
2490         (outside-staff-priority . 600)
2491         (padding . 1)
2492         (side-axis . ,Y)
2493         (X-extent . ,ly:axis-group-interface::width)
2494         (Y-extent . ,ly:axis-group-interface::height)
2495         (Y-offset . ,ly:side-position-interface::y-aligned-side)
2496         (meta . ((class . Spanner)
2497                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
2498                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
2499                  (interfaces . (axis-group-interface
2500                                 side-position-interface
2501                                 volta-interface))))))
2502
2503 ))
2504
2505 (define (completize-grob-entry x)
2506   "Transplant assoc key into 'name entry of 'meta of X.  Set interfaces for Item, Spanner etc.
2507 "
2508   ;;  (display (car x))
2509   ;;  (newline)
2510   (let* ((name-sym  (car x))
2511          (grob-entry (cdr x))
2512          (meta-entry (assoc-get 'meta grob-entry))
2513          (class (assoc-get 'class meta-entry))
2514          (ifaces-entry
2515           (assoc-get 'interfaces meta-entry)))
2516
2517     (cond
2518      ((eq? 'Item class)
2519       (set! ifaces-entry (cons 'item-interface ifaces-entry)))
2520      ((eq? 'Spanner class)
2521       (set! ifaces-entry (cons 'spanner-interface ifaces-entry)))
2522      ((eq? 'Paper_column class)
2523       (set! ifaces-entry (cons 'item-interface
2524                                (cons 'paper-column-interface ifaces-entry))))
2525      ((eq? 'System class)
2526       (set! ifaces-entry (cons 'system-interface
2527                                (cons 'spanner-interface ifaces-entry))))
2528      (else
2529       (ly:warning "Unknown class ~a" class)))
2530
2531     (set! ifaces-entry (uniq-list (sort ifaces-entry symbol<?)))
2532     (set! ifaces-entry (cons 'grob-interface ifaces-entry))
2533
2534     (set! meta-entry (assoc-set! meta-entry 'name name-sym))
2535     (set! meta-entry (assoc-set! meta-entry 'interfaces
2536                                  ifaces-entry))
2537     (set! grob-entry (assoc-set! grob-entry 'meta meta-entry))
2538     (cons name-sym grob-entry)))
2539
2540 (set! all-grob-descriptions (map completize-grob-entry all-grob-descriptions))
2541
2542 ;;  (display (map pair? all-grob-descriptions))
2543
2544 ;; make sure that \property Foo.Bar =\turnOff doesn't complain
2545
2546 (map (lambda (x)
2547        ;; (display (car x)) (newline)
2548
2549        (set-object-property! (car x) 'translation-type? list?)
2550        (set-object-property! (car x) 'is-grob? #t))
2551      all-grob-descriptions)
2552
2553 (set! all-grob-descriptions (sort all-grob-descriptions alist<?))
2554
2555 (define (volta-bracket-interface::pure-height grob start end)
2556   (let ((edge-height (ly:grob-property grob 'edge-height)))
2557     (if (number-pair? edge-height)
2558         (let ((smaller (min (car edge-height) (cdr edge-height)))
2559               (larger (max (car edge-height) (cdr edge-height))))
2560           (interval-union '(0 . 0) (cons smaller larger)))
2561         '(0 . 0))))
2562
2563 (define pure-print-callbacks
2564   (list
2565    fret-board::calc-stencil
2566    note-head::brew-ez-stencil
2567    print-circled-text-callback
2568    laissez-vibrer::print
2569    lyric-text::print
2570    ly:bar-line::print
2571    ly:mensural-ligature::brew-ligature-primitive
2572    ly:note-head::print
2573    ly:dots::print
2574    ly:clef::print
2575    ly:key-signature-interface::print
2576    ly:percent-repeat-item-interface::beat-slash
2577    ly:text-interface::print
2578    ly:script-interface::print
2579    ly:sustain-pedal::print))
2580
2581 ;; Sometimes we have grobs with (Y-extent . ,ly:grob::stencil-height)
2582 ;; and the print function is not pure, but there is a easy way to
2583 ;; figure out the Y-extent from the print function.
2584 (define pure-print-to-height-conversions
2585   `(
2586     (,ly:arpeggio::print . ,ly:arpeggio::pure-height)
2587     (,ly:arpeggio::brew-chord-bracket . ,ly:arpeggio::pure-height)
2588     (,ly:arpeggio::brew-chord-slur . ,ly:arpeggio::pure-height)
2589     (,ly:hairpin::print . ,ly:hairpin::pure-height)
2590     (,ly:stem-tremolo::print . ,ly:stem-tremolo::pure-height)
2591     (,ly:volta-bracket-interface::print . ,volta-bracket-interface::pure-height)))
2592
2593 ;; ly:grob::stencil-extent is safe if the print callback is safe too
2594 (define (pure-stencil-height grob start stop)
2595   (let* ((sten (ly:grob-property-data grob 'stencil))
2596          (pure-height-callback (assoc-get sten pure-print-to-height-conversions)))
2597     (cond ((or
2598             (ly:stencil? sten)
2599             (memq sten pure-print-callbacks))
2600            (ly:grob::stencil-height grob))
2601           ((procedure? pure-height-callback)
2602            (pure-height-callback grob start stop))
2603           (else
2604            '(0 . 0)))))
2605
2606 ;; Sometimes, a pure callback will be chained to a non-pure callback via
2607 ;; chain_offset_callback, in which case this provides a default by simply
2608 ;; passing through the value from the pure callback.
2609 (define (pure-chain-offset-callback grob start end prev-offset) prev-offset)
2610
2611 (define pure-conversions-alist
2612   `(
2613     (,ly:accidental-interface::height . ,ly:accidental-interface::pure-height)
2614     (,ly:axis-group-interface::calc-staff-staff-spacing . ,ly:axis-group-interface::calc-pure-staff-staff-spacing)
2615     (,ly:axis-group-interface::height . ,ly:axis-group-interface::pure-height)
2616     (,ly:grob::stencil-height . ,pure-stencil-height)
2617     (,ly:hara-kiri-group-spanner::y-extent . ,ly:hara-kiri-group-spanner::pure-height)
2618     (,ly:rest-collision::force-shift-callback-rest . ,pure-chain-offset-callback)
2619     (,ly:rest::height . ,ly:rest::pure-height)
2620     (,ly:self-alignment-interface::y-aligned-on-self . ,ly:self-alignment-interface::pure-y-aligned-on-self)
2621     (,ly:side-position-interface::y-aligned-side . ,ly:side-position-interface::pure-y-aligned-side)
2622     (,ly:slur::height . ,ly:slur::pure-height)
2623     (,ly:slur::outside-slur-callback . ,ly:slur::pure-outside-slur-callback)
2624     (,ly:stem::height . ,ly:stem::pure-height)
2625     (,ly:system::height . ,ly:system::calc-pure-height)))
2626
2627 (define pure-functions
2628   (list
2629    parenthesize-elements
2630    laissez-vibrer::print
2631    ly:rest::y-offset-callback
2632    ly:staff-symbol-referencer::callback
2633    ly:staff-symbol::height))
2634
2635 (define-public (pure-relevant? grob)
2636   (let ((extent-callback (ly:grob-property-data grob 'Y-extent)))
2637     (not (eq? #f
2638               (or
2639                (pair? extent-callback)
2640                (memq extent-callback pure-functions)
2641                (and
2642                 (pair? (assq extent-callback pure-conversions-alist))
2643                 (let ((stencil (ly:grob-property-data grob 'stencil)))
2644                   (or
2645                    (not (eq? extent-callback ly:grob::stencil-height))
2646                    (memq stencil pure-print-callbacks)
2647                    (assq stencil pure-print-to-height-conversions)
2648                    (ly:stencil? stencil)))))))))
2649
2650 (define-public (call-pure-function unpure args start end)
2651   (if (ly:simple-closure? unpure)
2652       (ly:eval-simple-closure (car args) unpure start end)
2653       (if (not (procedure? unpure))
2654           unpure
2655           (if (memq unpure pure-functions)
2656               (apply unpure args)
2657               (let ((pure (assq unpure pure-conversions-alist)))
2658                 (if pure
2659                     (apply (cdr pure)
2660                            (append
2661                             (list (car args) start end)
2662                             (cdr args)))))))))