1 ;;;; grob-description.scm -- part of generated backend documentation
3 ;;;; source file of the GNU LilyPond music typesetter
5 ;;;; (c) 1998--2002 Han-Wen Nienhuys <hanwen@cs.uu.nl>
6 ;;;; Jan Nieuwenhuizen <janneke@gnu.org>
8 ;;;; distances are given in stafflinethickness (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.
31 (right-padding . 0.15)
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 . (extra-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 (first-note . (extra-space . 1.3))
81 (right-edge . (extra-space . 0.0))
85 ;; Ross. page 151 lists other values, we opt for a leaner look
89 (hair-thickness . 1.6)
90 (thick-thickness . 6.0)
91 (meta . ((interfaces . (bar-line-interface item-interface break-aligned-interface font-interface))))
97 (molecule-callback . ,Text_item::brew_molecule)
99 (break-visibility . ,begin-of-line-visible)
102 (font-family . roman)
103 (font-relative-size . -1)
104 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
105 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
106 (self-alignment-X . 1)
107 (extra-offset . (1.3 . 0))
109 ((interfaces . (side-position-interface
111 self-alignment-interface
112 font-interface item-interface break-aligned-interface))))
118 (molecule-callback . ,brew-bass-figure)
119 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
121 (font-family . number)
122 (font-relative-size . -1)
126 (meta . ((interfaces . (text-interface bass-figure-interface item-interface self-alignment-interface font-interface))))
130 ;; todo: clean this up a bit: the list is getting
132 (molecule-callback . ,Beam::brew_molecule)
133 (concaveness-gap . 2.0)
134 (concaveness-threshold . 0.08)
135 (positions . (#f . #f))
136 (position-callbacks . (,Beam::least_squares
139 ,Beam::shift_region_to_valid
143 ;; TODO: should be in SLT.
144 (thickness . 0.48) ; in staff-space
145 (before-line-breaking-callback . ,Beam::before_line_breaking)
146 (after-line-breaking-callback . ,Beam::after_line_breaking)
147 (neutral-direction . -1)
148 (dir-function . ,beam-dir-majority-median)
150 ;; Whe have some unreferenced problems here.
152 ;; If we shorten beamed stems less than normal stems (1 staffspace),
153 ;; or high order less than 8th beams, patterns like
154 ;; c''4 [c''8 c''] c''4 [c''16 c]
155 ;; are ugly (different stem lengths).
157 ;; But if we shorten 16th beams as much as 8th beams, a single
158 ;; forced 16th beam looks *very* short.
160 ;; We choose to shorten 8th beams the same as single stems,
161 ;; and high order beams less than 8th beams, so that all
162 ;; isolated shortened beams look nice and a bit shortened,
163 ;; sadly possibly breaking patterns with high order beams.
164 (beamed-stem-shorten . (1.0 0.5 0.25))
166 (outer-stem-length-limit . 0.2)
168 (flag-width-function . ,beam-flag-width-function)
170 (auto-knee-gap . 5.5)
171 (font-name . "cmr10")
172 (space-function . ,Beam::space_function)
173 (meta . ((interfaces . (staff-symbol-referencer-interface beam-interface spanner-interface))))
181 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
182 (meta . ((interfaces . (break-alignment-interface item-interface axis-group-interface)))))
188 (X-offset-callbacks . (,Break_align_interface::alignment_callback))
189 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
190 (meta . ((interfaces . (break-aligned-interface item-interface axis-group-interface item-interface ))))
195 (break-align-symbol . breathing-sign)
198 (ambitus . (extra-space . 2.0))
199 (key-signature . (minimum-space . 1.5))
200 (staff-bar . (minimum-space . 1.5))
201 (clef . (minimum-space . 2.0))
202 (first-note . (minimum-space . 1.0))
204 (molecule-callback . ,Text_item::brew_molecule)
206 (font-family . music)
207 (text . "scripts-rcomma")
208 (Y-offset-callbacks . (,Breathing_sign::offset_callback))
209 (break-visibility . ,begin-of-line-invisible)
210 (meta . ((interfaces . (break-aligned-interface breathing-sign-interface text-interface font-interface item-interface ))))
215 (molecule-callback . ,Clef::brew_molecule)
216 (before-line-breaking-callback . ,Clef::before_line_breaking)
218 (font-family . music)
219 (break-align-symbol . clef)
220 (break-visibility . ,begin-of-line-visible)
222 (ambitus . (extra-space . 2.0))
223 (staff-bar . (minimum-space . 3.7))
224 (key-signature . (minimum-space . 4.0))
225 (time-signature . (minimum-space . 4.2))
226 (first-note . (minimum-space . 5.0))
227 (next-note . (extra-space . 0.5))
228 (right-edge . (extra-space . 0.5))
230 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
231 (meta . ((interfaces . (clef-interface staff-symbol-referencer-interface font-interface break-aligned-interface item-interface ))))
236 (molecule-callback . ,Cluster::brew_molecule)
237 (spacing-procedure . ,Spanner::set_spacing_rods)
238 (minimum-length . 0.0)
240 (shape . leftsided-stairs)
241 (meta . ((interfaces . (cluster-interface spanner-interface))))
246 (molecule-callback . ,Chord_name::brew_molecule)
247 (after-line-breaking-callback . ,Chord_name::after_line_breaking)
248 (chord-name-function . ,default-chord-name-function)
249 (font-family . roman)
250 (meta . ((interfaces . (font-interface text-interface chord-name-interface item-interface ))))
255 (break-align-symbol . custos)
257 (molecule-callback . ,Custos::brew_molecule)
258 (break-visibility . ,end-of-line-visible)
260 (neutral-position . 0)
261 (neutral-direction . -1)
262 (adjust-if-on-staffline . #t)
263 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
264 (font-family . ancient)
266 (first-note . (minimum-space . 0.0))
267 (right-edge . (extra-space . 0.1))
270 . (custos-interface staff-symbol-referencer-interface
272 break-aligned-interface item-interface ))))
280 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
281 (X-offset-callbacks . (,Dot_column::side_position))
282 (meta . ((interfaces . (dot-column-interface axis-group-interface item-interface ))))
287 (molecule-callback . ,Dots::brew_molecule)
289 (Y-offset-callbacks . (,Dots::quantised_position_callback ,Staff_symbol_referencer::callback))
290 (meta . ((interfaces . (font-interface staff-symbol-referencer-interface dots-interface item-interface ))))
293 (DoublePercentRepeat .
295 (molecule-callback . ,Percent_repeat_item_interface::double_percent)
298 (font-family . music)
301 (break-align-symbol . staff-bar)
302 (break-visibility . ,begin-of-line-invisible)
303 (meta . ((interfaces . (font-interface
304 break-aligned-interface
305 percent-repeat-interface item-interface ))))
310 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
311 (molecule-callback . ,Text_item::brew_molecule)
312 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
313 ,Self_alignment_interface::centered_on_parent))
314 (self-alignment-X . 0)
315 (no-spacing-rods . #t)
316 (script-priority . 100)
318 (font-family . dynamic)
319 (font-shape . italic)
320 (self-alignment-Y . 0)
321 (meta . ((interfaces . (font-interface text-interface self-alignment-interface dynamic-interface script-interface item-interface ))))
327 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
328 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
330 (minimum-space . 1.2)
332 (meta . ((interfaces . (dynamic-interface axis-group-interface side-position-interface spanner-interface))))
337 (break-align-symbol . left-edge)
338 (X-extent-callback . ,Grob::point_dimension_callback)
341 (custos . (extra-space . 0.0))
342 (ambitus . (extra-space . 2.0))
343 (time-signature . (extra-space . 0.0))
344 (staff-bar . (extra-space . 0.0))
345 (breathing-sign . (minimum-space . 0.0))
346 (clef . (extra-space . 1.0))
347 (first-note . (extra-space . 1.0))
348 (right-edge . (extra-space . 0.0))
349 (key-signature . (extra-space . 0.0))
351 (meta . ((interfaces . (break-aligned-interface item-interface ))))
356 (molecule-callback . ,Text_item::brew_molecule)
359 (self-alignment-X . 0)
360 (self-alignment-Y . 0)
361 (script-priority . 100)
362 (font-family . number)
363 (font-relative-size . -3)
364 (font-shape . upright)
365 (meta . ((interfaces . (finger-interface font-interface text-script-interface text-interface side-position-interface self-alignment-interface item-interface ))))
369 (HaraKiriVerticalGroup
371 (Y-offset-callbacks . (,Hara_kiri_group_spanner::force_hara_kiri_callback))
372 (Y-extent-callback . ,Hara_kiri_group_spanner::y_extent)
374 (meta . ((interfaces . (axis-group-interface hara-kiri-group-interface item-interface spanner-interface))))
379 (molecule-callback . ,Hairpin::brew_molecule)
382 (spacing-procedure . ,Spanner::set_spacing_rods)
383 (minimum-length . 2.0)
384 (if-text-padding . 1.0)
385 (width-correct . -1.0)
387 (dash-thickness . 1.2)
389 (self-alignment-Y . 0)
390 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
391 (meta . ((interfaces . (hairpin-interface self-alignment-interface dynamic-interface spanner-interface))))
397 (molecule-callback . ,Horizontal_bracket::brew_molecule)
398 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
401 (meta . ((interfaces . (horizontal-bracket-interface spanner-interface))))
406 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self
407 ,Side_position_interface::aligned_on_support_refpoints))
408 ;; huh? what's this for?
411 (left-edge . (extra-space . 1.0))
414 (self-alignment-Y . 0)
415 (molecule-callback . ,Text_item::brew_molecule)
416 (break-align-symbol . instrument-name)
417 (break-visibility . ,begin-of-line-visible)
419 (font-family . roman)
420 (meta . ((interfaces . (font-interface self-alignment-interface side-position-interface text-interface break-aligned-interface item-interface ))))
425 (molecule-callback . ,Key_signature_interface::brew_molecule)
427 (time-signature . (extra-space . 1.25))
428 (staff-bar . (extra-space . 1.1))
429 (right-edge . (extra-space . 0.5))
430 (first-note . (extra-space . 2.5))
432 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
433 (break-align-symbol . key-signature)
434 (break-visibility . ,begin-of-line-visible)
436 (meta . ((interfaces . (key-signature-interface font-interface break-aligned-interface item-interface ))))
441 (molecule-callback . ,Ligature_bracket::brew_molecule)
442 (meta . ((interfaces . (ligature-interface))))
449 (ligature-primitive-callback . ,Note_head::brew_molecule)
450 (molecule-callback . ,Ligature_bracket::brew_molecule)
451 (meta . ((interfaces . (ligature-bracket-interface spanner-interface))))
456 (ligature-primitive-callback . ,Note_head::brew_molecule)
457 (molecule-callback . ,Ligature_head::brew_molecule)
458 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
459 (stem-attachment-function . ,note-head-style->attachment-coordinates)
460 (font-family . ancient)
462 (glyph-name-procedure . ,find-notehead-symbol)
463 (meta . ((interfaces . (ligature-head-interface rhythmic-head-interface
465 note-head-interface staff-symbol-referencer-interface))))
472 (minimum-length . 0.5)
473 (maximum-length . 100)
474 (molecule-callback . ,Hyphen_spanner::brew_molecule)
475 (Y-extent-callback . ,Grob::point_dimension_callback)
476 (meta . ((interfaces . (lyric-hyphen-interface spanner-interface))))
481 (molecule-callback . ,Lyric_extender::brew_molecule)
482 (height . 0.8) ; stafflinethickness;
483 (right-trim-amount . 0.5)
484 (Y-extent-callback . ,Grob::point_dimension_callback)
485 (meta . ((interfaces . (lyric-extender-interface spanner-interface))))
490 (molecule-callback . ,Text_item::brew_molecule)
491 (X-offset-callbacks . (,Self_alignment_interface::centered_on_parent
492 ,Self_alignment_interface::aligned_on_self))
493 (self-alignment-X . 0)
495 (ignore-length-mismatch . #f)
496 (begin-alignment . 4)
498 (font-family . roman)
499 (font-shape . upright)
501 ;; duh, side-position-interface?
502 (meta . ((interfaces . (lyric-syllable-interface self-alignment-interface text-interface font-interface item-interface ))))
509 (ligature-primitive-callback . ,Mensural_ligature::brew_ligature_primitive)
510 (molecule-callback . ,Mensural_ligature::brew_molecule)
511 (font-family . ancient)
512 (meta . ((interfaces . (mensural-ligature-interface font-interface))))
518 (auto-properties . #f)
524 (molecule-callback . ,Porrectus::brew_molecule)
525 (meta . ((interfaces . (porrectus-interface))))
530 (molecule-callback . ,Text_item::brew_molecule)
531 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
532 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
533 (self-alignment-X . 0)
537 (font-family . roman)
539 (break-visibility . ,end-of-line-invisible)
541 (meta . ((interfaces . (text-interface side-position-interface font-interface mark-interface self-alignment-interface item-interface ))))
546 (Y-offset-callbacks . (,Side_position_interface::out_of_staff
547 ,Side_position_interface::aligned_side))
548 (molecule-callback . ,Measure_grouping::brew_molecule)
549 (meta . ((interfaces . (spanner-interface measure-grouping-interface)))) (staff-padding . 3)
557 (spacing-procedure . ,Multi_measure_rest::set_spacing_rods)
558 (molecule-callback . ,Multi_measure_rest::brew_molecule)
559 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
562 (thick-thickness . 6.6)
563 (hair-thickness . 2.0)
565 (meta . ((interfaces . (multi-measure-rest-interface rest-interface font-interface staff-symbol-referencer-interface spanner-interface))))
568 (MultiMeasureRestNumber
570 (molecule-callback . ,Text_item::brew_molecule)
571 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
572 ,Self_alignment_interface::centered_on_other_axis_parent))
573 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
574 (self-alignment-X . 0)
577 (font-family . number)
578 (meta . ((interfaces . (side-position-interface font-interface spanner-interface))))
585 ;; Ugh, should not be hard-coded.
587 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
588 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
589 (meta . ((interfaces . (note-collision-interface axis-group-interface item-interface ))))
595 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
596 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
597 (meta . ((interfaces . (axis-group-interface note-column-interface item-interface ))))
603 (molecule-callback . ,Note_head::brew_molecule)
604 (glyph-name-procedure . ,find-notehead-symbol)
605 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
606 (stem-attachment-function . ,note-head-style->attachment-coordinates)
607 (meta . ((interfaces . (rhythmic-head-interface font-interface note-head-interface staff-symbol-referencer-interface item-interface ))))
614 (zigzag-width . 0.75)
616 (X-extent-callback . #f)
617 (Y-extent-callback . #f)
618 (molecule-callback . ,Line_spanner::brew_molecule)
619 (meta . ((interfaces . (line-spanner-interface spanner-interface))))
627 (X-extent-callback . #f)
628 (Y-extent-callback . #f)
629 (molecule-callback . ,Line_spanner::brew_molecule)
630 (meta . ((interfaces . (line-spanner-interface spanner-interface))))
635 (molecule-callback . ,Text_item::brew_molecule)
636 (font-family . roman)
637 (meta . ((interfaces . (note-name-interface text-interface font-interface item-interface ))))
642 (self-alignment-X . 0)
644 (break-visibility . ,begin-of-line-visible)
645 (X-offset-callbacks . (,Self_alignment_interface::centered_on_parent ,Self_alignment_interface::aligned_on_self))
646 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
647 (molecule-callback . ,Text_item::brew_molecule)
648 (font-shape . italic)
650 (font-relative-size . -2)
651 (font-family . roman)
652 (meta . ((interfaces . (text-interface self-alignment-interface side-position-interface font-interface item-interface ))))
658 (before-line-breaking-callback . ,Paper_column::before_line_breaking)
659 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
661 ; (molecule-callback . ,Paper_column::brew_molecule) (font-name . "cmr8") (Y-extent-callback . #f)
662 (meta . ((interfaces . (paper-column-interface axis-group-interface spaceable-grob-interface item-interface ))))
667 (molecule-callback . ,Slur::brew_molecule)
669 (spacing-procedure . ,Spanner::set_spacing_rods)
670 (minimum-length . 1.5)
671 (after-line-breaking-callback . ,Slur::after_line_breaking)
672 (extremity-rules . ,default-slur-extremity-rules)
673 (extremity-offset-alist . ,default-phrasing-slur-extremity-offset-alist)
674 (de-uglify-parameters . (1.5 0.8 -2.0))
675 (Y-extent-callback . ,Slur::height)
680 (attachment . (#f . #f))
681 (attachment-offset . ((0 . 0) . (0 . 0)))
683 (details . ((force-blowfit . 0.5)
684 (bezier-pct-c0 . -0.2) (bezier-pct-c3 . 0.000006)
685 (bezier-pct-out-max . 0.8) (bezier-pct-in-max . 1.2)
686 (bezier-area-steps . 1.0)))
687 (meta . ((interfaces . (slur-interface spanner-interface))))
690 (NonMusicalPaperColumn
693 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
694 (before-line-breaking-callback . ,Paper_column::before_line_breaking)
695 ;; debugging stuff: print column number.
696 ; (molecule-callback . ,Paper_column::brew_molecule) (font-name . "cmr8") (Y-extent-callback . #f)
699 (meta . ((interfaces . (paper-column-interface axis-group-interface spaceable-grob-interface item-interface ))))
704 (spacing-procedure . ,Multi_measure_rest::set_spacing_rods)
705 (molecule-callback . ,Multi_measure_rest::percent)
708 (minimum-width . 12.5) ; staffspace
709 (font-family . music)
710 (meta . ((interfaces . (multi-measure-rest-interface spanner-interface font-interface percent-repeat-interface))))
713 (PianoPedalBracket ;; an example of a text spanner
715 (molecule-callback . ,Text_spanner::brew_molecule)
716 (font-family . roman)
718 (if-text-padding . 1.0)
722 (edge-widen . (0.5 . 0.5))
723 (edge-height . (1.0 . 1.0))
724 (shorten-pair . (0.0 . 0.0))
726 (meta . ((interfaces . (text-spanner-interface piano-pedal-interface spanner-interface))))
731 (molecule-callback . , Percent_repeat_item_interface::beat_slash)
734 (meta . ((interfaces . (percent-repeat-interface item-interface ))))
738 (after-line-breaking-callback . ,Rest::after_line_breaking)
739 (X-extent-callback . ,Rest::extent_callback)
740 (Y-extent-callback . ,Rest::extent_callback)
741 (molecule-callback . ,Rest::brew_molecule)
742 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
743 (minimum-beam-collision-distance . 0.75)
745 (interfaces . (font-interface
746 rhythmic-head-interface
747 staff-symbol-referencer-interface
748 rest-interface item-interface ))
753 (minimum-distance . 0.75)
754 (meta . ((interfaces . (rest-collision-interface item-interface ))))
759 ;; don't set direction here: it breaks staccato.
760 (molecule-callback . ,Script_interface::brew_molecule)
762 ;; This value is sensitive: if too large, staccato dots will move a
765 ;; (script-priority . 0) priorities for scripts, see script.scm
766 (X-offset-callbacks . (,Self_alignment_interface::centered_on_parent))
767 (before-line-breaking-callback . ,Script_interface::before_line_breaking)
768 (font-family . music)
769 (meta . ((interfaces . (script-interface side-position-interface font-interface item-interface ))))
774 (before-line-breaking-callback . ,Script_column::before_line_breaking)
775 (meta . ((interfaces . (script-column-interface item-interface ))))
780 (molecule-callback . ,Slur::brew_molecule)
782 (spacing-procedure . ,Spanner::set_spacing_rods)
783 (minimum-length . 1.5)
784 (after-line-breaking-callback . ,Slur::after_line_breaking)
785 (extremity-rules . ,default-slur-extremity-rules)
786 (extremity-offset-alist . ,default-slur-extremity-offset-alist)
787 (de-uglify-parameters . (1.5 0.8 -2.0))
788 (Y-extent-callback . ,Slur::height)
793 (attachment . (#f . #f))
794 (attachment-offset . ((0 . 0) . (0 . 0)))
796 (details . ((force-blowfit . 0.5)
797 (bezier-pct-c0 . -0.2) (bezier-pct-c3 . 0.000006)
798 (bezier-pct-out-max . 0.8) (bezier-pct-in-max . 1.2)
799 (bezier-area-steps . 1.0)))
800 (meta . ((interfaces . (slur-interface spanner-interface))))
805 (spacing-procedure . ,Spacing_spanner::set_springs)
806 (grace-space-factor . 0.6)
807 (shortest-duration-space . 2.0)
808 (spacing-increment . 1.2)
809 (base-shortest-duration . ,(ly:make-moment 1 8))
810 (meta . ((interfaces . (spacing-interface spacing-spanner-interface spanner-interface))))
815 (break-align-symbol . staff-bar)
816 (bar-size-procedure . ,Span_bar::get_bar_size)
817 (molecule-callback . ,Span_bar::brew_molecule)
818 (break-visibility . ,begin-of-line-invisible)
819 (X-extent-callback . ,Span_bar::width_callback)
820 (Y-extent-callback . ())
823 (before-line-breaking-callback . ,Span_bar::before_line_breaking)
827 ;; Ross. page 151 lists other values, we opt for a leaner look
831 (hair-thickness . 1.6)
832 (thick-thickness . 6.0)
833 (meta . ((interfaces . (span-bar-interface font-interface
834 bar-line-interface item-interface ))))
840 (molecule-callback . ,Text_item::brew_molecule)
841 (break-align-symbol . clef)
842 (break-visibility . ,begin-of-line-visible)
843 (font-family . roman)
844 (meta . ((interfaces . (break-aligned-interface text-interface font-interface item-interface ))))
850 (stem-spacing-correction . 0.4)
851 (knee-spacing-correction . 0.75)
852 (meta . ((interfaces . (spacing-interface staff-spacing-interface item-interface ))))
856 (stem-spacing-correction . 0.5)
857 (knee-spacing-correction . 0.75)
858 (meta . ((interfaces . (spacing-interface note-spacing-interface item-interface ))))
863 (molecule-callback . ,Staff_symbol::brew_molecule)
866 (meta . ((interfaces . (staff-symbol-interface spanner-interface))))
871 (molecule-callback . ,Text_item::brew_molecule)
873 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
874 (no-spacing-rods . #t)
875 (padding . 0.0) ;; padding relative to SostenutoPedalLineSpanner
877 (font-family . roman)
878 (font-shape . italic)
879 (self-alignment-X . 0)
880 (meta . ((interfaces . (text-interface self-alignment-interface font-interface item-interface))))
883 (SostenutoPedalLineSpanner
886 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
887 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
891 (minimum-space . 1.0)
893 (meta . ((interfaces . (piano-pedal-interface axis-group-interface side-position-interface spanner-interface))))
898 (before-line-breaking-callback . ,Stem::before_line_breaking)
899 (molecule-callback . ,Stem::brew_molecule)
902 ;; 3.5 (or 3 measured from note head) is standar length
903 ;; 32nd, 64th flagged stems should be longer
904 (lengths . (3.5 3.5 3.5 4.5 5.0))
906 ;; Stems in unnatural (forced) direction should be shortened by
907 ;; one staff space, according to [Roush & Gourlay].
908 ;; Flagged stems we shorten only half a staff space.
909 (stem-shorten . (1.0 0.5))
911 ;; default stem direction for note on middle line
912 (neutral-direction . -1)
914 ;; [Wanske]: standard length (but no shorter than minimum).
915 ;; (beamed-lengths . (3.5))
917 ;; FIXME. 3.5 yields too long beams (according to Ross and
918 ;; looking at Baerenreiter examples) for a number of common
919 ;; boundary cases. Subtracting half a beam thickness fixes
920 ;; this, but the bug may well be somewhere else.
921 (beamed-lengths . (3.26))
923 ;; [Wanske] lists three sets of minimum lengths. One
924 ;; set for the nomal case, and one set for beams with `der
925 ;; Balkenendpunkt weiter "uber bzw. unter die Systemgrenze
926 ;; hinaus (bei Gruppen mit grossem Tonumfang)' and the extreme
929 ;; Note that Wanske lists numbers lengths starting from top of
930 ;; head, so we must add half a staff space.
932 ;; We use the normal minima as minimum for the ideal lengths,
933 ;; and the extreme minima as abolute minimum length.
935 ;; The 'normal' minima
936 (beamed-minimum-free-lengths . (2.5 2.0 1.5))
938 ;; The 'far outside staff' minima, not used
939 ;(beamed-far-minimum-free-lengths . (1.83))
941 ;; The 'extreme case' minima
942 (beamed-extreme-minimum-free-lengths . (1.83 1.5))
944 (X-offset-callbacks . (,Stem::off_callback))
945 (X-extent-callback . ,Stem::dim_callback)
946 (Y-extent-callback . ,Stem::height)
947 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
948 (adjust-if-on-staffline . #t)
949 (font-family . music)
950 (avoid-note-head . #f)
952 (meta . ((interfaces . (stem-interface font-interface item-interface ))))
957 (molecule-callback . ,Stem_tremolo::brew_molecule)
958 (Y-extent-callback . ,Stem_tremolo::height)
959 (X-extent-callback . #f)
961 (beam-width . 1.6) ; staff-space
962 (beam-thickness . 0.48) ; staff-space
963 (meta . ((interfaces . (stem-tremolo-interface item-interface ))))
968 (meta . ((interfaces . (spacing-interface separation-item-interface item-interface ))))
971 (SeparatingGroupSpanner
973 (spacing-procedure . ,Separating_group_spanner::set_spacing_rods)
974 (meta . ((interfaces . (spacing-interface separation-spanner-interface spanner-interface))))
979 (no-spacing-rods . #t)
980 (molecule-callback . ,Sustain_pedal::brew_molecule)
981 (self-alignment-X . 0)
983 (padding . 0.0) ;; padding relative to SustainPedalLineSpanner
985 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
986 (meta . ((interfaces . (piano-pedal-interface text-spanner-interface text-interface self-alignment-interface font-interface item-interface))))
989 (SustainPedalLineSpanner
992 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
993 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
996 (minimum-space . 1.0)
998 (meta . ((interfaces . (piano-pedal-interface axis-group-interface side-position-interface spanner-interface))))
1004 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
1005 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1006 (meta . ((interfaces . (system-interface axis-group-interface spanner-interface))))
1012 (molecule-callback . ,System_start_delimiter::brew_molecule)
1013 (collapse-height . 5.0)
1014 (font-family . braces)
1015 (Y-extent-callback . #f)
1016 (meta . ((interfaces . (system-start-delimiter-interface font-interface))))
1021 (Y-extent-callback . #f)
1022 (molecule-callback . ,System_start_delimiter::brew_molecule)
1028 (bracket-collapse-height . 1)
1030 (meta . ((interfaces . (system-start-delimiter-interface spanner-interface))))
1035 (Y-extent-callback . #f)
1036 (molecule-callback . ,System_start_delimiter::brew_molecule)
1037 (glyph . "bar-line")
1039 (after-line-breaking-callback . ,System_start_delimiter::after_line_breaking)
1040 (meta . ((interfaces . (system-start-delimiter-interface spanner-interface))))
1045 (molecule-callback . ,Text_item::brew_molecule)
1046 (no-spacing-rods . #t)
1047 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1050 (script-priority . 200)
1051 ;; todo: add X self alignment?
1053 (font-family . roman)
1054 (meta . ((interfaces . (text-script-interface text-interface side-position-interface font-interface item-interface ))))
1059 (molecule-callback . ,Text_spanner::brew_molecule)
1060 (font-family . roman)
1063 ;; urg, only for (de)cresc. text spanners
1064 (if-text-padding . 1.0)
1065 (width-correct . -1)
1068 (meta . ((interfaces . (text-spanner-interface side-position-interface font-interface spanner-interface))))
1073 (font-family . roman)
1075 (molecule-callback . ,tablature-molecule-callback)
1076 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
1077 (extra-offset . (0 . -0.65)) ;; UGH! TODO: Clean this up!
1078 (stem-attachment-function . ,tablature-stem-attachment-function)
1079 (meta . ((interfaces
1080 . (rhythmic-head-interface
1082 note-head-interface staff-symbol-referencer-interface
1083 text-interface item-interface ))))
1089 (molecule-callback . ,Tie::brew_molecule)
1090 (spacing-procedure . ,Spanner::set_spacing_rods)
1091 (staffline-clearance . 0.35)
1092 (details . ((ratio . 0.333) (height-limit . 1.0)))
1096 (minimum-length . 2.5)
1097 (meta . ((interfaces . (tie-interface spanner-interface))))
1102 (after-line-breaking-callback . ,Tie_column::after_line_breaking)
1103 (X-extent-callback . ())
1104 (Yoo-extent-callback . ())
1105 (meta . ((interfaces . (tie-column-interface spanner-interface))))
1110 (molecule-callback . ,Time_signature::brew_molecule)
1111 (break-align-symbol . time-signature)
1112 (break-visibility . ,all-visible)
1114 (first-note . (extra-space . 2.0))
1115 (right-edge . (extra-space . 0.5))
1116 (staff-bar . (minimum-space . 2.0))
1120 (font-family . number)
1121 (meta . ((interfaces . (time-signature-interface break-aligned-interface font-interface item-interface ))))
1129 (edge-widen . (0.0 . 0.0))
1130 (edge-height . (0.7 . 0.7))
1131 (shorten-pair . (-0.2 . -0.2))
1132 (before-line-breaking-callback . ,Tuplet_bracket::before_line_breaking)
1133 (after-line-breaking-callback . ,Tuplet_bracket::after_line_breaking)
1134 (molecule-callback . ,Tuplet_bracket::brew_molecule)
1135 (font-family . roman)
1136 (font-shape . italic)
1138 (font-relative-size . -1)
1139 (meta . ((interfaces . (text-interface tuplet-bracket-interface font-interface spanner-interface))))
1144 (molecule-callback . ,Text_item::brew_molecule)
1145 (font-family . roman)
1146 (font-shape . italic)
1147 (no-spacing-rods . #t)
1148 (self-alignment-X . 0)
1151 (padding . 0.0) ;; padding relative to UnaCordaPedalLineSpanner
1152 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1153 (meta . ((interfaces . (text-interface self-alignment-interface font-interface item-interface ))))
1156 (UnaCordaPedalLineSpanner
1159 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1160 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1163 (minimum-space . 1.0)
1165 (meta . ((interfaces . (piano-pedal-interface axis-group-interface side-position-interface spanner-interface))))
1170 (molecule-callback . ,Volta_bracket_interface::brew_molecule)
1173 (font-style . volta)
1174 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1175 (thickness . 1.6) ; stafflinethickness
1176 (height . 2.0) ; staffspace;
1178 (font-family . number)
1179 (font-relative-size . -2)
1180 (meta . ((interfaces . (volta-bracket-interface text-interface side-position-interface font-interface spanner-interface))))
1186 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1188 (meta . ((interfaces . (align-interface axis-group-interface spanner-interface))))
1194 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1196 (meta . ((interfaces . (axis-group-interface spanner-interface))))
1204 (define (completize-grob-entry x)
1205 "transplant assoc key into 'name entry of 'meta of X
1207 (let* ((name-sym (car x))
1208 (grob-entry (cdr x))
1209 (metaentry (cdr (assoc 'meta grob-entry)))
1211 (cdr (assoc 'interfaces metaentry)))
1214 (set! metaentry (assoc-set! metaentry 'name name-sym))
1215 (set! metaentry (assoc-set! metaentry 'interfaces
1216 (cons 'grob-interface ifaces-entry)))
1217 (set! grob-entry (assoc-set! grob-entry 'meta metaentry))
1218 (cons name-sym grob-entry)))
1220 (set! all-grob-descriptions (map completize-grob-entry all-grob-descriptions))
1224 ; (display (map pair? all-grob-descriptions))
1227 ;; make sure that \property Foo.Bar =\turnOff doesn't complain
1230 ; (display (car x)) (newline)
1232 (set-object-property! (car x) 'translation-type? list?)
1233 (set-object-property! (car x) 'is-grob? #t))
1234 all-grob-descriptions)
1237 (set! all-grob-descriptions (sort all-grob-descriptions alist<?))