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