]> 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 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-threshold . 0.08)
105         (positions . (#f . #f))
106         (position-callbacks . (,Beam::least_squares
107                                ,Beam::check_concave
108                                ,Beam::slope_damping
109                                ,Beam::quanting
110                               ))
111
112         ;; TODO: should be in SLT.
113         (thickness . 0.48) ; in staff-space
114         (before-line-breaking-callback . ,Beam::before_line_breaking)
115         (after-line-breaking-callback . (,Beam::after_line_breaking
116                                          ,Beam::end_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         (staff-position . 0.0)
226         (Y-offset-callbacks  . (,Dots::quantised_position_callback ,Staff_symbol_referencer::callback))
227         (meta . ((interfaces . (font-interface staff-symbol-referencer-interface dots-interface))))
228         ))
229
230     (DoublePercentRepeat .
231                          (
232                           (molecule-callback . ,Percent_repeat_item_interface::double_percent)
233                           (breakable . #t)
234                           (slope . 1.0)
235                           (font-family . music)
236                           (width . 2.0)
237                           (thickness . 0.48)
238                           (break-align-symbol . staff-bar)
239                           (visibility-lambda . ,begin-of-line-invisible)
240                           (meta . ((interfaces . (font-interface percent-repeat-interface))))
241                          ))
242
243     (DynamicText
244      . (
245         (Y-offset-callbacks . (,Side_position_interface::aligned_on_self))
246         (molecule-callback . ,Text_item::brew_molecule)
247         (X-offset-callbacks . (,Side_position_interface::aligned_on_self))
248         (self-alignment-X . 0)
249         (no-spacing-rods . #t)
250         (script-priority . 100)
251         (font-series . bold)
252         (font-family . dynamic)
253         (font-shape . italic)
254         (self-alignment-Y . 0)
255         (meta . ((interfaces . (font-interface text-interface dynamic-interface))))
256         ))
257
258     (DynamicLineSpanner
259      . (
260         (axes . (1))
261         (Y-extent-callback . ,Axis_group_interface::group_extent_callback)      
262         
263         (padding . 0.6)
264         (minimum-space . 1.2)
265         (direction . -1)
266         (meta . ((interfaces . (dynamic-interface axis-group-interface side-position-interface))))
267         ))
268
269     (LeftEdge
270      . (
271         (break-align-symbol . left-edge)
272         (X-offset-callbacks . (,Break_align_interface::alignment_callback))
273         (X-extent-callback . ,Grob::point_dimension_callback)
274         (breakable . #t)
275         (space-alist . (
276                         (time-signature . (extra-space . 0.0)) 
277                         (staff-bar . (extra-space . 0.0))
278                         (breathing-sign . (minimum-space  . 0.0))
279                         (clef . (extra-space . 1.0))
280                         (first-note . (extra-space . 0.0))
281                         (key-signature . (extra-space . 0.0))
282                         ))
283         (meta . ((interfaces . (break-aligned-interface))))
284         ))
285
286     (Fingering
287      . (
288         (molecule-callback . ,Text_item::brew_molecule)
289         (X-offset-callbacks . (,Side_position_interface::centered_on_parent
290                                ,Side_position_interface::aligned_on_self))
291         (padding . 0.6)
292                                         ;               (direction . -1)
293         (self-alignment-X . 0)
294         (self-alignment-Y . 0)
295         (font-family . number)
296         (font-relative-size . -3)
297         (font-shape . upright)
298         (meta . ((interfaces . (finger-interface font-interface text-script-interface text-interface side-position-interface))))
299         ))
300
301
302     (HaraKiriVerticalGroup
303      . (
304         (Y-offset-callbacks . (,Hara_kiri_group_spanner::force_hara_kiri_callback))
305         (Y-extent-callback . ,Hara_kiri_group_spanner::y_extent)
306         (axes . (1))
307         (meta . ((interfaces . (axis-group-interface hara-kiri-group-interface))))
308         ))
309
310     (Hairpin
311      . (
312         (molecule-callback . ,Hairpin::brew_molecule)
313         (thickness . 1.0)
314         (height . 0.6666)
315         (spacing-procedure . ,Spanner::set_spacing_rods)
316         (minimum-length . 2.0)
317         (if-text-padding . 1.0)
318         (width-correct . -1.0)
319
320         (dash-thickness . 1.2)
321         (dash-length . 4.0)
322         (self-alignment-Y . 0)
323         (Y-offset-callbacks . (,Side_position_interface::aligned_on_self))
324         (meta . ((interfaces . (hairpin-interface dynamic-interface))))
325         ))
326
327     (InstrumentName
328      . (
329         (breakable . #t)
330         (Y-offset-callbacks . (,Side_position_interface::aligned_on_self
331                                ,Side_position_interface::aligned_on_support_refpoints))
332         ;; huh? what's this for?
333         (direction . 0)
334         (space-alist . (
335                         (left-edge . (extra-space . 1.0))
336                         ))
337
338         (self-alignment-Y . 0)
339         (molecule-callback . ,Text_item::brew_molecule)         
340         (break-align-symbol . instrument-name)
341         (visibility-lambda . ,begin-of-line-visible)
342         (baseline-skip . 2)
343         (font-family . roman)
344         (meta . ((interfaces . (font-interface side-position-interface text-interface break-aligned-interface))))
345         ))
346
347     (KeySignature
348      . (
349         (molecule-callback . ,Key_signature_interface::brew_molecule)
350         (space-alist . (
351                         (time-signature . (extra-space . 1.25))
352                         (staff-bar .  (extra-space . 1.1))
353                         (first-note . (extra-space . 2.5))
354                         ))
355         (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
356         (break-align-symbol . key-signature)
357         (visibility-lambda . ,begin-of-line-visible)
358         (breakable . #t)
359         (meta . ((interfaces . (key-signature-interface  font-interface  break-aligned-interface))))
360         ))
361
362
363     (LyricHyphen
364      . (
365         (thickness . 1.0)
366         (height . 0.4)
367         (minimum-length .  0.5) 
368         (maximum-length .  100)
369         (molecule-callback . ,Hyphen_spanner::brew_molecule)
370         (Y-extent-callback . ,Grob::point_dimension_callback)
371         (meta . ((interfaces . (lyric-hyphen-interface))))
372         ))
373
374     (LyricExtender
375      . (
376         (molecule-callback . ,Lyric_extender::brew_molecule)
377         (height . 0.8) ; stafflinethickness;
378         (right-trim-amount . 0.5)
379         (Y-extent-callback . ,Grob::point_dimension_callback)
380         (meta . ((interfaces . (lyric-extender-interface))))
381         ))
382
383     (LyricText
384      . (
385         (molecule-callback . ,Text_item::brew_molecule)
386         (X-offset-callbacks . (,Side_position_interface::aligned_on_self))
387         (self-alignment-X . 0)
388         (non-rhythmic . #t)
389         (word-space . 0.6)
390         (ignore-length-mismatch . #f)
391         (begin-alignment . 4)
392         (end-alignment . 2)
393         (font-family . roman)
394         (font-shape . upright)
395         ;; duh, side-position-interface?
396         (meta . ((interfaces . (lyric-syllable-interface side-position-interface text-interface font-interface))))
397         ))
398
399     (Porrectus
400      . (
401         (style . mensural)
402         (auto-properties . #f)
403         (solid . #f)
404         (width . 2.4)
405         (thickness . 1.0)
406         (add-stem . #t)
407         (direction . 1)
408         (molecule-callback . ,Porrectus::brew_molecule)
409         (meta . ((interfaces . (porrectus-interface))))
410         ))
411
412     (RehearsalMark
413      . (
414         (molecule-callback . ,Text_item::brew_molecule)
415         (X-offset-callbacks . (,Side_position_interface::aligned_on_self))
416         (self-alignment-X . 0)
417
418         (direction . 1)
419         (breakable . #t)
420         (font-family . roman)
421         (font-shape . upright)
422         (font-relative-size . 1)
423         (visibility-lambda . ,end-of-line-invisible)
424         (padding . 0.8)
425         (meta . ((interfaces . (text-interface font-interface mark-interface side-position-interface))))
426         ))
427
428     (MultiMeasureRest
429      . (
430         (spacing-procedure . ,Multi_measure_rest::set_spacing_rods)
431         (molecule-callback . ,Multi_measure_rest::brew_molecule)
432         (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
433         (staff-position . 0)
434         (expand-limit . 10)
435         (thickness . 6.6)
436         (font-family . number)
437         (meta . ((interfaces . (multi-measure-rest-interface rest-interface font-interface staff-symbol-referencer-interface))))
438         ))
439
440     (NoteCollision
441      . (
442         (axes . (0 1))
443         ;; Ugh, should not be hard-coded. 
444         (note-width . 1.321)
445         (X-extent-callback . ,Axis_group_interface::group_extent_callback)
446         (Y-extent-callback . ,Axis_group_interface::group_extent_callback)      
447         (meta . ((interfaces . (note-collision-interface axis-group-interface))))
448         ))
449
450     (NoteColumn
451      . (
452         (axes . (0 1))
453         (X-extent-callback . ,Axis_group_interface::group_extent_callback)
454         (Y-extent-callback . ,Axis_group_interface::group_extent_callback)      
455         (meta . ((interfaces . (axis-group-interface note-column-interface))))
456         ))
457
458     (NoteHead
459      . (
460         (style . default)
461         (molecule-callback . ,Note_head::brew_molecule)
462         (Y-offset-callbacks  . (,Staff_symbol_referencer::callback))
463         (stem-attachment-function . ,note-head-style->attachment-coordinates)
464         (meta . ((interfaces . (rhythmic-head-interface font-interface note-head-interface staff-symbol-referencer-interface))))
465         ))
466
467     (Glissando
468      . (
469         (type . line)
470         (gap . 0.5)
471         (breakable . #t)
472         (X-extent-callback . #f)
473         (Y-extent-callback . #f)                         
474         (molecule-callback . ,Line_spanner::brew_molecule)
475         (meta . ((interfaces . (line-spanner-interface))))
476         ))
477
478     (VoiceFollower
479      . (
480         (type . line)
481         (gap . 0.5)
482         (breakable . #t)
483         (X-extent-callback . #f)
484         (Y-extent-callback . #f)                         
485         (molecule-callback . ,Line_spanner::brew_molecule)
486         (meta . ((interfaces . (line-spanner-interface))))
487         ))
488
489     (NoteName
490      . (
491         (molecule-callback . ,Text_item::brew_molecule)
492         (font-family . roman)
493         (meta . ((interfaces . (note-name-interface text-interface font-interface))))
494         ))
495
496     (OctavateEight
497      . (
498         (self-alignment-X . 0)
499         (text . "8")
500         (visibility-lambda . ,begin-of-line-visible)
501         (X-offset-callbacks . (,Side_position_interface::centered_on_parent ,Side_position_interface::aligned_on_self))
502         (Y-offset-callbacks . (,Side_position_interface::aligned_side))
503         (molecule-callback . ,Text_item::brew_molecule)
504         (font-shape . italic)
505         (font-family . roman)
506         (meta . ((interfaces . (text-interface side-position-interface font-interface))))
507         ))
508
509     (PaperColumn
510      . (
511         (axes . (0))
512         (X-extent-callback . ,Axis_group_interface::group_extent_callback)
513
514 ;               (molecule-callback . ,Paper_column::brew_molecule) (font-name . "cmr8") (Y-extent-callback . #f)
515         (meta . ((interfaces . (paper-column-interface axis-group-interface spaceable-grob-interface))))
516         ))
517
518     (PhrasingSlur
519      . (
520         (molecule-callback . ,Slur::brew_molecule)
521         (thickness . 1.2)               
522         (spacing-procedure . ,Spanner::set_spacing_rods)                
523         (minimum-length . 1.5)
524         (after-line-breaking-callback . ,Slur::after_line_breaking)
525         (extremity-rules . ,default-slur-extremity-rules)
526         (extremity-offset-alist . ,default-phrasing-slur-extremity-offset-alist)
527         (de-uglify-parameters . (1.5  0.8  -2.0))
528         (Y-extent-callback . ,Slur::height)
529         (details . ((height-limit . 2.0) (ratio . 0.333) (force-blowfit . 0.5)
530                     (bezier-pct-c0 . -0.2) (bezier-pct-c3 . 0.000006)
531                     (bezier-pct-out-max . 0.8) (bezier-pct-in-max . 1.2)
532                     (bezier-area-steps . 1.0)))
533         (beautiful . 0.5)
534         (y-free . 0.75)
535         (attachment . (#f . #f))
536         (attachment-offset . ((0 . 0) . (0 . 0)))
537         (slope-limit . 0.8)
538         (meta . ((interfaces . (slur-interface))))
539         ))
540
541     (NonMusicalPaperColumn
542      . (
543         (axes . (0))
544         (X-extent-callback . ,Axis_group_interface::group_extent_callback)
545
546         ;; debugging stuff: print column number.
547 ;       (molecule-callback . ,Paper_column::brew_molecule) (font-name . "cmr8") (Y-extent-callback . #f)
548
549
550         (meta .  ((interfaces . (paper-column-interface axis-group-interface spaceable-grob-interface))))
551         ))
552
553     (PercentRepeat
554      . (
555         (spacing-procedure . ,Multi_measure_rest::set_spacing_rods)
556         (molecule-callback . ,Multi_measure_rest::percent)
557         (slope . 1.0)
558         (thickness . 0.48)
559         (minimum-width . 12.5) ; staffspace
560         (font-family . music)
561         (meta . ((interfaces . (multi-measure-rest-interface  font-interface percent-repeat-interface))))
562         ))
563
564     (PianoPedalBracket   ;; an example of a text spanner
565      . (
566         (molecule-callback . ,Text_spanner::brew_molecule)
567         (font-family . roman)
568         (type . line)
569         (if-text-padding . 1.0)
570         (width-correct . 0)
571         (outer . #t)
572         (direction . -1)
573         (edge-width . (0.5 . 0.5))
574         (edge-height . (1.0 . 1.0))
575         (shorten-pair . (0.0 . 0.0))
576         (thickness .  1.0)
577         (meta . ((interfaces . (piano-pedal-interface))))
578         ))
579
580     (RepeatSlash
581      . (
582         (molecule-callback . , Percent_repeat_item_interface::beat_slash)
583         (thickness . 0.48)
584         (slope . 1.7)
585         (meta . ((interfaces . (percent-repeat-interface))))
586         ))
587     (Rest
588      . (
589         (after-line-breaking-callback . ,Rest::after_line_breaking)
590         (X-extent-callback . ,Rest::extent_callback)
591         (Y-extent-callback . ,Rest::extent_callback)            
592         (molecule-callback . ,Rest::brew_molecule)
593         (Y-offset-callbacks . (,Staff_symbol_referencer::callback)) 
594         (minimum-beam-collision-distance . 1.5)
595         (meta . (
596                  (interfaces . (font-interface
597                                 rhythmic-head-interface
598                                 staff-symbol-referencer-interface
599                                 rest-interface))
600                 ))))
601
602     (RestCollision
603      . (
604         (minimum-distance . 0.75)
605         (meta . ((interfaces . (rest-collision-interface))))
606         ))
607
608     (Script
609      . (
610         ;; don't set direction here: it breaks staccato.
611         (molecule-callback . ,Script::brew_molecule)
612         (padding . 0.29) 
613         (X-offset-callbacks . (,Side_position_interface::centered_on_parent))
614         (before-line-breaking-callback . ,Script::before_line_breaking)
615         (font-family . music)
616         (meta . ((interfaces . (script-interface side-position-interface font-interface))))
617         ))
618
619     (ScriptColumn
620      . (
621         (before-line-breaking-callback . ,Script_column::before_line_breaking)
622         (meta . ((interfaces . (script-column-interface))))
623         ))
624
625     (Slur
626      . (
627         (molecule-callback . ,Slur::brew_molecule)
628         (thickness . 1.2)               
629         (spacing-procedure . ,Spanner::set_spacing_rods)                
630         (minimum-length . 1.5)
631         (after-line-breaking-callback . ,Slur::after_line_breaking)
632         (extremity-rules . ,default-slur-extremity-rules)
633         (extremity-offset-alist . ,default-slur-extremity-offset-alist)
634         (de-uglify-parameters . (1.5  0.8  -2.0))
635         (Y-extent-callback . ,Slur::height)
636         (details . ((height-limit . 2.0) (ratio . 0.333) (force-blowfit . 0.5)
637                     (bezier-pct-c0 . -0.2) (bezier-pct-c3 . 0.000006)
638                     (bezier-pct-out-max . 0.8) (bezier-pct-in-max . 1.2)
639                     (bezier-area-steps . 1.0)))
640         (beautiful . 0.5)
641         (y-free . 0.75)
642         (attachment . (#f . #f))
643         (attachment-offset . ((0 . 0) . (0 . 0)))
644         (slope-limit . 0.8)
645         (meta . ((interfaces . (slur-interface))))
646         ))
647
648     (SpacingSpanner
649      . (
650         (spacing-procedure .  ,Spacing_spanner::set_springs)
651         (grace-space-factor . 0.5)
652
653         (shortest-duration-space . 2.0)
654         (spacing-increment . 1.2)
655         
656
657         (meta . ((interfaces . (spacing-spanner-interface))))
658         ))
659
660     (SpanBar
661      . (
662         (break-align-symbol . staff-bar)
663         (bar-size-procedure . ,Span_bar::get_bar_size) 
664         (molecule-callback . ,Span_bar::brew_molecule)
665         (visibility-lambda . ,begin-of-line-invisible)
666         (X-extent-callback . ,Span_bar::width_callback)
667         (Y-extent-callback . ())
668         (breakable . #t)
669         (glyph . "|")
670         (before-line-breaking-callback . ,Span_bar::before_line_breaking)
671         ;; ugh duplication! 
672
673         ;;
674         ;; Ross. page 151 lists other values, we opt for a leaner look
675         ;; 
676         (kern . 3.0)
677         (thin-kern . 3.0)
678         (hair-thickness . 1.6)
679         (thick-thickness . 6.0)
680         (meta . ((interfaces . (span-bar-interface bar-line-interface))))
681         ))
682
683     (StanzaNumber
684      . (
685         (breakable . #t)
686         (molecule-callback . ,Text_item::brew_molecule)         
687         (break-align-symbol . clef)
688         (visibility-lambda . ,begin-of-line-visible)
689         (font-family . roman)
690         (meta . ((interfaces . (break-aligned-interface text-interface font-interface))))               
691         ))
692
693     (StaffSpacing
694      . (
695         (breakable . #t)
696         (stem-spacing-correction . 0.4)
697         (meta . ((interfaces . (staff-spacing-interface))))
698         ))
699     (NoteSpacing
700      . (
701         (stem-spacing-correction . 0.5)
702         (space-factor . 1.0)
703         (meta . ((interfaces . (note-spacing-interface))))
704         ))
705
706     (StaffSymbol
707      . (
708         (molecule-callback . ,Staff_symbol::brew_molecule)
709         (staff-space . 1.0)
710         (line-count . 5)
711         (layer . 0)
712         (meta . ((interfaces . (staff-symbol-interface))))
713         ))
714
715     (SostenutoPedal
716      . (
717         (molecule-callback . ,Text_item::brew_molecule)
718         (direction . 1)
719         (X-offset-callbacks . (,Side_position_interface::aligned_on_self))
720         (no-spacing-rods . #t)
721         (padding . 0.0) ;; padding relative to SostenutoPedalLineSpanner
722         (pedal-type . mixed)
723         (font-family . roman)
724         (font-shape . italic)
725         (self-alignment-X . 0)
726         (meta . ((interfaces . (text-interface  font-interface))))
727         ))
728
729     (SostenutoPedalLineSpanner 
730      . (
731         (axes . (1))
732         (Y-extent-callback . ,Axis_group_interface::group_extent_callback)      
733
734         (padding . 1.2)
735         (minimum-space . 1.0)
736         (direction . -1)
737         (meta . ((interfaces . (piano-pedal-interface axis-group-interface side-position-interface))))
738         ))
739         
740     (Stem
741      . (
742         (before-line-breaking-callback . ,Stem::before_line_breaking)
743         (molecule-callback . ,Stem::brew_molecule)
744         (thickness . 0.8)
745         (beamed-lengths . (0.0 2.5 2.0 1.5))
746         (beamed-minimum-lengths . (0.0 1.5 1.25 1.0))
747
748         ;;  Stems in unnatural (forced) direction should be shortened,
749         ;;  according to [Roush & Gourlay].  Their suggestion to knock off
750         ;;  a whole staffspace seems a bit drastical: we'll do half.
751
752         (lengths . (3.5 3.5 3.5 4.5 5.0))
753         (stem-shorten . (1.0 0.5))
754                                         ; if stem is on middle line, choose this direction.
755         (neutral-direction . -1)
756         (X-offset-callbacks . (,Stem::off_callback))
757         (X-extent-callback . ,Stem::dim_callback)       
758         (Y-extent-callback . ,Stem::height)
759         (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
760         (adjust-if-on-staffline . #t)
761         (font-family . music)      
762         (meta . ((interfaces . (stem-interface  font-interface))))
763         ))
764
765     (StemTremolo
766      . (
767         (molecule-callback . ,Stem_tremolo::brew_molecule)
768         (Y-extent-callback . ,Stem_tremolo::height)
769         (X-extent-callback . #f)
770
771         (beam-width . 2.0) ; staff-space
772         (beam-thickness . 0.48) ; staff-space
773         (meta . ((interfaces . (stem-tremolo-interface))))
774         ))
775
776     (SeparationItem
777      . (
778         (meta . ((interfaces . (separation-item-interface))))
779         ))
780
781     (SeparatingGroupSpanner
782      . (
783         (spacing-procedure . ,Separating_group_spanner::set_spacing_rods)
784         (meta . ((interfaces . (separation-spanner-interface))))
785         ))
786
787     (SustainPedal
788      . (
789         (no-spacing-rods . #t)
790         (molecule-callback . ,Sustain_pedal::brew_molecule)
791         (self-alignment-X . 0)
792         (direction . 1)
793         (padding . 0.0)  ;; padding relative to SustainPedalLineSpanner
794         (pedal-type . text)
795         (X-offset-callbacks . (,Side_position_interface::aligned_on_self))
796         (meta . ((interfaces . (piano-pedal-interface text-spanner-interface text-interface side-position-interface font-interface))))
797         ))
798
799     (SustainPedalLineSpanner 
800      . (
801         (axes . (1))
802         (Y-extent-callback . ,Axis_group_interface::group_extent_callback)      
803         
804         (padding . 1.2)
805         (minimum-space . 1.0)
806         (direction . -1)
807         (meta . ((interfaces . (piano-pedal-interface axis-group-interface side-position-interface))))
808         ))
809
810     (System
811      . (
812         (axes . (0 1))
813         (X-extent-callback . ,Axis_group_interface::group_extent_callback)
814         (Y-extent-callback . ,Axis_group_interface::group_extent_callback)      
815         (meta . ((interfaces . (system-interface axis-group-interface))))
816         ))
817
818     (SystemStartBrace
819      . (
820         (glyph . "brace")
821         (molecule-callback . ,System_start_delimiter::brew_molecule)
822         (collapse-height . 5.0)
823         (font-family . braces)
824         (Y-extent-callback . #f)
825         (meta . ((interfaces . (system-start-delimiter-interface font-interface))))
826         ))
827
828     (SystemStartBracket
829      . (
830         (Y-extent-callback . #f)
831         (molecule-callback . ,System_start_delimiter::brew_molecule)
832         (glyph . "bracket")
833         (arch-height . 1.5)
834         (arch-angle . 50.0)
835         (arch-thick . 0.25)
836         (arch-width . 1.5)
837         (bracket-collapse-height . 1)
838         (thickness . 0.25)
839         (meta . ((interfaces . (system-start-delimiter-interface))))
840         ))
841
842     (SystemStartBar
843      . (
844         (Y-extent-callback . #f)
845         (molecule-callback . ,System_start_delimiter::brew_molecule)
846         (glyph . "bar-line")
847         (thickness . 1.6)
848         (after-line-breaking-callback . ,System_start_delimiter::after_line_breaking)
849         (meta . ((interfaces . (system-start-delimiter-interface))))
850         ))
851
852     (TextScript
853      . (
854         (molecule-callback . ,Text_item::brew_molecule)
855         (no-spacing-rods . #t)
856         (direction . -1)
857         (padding . 0.5)
858         ;; todo: add X self alignment?
859         (baseline-skip . 2)
860         (font-family . roman)
861         (meta . ((interfaces . (text-script-interface text-interface side-position-interface font-interface))))
862         ))
863
864     (TextSpanner
865      . (
866         (molecule-callback . ,Text_spanner::brew_molecule)
867         (font-family . roman)
868         (type . line)
869
870         ;; urg, only for (de)cresc. text spanners
871         (if-text-padding . 1.0)
872         (width-correct . -1)
873
874         (direction . 1)
875         (meta . ((interfaces . (text-spanner-interface  font-interface))))              
876         ))
877
878     (Tie
879      . (
880         (molecule-callback . ,Tie::brew_molecule)
881         (spacing-procedure . ,Spanner::set_spacing_rods)
882         (staffline-clearance . 0.35)
883         (details . ((ratio . 0.333) (height-limit . 1.0)))
884         (thickness . 1.2)
885         (x-gap . 0.2)
886         (y-offset . 0.6)
887         (minimum-length  . 2.5)
888         (meta . ((interfaces . (tie-interface))))
889         ))
890
891     (TieColumn
892      . (
893         (after-line-breaking-callback . ,Tie_column::after_line_breaking)
894         (X-extent-callback . ())
895         (Yoo-extent-callback . ())      
896         (meta . ((interfaces . (tie-column-interface))))
897         ))
898
899     (TimeSignature
900      . (
901         (molecule-callback . ,Time_signature::brew_molecule)
902         (break-align-symbol . time-signature)
903         (visibility-lambda . ,all-visible)
904         (space-alist . (
905                         (first-note . (extra-space . 2.0))
906                         (staff-bar .  (minimum-space . 2.0))
907                         ))
908         (breakable . #t)
909         (style . C)
910         (font-family . number)
911         (meta . ((interfaces . (time-signature-interface  font-interface))))
912         ))
913
914     (TupletBracket
915      . (
916         (number-gap . 2.0)   
917         (thick . 1.0)
918         (after-line-breaking-callback . ,Tuplet_bracket::after_line_breaking)
919         (molecule-callback . ,Tuplet_bracket::brew_molecule)
920         (font-family . roman)
921         (font-shape . italic)
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