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