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