1 ;;;; define-grobs.scm --
3 ;;;; source file of the GNU LilyPond music typesetter
5 ;;;; (c) 1998--2004 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 (print-function . ,Accidental_interface::print)
20 (cautionary-style . parentheses)
21 (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))))
37 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
38 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
40 (clef . (extra-space . 0.5))
41 (key-signature . (extra-space . 0.0))
42 (staff-bar . (extra-space . 0.0))
43 (time-signature . (extra-space . 0.0))
44 (first-note . (fixed-space . 0.0))
47 (break-align-symbol . ambitus)
48 (break-visibility . ,begin-of-line-visible)
49 (meta . ((interfaces . (axis-group-interface break-aligned-interface ambitus-interface item-interface ))))
54 (print-function . ,Ambitus::print)
57 (X-offset-callbacks . (,Self_alignment_interface::centered_on_parent))
59 (meta . ((interfaces . (ambitus-interface staff-symbol-referencer-interface item-interface font-interface))))
63 (print-function . ,Accidental_interface::print)
66 (X-offset-callbacks . (,Side_position_interface::aligned_side))
68 (cautionary-style . parentheses)
69 (after-line-breaking-callback . ,Accidental_interface::after_line_breaking) (meta . ((interfaces . (item-interface accidental-interface break-aligned-interface side-position-interface font-interface))))
75 (print-function . ,Note_head::print)
76 (glyph-name-procedure . ,find-notehead-symbol)
77 (X-extent-callback . ,Note_head::extent)
78 (Y-extent-callback . ,Note_head::extent)
79 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
80 (meta . ((interfaces . (font-interface note-head-interface ambitus-interface staff-symbol-referencer-interface rhythmic-head-interface item-interface ))))
85 (X-extent-callback . ,Arpeggio::width_callback)
86 (Y-extent-callback . #f)
87 (print-function . ,Arpeggio::print)
88 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
89 (X-offset-callbacks . (,Side_position_interface::aligned_side))
92 (staff-position . 0.0)
93 (meta . ((interfaces . (arpeggio-interface staff-symbol-referencer-interface side-position-interface item-interface font-interface))))
98 (break-align-symbol . staff-bar)
100 (break-glyph-function . ,default-break-barline)
101 (bar-size-procedure . ,Bar_line::get_staff_bar_size)
102 (print-function . ,Bar_line::print)
103 (break-visibility . ,all-visible)
105 (before-line-breaking-callback . ,Bar_line::before_line_breaking)
107 (time-signature . (extra-space . 0.75))
108 (custos . (minimum-space . 2.0))
109 (clef . (minimum-space . 1.0))
110 (key-signature . (extra-space . 1.0))
111 (first-note . (fixed-space . 1.3))
112 (next-note . (semi-fixed-space . 1.3))
113 (right-edge . (extra-space . 0.0))
117 ;; Ross. page 151 lists other values, we opt for a leaner look
121 (hair-thickness . 1.6)
122 (thick-thickness . 6.0)
123 (meta . ((interfaces . (bar-line-interface item-interface break-aligned-interface font-interface))))
129 (print-function . ,Text_item::print)
131 (break-visibility . ,begin-of-line-visible)
134 (font-family . roman)
136 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
137 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
138 (self-alignment-X . 1)
140 ;; hmm. why did we do this: ?
141 (extra-offset . (1.3 . 0))
143 ((interfaces . (side-position-interface
145 self-alignment-interface
146 font-interface item-interface break-aligned-interface))))
152 (print-function . ,Text_item::print)
153 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
155 (font-family . number)
157 ;; We must do this, other BFs in
158 ;; paper16 become too small.
161 (meta . ((interfaces . (text-interface rhythmic-grob-interface
162 bass-figure-interface item-interface
163 self-alignment-interface font-interface))))
167 ;; todo: clean this up a bit: the list is getting
169 (print-function . ,Beam::print)
170 (concaveness-gap . 1.85)
171 (concaveness-threshold . 0.26)
173 (positions . (#f . #f))
174 (position-callbacks . (,Beam::least_squares
177 ,Beam::shift_region_to_valid
181 ;; TODO: should be in SLT.
182 (thickness . 0.48) ; in staff-space
183 (before-line-breaking-callback . ,Beam::before_line_breaking)
184 (after-line-breaking-callback . ,Beam::after_line_breaking)
185 (neutral-direction . -1)
186 (dir-function . ,beam-dir-majority-median)
188 ;; Whe have some unreferenced problems here.
190 ;; If we shorten beamed stems less than normal stems (1 staffspace),
191 ;; or high order less than 8th beams, patterns like
192 ;; c''4 [c''8 c''] c''4 [c''16 c]
193 ;; are ugly (different stem lengths).
195 ;; But if we shorten 16th beams as much as 8th beams, a single
196 ;; forced 16th beam looks *very* short.
198 ;; We choose to shorten 8th beams the same as single stems,
199 ;; and high order beams less than 8th beams, so that all
200 ;; isolated shortened beams look nice and a bit shortened,
201 ;; sadly possibly breaking patterns with high order beams.
202 (beamed-stem-shorten . (1.0 0.5 0.25))
205 (flag-width-function . ,beam-flag-width-function)
207 (auto-knee-gap . 5.5)
209 ;; only for debugging.
210 (font-family . roman)
212 (space-function . ,Beam::space_function)
213 (meta . ((interfaces . (staff-symbol-referencer-interface beam-interface spanner-interface))))
220 (break-align-orders . #(; end-of-line:
221 (instrument-name left-edge ambitus breathing-sign
222 clef staff-bar key-signature
223 time-signature custos)
226 (instrument-name left-edge ambitus breathing-sign
227 clef staff-bar key-signature
229 time-signature custos)
231 (instrument-name left-edge ambitus breathing-sign
232 clef key-signature staff-bar
233 time-signature custos)
237 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
238 (meta . ((interfaces . (break-alignment-interface item-interface axis-group-interface)))))
244 (X-offset-callbacks . (,Break_align_interface::alignment_callback))
245 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
246 (meta . ((interfaces . (break-aligned-interface item-interface axis-group-interface item-interface ))))
251 (break-align-symbol . breathing-sign)
254 (ambitus . (extra-space . 2.0))
255 (custos . (minimum-space . 1.0))
256 (key-signature . (minimum-space . 1.5))
257 (staff-bar . (minimum-space . 1.5))
258 (clef . (minimum-space . 2.0))
259 (first-note . (fixed-space . 1.0)) ;huh?
260 (right-edge . (extra-space . 0.1))
262 (print-function . ,Text_item::print)
263 (text . ,(make-musicglyph-markup "scripts-rcomma"))
264 (Y-offset-callbacks . (,Breathing_sign::offset_callback))
265 (break-visibility . ,begin-of-line-invisible)
266 (meta . ((interfaces . (break-aligned-interface breathing-sign-interface text-interface font-interface item-interface ))))
271 (print-function . ,Clef::print)
272 (before-line-breaking-callback . ,Clef::before_line_breaking)
274 (font-family . music)
275 (break-align-symbol . clef)
276 (break-visibility . ,begin-of-line-visible)
277 (space-alist . ((ambitus . (extra-space . 2.0))
278 (staff-bar . (extra-space . 0.7))
279 (key-signature . (minimum-space . 4.0))
280 (time-signature . (minimum-space . 4.2))
281 (first-note . (minimum-fixed-space . 5.0))
282 (next-note . (extra-space . 0.5))
283 (right-edge . (extra-space . 0.5))
285 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
286 (meta . ((interfaces . (clef-interface staff-symbol-referencer-interface font-interface break-aligned-interface item-interface ))))
289 (ClusterSpannerBeacon
291 (print-function . #f)
292 (Y-extent-callback . ,Cluster_beacon::height)
293 (meta . ((interfaces . (cluster-beacon-interface item-interface))))
298 (print-function . ,Cluster::print)
299 (spacing-procedure . ,Spanner::set_spacing_rods)
300 (minimum-length . 0.0)
303 (meta . ((interfaces . (cluster-interface spanner-interface))))
308 (print-function . ,Text_item::print)
309 (after-line-breaking-callback . ,Chord_name::after_line_breaking)
313 (meta . ((interfaces . (font-interface rhythmic-grob-interface
314 text-interface chord-name-interface item-interface ))))
319 (break-align-symbol . custos)
321 (print-function . ,Custos::print)
322 (break-visibility . ,end-of-line-visible)
324 (neutral-direction . -1)
325 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
327 (first-note . (minimum-fixed-space . 0.0))
328 (right-edge . (extra-space . 0.1))
331 . (custos-interface staff-symbol-referencer-interface
333 break-aligned-interface item-interface ))))
341 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
342 (X-offset-callbacks . (,Dot_column::side_position))
343 (meta . ((interfaces . (dot-column-interface axis-group-interface item-interface ))))
348 (print-function . ,Dots::print)
350 (meta . ((interfaces . (font-interface staff-symbol-referencer-interface dots-interface item-interface ))))
355 (print-function . ,Percent_repeat_item_interface::double_percent)
358 (font-encoding . fetaMusic)
361 (break-align-symbol . staff-bar)
362 (break-visibility . ,begin-of-line-invisible)
363 (meta . ((interfaces . (font-interface
364 break-aligned-interface
365 percent-repeat-interface item-interface ))))
369 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
370 (print-function . ,Text_item::print)
371 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
372 ,Self_alignment_interface::centered_on_parent))
373 (self-alignment-X . 0)
374 (no-spacing-rods . #t)
375 (script-priority . 100)
377 (font-encoding . fetaDynamic)
378 (font-shape . italic)
379 (self-alignment-Y . 0)
380 (meta . ((interfaces . (font-interface text-interface self-alignment-interface dynamic-interface script-interface item-interface))))
386 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
387 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
388 (staff-padding . 0.1)
390 (minimum-space . 1.2)
392 (meta . ((interfaces . (dynamic-interface axis-group-interface side-position-interface spanner-interface))))
397 (break-align-symbol . left-edge)
401 (custos . (extra-space . 0.0))
402 (ambitus . (extra-space . 2.0))
403 (time-signature . (extra-space . 0.0))
404 (staff-bar . (extra-space . 0.0))
405 (breathing-sign . (minimum-space . 0.0))
406 (clef . (extra-space . 0.85))
407 (first-note . (fixed-space . 1.0))
408 (right-edge . (extra-space . 0.0))
409 (key-signature . (extra-space . 0.0))
411 (meta . ((interfaces . (break-aligned-interface item-interface ))))
416 (print-function . ,Text_item::print)
418 (staff-padding . 0.6)
419 (self-alignment-X . 0)
420 (self-alignment-Y . 0)
421 (script-priority . 100)
422 (font-encoding . fetaNumber)
423 (font-size . -5) ; don't overlap when next to heads.
424 (meta . ((interfaces . (finger-interface font-interface text-script-interface text-interface side-position-interface self-alignment-interface item-interface ))))
431 (zigzag-width . 0.75)
433 (X-extent-callback . #f)
434 (Y-extent-callback . #f)
435 (after-line-breaking-callback . ,Line_spanner::after_line_breaking)
436 (print-function . ,Line_spanner::print)
437 (meta . ((interfaces . (line-spanner-interface spanner-interface))))
442 (print-function . ,Hairpin::print)
445 (spacing-procedure . ,Spanner::set_spacing_rods)
446 (minimum-length . 2.0)
447 (if-text-padding . 1.0)
448 (self-alignment-Y . 0)
449 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
450 (meta . ((interfaces . (hairpin-interface line-interface self-alignment-interface dynamic-interface spanner-interface))))
456 (print-function . ,Horizontal_bracket::print)
457 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
460 (meta . ((interfaces . (horizontal-bracket-interface side-position-interface spanner-interface))))
465 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self
466 ,Side_position_interface::aligned_on_support_refpoints))
467 ;; This direction is for aligned_on_support_refpoints
471 (left-edge . (extra-space . 1.0))
474 (self-alignment-Y . 0)
475 (print-function . ,Text_item::print)
476 (break-align-symbol . instrument-name)
477 (break-visibility . ,begin-of-line-visible)
479 (meta . ((interfaces . (font-interface self-alignment-interface side-position-interface text-interface break-aligned-interface item-interface ))))
485 (Y-offset-callbacks . (,Side_position_interface::aligned_on_support_refpoints))
487 (space-alist . ((left-edge . (extra-space . 1.0))
489 (break-align-symbol . instrument-name)
490 (print-function . ,Text_item::print)
491 (break-align-symbol . clef)
492 (break-visibility . ,begin-of-line-visible)
494 (meta . ((interfaces . (font-interface
495 self-alignment-interface
496 side-position-interface text-interface
497 break-aligned-interface item-interface ))))
502 (print-function . ,Key_signature_interface::print)
504 (time-signature . (extra-space . 1.25))
505 (staff-bar . (extra-space . 1.1))
506 (right-edge . (extra-space . 0.5))
507 (first-note . (fixed-space . 2.5))
509 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
510 (break-align-symbol . key-signature)
511 (break-visibility . ,begin-of-line-visible)
513 (meta . ((interfaces . (key-signature-interface font-interface break-aligned-interface item-interface ))))
517 (print-function . ,Ledger_line_spanner::print)
518 (X-extent-callback . #f)
519 (Y-extent-callback . #f)
520 (print-function . ,Ledger_line_spanner::print)
521 (meta . ((interfaces . (spanner-interface ledger-line-interface))))
526 (ligature-primitive-callback . ,Note_head::print)
531 (edge-height . (0.7 . 0.7))
532 (shorten-pair . (-0.2 . -0.2))
533 (before-line-breaking-callback . ,Tuplet_bracket::before_line_breaking)
534 (after-line-breaking-callback . ,Tuplet_bracket::after_line_breaking)
535 (print-function . ,Tuplet_bracket::print)
536 (meta . ((interfaces . (tuplet-bracket-interface spanner-interface))))
545 (spacing-procedure . ,Hyphen_spanner::set_spacing_rods)
546 (print-function . ,Hyphen_spanner::print)
548 (meta . ((interfaces . (lyric-interface lyric-hyphen-interface
549 spanner-interface))))
554 (print-function . ,Lyric_extender::print)
555 (thickness . 0.8) ; linethickness
556 (minimum-length . 1.5)
558 (meta . ((interfaces . (lyric-interface
559 lyric-extender-interface spanner-interface))))
563 . ((print-function . ,Text_item::print)
564 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_parent))
565 (self-alignment-X . 0)
567 (font-series . bold-narrow)
569 (meta . ((interfaces . (rhythmic-grob-interface lyric-syllable-interface self-alignment-interface text-interface font-interface item-interface ))))
576 (ligature-primitive-callback . ,Mensural_ligature::brew_ligature_primitive)
577 (print-function . ,Mensural_ligature::print)
578 (meta . ((interfaces . (mensural-ligature-interface font-interface))))
583 (print-function . ,Text_item::print)
584 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
585 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
586 (after-line-breaking-callback . ,shift-right-at-line-begin)
587 (self-alignment-X . 0)
592 (break-visibility . ,end-of-line-invisible)
594 (meta . ((interfaces . (text-interface side-position-interface font-interface mark-interface self-alignment-interface item-interface ))))
598 (print-function . ,Text_item::print)
599 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
602 (meta . ((interfaces . (text-interface side-position-interface font-interface metronome-mark-interface item-interface))))
606 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
607 (print-function . ,Measure_grouping::print)
613 (meta . ((interfaces . (spanner-interface side-position-interface measure-grouping-interface))))
617 (spacing-procedure . ,Multi_measure_rest::set_spacing_rods)
618 (print-function . ,Multi_measure_rest::print)
619 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
622 (thick-thickness . 6.6)
623 (hair-thickness . 2.0)
625 (meta . ((interfaces . (multi-measure-rest-interface multi-measure-interface rest-interface font-interface staff-symbol-referencer-interface))))
628 (MultiMeasureRestNumber
630 (print-function . ,Text_item::print)
631 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
632 ,Self_alignment_interface::centered_on_other_axis_parent))
633 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
634 (self-alignment-X . 0)
637 (staff-padding . 1.3)
638 (font-encoding . fetaNumber)
639 (meta . ((interfaces . (side-position-interface multi-measure-interface self-alignment-interface font-interface spanner-interface text-interface))))
641 (MultiMeasureRestText
643 (print-function . ,Text_item::print)
644 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
645 ,Self_alignment_interface::centered_on_other_axis_parent))
646 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
647 (self-alignment-X . 0)
650 (staff-padding . 1.5)
651 (meta . ((interfaces . (side-position-interface multi-measure-interface self-alignment-interface font-interface spanner-interface text-interface))))
656 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
657 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
658 (meta . ((interfaces . (note-collision-interface axis-group-interface item-interface ))))
664 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
665 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
666 (meta . ((interfaces . (axis-group-interface note-column-interface item-interface ))))
672 (print-function . ,Note_head::print)
673 (ligature-primitive-callback . ,Note_head::print)
674 (glyph-name-procedure . ,find-notehead-symbol)
675 (X-extent-callback . ,Note_head::extent)
676 (Y-extent-callback . ,Note_head::extent)
677 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
678 (stem-attachment-function . ,note-head-style->attachment-coordinates)
679 (meta . ((interfaces . (rhythmic-grob-interface rhythmic-head-interface font-interface note-head-interface staff-symbol-referencer-interface item-interface ))))
684 (stem-spacing-correction . 0.5)
686 ;; Changed this from 0.75.
687 ;; If you ever change this back, please document! --hwn
688 (knee-spacing-correction . 1.0)
690 (meta . ((interfaces . (spacing-interface note-spacing-interface item-interface ))))
698 (X-extent-callback . #f)
699 (Y-extent-callback . #f)
700 (print-function . ,Line_spanner::print)
701 (after-line-breaking-callback . ,Line_spanner::after_line_breaking)
702 (meta . ((interfaces . (line-spanner-interface line-interface spanner-interface))))
707 (print-function . ,Text_item::print)
708 (meta . ((interfaces . (note-name-interface
709 text-interface font-interface item-interface ))))
714 (self-alignment-X . 0)
715 (break-visibility . ,begin-of-line-visible)
716 (X-offset-callbacks . (,Self_alignment_interface::centered_on_parent ,Self_alignment_interface::aligned_on_self))
717 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
718 (print-function . ,Text_item::print)
720 ;; no Y dimensions, because of lyrics under tenor clef.
722 (font-shape . italic)
724 (staff-padding . 0.2)
726 (meta . ((interfaces . (text-interface self-alignment-interface side-position-interface font-interface item-interface ))))
732 (before-line-breaking-callback . ,Paper_column::before_line_breaking)
733 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
735 ; (print-function . ,Paper_column::print) (font-name . "ecrm8") (Y-extent-callback . #f)
736 (meta . ((interfaces . (paper-column-interface axis-group-interface spaceable-grob-interface item-interface ))))
741 (print-function . ,New_slur::print)
743 (spacing-procedure . ,Spanner::set_spacing_rods)
744 (minimum-length . 1.5)
745 (after-line-breaking-callback . ,New_slur::after_line_breaking)
746 (Y-extent-callback . ,New_slur::height)
749 (meta . ((interfaces . (slur-interface spanner-interface))))
752 (NonMusicalPaperColumn
755 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
756 (before-line-breaking-callback . ,Paper_column::before_line_breaking)
758 ;; debugging stuff: print column number.
759 ; (print-function . ,Paper_column::print) (font-name . "ecrm8") (Y-extent-callback . #f)
762 (meta . ((interfaces . (paper-column-interface axis-group-interface spaceable-grob-interface item-interface ))))
767 (spacing-procedure . ,Multi_measure_rest::set_spacing_rods)
768 (print-function . ,Multi_measure_rest::percent)
771 (font-encoding . fetaMusic)
772 (meta . ((interfaces . (multi-measure-rest-interface spanner-interface font-interface percent-repeat-interface))))
775 (PianoPedalBracket ;; an example of a text spanner
777 (print-function . ,Piano_pedal_bracket::print)
779 (if-text-padding . 1.0)
781 (bracket-flare . (0.5 . 0.5))
782 (edge-height . (1.0 . 1.0))
783 (shorten-pair . (0.0 . 0.0))
785 (meta . ((interfaces . (line-interface piano-pedal-interface piano-pedal-bracket-interface spanner-interface))))
789 (RemoveEmptyVerticalGroup
791 (Y-offset-callbacks . (,Hara_kiri_group_spanner::force_hara_kiri_callback))
792 (Y-extent-callback . ,Hara_kiri_group_spanner::y_extent)
795 (meta . ((interfaces . (axis-group-interface hara-kiri-group-interface item-interface spanner-interface))))
800 (print-function . ,Percent_repeat_item_interface::beat_slash)
803 (meta . ((interfaces . (percent-repeat-interface item-interface ))))
807 (after-line-breaking-callback . ,Rest::after_line_breaking)
808 (X-extent-callback . ,Rest::extent_callback)
809 (Y-extent-callback . ,Rest::extent_callback)
810 (print-function . ,Rest::print)
811 (Y-offset-callbacks . (,Staff_symbol_referencer::callback
812 ,Rest::polyphonic_offset_callback
814 (minimum-distance . 0.25)
816 (interfaces . (font-interface
817 rhythmic-head-interface
818 rhythmic-grob-interface
819 staff-symbol-referencer-interface
820 rest-interface item-interface ))
825 (minimum-distance . 0.75)
826 (meta . ((interfaces . (rest-collision-interface item-interface ))))
831 ;; don't set direction here: it breaks staccato.
832 (print-function . ,Script_interface::print)
834 ;; This value is sensitive: if too large, staccato dots will move a
837 (staff-padding . 0.25)
838 ;; (script-priority . 0) priorities for scripts, see script.scm
839 (X-offset-callbacks . (,Self_alignment_interface::centered_on_parent))
840 (before-line-breaking-callback . ,Script_interface::before_line_breaking)
841 (font-encoding . fetaMusic)
842 (meta . ((interfaces . (script-interface side-position-interface font-interface item-interface ))))
847 (before-line-breaking-callback . ,Script_column::before_line_breaking)
848 (meta . ((interfaces . (script-column-interface item-interface ))))
853 (print-function . ,New_slur::print)
855 (spacing-procedure . ,Spanner::set_spacing_rods)
856 (minimum-length . 1.5)
857 (after-line-breaking-callback . ,New_slur::after_line_breaking)
858 (Y-extent-callback . ,New_slur::height)
862 (meta . ((interfaces . (slur-interface spanner-interface))))
867 (spacing-procedure . ,Spacing_spanner::set_springs)
868 (grace-space-factor . 0.6)
869 (shortest-duration-space . 2.0)
870 (spacing-increment . 1.2)
871 (base-shortest-duration . ,(ly:make-moment 1 8))
872 (meta . ((interfaces . (spacing-interface spacing-spanner-interface spanner-interface))))
877 (break-align-symbol . staff-bar)
878 (bar-size-procedure . ,Span_bar::get_bar_size)
879 (print-function . ,Span_bar::print)
880 (X-extent-callback . ,Span_bar::width_callback)
881 (Y-extent-callback . ())
883 (before-line-breaking-callback . ,Span_bar::before_line_breaking)
887 ;; Ross. page 151 lists other values, we opt for a leaner look
891 (hair-thickness . 1.6)
892 (thick-thickness . 6.0)
893 (meta . ((interfaces . (span-bar-interface font-interface
894 bar-line-interface item-interface ))))
898 . ((print-function . ,Text_item::print)
901 (X-offset-callbacks . (,Side_position_interface::aligned_side))
903 (meta . ((interfaces . (side-position-interface stanza-number-interface text-interface font-interface item-interface ))))
909 (stem-spacing-correction . 0.4)
911 (meta . ((interfaces . (spacing-interface staff-spacing-interface item-interface ))))
916 (print-function . ,Text_item::print)
918 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
919 (no-spacing-rods . #t)
920 (padding . 0.0) ;; padding relative to SostenutoPedalLineSpanner
921 (font-shape . italic)
922 (self-alignment-X . 0)
923 (meta . ((interfaces . (text-interface self-alignment-interface font-interface item-interface))))
926 (SostenutoPedalLineSpanner
929 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
930 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
934 (minimum-space . 1.0)
936 (meta . ((interfaces . (piano-pedal-interface axis-group-interface side-position-interface spanner-interface))))
941 (print-function . ,Staff_symbol::print)
943 (ledger-line-thickness . (1.0 . 0.1))
945 (meta . ((interfaces . (staff-symbol-interface spanner-interface))))
950 ;; this list is rather long. Trim --hwn
951 (before-line-breaking-callback . ,Stem::before_line_breaking)
952 (print-function . ,Stem::print)
955 ;; 3.5 (or 3 measured from note head) is standard length
956 ;; 32nd, 64th flagged stems should be longer
957 (lengths . (3.5 3.5 3.5 4.5 5.0))
959 ;; Stems in unnatural (forced) direction should be shortened by
960 ;; one staff space, according to [Roush & Gourlay].
961 ;; Flagged stems we shorten only half a staff space.
962 (stem-shorten . (1.0 0.5))
964 ;; default stem direction for note on middle line
965 (neutral-direction . -1)
969 ;; FIXME. 3.5 yields too long beams (according to Ross and
970 ;; looking at Baerenreiter examples) for a number of common
971 ;; boundary cases. Subtracting half a beam thickness fixes
972 ;; this, but the bug may well be somewhere else.
974 ;; FIXME this should come from 'lengths
976 (beamed-lengths . (3.26 3.26 1.5))
978 ;; We use the normal minima as minimum for the ideal lengths,
979 ;; and the extreme minima as abolute minimum length.
981 ;; The 'normal' minima
982 (beamed-minimum-free-lengths . (1.83 1.5 1.25))
984 ;; The 'extreme case' minima
985 (beamed-extreme-minimum-free-lengths . (2.0 1.25))
987 (X-offset-callbacks . (,Stem::off_callback))
988 (X-extent-callback . ,Stem::dim_callback)
989 (Y-extent-callback . ,Stem::height)
990 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
991 (meta . ((interfaces . (stem-interface font-interface item-interface ))))
996 (print-function . ,Stem_tremolo::print)
997 (Y-extent-callback . ,Stem_tremolo::height)
998 (X-extent-callback . #f)
1000 (beam-width . 1.6) ; staff-space
1001 (beam-thickness . 0.48) ; staff-space
1002 (meta . ((interfaces . (stem-tremolo-interface item-interface ))))
1007 (X-extent-callback . #f)
1008 (Y-extent-callback . #f)
1009 (meta . ((interfaces . (spacing-interface separation-item-interface item-interface ))))
1012 (SeparatingGroupSpanner
1014 (spacing-procedure . ,Separating_group_spanner::set_spacing_rods)
1015 (meta . ((interfaces . (only-prebreak-interface spacing-interface separation-spanner-interface spanner-interface))))
1020 (no-spacing-rods . #t)
1021 (print-function . ,Sustain_pedal::print)
1022 (self-alignment-X . 0)
1024 (padding . 0.0) ;; padding relative to SustainPedalLineSpanner
1025 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1026 (meta . ((interfaces . (piano-pedal-interface text-spanner-interface text-interface self-alignment-interface font-interface item-interface))))
1029 (SustainPedalLineSpanner
1032 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1033 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1036 (staff-padding . 1.2)
1037 (minimum-space . 1.0)
1039 (meta . ((interfaces . (piano-pedal-interface axis-group-interface side-position-interface spanner-interface))))
1045 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
1046 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1047 (meta . ((interfaces . (system-interface axis-group-interface spanner-interface))))
1053 (print-function . ,System_start_delimiter::print)
1054 (collapse-height . 5.0)
1055 (font-encoding . fetaBraces)
1056 (Y-extent-callback . #f)
1057 (meta . ((interfaces . (system-start-delimiter-interface font-interface))))
1062 (Y-extent-callback . #f)
1063 (print-function . ,System_start_delimiter::print)
1069 (collapse-height . 1)
1071 (meta . ((interfaces . (system-start-delimiter-interface spanner-interface))))
1076 (Y-extent-callback . #f)
1077 (print-function . ,System_start_delimiter::print)
1078 (glyph . "bar-line")
1080 (after-line-breaking-callback . ,System_start_delimiter::after_line_breaking)
1081 (meta . ((interfaces . (system-start-delimiter-interface spanner-interface))))
1086 (print-function . ,Text_item::print)
1087 (no-spacing-rods . #t)
1088 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1091 (staff-padding . 0.5)
1092 (script-priority . 200)
1093 ;; todo: add X self alignment?
1094 (meta . ((interfaces . (text-script-interface text-interface side-position-interface font-interface item-interface ))))
1098 (print-function . ,Text_item::print)
1099 (no-spacing-rods . #t)
1100 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1101 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1103 (extra-offset . (-1 . 0))
1105 (staff-padding . 0.5)
1106 (script-priority . 200)
1107 ;; todo: add X self alignment?
1109 (font-series . bold)
1110 (meta . ((interfaces . (text-script-interface text-interface side-position-interface font-interface item-interface ))))
1114 (print-function . ,Text_spanner::print)
1115 (font-shape . italic)
1116 (style . dashed-line)
1117 (staff-padding . 0.1)
1119 ;; urg, only for (de)cresc. text spanners
1120 (if-text-padding . 1.0)
1121 (dash-fraction . 0.2)
1124 (meta . ((interfaces . (text-spanner-interface side-position-interface font-interface spanner-interface))))
1129 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1130 (print-function . ,Ottava_bracket::print)
1131 (font-shape . italic)
1132 (shorten-pair . (0.0 . -0.6))
1133 (staff-padding . 1.0)
1135 (minimum-length . 1.0)
1136 (dash-fraction . 0.3)
1137 (edge-height . (0 . 1.2))
1139 (meta . ((interfaces . (ottava-bracket-interface
1140 line-interface side-position-interface
1141 font-interface text-interface spanner-interface))))
1147 (print-function . ,Text_item::print)
1148 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
1149 (extra-offset . (0 . -0.65)) ;; UGH! TODO: Clean this up!
1150 (stem-attachment-function . ,tablature-stem-attachment-function)
1151 (meta . ((interfaces
1152 . (rhythmic-head-interface
1154 note-head-interface staff-symbol-referencer-interface
1155 text-interface item-interface ))))
1161 (print-function . ,Tie::print)
1162 (spacing-procedure . ,Spanner::set_spacing_rods)
1163 (staffline-clearance . 0.35)
1164 (details . ((ratio . 0.333) (height-limit . 1.0)))
1168 (minimum-length . 2.5)
1169 (meta . ((interfaces . (tie-interface spanner-interface))))
1174 (after-line-breaking-callback . ,Tie_column::after_line_breaking)
1175 (X-extent-callback . #f)
1176 (Y-extent-callback . #f)
1177 (meta . ((interfaces . (tie-column-interface spanner-interface))))
1182 (print-function . ,Time_signature::print)
1183 ; (print-function . ,Text_item::print)
1184 (break-align-symbol . time-signature)
1185 (break-visibility . ,all-visible)
1187 (first-note . (fixed-space . 2.0))
1188 (right-edge . (extra-space . 0.5))
1189 (staff-bar . (minimum-space . 2.0))
1193 ; (text . (,time-signature-glue-markup))
1194 (meta . ((interfaces . (time-signature-interface break-aligned-interface font-interface item-interface ))))
1201 (edge-height . (0.7 . 0.7))
1202 (shorten-pair . (-0.2 . -0.2))
1203 (before-line-breaking-callback . ,Tuplet_bracket::before_line_breaking)
1204 (after-line-breaking-callback . ,Tuplet_bracket::after_line_breaking)
1205 (print-function . ,Tuplet_bracket::print)
1206 (font-shape . italic)
1207 (font-series . bold)
1210 (meta . ((interfaces . (text-interface line-interface tuplet-bracket-interface font-interface spanner-interface))))
1215 (print-function . ,Text_item::print)
1216 (font-shape . italic)
1217 (no-spacing-rods . #t)
1218 (self-alignment-X . 0)
1220 (padding . 0.0) ;; padding relative to UnaCordaPedalLineSpanner
1221 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1222 (meta . ((interfaces . (text-interface self-alignment-interface font-interface item-interface ))))
1225 (UnaCordaPedalLineSpanner
1228 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1229 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1231 (staff-padding . 1.2)
1232 (minimum-space . 1.0)
1234 (meta . ((interfaces . (piano-pedal-interface axis-group-interface side-position-interface spanner-interface))))
1241 (ligature-primitive-callback . ,Vaticana_ligature::brew_ligature_primitive)
1242 (print-function . ,Vaticana_ligature::print)
1243 (meta . ((interfaces . (vaticana-ligature-interface font-interface))))
1248 (print-function . ,Volta_bracket_interface::print)
1251 (font-encoding . fetaNumber)
1252 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1253 (thickness . 1.6) ; linethickness
1254 (height . 2.0) ; staffspace;
1257 (meta . ((interfaces . (volta-bracket-interface line-interface text-interface side-position-interface font-interface spanner-interface))))
1263 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1264 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
1266 (meta . ((interfaces . (align-interface axis-group-interface spanner-interface))))
1272 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1273 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
1275 (meta . ((interfaces . (axis-group-interface spanner-interface))))
1283 (define (completize-grob-entry x)
1284 "transplant assoc key into 'name entry of 'meta of X
1286 (let* ((name-sym (car x))
1287 (grob-entry (cdr x))
1288 (metaentry (cdr (assoc 'meta grob-entry)))
1290 (cdr (assoc 'interfaces metaentry)))
1293 (set! metaentry (assoc-set! metaentry 'name name-sym))
1294 (set! metaentry (assoc-set! metaentry 'interfaces
1295 (cons 'grob-interface ifaces-entry)))
1296 (set! grob-entry (assoc-set! grob-entry 'meta metaentry))
1297 (cons name-sym grob-entry)))
1299 (set! all-grob-descriptions (map completize-grob-entry all-grob-descriptions))
1303 ; (display (map pair? all-grob-descriptions))
1306 ;; make sure that \property Foo.Bar =\turnOff doesn't complain
1309 ; (display (car x)) (newline)
1311 (set-object-property! (car x) 'translation-type? list?)
1312 (set-object-property! (car x) 'is-grob? #t))
1313 all-grob-descriptions)
1316 (set! all-grob-descriptions (sort all-grob-descriptions alist<?))