1 ;;;; grob-description.scm -- part of generated backend documentation
3 ;;;; source file of the GNU LilyPond music typesetter
5 ;;;; (c) 1998--2003 Han-Wen Nienhuys <hanwen@cs.uu.nl>
6 ;;;; Jan Nieuwenhuizen <janneke@gnu.org>
8 ;;;; distances are given in linethickness (thicknesses) and
9 ;;;; staffspace (distances)
11 ;;;; WARNING: the meta field should be the last one.
12 ;;;; WARNING: don't use anonymous functions for initialization.
14 ;; TODO: junk the meta field in favor of something more compact?
15 (define-public all-grob-descriptions
19 (molecule-callback . ,Accidental_interface::brew_molecule)
21 (cautionary-style . parentheses)
22 (after-line-breaking-callback . ,Accidental_interface::after_line_breaking) (meta . ((interfaces . (item-interface accidental-interface font-interface))))
26 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
29 ;; this is quite small, but it is very ugly to have
30 ;; accs closer to the previous note than to the next one.
32 (meta . ((interfaces . (item-interface accidental-placement-interface))))
38 (break-align-symbol . ambitus)
39 (molecule-callback . ,Ambitus::brew_molecule)
41 (note-head-style . "noteheads-2")
42 (visibility-lambda . ,begin-of-line-visible)
45 (clef . (extra-space . 0.0))
46 (key-signature . (extra-space . 0.0))
47 (staff-bar . (extra-space . 0.0))
48 (time-signature . (extra-space . 0.0))
49 (first-note . (fixed-space . 0.0))
51 (meta . ((interfaces . (ambitus-interface staff-symbol-referencer-interface break-aligned-interface item-interface font-interface))))
56 (X-extent-callback . ,Arpeggio::width_callback)
57 (Y-extent-callback . #f)
58 (molecule-callback . ,Arpeggio::brew_molecule)
59 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
60 (X-offset-callbacks . (,Side_position_interface::aligned_side))
62 (staff-position . 0.0)
63 (meta . ((interfaces . (arpeggio-interface staff-symbol-referencer-interface side-position-interface item-interface font-interface))))
68 (break-align-symbol . staff-bar)
70 (break-glyph-function . ,default-break-barline)
71 (bar-size-procedure . ,Bar_line::get_staff_bar_size)
72 (molecule-callback . ,Bar_line::brew_molecule)
73 (break-visibility . ,all-visible)
75 (before-line-breaking-callback . ,Bar_line::before_line_breaking)
77 (time-signature . (extra-space . 0.75))
78 (custos . (minimum-space . 2.0))
79 (clef . (minimum-space . 1.0))
80 (key-signature . (extra-space . 1.0))
81 (first-note . (fixed-space . 1.3))
82 (next-note . (semi-fixed-space . 1.3))
83 (right-edge . (extra-space . 0.0))
87 ;; Ross. page 151 lists other values, we opt for a leaner look
91 (hair-thickness . 1.6)
92 (thick-thickness . 6.0)
93 (meta . ((interfaces . (bar-line-interface item-interface break-aligned-interface font-interface))))
99 (molecule-callback . ,Text_item::brew_molecule)
101 (break-visibility . ,begin-of-line-visible)
104 (font-family . roman)
106 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
107 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
108 (self-alignment-X . 1)
109 (extra-offset . (1.3 . 0))
111 ((interfaces . (side-position-interface
113 self-alignment-interface
114 font-interface item-interface break-aligned-interface))))
120 (molecule-callback . ,Text_item::brew_molecule)
121 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
123 (font-family . number)
125 ;; We must do this, other BFs in
126 ;; paper16 become too small.
128 (font-magnification . 0.8)
130 (meta . ((interfaces . (text-interface rhythmic-grob-interface
131 bass-figure-interface item-interface
132 self-alignment-interface font-interface))))
136 ;; todo: clean this up a bit: the list is getting
138 (molecule-callback . ,Beam::brew_molecule)
139 (concaveness-gap . 2.0)
140 (concaveness-threshold . 0.08)
142 (positions . (#f . #f))
143 (position-callbacks . (,Beam::least_squares
146 ,Beam::shift_region_to_valid
150 ;; TODO: should be in SLT.
151 (thickness . 0.48) ; in staff-space
152 (before-line-breaking-callback . ,Beam::before_line_breaking)
153 (after-line-breaking-callback . ,Beam::after_line_breaking)
154 (neutral-direction . -1)
155 (dir-function . ,beam-dir-majority-median)
157 ;; Whe have some unreferenced problems here.
159 ;; If we shorten beamed stems less than normal stems (1 staffspace),
160 ;; or high order less than 8th beams, patterns like
161 ;; c''4 [c''8 c''] c''4 [c''16 c]
162 ;; are ugly (different stem lengths).
164 ;; But if we shorten 16th beams as much as 8th beams, a single
165 ;; forced 16th beam looks *very* short.
167 ;; We choose to shorten 8th beams the same as single stems,
168 ;; and high order beams less than 8th beams, so that all
169 ;; isolated shortened beams look nice and a bit shortened,
170 ;; sadly possibly breaking patterns with high order beams.
171 (beamed-stem-shorten . (1.0 0.5 0.25))
173 (outer-stem-length-limit . 0.2)
175 (flag-width-function . ,beam-flag-width-function)
177 (auto-knee-gap . 5.5)
179 ;; only for debugging.
180 (font-family . roman)
182 (space-function . ,Beam::space_function)
183 (meta . ((interfaces . (staff-symbol-referencer-interface beam-interface spanner-interface))))
191 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
192 (meta . ((interfaces . (break-alignment-interface item-interface axis-group-interface)))))
198 (X-offset-callbacks . (,Break_align_interface::alignment_callback))
199 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
200 (meta . ((interfaces . (break-aligned-interface item-interface axis-group-interface item-interface ))))
205 (break-align-symbol . breathing-sign)
208 (ambitus . (extra-space . 2.0))
209 (custos . (minimum-space . 1.0))
210 (key-signature . (minimum-space . 1.5))
211 (staff-bar . (minimum-space . 1.5))
212 (clef . (minimum-space . 2.0))
213 (first-note . (fixed-space . 1.0)) ;huh?
214 (right-edge . (extra-space . 0.1))
216 (molecule-callback . ,Text_item::brew_molecule)
217 (text . ,(make-musicglyph-markup "scripts-rcomma"))
218 (Y-offset-callbacks . (,Breathing_sign::offset_callback))
219 (break-visibility . ,begin-of-line-invisible)
220 (meta . ((interfaces . (break-aligned-interface breathing-sign-interface text-interface font-interface item-interface ))))
225 (molecule-callback . ,Clef::brew_molecule)
226 (before-line-breaking-callback . ,Clef::before_line_breaking)
228 (font-family . music)
229 (break-align-symbol . clef)
230 (break-visibility . ,begin-of-line-visible)
231 (space-alist . ((ambitus . (extra-space . 2.0))
232 (staff-bar . (extra-space . 0.7))
233 (key-signature . (minimum-space . 4.0))
234 (time-signature . (minimum-space . 4.2))
235 (first-note . (minimum-fixed-space . 5.0))
236 (next-note . (extra-space . 0.5))
237 (right-edge . (extra-space . 0.5))
239 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
240 (meta . ((interfaces . (clef-interface staff-symbol-referencer-interface font-interface break-aligned-interface item-interface ))))
243 (ClusterSpannerBeacon
245 (molecule-callback . #f)
246 (meta . ((interfaces . (cluster-beacon-interface item-interface))))
251 (molecule-callback . ,Cluster::brew_molecule)
252 (spacing-procedure . ,Spanner::set_spacing_rods)
253 (minimum-length . 0.0)
256 (meta . ((interfaces . (cluster-interface spanner-interface))))
261 (molecule-callback . ,Text_item::brew_molecule)
262 (after-line-breaking-callback . ,Chord_name::after_line_breaking)
266 (meta . ((interfaces . (font-interface rhythmic-grob-interface
267 text-interface chord-name-interface item-interface ))))
272 (break-align-symbol . custos)
274 (molecule-callback . ,Custos::brew_molecule)
275 (break-visibility . ,end-of-line-visible)
277 (neutral-position . 0)
278 (neutral-direction . -1)
279 (adjust-if-on-staffline . #t)
280 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
282 (first-note . (minimum-fixed-space . 0.0))
283 (right-edge . (extra-space . 0.1))
286 . (custos-interface staff-symbol-referencer-interface
288 break-aligned-interface item-interface ))))
296 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
297 (X-offset-callbacks . (,Dot_column::side_position))
298 (meta . ((interfaces . (dot-column-interface axis-group-interface item-interface ))))
303 (molecule-callback . ,Dots::brew_molecule)
305 (meta . ((interfaces . (font-interface staff-symbol-referencer-interface dots-interface item-interface ))))
308 (DoublePercentRepeat .
310 (molecule-callback . ,Percent_repeat_item_interface::double_percent)
313 (font-family . music)
316 (break-align-symbol . staff-bar)
317 (break-visibility . ,begin-of-line-invisible)
318 (meta . ((interfaces . (font-interface
319 break-aligned-interface
320 percent-repeat-interface item-interface ))))
325 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
326 (molecule-callback . ,Text_item::brew_molecule)
327 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
328 ,Self_alignment_interface::centered_on_parent))
329 (self-alignment-X . 0)
330 (no-spacing-rods . #t)
331 (script-priority . 100)
333 (font-family . dynamic)
334 (font-shape . italic)
335 (self-alignment-Y . 0)
336 (meta . ((interfaces . (font-interface text-interface self-alignment-interface dynamic-interface script-interface item-interface))))
342 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
343 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
345 (minimum-space . 1.2)
347 (meta . ((interfaces . (dynamic-interface axis-group-interface side-position-interface spanner-interface))))
352 (break-align-symbol . left-edge)
353 (X-extent-callback . ,Grob::point_dimension_callback)
356 (custos . (extra-space . 0.0))
357 (ambitus . (extra-space . 2.0))
358 (time-signature . (extra-space . 0.0))
359 (staff-bar . (extra-space . 0.0))
360 (breathing-sign . (minimum-space . 0.0))
361 (clef . (extra-space . 0.85))
362 (first-note . (fixed-space . 1.0))
363 (right-edge . (extra-space . 0.0))
364 (key-signature . (extra-space . 0.0))
366 (meta . ((interfaces . (break-aligned-interface item-interface ))))
371 (molecule-callback . ,Text_item::brew_molecule)
373 (staff-padding . 0.5)
374 (self-alignment-X . 0)
375 (self-alignment-Y . 0)
376 (script-priority . 100)
377 (font-family . number)
378 (font-size . -5) ; don't overlap when next to heads.
379 (font-shape . upright)
380 (meta . ((interfaces . (finger-interface font-interface text-script-interface text-interface side-position-interface self-alignment-interface item-interface ))))
384 (RemoveEmptyVerticalGroup
386 (Y-offset-callbacks . (,Hara_kiri_group_spanner::force_hara_kiri_callback))
387 (Y-extent-callback . ,Hara_kiri_group_spanner::y_extent)
390 (meta . ((interfaces . (axis-group-interface hara-kiri-group-interface item-interface spanner-interface))))
395 (molecule-callback . ,Hairpin::brew_molecule)
398 (spacing-procedure . ,Spanner::set_spacing_rods)
399 (minimum-length . 2.0)
400 (if-text-padding . 1.0)
402 (self-alignment-Y . 0)
403 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
404 (meta . ((interfaces . (hairpin-interface line-interface self-alignment-interface dynamic-interface spanner-interface))))
410 (molecule-callback . ,Horizontal_bracket::brew_molecule)
411 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
414 (meta . ((interfaces . (horizontal-bracket-interface side-position-interface spanner-interface))))
419 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self
420 ,Side_position_interface::aligned_on_support_refpoints))
421 ;; This direction is for aligned_on_support_refpoints
425 (left-edge . (extra-space . 1.0))
428 (self-alignment-Y . 0)
429 (molecule-callback . ,Text_item::brew_molecule)
430 (break-align-symbol . instrument-name)
431 (break-visibility . ,begin-of-line-visible)
433 (font-family . roman)
434 (meta . ((interfaces . (font-interface self-alignment-interface side-position-interface text-interface break-aligned-interface item-interface ))))
439 (molecule-callback . ,Key_signature_interface::brew_molecule)
441 (time-signature . (extra-space . 1.25))
442 (staff-bar . (extra-space . 1.1))
443 (right-edge . (extra-space . 0.5))
444 (first-note . (fixed-space . 2.5))
446 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
447 (break-align-symbol . key-signature)
448 (break-visibility . ,begin-of-line-visible)
450 (meta . ((interfaces . (key-signature-interface font-interface break-aligned-interface item-interface ))))
455 (ligature-primitive-callback . ,Note_head::brew_molecule)
460 (edge-height . (0.7 . 0.7))
461 (shorten-pair . (-0.2 . -0.2))
462 (before-line-breaking-callback . ,Tuplet_bracket::before_line_breaking)
463 (after-line-breaking-callback . ,Tuplet_bracket::after_line_breaking)
464 (molecule-callback . ,Tuplet_bracket::brew_molecule)
465 (meta . ((interfaces . (tuplet-bracket-interface spanner-interface))))
474 (minimum-length . 0.5)
475 (molecule-callback . ,Hyphen_spanner::brew_molecule)
476 (Y-extent-callback . ,Grob::point_dimension_callback)
477 (meta . ((interfaces . (lyric-hyphen-interface spanner-interface))))
482 (molecule-callback . ,Lyric_extender::brew_molecule)
483 (thickness . 0.8) ; linethickness
484 (minimum-length . 1.5)
485 (Y-extent-callback . ,Grob::point_dimension_callback)
486 (meta . ((interfaces . (lyric-extender-interface spanner-interface))))
490 . ((molecule-callback . ,Text_item::brew_molecule)
491 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_parent))
492 (self-alignment-X . 0)
494 (font-family . roman)
495 (font-series . bold-narrow)
496 (font-shape . upright)
498 (meta . ((interfaces . (rhythmic-grob-interface lyric-syllable-interface self-alignment-interface text-interface font-interface item-interface ))))
505 (ligature-primitive-callback . ,Mensural_ligature::brew_ligature_primitive)
506 (molecule-callback . ,Mensural_ligature::brew_molecule)
507 (meta . ((interfaces . (mensural-ligature-interface font-interface))))
512 (molecule-callback . ,Text_item::brew_molecule)
513 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
514 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
515 (after-line-breaking-callback . ,shift-right-at-line-begin)
516 (self-alignment-X . 0)
520 (font-family . roman)
522 (break-visibility . ,end-of-line-invisible)
524 (meta . ((interfaces . (text-interface side-position-interface font-interface mark-interface self-alignment-interface item-interface ))))
528 (molecule-callback . ,Text_item::brew_molecule)
529 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
532 (font-family . roman)
533 (break-visibility . ,end-of-line-invisible)
535 (meta . ((interfaces . (text-interface side-position-interface font-interface metronome-mark-interface item-interface))))
539 (Y-offset-callbacks . (,Side_position_interface::out_of_staff
540 ,Side_position_interface::aligned_side))
541 (molecule-callback . ,Measure_grouping::brew_molecule)
547 (meta . ((interfaces . (spanner-interface side-position-interface measure-grouping-interface))))
551 (spacing-procedure . ,Multi_measure_rest::set_spacing_rods)
552 (molecule-callback . ,Multi_measure_rest::brew_molecule)
553 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
556 (thick-thickness . 6.6)
557 (hair-thickness . 2.0)
559 (meta . ((interfaces . (multi-measure-rest-interface rest-interface font-interface staff-symbol-referencer-interface))))
562 (MultiMeasureRestNumber
564 (molecule-callback . ,Text_item::brew_molecule)
565 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
566 ,Self_alignment_interface::centered_on_other_axis_parent))
567 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
568 (self-alignment-X . 0)
571 (font-family . number)
572 (meta . ((interfaces . (side-position-interface self-alignment-interface font-interface spanner-interface text-interface))))
574 (MultiMeasureRestText
576 (molecule-callback . ,Text_item::brew_molecule)
577 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
578 ,Self_alignment_interface::centered_on_other_axis_parent))
579 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
580 (self-alignment-X . 0)
583 (font-family . roman)
584 (meta . ((interfaces . (side-position-interface self-alignment-interface font-interface spanner-interface text-interface))))
589 ;; Ugh, should not be hard-coded.
591 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
592 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
593 (meta . ((interfaces . (note-collision-interface axis-group-interface item-interface ))))
599 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
600 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
601 (meta . ((interfaces . (axis-group-interface note-column-interface item-interface ))))
607 (molecule-callback . ,Note_head::brew_molecule)
608 (ligature-primitive-callback . ,Note_head::brew_molecule)
609 (glyph-name-procedure . ,find-notehead-symbol)
610 (X-extent-callback . ,Note_head::extent)
611 (Y-extent-callback . ,Note_head::extent)
612 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
613 (stem-attachment-function . ,note-head-style->attachment-coordinates)
614 (meta . ((interfaces . (rhythmic-grob-interface rhythmic-head-interface font-interface note-head-interface staff-symbol-referencer-interface item-interface ))))
621 (zigzag-width . 0.75)
623 (X-extent-callback . #f)
624 (Y-extent-callback . #f)
625 (after-line-breaking-callback . ,Line_spanner::after_line_breaking)
626 (molecule-callback . ,Line_spanner::brew_molecule)
627 (meta . ((interfaces . (line-spanner-interface spanner-interface))))
635 (X-extent-callback . #f)
636 (Y-extent-callback . #f)
637 (molecule-callback . ,Line_spanner::brew_molecule)
638 (after-line-breaking-callback . ,Line_spanner::after_line_breaking)
639 (meta . ((interfaces . (line-spanner-interface spanner-interface))))
644 (molecule-callback . ,Text_item::brew_molecule)
645 (font-family . roman)
646 (meta . ((interfaces . (note-name-interface text-interface font-interface item-interface ))))
651 (self-alignment-X . 0)
652 (break-visibility . ,begin-of-line-visible)
653 (X-offset-callbacks . (,Self_alignment_interface::centered_on_parent ,Self_alignment_interface::aligned_on_self))
654 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
655 (molecule-callback . ,Text_item::brew_molecule)
656 (font-shape . italic)
659 (font-family . roman)
660 (meta . ((interfaces . (text-interface self-alignment-interface side-position-interface font-interface item-interface ))))
666 (before-line-breaking-callback . ,Paper_column::before_line_breaking)
667 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
669 ; (molecule-callback . ,Paper_column::brew_molecule) (font-name . "cmr8") (Y-extent-callback . #f)
670 (meta . ((interfaces . (paper-column-interface axis-group-interface spaceable-grob-interface item-interface ))))
675 (molecule-callback . ,Slur::brew_molecule)
677 (spacing-procedure . ,Spanner::set_spacing_rods)
678 (minimum-length . 1.5)
679 (after-line-breaking-callback . ,Slur::after_line_breaking)
680 (extremity-rules . ,default-slur-extremity-rules)
681 (extremity-offset-alist . ,default-phrasing-slur-extremity-offset-alist)
682 (de-uglify-parameters . (1.5 0.8 -2.0))
683 (Y-extent-callback . ,Slur::height)
688 (attachment . (#f . #f))
689 (attachment-offset . ((0 . 0) . (0 . 0)))
691 (details . ((force-blowfit . 0.5)
692 (bezier-pct-c0 . -0.2) (bezier-pct-c3 . 0.000006)
693 (bezier-pct-out-max . 0.8) (bezier-pct-in-max . 1.2)
694 (bezier-area-steps . 1.0)))
695 (meta . ((interfaces . (slur-interface spanner-interface))))
698 (NonMusicalPaperColumn
701 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
702 (before-line-breaking-callback . ,Paper_column::before_line_breaking)
703 ;; debugging stuff: print column number.
704 ; (molecule-callback . ,Paper_column::brew_molecule) (font-name . "cmr8") (Y-extent-callback . #f)
707 (meta . ((interfaces . (paper-column-interface axis-group-interface spaceable-grob-interface item-interface ))))
712 (spacing-procedure . ,Multi_measure_rest::set_spacing_rods)
713 (molecule-callback . ,Multi_measure_rest::percent)
716 (minimum-width . 12.5) ; staffspace
717 (font-family . music)
718 (meta . ((interfaces . (multi-measure-rest-interface spanner-interface font-interface percent-repeat-interface))))
721 (PianoPedalBracket ;; an example of a text spanner
723 (molecule-callback . ,Piano_pedal_bracket::brew_molecule)
724 (font-family . roman)
726 (if-text-padding . 1.0)
728 (bracket-flare . (0.5 . 0.5))
729 (edge-height . (1.0 . 1.0))
730 (shorten-pair . (0.0 . 0.0))
732 (meta . ((interfaces . (line-interface piano-pedal-interface piano-pedal-bracket-interface spanner-interface))))
737 (molecule-callback . ,Percent_repeat_item_interface::beat_slash)
740 (meta . ((interfaces . (percent-repeat-interface item-interface ))))
744 (after-line-breaking-callback . ,Rest::after_line_breaking)
745 (X-extent-callback . ,Rest::extent_callback)
746 (Y-extent-callback . ,Rest::extent_callback)
747 (molecule-callback . ,Rest::brew_molecule)
748 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
749 (minimum-distance . 0.25)
751 (interfaces . (font-interface
752 rhythmic-head-interface
753 rhythmic-grob-interface
755 staff-symbol-referencer-interface
756 rest-interface item-interface ))
761 (minimum-distance . 0.75)
762 (meta . ((interfaces . (rest-collision-interface item-interface ))))
767 ;; don't set direction here: it breaks staccato.
768 (molecule-callback . ,Script_interface::brew_molecule)
770 ;; This value is sensitive: if too large, staccato dots will move a
773 ;; (script-priority . 0) priorities for scripts, see script.scm
774 (X-offset-callbacks . (,Self_alignment_interface::centered_on_parent))
775 (before-line-breaking-callback . ,Script_interface::before_line_breaking)
776 (font-family . music)
777 (meta . ((interfaces . (script-interface side-position-interface font-interface item-interface ))))
782 (before-line-breaking-callback . ,Script_column::before_line_breaking)
783 (meta . ((interfaces . (script-column-interface item-interface ))))
788 (molecule-callback . ,Slur::brew_molecule)
790 (spacing-procedure . ,Spanner::set_spacing_rods)
791 (minimum-length . 1.5)
792 (after-line-breaking-callback . ,Slur::after_line_breaking)
793 (extremity-rules . ,default-slur-extremity-rules)
794 (extremity-offset-alist . ,default-slur-extremity-offset-alist)
795 (de-uglify-parameters . (1.5 0.8 -2.0))
796 (Y-extent-callback . ,Slur::height)
801 (attachment . (#f . #f))
802 (attachment-offset . ((0 . 0) . (0 . 0)))
804 (details . ((force-blowfit . 0.5)
805 (bezier-pct-c0 . -0.2) (bezier-pct-c3 . 0.000006)
806 (bezier-pct-out-max . 0.8) (bezier-pct-in-max . 1.2)
807 (bezier-area-steps . 1.0)))
808 (meta . ((interfaces . (slur-interface spanner-interface))))
813 (spacing-procedure . ,Spacing_spanner::set_springs)
814 (grace-space-factor . 0.6)
815 (shortest-duration-space . 2.0)
816 (spacing-increment . 1.2)
817 (base-shortest-duration . ,(ly:make-moment 1 8))
818 (meta . ((interfaces . (spacing-interface spacing-spanner-interface spanner-interface))))
823 (break-align-symbol . staff-bar)
824 (bar-size-procedure . ,Span_bar::get_bar_size)
825 (molecule-callback . ,Span_bar::brew_molecule)
826 (break-visibility . ,begin-of-line-invisible)
827 (X-extent-callback . ,Span_bar::width_callback)
828 (Y-extent-callback . ())
831 (before-line-breaking-callback . ,Span_bar::before_line_breaking)
835 ;; Ross. page 151 lists other values, we opt for a leaner look
839 (hair-thickness . 1.6)
840 (thick-thickness . 6.0)
841 (meta . ((interfaces . (span-bar-interface font-interface
842 bar-line-interface item-interface ))))
846 . ((molecule-callback . ,Text_item::brew_molecule)
847 (font-family . roman)
850 (X-offset-callbacks . (,Side_position_interface::aligned_side))
852 (meta . ((interfaces . (side-position-interface text-interface font-interface item-interface ))))
858 (stem-spacing-correction . 0.4)
860 (meta . ((interfaces . (spacing-interface staff-spacing-interface item-interface ))))
864 (stem-spacing-correction . 0.5)
866 ;; Changed this from 0.75.
867 ;; If you ever change this back, please document! --hwn
868 (knee-spacing-correction . 1.0)
870 (meta . ((interfaces . (spacing-interface note-spacing-interface item-interface ))))
875 (molecule-callback . ,Staff_symbol::brew_molecule)
877 (ledger-line-thickness . (1.0 . 0.1))
879 (meta . ((interfaces . (staff-symbol-interface spanner-interface))))
884 (molecule-callback . ,Text_item::brew_molecule)
886 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
887 (no-spacing-rods . #t)
888 (padding . 0.0) ;; padding relative to SostenutoPedalLineSpanner
889 (font-family . roman)
890 (font-shape . italic)
891 (self-alignment-X . 0)
892 (meta . ((interfaces . (text-interface self-alignment-interface font-interface item-interface))))
895 (SostenutoPedalLineSpanner
898 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
899 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
903 (minimum-space . 1.0)
905 (meta . ((interfaces . (piano-pedal-interface axis-group-interface side-position-interface spanner-interface))))
911 ;; this list is rather long. Trim --hwn
912 (before-line-breaking-callback . ,Stem::before_line_breaking)
913 (molecule-callback . ,Stem::brew_molecule)
916 ;; 3.5 (or 3 measured from note head) is standar length
917 ;; 32nd, 64th flagged stems should be longer
918 (lengths . (3.5 3.5 3.5 4.5 5.0))
920 ;; Stems in unnatural (forced) direction should be shortened by
921 ;; one staff space, according to [Roush & Gourlay].
922 ;; Flagged stems we shorten only half a staff space.
923 (stem-shorten . (1.0 0.5))
925 ;; default stem direction for note on middle line
926 (neutral-direction . -1)
930 ;; FIXME. 3.5 yields too long beams (according to Ross and
931 ;; looking at Baerenreiter examples) for a number of common
932 ;; boundary cases. Subtracting half a beam thickness fixes
933 ;; this, but the bug may well be somewhere else.
935 ;; FIXME this should come from 'lengths
937 ; (beamed-lengths . (3.26 3.26 1.5))
938 (beamed-lengths . (3.5 3.5 3.5 4.5 5.0))
940 ;; We use the normal minima as minimum for the ideal lengths,
941 ;; and the extreme minima as abolute minimum length.
943 ;; The 'normal' minima
944 (beamed-minimum-free-lengths . (1.83 1.5 1.25))
946 ;; The 'extreme case' minima
947 (beamed-extreme-minimum-free-lengths . (2.0 1.25))
949 (X-offset-callbacks . (,Stem::off_callback))
950 (X-extent-callback . ,Stem::dim_callback)
951 (Y-extent-callback . ,Stem::height)
952 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
953 (adjust-if-on-staffline . #t)
954 (font-family . music)
955 (meta . ((interfaces . (stem-interface font-interface item-interface ))))
960 (molecule-callback . ,Stem_tremolo::brew_molecule)
961 (Y-extent-callback . ,Stem_tremolo::height)
962 (X-extent-callback . #f)
964 (beam-width . 1.6) ; staff-space
965 (beam-thickness . 0.48) ; staff-space
966 (meta . ((interfaces . (stem-tremolo-interface item-interface ))))
971 (X-extent-callback . #f)
972 (Y-extent-callback . #f)
973 (meta . ((interfaces . (spacing-interface separation-item-interface item-interface ))))
976 (SeparatingGroupSpanner
978 (spacing-procedure . ,Separating_group_spanner::set_spacing_rods)
979 (meta . ((interfaces . (only-prebreak-interface spacing-interface separation-spanner-interface spanner-interface))))
984 (no-spacing-rods . #t)
985 (molecule-callback . ,Sustain_pedal::brew_molecule)
986 (self-alignment-X . 0)
988 (padding . 0.0) ;; padding relative to SustainPedalLineSpanner
989 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
990 (meta . ((interfaces . (piano-pedal-interface text-spanner-interface text-interface self-alignment-interface font-interface item-interface))))
993 (SustainPedalLineSpanner
996 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
997 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1000 (minimum-space . 1.0)
1002 (meta . ((interfaces . (piano-pedal-interface axis-group-interface side-position-interface spanner-interface))))
1008 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
1009 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1010 (meta . ((interfaces . (system-interface axis-group-interface spanner-interface))))
1016 (molecule-callback . ,System_start_delimiter::brew_molecule)
1017 (collapse-height . 5.0)
1018 (font-family . braces)
1019 (Y-extent-callback . #f)
1020 (meta . ((interfaces . (system-start-delimiter-interface font-interface))))
1025 (Y-extent-callback . #f)
1026 (molecule-callback . ,System_start_delimiter::brew_molecule)
1032 (bracket-collapse-height . 1)
1034 (meta . ((interfaces . (system-start-delimiter-interface spanner-interface))))
1039 (Y-extent-callback . #f)
1040 (molecule-callback . ,System_start_delimiter::brew_molecule)
1041 (glyph . "bar-line")
1043 (after-line-breaking-callback . ,System_start_delimiter::after_line_breaking)
1044 (meta . ((interfaces . (system-start-delimiter-interface spanner-interface))))
1049 (molecule-callback . ,Text_item::brew_molecule)
1050 (no-spacing-rods . #t)
1051 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1054 (script-priority . 200)
1055 ;; todo: add X self alignment?
1057 (font-family . roman)
1058 (meta . ((interfaces . (text-script-interface text-interface side-position-interface font-interface item-interface ))))
1063 (molecule-callback . ,Text_spanner::brew_molecule)
1064 (font-family . roman)
1065 (style . dashed-line)
1067 ;; urg, only for (de)cresc. text spanners
1068 (if-text-padding . 1.0)
1069 (dash-fraction . 0.2)
1072 (meta . ((interfaces . (text-spanner-interface side-position-interface font-interface spanner-interface))))
1077 (Y-offset-callbacks . (,Side_position_interface::out_of_staff
1078 ,Side_position_interface::aligned_side))
1079 (molecule-callback . ,Ottava_bracket::brew_molecule)
1080 (font-shape . italic)
1081 (font-family . roman)
1082 (text-repeat-if-broken . #t)
1083 (shorten-pair . (0.0 . -0.6))
1084 (staff-padding . 1.0)
1086 (minimum-length . 1.0)
1087 (dash-fraction . 0.3)
1088 (edge-height . (0 . 1.2))
1090 (meta . ((interfaces . (ottava-bracket-interface
1091 line-interface side-position-interface
1092 font-interface text-interface spanner-interface))))
1097 (font-family . roman)
1099 (molecule-callback . ,Text_item::brew_molecule)
1100 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
1101 (extra-offset . (0 . -0.65)) ;; UGH! TODO: Clean this up!
1102 (stem-attachment-function . ,tablature-stem-attachment-function)
1103 (meta . ((interfaces
1104 . (rhythmic-head-interface
1106 note-head-interface staff-symbol-referencer-interface
1107 text-interface item-interface ))))
1113 (molecule-callback . ,Tie::brew_molecule)
1114 (spacing-procedure . ,Spanner::set_spacing_rods)
1115 (staffline-clearance . 0.35)
1116 (details . ((ratio . 0.333) (height-limit . 1.0)))
1120 (minimum-length . 2.5)
1121 (meta . ((interfaces . (tie-interface spanner-interface))))
1126 (after-line-breaking-callback . ,Tie_column::after_line_breaking)
1127 (X-extent-callback . #f)
1128 (Y-extent-callback . #f)
1129 (meta . ((interfaces . (tie-column-interface spanner-interface))))
1134 (molecule-callback . ,Time_signature::brew_molecule)
1135 ; (molecule-callback . ,Text_item::brew_molecule)
1136 (break-align-symbol . time-signature)
1137 (break-visibility . ,all-visible)
1139 (first-note . (fixed-space . 2.0))
1140 (right-edge . (extra-space . 0.5))
1141 (staff-bar . (minimum-space . 2.0))
1145 ; (text . (,time-signature-glue-markup))
1146 (font-family . number)
1147 (meta . ((interfaces . (time-signature-interface break-aligned-interface font-interface item-interface ))))
1155 (edge-height . (0.7 . 0.7))
1156 (shorten-pair . (-0.2 . -0.2))
1157 (before-line-breaking-callback . ,Tuplet_bracket::before_line_breaking)
1158 (after-line-breaking-callback . ,Tuplet_bracket::after_line_breaking)
1159 (molecule-callback . ,Tuplet_bracket::brew_molecule)
1160 (font-family . roman)
1161 (font-shape . italic)
1162 (font-series . bold)
1165 (meta . ((interfaces . (text-interface line-interface tuplet-bracket-interface font-interface spanner-interface))))
1170 (molecule-callback . ,Text_item::brew_molecule)
1171 (font-family . roman)
1172 (font-shape . italic)
1173 (no-spacing-rods . #t)
1174 (self-alignment-X . 0)
1176 (padding . 0.0) ;; padding relative to UnaCordaPedalLineSpanner
1177 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1178 (meta . ((interfaces . (text-interface self-alignment-interface font-interface item-interface ))))
1181 (UnaCordaPedalLineSpanner
1184 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1185 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1188 (minimum-space . 1.0)
1190 (meta . ((interfaces . (piano-pedal-interface axis-group-interface side-position-interface spanner-interface))))
1197 (ligature-primitive-callback . ,Vaticana_ligature::brew_ligature_primitive)
1198 (molecule-callback . ,Vaticana_ligature::brew_molecule)
1199 (meta . ((interfaces . (vaticana-ligature-interface font-interface))))
1204 (molecule-callback . ,Volta_bracket_interface::brew_molecule)
1207 (font-family . number)
1208 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1209 (thickness . 1.6) ; linethickness
1210 (height . 2.0) ; staffspace;
1212 (font-family . number)
1214 (meta . ((interfaces . (volta-bracket-interface line-interface text-interface side-position-interface font-interface spanner-interface))))
1220 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1221 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
1223 (meta . ((interfaces . (align-interface axis-group-interface spanner-interface))))
1229 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1230 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
1232 (meta . ((interfaces . (axis-group-interface spanner-interface))))
1240 (define (completize-grob-entry x)
1241 "transplant assoc key into 'name entry of 'meta of X
1243 (let* ((name-sym (car x))
1244 (grob-entry (cdr x))
1245 (metaentry (cdr (assoc 'meta grob-entry)))
1247 (cdr (assoc 'interfaces metaentry)))
1250 (set! metaentry (assoc-set! metaentry 'name name-sym))
1251 (set! metaentry (assoc-set! metaentry 'interfaces
1252 (cons 'grob-interface ifaces-entry)))
1253 (set! grob-entry (assoc-set! grob-entry 'meta metaentry))
1254 (cons name-sym grob-entry)))
1256 (set! all-grob-descriptions (map completize-grob-entry all-grob-descriptions))
1260 ; (display (map pair? all-grob-descriptions))
1263 ;; make sure that \property Foo.Bar =\turnOff doesn't complain
1266 ; (display (car x)) (newline)
1268 (set-object-property! (car x) 'translation-type? list?)
1269 (set-object-property! (car x) 'is-grob? #t))
1270 all-grob-descriptions)
1273 (set! all-grob-descriptions (sort all-grob-descriptions alist<?))