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