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