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