]> git.donarmstrong.com Git - lilypond.git/blob - scm/grob-description.scm
''
[lilypond.git] / scm / grob-description.scm
1 ;;;; grob-description.scm -- part of generated backend documentation
2 ;;;;
3 ;;;;  source file of the GNU LilyPond music typesetter
4 ;;;; 
5 ;;;; (c) 1998--20.301  Han-Wen Nienhuys <hanwen@cs.uu.nl>
6 ;;;;                 Jan Nieuwenhuizen <janneke@gnu.org>
7
8 ;;;; distances are given in stafflinethickness (thicknesses) and
9 ;;;; staffspace (distances)
10
11 ;;;; WARNING: the meta field should be the last one.
12
13 ;; TODO: junk the meta field in favor of something more compact?
14 (define all-grob-descriptions
15   `(
16     (Accidentals
17      . (
18         (molecule-callback . ,Local_key_item::brew_molecule)
19         (X-offset-callbacks . (,Side_position_interface::aligned_side))
20         (Y-offset-callbacks . (,Staff_symbol_referencer::callback))     
21         (after-line-breaking-callback . ,Local_key_item::after_line_breaking)
22         (direction . -1)
23         (left-padding . 0.2)
24         (right-padding . 0.5)
25         (paren-cautionaries . #t)
26         (font-family . music)
27         (meta . ((interfaces . (accidentals-interface staff-symbol-referencer-interface font-interface side-position-interface))))
28         ))
29
30     (Arpeggio
31      . (
32         (X-extent-callback . ,Arpeggio::width_callback)
33         (Y-extent-callback . #f)               
34         (molecule-callback . ,Arpeggio::brew_molecule)
35         (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
36         (X-offset-callbacks . (,Side_position_interface::aligned_side))
37         (direction . -1)
38         (staff-position . 0.0)
39         (meta . ((interfaces . (arpeggio-interface staff-symbol-referencer-interface side-position-interface font-interface))))
40         ))
41
42     (BarLine
43      . (
44         (break-align-symbol . staff-bar)
45         (glyph . "|")
46         (break-glyph-function . ,default-break-barline)
47         (bar-size-procedure . ,Bar_line::get_staff_bar_size)
48         (molecule-callback . ,Bar_line::brew_molecule)     
49         (visibility-lambda . ,all-visible)
50         (breakable . #t)
51         (before-line-breaking-callback . ,Bar_line::before_line_breaking)
52         (space-alist . (
53                         (time-signature . (extra-space . 0.75)) 
54                         (custos . (minimum-space . 2.0))
55                         (clef .   (minimum-space . 1.0))
56                         (first-note . (extra-space . 1.3))
57                         ))
58
59         ;;
60         ;; Ross. page 151 lists other values, we opt for a leaner look
61         ;; 
62         (kern . 3.0)
63         (thin-kern . 3.0)
64         (hair-thickness . 1.6)
65         (thick-thickness . 6.0)
66         (meta . ((interfaces . (bar-line-interface  break-aligned-interface font-interface))))
67         ))
68
69     
70     (BarNumber
71      . (
72         (molecule-callback . ,Text_item::brew_molecule)
73         (breakable . #t)
74         (visibility-lambda . ,begin-of-line-visible)
75         (padding . 1.0)
76         (direction . 1)
77         (font-family . roman)
78         (font-relative-size . -1)
79         (Y-offset-callbacks . (,Side_position_interface::aligned_side))
80         (meta .
81               ((interfaces . (side-position-interface
82                               text-interface
83                               font-interface break-aligned-interface))))
84
85              ))
86
87     (BassFigure
88      . (
89         (molecule-callback . ,brew-bass-figure)
90         (Y-offset-callbacks . (,Side_position_interface::aligned_on_self))
91         (direction . 0)
92         (font-family . number)
93         (font-relative-size . -1)
94         (padding . 0.1)
95         (kern . 0.2)
96         (thickness . 1.0)
97         (meta . ((interfaces . (text-interface font-interface))))
98         ))
99     (Beam
100      . (
101         ;; todo: clean this up a bit: the list is getting
102         ;; rather long.
103         (molecule-callback . ,Beam::brew_molecule)
104         (concaveness-gap . 2.0)
105         (concaveness-threshold . 0.08)
106         (positions . (#f . #f))
107         (position-callbacks . (,Beam::least_squares
108                                ,Beam::check_concave
109                                ,Beam::slope_damping
110                                ,Beam::quanting
111                               ))
112
113         ;; TODO: should be in SLT.
114         (thickness . 0.48) ; in staff-space
115         (before-line-breaking-callback . ,Beam::before_line_breaking)
116         (after-line-breaking-callback . ,Beam::after_line_breaking)
117         (neutral-direction . -1)
118         (dir-function . ,beam-dir-majority-median)
119         (beamed-stem-shorten . (1.0 0.5))
120         (outer-stem-length-limit . 0.2)
121         (slope-limit . 0.2)
122         (flag-width-function . ,default-beam-flag-width-function)
123         (damping . 1)
124         (auto-knee-gap . 7)
125         (font-name . "cmr10")
126         (meta . ((interfaces . (staff-symbol-referencer-interface beam-interface))))
127         ))
128
129     (BreakAlignment
130      . (
131         (breakable . #t)
132         (stacking-dir . 1)
133         (axes . (0))
134         (X-extent-callback . ,Axis_group_interface::group_extent_callback)
135         (meta . ((interfaces . (break-alignment-interface axis-group-interface)))))
136         )
137
138     (BreakAlignGroup
139      . (
140         (axes  . (0))
141         (X-offset-callbacks . (,Break_align_interface::alignment_callback))
142         (X-extent-callback . ,Axis_group_interface::group_extent_callback)
143         (meta . ((interfaces . (break-aligned-interface axis-group-interface))))
144         ))
145
146     (BreathingSign
147      . (
148         (break-align-symbol . breathing-sign)
149         (breakable . #t)
150         (space-alist . (
151                         (key-signature . (minimum-space . 1.5))
152                         (staff-bar . (minimum-space . 1.5))
153                         (clef . (minimum-space . 2.0))
154                         (first-note . (minimum-space . 1.0))
155                         ))
156         (molecule-callback . ,Text_item::brew_molecule)
157         (lookup . name)
158         (font-family . music)
159         (text . "scripts-rcomma")
160         (Y-offset-callbacks . (,Breathing_sign::offset_callback))
161         (visibility-lambda . ,begin-of-line-invisible)
162         (meta . ((interfaces . (break-aligned-interface breathing-sign-interface text-interface font-interface))))
163         ))
164
165     (Clef
166      . (
167         (molecule-callback . ,Clef::brew_molecule)
168         (before-line-breaking-callback . ,Clef::before_line_breaking)
169         (breakable . #t)
170         (font-family . music)      
171         (break-align-symbol . clef)
172         (visibility-lambda . ,begin-of-line-visible)
173         (space-alist . (
174                         (staff-bar . (minimum-space .  3.7))
175                         (key-signature . (minimum-space . 4.0))
176                         (time-signature . (minimum-space . 4.2))
177                         (first-note . (minimum-space . 5.0))
178                         (next-note . (extra-space . 0.5))                       
179                         ))
180         (Y-offset-callbacks  . (,Staff_symbol_referencer::callback)) 
181         (meta . ((interfaces . (clef-interface staff-symbol-referencer-interface font-interface break-aligned-interface))))
182         ))
183
184     (ChordName
185      . (
186         (molecule-callback . ,Chord_name::brew_molecule)
187         (after-line-breaking-callback . ,Chord_name::after_line_breaking)
188         (chord-name-function . ,default-chord-name-function)
189         (font-family . roman)
190         (meta . ((interfaces . (font-interface text-interface chord-name-interface))))
191         ))
192
193     (Custos
194      . (
195         (break-align-symbol . custos)
196         (breakable . #t)
197         (molecule-callback . ,Custos::brew_molecule)
198         (visibility-lambda . ,end-of-line-visible)
199         (style . vaticana)
200         (neutral-position . 0)
201         (neutral-direction . -1)
202         (adjust-if-on-staffline . #t)
203         (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
204         (font-family . music)
205         (space-alist . (
206                         (first-note . (minimum-space . 0.0))
207                         ))
208         (meta . ((interfaces . (custos-interface staff-symbol-referencer-interface break-aligned-interface))))
209         ))
210
211
212     (DotColumn
213      . (
214         (axes . (0))
215         (direction . 1)
216         (X-extent-callback . ,Axis_group_interface::group_extent_callback)
217         (X-offset-callbacks . (,Dot_column::side_position))
218         (meta . ((interfaces . (dot-column-interface axis-group-interface))))
219         ))
220
221     (Dots
222      . (
223         (molecule-callback . ,Dots::brew_molecule)
224         (dot-count . 1)
225         (Y-offset-callbacks  . (,Dots::quantised_position_callback ,Staff_symbol_referencer::callback))
226         (meta . ((interfaces . (font-interface staff-symbol-referencer-interface dots-interface))))
227         ))
228
229     (DoublePercentRepeat .
230                          (
231                           (molecule-callback . ,Percent_repeat_item_interface::double_percent)
232                           (breakable . #t)
233                           (slope . 1.0)
234                           (font-family . music)
235                           (width . 2.0)
236                           (thickness . 0.48)
237                           (break-align-symbol . staff-bar)
238                           (visibility-lambda . ,begin-of-line-invisible)
239                           (meta . ((interfaces . (font-interface percent-repeat-interface))))
240                          ))
241
242     (DynamicText
243      . (
244         (Y-offset-callbacks . (,Side_position_interface::aligned_on_self))
245         (molecule-callback . ,Text_item::brew_molecule)
246         (X-offset-callbacks . (,Side_position_interface::aligned_on_self))
247         (self-alignment-X . 0)
248         (no-spacing-rods . #t)
249         (script-priority . 100)
250         (font-series . bold)
251         (font-family . dynamic)
252         (font-shape . italic)
253         (self-alignment-Y . 0)
254         (meta . ((interfaces . (font-interface text-interface dynamic-interface))))
255         ))
256
257     (DynamicLineSpanner
258      . (
259         (axes . (1))
260         (Y-extent-callback . ,Axis_group_interface::group_extent_callback)      
261         
262         (padding . 0.6)
263         (minimum-space . 1.2)
264         (direction . -1)
265         (meta . ((interfaces . (dynamic-interface axis-group-interface side-position-interface))))
266         ))
267
268     (LeftEdge
269      . (
270         (break-align-symbol . left-edge)
271         (X-offset-callbacks . (,Break_align_interface::alignment_callback))
272         (X-extent-callback . ,Grob::point_dimension_callback)
273         (breakable . #t)
274         (space-alist . (
275                         (time-signature . (extra-space . 0.0)) 
276                         (staff-bar . (extra-space . 0.0))
277                         (breathing-sign . (minimum-space  . 0.0))
278                         (clef . (extra-space . 1.0))
279                         (first-note . (extra-space . 0.0))
280                         (key-signature . (extra-space . 0.0))
281                         ))
282         (meta . ((interfaces . (break-aligned-interface))))
283         ))
284
285     (Fingering
286      . (
287         (molecule-callback . ,Text_item::brew_molecule)
288         (X-offset-callbacks . (,Side_position_interface::centered_on_parent
289                                ,Side_position_interface::aligned_on_self))
290         (padding . 0.6)
291                                         ;               (direction . -1)
292         (self-alignment-X . 0)
293         (self-alignment-Y . 0)
294         (font-family . number)
295         (font-relative-size . -3)
296         (font-shape . upright)
297         (meta . ((interfaces . (finger-interface font-interface text-script-interface text-interface side-position-interface))))
298         ))
299
300
301     (HaraKiriVerticalGroup
302      . (
303         (Y-offset-callbacks . (,Hara_kiri_group_spanner::force_hara_kiri_callback))
304         (Y-extent-callback . ,Hara_kiri_group_spanner::y_extent)
305         (axes . (1))
306         (meta . ((interfaces . (axis-group-interface hara-kiri-group-interface))))
307         ))
308
309     (Hairpin
310      . (
311         (molecule-callback . ,Hairpin::brew_molecule)
312         (thickness . 1.0)
313         (height . 0.6666)
314         (spacing-procedure . ,Spanner::set_spacing_rods)
315         (minimum-length . 2.0)
316         (if-text-padding . 1.0)
317         (width-correct . -1.0)
318
319         (dash-thickness . 1.2)
320         (dash-length . 4.0)
321         (self-alignment-Y . 0)
322         (Y-offset-callbacks . (,Side_position_interface::aligned_on_self))
323         (meta . ((interfaces . (hairpin-interface dynamic-interface))))
324         ))
325
326     (InstrumentName
327      . (
328         (breakable . #t)
329         (Y-offset-callbacks . (,Side_position_interface::aligned_on_self
330                                ,Side_position_interface::aligned_on_support_refpoints))
331         ;; huh? what's this for?
332         (direction . 0)
333         (space-alist . (
334                         (left-edge . (extra-space . 1.0))
335                         ))
336
337         (self-alignment-Y . 0)
338         (molecule-callback . ,Text_item::brew_molecule)         
339         (break-align-symbol . instrument-name)
340         (visibility-lambda . ,begin-of-line-visible)
341         (baseline-skip . 2)
342         (font-family . roman)
343         (meta . ((interfaces . (font-interface side-position-interface text-interface break-aligned-interface))))
344         ))
345
346     (KeySignature
347      . (
348         (molecule-callback . ,Key_signature_interface::brew_molecule)
349         (space-alist . (
350                         (time-signature . (extra-space . 1.25))
351                         (staff-bar .  (extra-space . 1.1))
352                         (first-note . (extra-space . 2.5))
353                         ))
354         (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
355         (break-align-symbol . key-signature)
356         (visibility-lambda . ,begin-of-line-visible)
357         (breakable . #t)
358         (meta . ((interfaces . (key-signature-interface  font-interface  break-aligned-interface))))
359         ))
360
361
362     (LyricHyphen
363      . (
364         (thickness . 1.0)
365         (height . 0.4)
366         (minimum-length .  0.5) 
367         (maximum-length .  100)
368         (molecule-callback . ,Hyphen_spanner::brew_molecule)
369         (Y-extent-callback . ,Grob::point_dimension_callback)
370         (meta . ((interfaces . (lyric-hyphen-interface))))
371         ))
372
373     (LyricExtender
374      . (
375         (molecule-callback . ,Lyric_extender::brew_molecule)
376         (height . 0.8) ; stafflinethickness;
377         (right-trim-amount . 0.5)
378         (Y-extent-callback . ,Grob::point_dimension_callback)
379         (meta . ((interfaces . (lyric-extender-interface))))
380         ))
381
382     (LyricText
383      . (
384         (molecule-callback . ,Text_item::brew_molecule)
385         (X-offset-callbacks . (,Side_position_interface::aligned_on_self))
386         (self-alignment-X . 0)
387         (non-rhythmic . #t)
388         (word-space . 0.6)
389         (ignore-length-mismatch . #f)
390         (begin-alignment . 4)
391         (end-alignment . 2)
392         (font-family . roman)
393         (font-shape . upright)
394         ;; duh, side-position-interface?
395         (meta . ((interfaces . (lyric-syllable-interface side-position-interface text-interface font-interface))))
396         ))
397
398     (Porrectus
399      . (
400         (style . mensural)
401         (auto-properties . #f)
402         (solid . #f)
403         (width . 2.4)
404         (thickness . 1.0)
405         (add-stem . #t)
406         (direction . 1)
407         (molecule-callback . ,Porrectus::brew_molecule)
408         (meta . ((interfaces . (porrectus-interface))))
409         ))
410
411     (RehearsalMark
412      . (
413         (molecule-callback . ,Text_item::brew_molecule)
414         (X-offset-callbacks . (,Side_position_interface::aligned_on_self))
415         (self-alignment-X . 0)
416
417         (direction . 1)
418         (breakable . #t)
419         (visibility-lambda . ,end-of-line-invisible)
420         (padding . 0.8)
421         (meta . ((interfaces . (text-interface font-interface mark-interface side-position-interface))))
422         ))
423
424     (MultiMeasureRest
425      . (
426         (spacing-procedure . ,Multi_measure_rest::set_spacing_rods)
427         (molecule-callback . ,Multi_measure_rest::brew_molecule)
428         (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
429         (staff-position . 0)
430         (expand-limit . 10)
431         (number-threshold . 0)
432         (padding . 1)
433         (thickness . 6.6)
434         (font-family . number)
435         (padding . 1)
436         (meta . ((interfaces . (multi-measure-rest-interface rest-interface font-interface staff-symbol-referencer-interface))))
437         ))
438
439     (NoteCollision
440      . (
441         (axes . (0 1))
442         ;; Ugh, should not be hard-coded. 
443         (note-width . 1.321)
444         (X-extent-callback . ,Axis_group_interface::group_extent_callback)
445         (Y-extent-callback . ,Axis_group_interface::group_extent_callback)      
446         (meta . ((interfaces . (note-collision-interface axis-group-interface))))
447         ))
448
449     (NoteColumn
450      . (
451         (axes . (0 1))
452         (X-extent-callback . ,Axis_group_interface::group_extent_callback)
453         (Y-extent-callback . ,Axis_group_interface::group_extent_callback)      
454         (meta . ((interfaces . (axis-group-interface note-column-interface))))
455         ))
456
457     (NoteHead
458      . (
459         (style . default)
460         (molecule-callback . ,Note_head::brew_molecule)
461         (Y-offset-callbacks  . (,Staff_symbol_referencer::callback))
462         (stem-attachment-function . ,note-head-style->attachment-coordinates)
463         (meta . ((interfaces . (rhythmic-head-interface font-interface note-head-interface staff-symbol-referencer-interface))))
464         ))
465
466     (Glissando
467      . (
468         (type . line)
469         (gap . 0.5)
470         (breakable . #t)
471         (X-extent-callback . #f)
472         (Y-extent-callback . #f)                         
473         (molecule-callback . ,Line_spanner::brew_molecule)
474         (meta . ((interfaces . (line-spanner-interface))))
475         ))
476
477     (VoiceFollower
478      . (
479         (type . line)
480         (gap . 0.5)
481         (breakable . #t)
482         (X-extent-callback . #f)
483         (Y-extent-callback . #f)                         
484         (molecule-callback . ,Line_spanner::brew_molecule)
485         (meta . ((interfaces . (line-spanner-interface))))
486         ))
487
488     (NoteName
489      . (
490         (molecule-callback . ,Text_item::brew_molecule)
491         (font-family . roman)
492         (meta . ((interfaces . (note-name-interface text-interface font-interface))))
493         ))
494
495     (OctavateEight
496      . (
497         (self-alignment-X . 0)
498         (text . "8")
499         (visibility-lambda . ,begin-of-line-visible)
500         (X-offset-callbacks . (,Side_position_interface::centered_on_parent ,Side_position_interface::aligned_on_self))
501         (Y-offset-callbacks . (,Side_position_interface::aligned_side))
502         (molecule-callback . ,Text_item::brew_molecule)
503         (font-shape . italic)
504         (font-family . roman)
505         (meta . ((interfaces . (text-interface side-position-interface font-interface))))
506         ))
507
508     (PaperColumn
509      . (
510         (axes . (0))
511         (X-extent-callback . ,Axis_group_interface::group_extent_callback)
512
513 ;               (molecule-callback . ,Paper_column::brew_molecule) (font-name . "cmr8") (Y-extent-callback . #f)
514         (meta . ((interfaces . (paper-column-interface axis-group-interface spaceable-grob-interface))))
515         ))
516
517     (PhrasingSlur
518      . (
519         (molecule-callback . ,Slur::brew_molecule)
520         (thickness . 1.2)               
521         (spacing-procedure . ,Spanner::set_spacing_rods)                
522         (minimum-length . 1.5)
523         (after-line-breaking-callback . ,Slur::after_line_breaking)
524         (extremity-rules . ,default-slur-extremity-rules)
525         (extremity-offset-alist . ,default-phrasing-slur-extremity-offset-alist)
526         (de-uglify-parameters . (1.5  0.8  -2.0))
527         (Y-extent-callback . ,Slur::height)
528         (details . ((height-limit . 2.0) (ratio . 0.333) (force-blowfit . 0.5)
529                     (bezier-pct-c0 . -0.2) (bezier-pct-c3 . 0.000006)
530                     (bezier-pct-out-max . 0.8) (bezier-pct-in-max . 1.2)
531                     (bezier-area-steps . 1.0)))
532         (beautiful . 0.5)
533         (y-free . 0.75)
534         (attachment . (#f . #f))
535         (attachment-offset . ((0 . 0) . (0 . 0)))
536         (slope-limit . 0.8)
537         (meta . ((interfaces . (slur-interface))))
538         ))
539
540     (NonMusicalPaperColumn
541      . (
542         (axes . (0))
543         (X-extent-callback . ,Axis_group_interface::group_extent_callback)
544
545         ;; debugging stuff: print column number.
546 ;       (molecule-callback . ,Paper_column::brew_molecule) (font-name . "cmr8") (Y-extent-callback . #f)
547
548
549         (meta .  ((interfaces . (paper-column-interface axis-group-interface spaceable-grob-interface))))
550         ))
551
552     (PercentRepeat
553      . (
554         (spacing-procedure . ,Multi_measure_rest::set_spacing_rods)
555         (molecule-callback . ,Multi_measure_rest::percent)
556         (slope . 1.0)
557         (thickness . 0.48)
558         (minimum-width . 12.5) ; staffspace
559         (font-family . music)
560         (meta . ((interfaces . (multi-measure-rest-interface  font-interface percent-repeat-interface))))
561         ))
562
563     (PianoPedalBracket   ;; an example of a text spanner
564      . (
565         (molecule-callback . ,Text_spanner::brew_molecule)
566         (font-family . roman)
567         (type . line)
568         (if-text-padding . 1.0)
569         (width-correct . 0)
570         (outer . #t)
571         (direction . -1)
572         (edge-width . (0.5 . 0.5))
573         (edge-height . (1.0 . 1.0))
574         (shorten-pair . (0.0 . 0.0))
575         (thickness .  1.0)
576         (meta . ((interfaces . (piano-pedal-interface))))
577         ))
578
579     (RepeatSlash
580      . (
581         (molecule-callback . , Percent_repeat_item_interface::beat_slash)
582         (thickness . 0.48)
583         (slope . 1.7)
584         (meta . ((interfaces . (percent-repeat-interface))))
585         ))
586     (Rest
587      . (
588         (after-line-breaking-callback . ,Rest::after_line_breaking)
589         (X-extent-callback . ,Rest::extent_callback)
590         (Y-extent-callback . ,Rest::extent_callback)            
591         (molecule-callback . ,Rest::brew_molecule)
592         (Y-offset-callbacks . (,Staff_symbol_referencer::callback)) 
593         (minimum-beam-collision-distance . 1.5)
594         (meta . (
595                  (interfaces . (font-interface
596                                 rhythmic-head-interface
597                                 staff-symbol-referencer-interface
598                                 rest-interface))
599                 ))))
600
601     (RestCollision
602      . (
603         (minimum-distance . 0.75)
604         (meta . ((interfaces . (rest-collision-interface))))
605         ))
606
607     (Script
608      . (
609         ;; don't set direction here: it breaks staccato.
610         (molecule-callback . ,Script::brew_molecule)
611         (padding . 0.29) 
612         (X-offset-callbacks . (,Side_position_interface::centered_on_parent))
613         (before-line-breaking-callback . ,Script::before_line_breaking)
614         (font-family . music)
615         (meta . ((interfaces . (script-interface side-position-interface font-interface))))
616         ))
617
618     (ScriptColumn
619      . (
620         (before-line-breaking-callback . ,Script_column::before_line_breaking)
621         (meta . ((interfaces . (script-column-interface))))
622         ))
623
624     (Slur
625      . (
626         (molecule-callback . ,Slur::brew_molecule)
627         (thickness . 1.2)               
628         (spacing-procedure . ,Spanner::set_spacing_rods)                
629         (minimum-length . 1.5)
630         (after-line-breaking-callback . ,Slur::after_line_breaking)
631         (extremity-rules . ,default-slur-extremity-rules)
632         (extremity-offset-alist . ,default-slur-extremity-offset-alist)
633         (de-uglify-parameters . (1.5  0.8  -2.0))
634         (Y-extent-callback . ,Slur::height)
635         (details . ((height-limit . 2.0) (ratio . 0.333) (force-blowfit . 0.5)
636                     (bezier-pct-c0 . -0.2) (bezier-pct-c3 . 0.000006)
637                     (bezier-pct-out-max . 0.8) (bezier-pct-in-max . 1.2)
638                     (bezier-area-steps . 1.0)))
639         (beautiful . 0.5)
640         (y-free . 0.75)
641         (attachment . (#f . #f))
642         (attachment-offset . ((0 . 0) . (0 . 0)))
643         (slope-limit . 0.8)
644         (meta . ((interfaces . (slur-interface))))
645         ))
646
647     (SpacingSpanner
648      . (
649         (spacing-procedure .  ,Spacing_spanner::set_springs)
650         (grace-space-factor . 0.6)
651         (shortest-duration-space . 2.0)
652         (spacing-increment . 1.2)
653         (meta . ((interfaces . (spacing-spanner-interface))))
654         ))
655
656     (SpanBar
657      . (
658         (break-align-symbol . staff-bar)
659         (bar-size-procedure . ,Span_bar::get_bar_size) 
660         (molecule-callback . ,Span_bar::brew_molecule)
661         (visibility-lambda . ,begin-of-line-invisible)
662         (X-extent-callback . ,Span_bar::width_callback)
663         (Y-extent-callback . ())
664         (breakable . #t)
665         (glyph . "|")
666         (before-line-breaking-callback . ,Span_bar::before_line_breaking)
667         ;; ugh duplication! 
668
669         ;;
670         ;; Ross. page 151 lists other values, we opt for a leaner look
671         ;; 
672         (kern . 3.0)
673         (thin-kern . 3.0)
674         (hair-thickness . 1.6)
675         (thick-thickness . 6.0)
676         (meta . ((interfaces . (span-bar-interface bar-line-interface))))
677         ))
678
679     (StanzaNumber
680      . (
681         (breakable . #t)
682         (molecule-callback . ,Text_item::brew_molecule)         
683         (break-align-symbol . clef)
684         (visibility-lambda . ,begin-of-line-visible)
685         (font-family . roman)
686         (meta . ((interfaces . (break-aligned-interface text-interface font-interface))))               
687         ))
688
689     (StaffSpacing
690      . (
691         (breakable . #t)
692         (stem-spacing-correction . 0.4)
693         (meta . ((interfaces . (staff-spacing-interface))))
694         ))
695     (NoteSpacing
696      . (
697         (stem-spacing-correction . 0.5)
698         (meta . ((interfaces . (note-spacing-interface))))
699         ))
700
701     (StaffSymbol
702      . (
703         (molecule-callback . ,Staff_symbol::brew_molecule)
704         (line-count . 5)
705         (layer . 0)
706         (meta . ((interfaces . (staff-symbol-interface))))
707         ))
708
709     (SostenutoPedal
710      . (
711         (molecule-callback . ,Text_item::brew_molecule)
712         (direction . 1)
713         (X-offset-callbacks . (,Side_position_interface::aligned_on_self))
714         (no-spacing-rods . #t)
715         (padding . 0.0) ;; padding relative to SostenutoPedalLineSpanner
716         (pedal-type . mixed)
717         (font-family . roman)
718         (font-shape . italic)
719         (self-alignment-X . 0)
720         (meta . ((interfaces . (text-interface  font-interface))))
721         ))
722
723     (SostenutoPedalLineSpanner 
724      . (
725         (axes . (1))
726         (Y-extent-callback . ,Axis_group_interface::group_extent_callback)      
727
728         (padding . 1.2)
729         (minimum-space . 1.0)
730         (direction . -1)
731         (meta . ((interfaces . (piano-pedal-interface axis-group-interface side-position-interface))))
732         ))
733         
734     (Stem
735      . (
736         (before-line-breaking-callback . ,Stem::before_line_breaking)
737         (molecule-callback . ,Stem::brew_molecule)
738         (thickness . 1.3)
739         (beamed-lengths . (0.0 2.5 2.0 1.5))
740         (beamed-minimum-lengths . (0.0 1.5 1.25 1.0))
741
742         ;;  Stems in unnatural (forced) direction should be shortened,
743         ;;  according to [Roush & Gourlay].  Their suggestion to knock off
744         ;;  a whole staffspace seems a bit drastical: we'll do half.
745
746         (lengths . (3.5 3.5 3.5 4.5 5.0))
747         (stem-shorten . (1.0 0.5))
748                                         ; if stem is on middle line, choose this direction.
749         (neutral-direction . -1)
750         (X-offset-callbacks . (,Stem::off_callback))
751         (X-extent-callback . ,Stem::dim_callback)       
752         (Y-extent-callback . ,Stem::height)
753         (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
754         (adjust-if-on-staffline . #t)
755         (font-family . music)      
756         (meta . ((interfaces . (stem-interface  font-interface))))
757         ))
758
759     (StemTremolo
760      . (
761         (molecule-callback . ,Stem_tremolo::brew_molecule)
762         (Y-extent-callback . ,Stem_tremolo::height)
763         (X-extent-callback . #f)
764
765         (beam-width . 2.0) ; staff-space
766         (beam-thickness . 0.48) ; staff-space
767         (meta . ((interfaces . (stem-tremolo-interface))))
768         ))
769
770     (SeparationItem
771      . (
772         (meta . ((interfaces . (separation-item-interface))))
773         ))
774
775     (SeparatingGroupSpanner
776      . (
777         (spacing-procedure . ,Separating_group_spanner::set_spacing_rods)
778         (meta . ((interfaces . (separation-spanner-interface))))
779         ))
780
781     (SustainPedal
782      . (
783         (no-spacing-rods . #t)
784         (molecule-callback . ,Sustain_pedal::brew_molecule)
785         (self-alignment-X . 0)
786         (direction . 1)
787         (padding . 0.0)  ;; padding relative to SustainPedalLineSpanner
788         (pedal-type . text)
789         (X-offset-callbacks . (,Side_position_interface::aligned_on_self))
790         (meta . ((interfaces . (piano-pedal-interface text-spanner-interface text-interface side-position-interface font-interface))))
791         ))
792
793     (SustainPedalLineSpanner 
794      . (
795         (axes . (1))
796         (Y-extent-callback . ,Axis_group_interface::group_extent_callback)      
797         
798         (padding . 1.2)
799         (minimum-space . 1.0)
800         (direction . -1)
801         (meta . ((interfaces . (piano-pedal-interface axis-group-interface side-position-interface))))
802         ))
803
804     (System
805      . (
806         (axes . (0 1))
807         (X-extent-callback . ,Axis_group_interface::group_extent_callback)
808         (Y-extent-callback . ,Axis_group_interface::group_extent_callback)      
809         (meta . ((interfaces . (system-interface axis-group-interface))))
810         ))
811
812     (SystemStartBrace
813      . (
814         (glyph . "brace")
815         (molecule-callback . ,System_start_delimiter::brew_molecule)
816         (collapse-height . 5.0)
817         (font-family . braces)
818         (Y-extent-callback . #f)
819         (meta . ((interfaces . (system-start-delimiter-interface font-interface))))
820         ))
821
822     (SystemStartBracket
823      . (
824         (Y-extent-callback . #f)
825         (molecule-callback . ,System_start_delimiter::brew_molecule)
826         (glyph . "bracket")
827         (arch-height . 1.5)
828         (arch-angle . 50.0)
829         (arch-thick . 0.25)
830         (arch-width . 1.5)
831         (bracket-collapse-height . 1)
832         (thickness . 0.25)
833         (meta . ((interfaces . (system-start-delimiter-interface))))
834         ))
835
836     (SystemStartBar
837      . (
838         (Y-extent-callback . #f)
839         (molecule-callback . ,System_start_delimiter::brew_molecule)
840         (glyph . "bar-line")
841         (thickness . 1.6)
842         (after-line-breaking-callback . ,System_start_delimiter::after_line_breaking)
843         (meta . ((interfaces . (system-start-delimiter-interface))))
844         ))
845
846     (TextScript
847      . (
848         (molecule-callback . ,Text_item::brew_molecule)
849         (no-spacing-rods . #t)
850         (direction . -1)
851         (padding . 0.5)
852         ;; todo: add X self alignment?
853         (baseline-skip . 2)
854         (font-family . roman)
855         (meta . ((interfaces . (text-script-interface text-interface side-position-interface font-interface))))
856         ))
857
858     (TextSpanner
859      . (
860         (molecule-callback . ,Text_spanner::brew_molecule)
861         (font-family . roman)
862         (type . line)
863
864         ;; urg, only for (de)cresc. text spanners
865         (if-text-padding . 1.0)
866         (width-correct . -1)
867
868         (direction . 1)
869         (meta . ((interfaces . (text-spanner-interface  font-interface))))              
870         ))
871
872     (Tie
873      . (
874         (molecule-callback . ,Tie::brew_molecule)
875         (spacing-procedure . ,Spanner::set_spacing_rods)
876         (staffline-clearance . 0.35)
877         (details . ((ratio . 0.333) (height-limit . 1.0)))
878         (thickness . 1.2)
879         (x-gap . 0.2)
880         (y-offset . 0.6)
881         (minimum-length  . 2.5)
882         (meta . ((interfaces . (tie-interface))))
883         ))
884
885     (TieColumn
886      . (
887         (after-line-breaking-callback . ,Tie_column::after_line_breaking)
888         (X-extent-callback . ())
889         (Yoo-extent-callback . ())      
890         (meta . ((interfaces . (tie-column-interface))))
891         ))
892
893     (TimeSignature
894      . (
895         (molecule-callback . ,Time_signature::brew_molecule)
896         (break-align-symbol . time-signature)
897         (visibility-lambda . ,all-visible)
898         (space-alist . (
899                         (first-note . (extra-space . 2.0))
900                         (staff-bar .  (minimum-space . 2.0))
901                         ))
902         (breakable . #t)
903         (style . C)
904         (font-family . number)
905         (meta . ((interfaces . (time-signature-interface break-aligned-interface font-interface))))
906         ))
907
908     (TupletBracket
909      . (
910         (gap . 2.0)
911         (padding . 0.9)
912         (thickness . 1.6)
913         (edge-width . (0.0 . 0.0))
914         (edge-height . (0.7 . 0.7))
915         (shorten-pair . (0.0 . 0.0))
916         (before-line-breaking-callback . ,Tuplet_bracket::before_line_breaking)
917         (after-line-breaking-callback . ,Tuplet_bracket::after_line_breaking)
918         (molecule-callback . ,Tuplet_bracket::brew_molecule)
919         (font-family . roman)
920         (font-shape . italic)
921
922         (font-relative-size . -1)
923         (meta .  ((interfaces . (text-interface tuplet-bracket-interface font-interface))))
924         ))
925
926     (UnaCordaPedal
927      . (
928         (molecule-callback . ,Text_item::brew_molecule)
929         (font-family . roman)
930         (font-shape . italic)
931         (no-spacing-rods . #t)
932         (self-alignment-X . 0)
933         (direction . 1)
934         (pedal-type . text)
935         (padding . 0.0)  ;; padding relative to UnaCordaPedalLineSpanner
936         (X-offset-callbacks . (,Side_position_interface::aligned_on_self))
937         (meta . ((interfaces . (text-interface font-interface))))
938         ))
939
940     (UnaCordaPedalLineSpanner 
941      . (
942         (axes . (1))
943         (Y-extent-callback . ,Axis_group_interface::group_extent_callback)      
944         (padding . 1.2)
945         (minimum-space . 1.0)
946         (direction . -1)
947         (meta . ((interfaces . (piano-pedal-interface axis-group-interface side-position-interface))))
948         ))
949
950     (VoltaBracket
951      . (
952         (molecule-callback . ,Volta_bracket_interface::brew_molecule)
953         (direction . 1)
954         (padding . 1)
955         (font-style . volta)
956         (Y-offset-callbacks . (,Side_position_interface::aligned_side))
957         (thickness . 1.6)  ;  stafflinethickness
958         (height . 2.0) ; staffspace;
959         (minimum-space . 5)
960         (font-family . number)
961         (font-relative-size . -2)
962         (meta . ((interfaces . (volta-bracket-interface text-interface side-position-interface font-interface))))
963         ))
964     
965     (VerticalAlignment
966      . (
967         (axes . (1))
968         (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
969         (stacking-dir . -1)
970         (meta . ((interfaces . (align-interface axis-group-interface))))
971         ))
972
973     (VerticalAxisGroup
974      . (
975         (axes . (1))
976         (Y-extent-callback . ,Axis_group_interface::group_extent_callback)      
977         
978         (meta . ((interfaces . (axis-group-interface))))
979         ))
980    )
981  )
982
983
984
985
986 (define (completize-grob-entry x)
987   "transplant assoc key into 'name entry of 'meta of X
988 "
989
990   (let* ((name-sym  (car x))
991          (grob-entry (cdr x))
992          (metaentry (cdr (assoc 'meta grob-entry)))
993          (ifaces-entry
994           (cdr (assoc 'interfaces metaentry)))
995
996         )
997     (set! metaentry (assoc-set! metaentry 'name name-sym))
998     (set! metaentry (assoc-set! metaentry 'interfaces
999                                 (cons 'grob-interface ifaces-entry)))
1000     (set! grob-entry (assoc-set! grob-entry 'meta metaentry))
1001     (cons name-sym grob-entry)))
1002
1003 (set! all-grob-descriptions (map completize-grob-entry all-grob-descriptions))
1004
1005
1006
1007                                         ;  (display  (map pair? all-grob-descriptions))
1008
1009
1010 ;; make sure that \property Foo.Bar =\turnOff doesn't complain
1011
1012 (map (lambda (x)
1013                                         ; (display (car x)) (newline)
1014
1015        (set-object-property! (car x) 'translation-type? list?))
1016      all-grob-descriptions)
1017