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