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