1 ;;;; define-grobs.scm --
3 ;;;; source file of the GNU LilyPond music typesetter
5 ;;;; (c) 1998--2005 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)
21 (cautionary-style . parentheses)
22 (after-line-breaking-callback . ,Accidental_interface::after_line_breaking)
23 (meta . ((interfaces . (item-interface accidental-interface
28 . ((X-extent-callback . ,Axis_group_interface::group_extent_callback)
31 ;; this is quite small, but it is very ugly to have
32 ;; accs closer to the previous note than to the next one.
33 (right-padding . 0.15)
34 (meta . ((interfaces . (item-interface accidental-placement-interface))))
39 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
40 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
42 (clef . (extra-space . 0.5))
43 (key-signature . (extra-space . 0.0))
44 (staff-bar . (extra-space . 0.0))
45 (time-signature . (extra-space . 0.0))
46 (first-note . (fixed-space . 0.0))
49 (break-align-symbol . ambitus)
50 (break-visibility . ,begin-of-line-visible)
51 (meta . ((interfaces . (axis-group-interface break-aligned-interface ambitus-interface item-interface))))
56 (print-function . ,Ambitus::print)
59 (X-offset-callbacks . (,Self_alignment_interface::centered_on_parent))
61 (meta . ((interfaces . (ambitus-interface staff-symbol-referencer-interface item-interface font-interface))))
65 (print-function . ,Accidental_interface::print)
68 (X-offset-callbacks . (,Side_position_interface::aligned_side))
70 (cautionary-style . parentheses)
71 (after-line-breaking-callback . ,Accidental_interface::after_line_breaking) (meta . ((interfaces . (item-interface accidental-interface break-aligned-interface side-position-interface font-interface))))
78 (print-function . ,Note_head::print)
79 (glyph-name-procedure . ,find-notehead-symbol)
80 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
81 (meta . ((interfaces . (font-interface note-head-interface
83 staff-symbol-referencer-interface
84 rhythmic-head-interface
91 (X-extent-callback . ,Arpeggio::width_callback)
92 (Y-extent-callback . #f)
93 (print-function . ,Arpeggio::print)
94 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
95 (X-offset-callbacks . (,Side_position_interface::aligned_side))
98 (staff-position . 0.0)
99 (meta . ((interfaces . (arpeggio-interface staff-symbol-referencer-interface side-position-interface item-interface font-interface))))
104 (break-align-symbol . staff-bar)
106 (break-glyph-function . ,default-break-barline)
107 (bar-size-procedure . ,Bar_line::get_staff_bar_size)
108 (print-function . ,Bar_line::print)
109 (break-visibility . ,all-visible)
111 (before-line-breaking-callback . ,Bar_line::before_line_breaking)
113 (time-signature . (extra-space . 0.75))
114 (custos . (minimum-space . 2.0))
115 (clef . (minimum-space . 1.0))
116 (key-signature . (extra-space . 1.0))
117 (key-cancellation . (extra-space . 1.0))
118 (first-note . (fixed-space . 1.3))
119 (next-note . (semi-fixed-space . 1.3))
120 (right-edge . (extra-space . 0.0))
124 ;; Ross. page 151 lists other values, we opt for a leaner look
127 ;; kern should scale with linethickness too.
130 (hair-thickness . 1.9)
131 (thick-thickness . 6.0)
132 (meta . ((interfaces . (bar-line-interface item-interface break-aligned-interface font-interface))))
138 (print-function . ,Text_interface::print)
140 (break-visibility . ,begin-of-line-visible)
143 (font-family . roman)
145 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
146 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
147 (self-alignment-X . 1)
150 ((interfaces . (side-position-interface
152 self-alignment-interface
153 font-interface item-interface break-aligned-interface))))
159 (print-function . ,Text_interface::print)
160 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
162 (font-family . number)
164 ;; We must do this, other BFs in
165 ;; layout16 become too small.
168 (meta . ((interfaces . (text-interface rhythmic-grob-interface
169 bass-figure-interface item-interface
170 self-alignment-interface font-interface))))
174 ;; todo: clean this up a bit: the list is getting
176 (print-function . ,Beam::print)
178 (positions . (#f . #f))
179 (position-callbacks . (,Beam::least_squares
182 ,Beam::shift_region_to_valid
186 ;; TODO: should be in SLT.
187 (thickness . 0.48) ; in staff-space
188 (before-line-breaking-callback . ,Beam::before_line_breaking)
189 (after-line-breaking-callback . ,Beam::after_line_breaking)
190 (neutral-direction . -1)
191 (dir-function . ,beam-dir-majority-median)
193 ;; Whe have some unreferenced problems here.
195 ;; If we shorten beamed stems less than normal stems (1 staffspace),
196 ;; or high order less than 8th beams, patterns like
197 ;; c''4 [c''8 c''] c''4 [c''16 c]
198 ;; are ugly (different stem lengths).
200 ;; But if we shorten 16th beams as much as 8th beams, a single
201 ;; forced 16th beam looks *very* short.
203 ;; We choose to shorten 8th beams the same as single stems,
204 ;; and high order beams less than 8th beams, so that all
205 ;; isolated shortened beams look nice and a bit shortened,
206 ;; sadly possibly breaking patterns with high order beams.
207 (beamed-stem-shorten . (1.0 0.5 0.25))
209 (flag-width-function . ,beam-flag-width-function)
211 (auto-knee-gap . 5.5)
213 ;; only for debugging.
214 (font-family . roman)
216 (space-function . ,Beam::space_function)
217 (meta . ((interfaces . (staff-symbol-referencer-interface beam-interface spanner-interface))))
224 (break-align-orders . #(; end-of-line:
226 left-edge ambitus breathing-sign
227 clef staff-bar key-cancellation key-signature
228 time-signature custos)
231 (instrument-name left-edge ambitus breathing-sign
232 clef staff-bar key-cancellation key-signature
234 time-signature custos)
236 (instrument-name left-edge ambitus breathing-sign
237 clef key-cancellation key-signature staff-bar
238 time-signature custos)
242 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
243 (meta . ((interfaces . (break-alignment-interface item-interface axis-group-interface)))))
249 (X-offset-callbacks . (,Break_align_interface::alignment_callback))
250 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
251 (meta . ((interfaces . (break-aligned-interface item-interface axis-group-interface item-interface ))))
256 (break-align-symbol . breathing-sign)
259 (ambitus . (extra-space . 2.0))
260 (custos . (minimum-space . 1.0))
261 (key-signature . (minimum-space . 1.5))
262 (staff-bar . (minimum-space . 1.5))
263 (clef . (minimum-space . 2.0))
264 (first-note . (fixed-space . 1.0)) ;huh?
265 (right-edge . (extra-space . 0.1))
267 (print-function . ,Text_interface::print)
268 (text . ,(make-musicglyph-markup "scripts.rcomma"))
269 (Y-offset-callbacks . (,Breathing_sign::offset_callback))
270 (break-visibility . ,begin-of-line-invisible)
271 (meta . ((interfaces . (break-aligned-interface breathing-sign-interface text-interface font-interface item-interface ))))
276 (print-function . ,Clef::print)
277 (before-line-breaking-callback . ,Clef::before_line_breaking)
279 (font-family . music)
280 (break-align-symbol . clef)
281 (break-visibility . ,begin-of-line-visible)
282 (space-alist . ((ambitus . (extra-space . 2.0))
283 (staff-bar . (extra-space . 0.7))
284 (key-cancellation . (minimum-space . 4.0))
285 (key-signature . (minimum-space . 4.0))
286 (time-signature . (minimum-space . 4.2))
287 (first-note . (minimum-fixed-space . 5.0))
288 (next-note . (extra-space . 0.5))
289 (right-edge . (extra-space . 0.5))
291 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
292 (meta . ((interfaces . (clef-interface staff-symbol-referencer-interface font-interface break-aligned-interface item-interface ))))
295 (ClusterSpannerBeacon
297 (print-function . #f)
298 (Y-extent-callback . ,Cluster_beacon::height)
299 (meta . ((interfaces . (cluster-beacon-interface item-interface))))
304 (print-function . ,Cluster::print)
305 (spacing-procedure . ,Spanner::set_spacing_rods)
306 (minimum-length . 0.0)
309 (meta . ((interfaces . (cluster-interface spanner-interface))))
314 (print-function . ,Text_interface::print)
315 (after-line-breaking-callback . ,Chord_name::after_line_breaking)
319 (meta . ((interfaces . (font-interface rhythmic-grob-interface
320 text-interface chord-name-interface item-interface ))))
325 (break-align-symbol . custos)
327 (print-function . ,Custos::print)
328 (break-visibility . ,end-of-line-visible)
330 (neutral-direction . -1)
331 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
333 (first-note . (minimum-fixed-space . 0.0))
334 (right-edge . (extra-space . 0.1))
337 . (custos-interface staff-symbol-referencer-interface
339 break-aligned-interface item-interface ))))
346 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
347 (X-offset-callbacks . (,Dot_column::side_position))
348 (meta . ((interfaces . (dot-column-interface axis-group-interface item-interface ))))
353 (print-function . ,Dots::print)
355 (meta . ((interfaces . (font-interface staff-symbol-referencer-interface dots-interface item-interface ))))
360 (print-function . ,Percent_repeat_item_interface::double_percent)
363 (font-encoding . fetaMusic)
366 (break-align-symbol . staff-bar)
367 (break-visibility . ,begin-of-line-invisible)
368 (meta . ((interfaces . (font-interface
369 break-aligned-interface
370 percent-repeat-interface item-interface ))))
374 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
375 (print-function . ,Text_interface::print)
376 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
377 ,Self_alignment_interface::centered_on_parent))
378 (self-alignment-X . 0)
379 (no-spacing-rods . #t)
380 (script-priority . 100)
382 (font-encoding . fetaDynamic)
383 (font-shape . italic)
384 (self-alignment-Y . 0)
385 (meta . ((interfaces . (font-interface text-interface self-alignment-interface
386 dynamic-interface script-interface item-interface))))
389 . ((print-function . ,Dynamic_text_spanner::print)
391 ;; rather ugh with NCSB
392 ; (font-series . bold)
393 (font-shape . italic)
394 (style . dashed-line)
396 ; need to blend with dynamic texts.
398 (bound-padding . 0.75)
399 (dash-fraction . 0.2)
401 (meta . ((interfaces . (font-interface
403 dynamic-interface dynamic-text-spanner-interface
410 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
411 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
412 (staff-padding . 0.1)
414 (minimum-space . 1.2)
417 (meta . ((interfaces . (dynamic-interface axis-group-interface
418 side-position-interface spanner-interface))))))
422 (break-align-symbol . left-edge)
425 (break-visibility . ,center-invisible)
427 (custos . (extra-space . 0.0))
428 (ambitus . (extra-space . 2.0))
429 (time-signature . (extra-space . 0.0))
430 (staff-bar . (extra-space . 0.0))
431 (breathing-sign . (minimum-space . 0.0))
432 (clef . (extra-space . 0.8))
433 (first-note . (fixed-space . 1.0))
434 (right-edge . (extra-space . 0.0))
435 (key-signature . (extra-space . 0.0))
436 (key-cancellation . (extra-space . 0.0))
439 (meta . ((interfaces . (break-aligned-interface item-interface ))))
444 (print-function . ,Text_interface::print)
446 ; sync with TextScript (?)
448 (staff-padding . 0.5)
449 (self-alignment-X . 0)
450 (self-alignment-Y . 0)
451 (script-priority . 100)
452 (font-encoding . fetaNumber)
453 (font-size . -5) ; don't overlap when next to heads.
454 (meta . ((interfaces . (finger-interface
455 font-interface text-script-interface text-interface
456 side-position-interface self-alignment-interface
461 (print-function . ,print-circled-text-callback)
463 (staff-padding . 0.5)
464 (self-alignment-X . 0)
465 (self-alignment-Y . 0)
466 (script-priority . 100)
467 (font-encoding . fetaNumber)
468 (font-size . -5) ; don't overlap when next to heads.
469 (meta . ((interfaces . (string-number-interface
470 font-interface text-script-interface text-interface
471 side-position-interface self-alignment-interface
479 (zigzag-width . 0.75)
481 (X-extent-callback . #f)
482 (Y-extent-callback . #f)
483 (after-line-breaking-callback . ,Line_spanner::after_line_breaking)
484 (print-function . ,Line_spanner::print)
485 (meta . ((interfaces . (line-interface line-spanner-interface spanner-interface))))
490 (print-function . ,Hairpin::print)
491 (after-line-breaking-callback . ,Hairpin::after_line_breaking)
494 (spacing-procedure . ,Spanner::set_spacing_rods)
495 (minimum-length . 2.0)
496 (bound-padding . 1.0)
497 (self-alignment-Y . 0)
498 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
499 (meta . ((interfaces . (hairpin-interface line-interface self-alignment-interface dynamic-interface spanner-interface))))
505 (print-function . ,Horizontal_bracket::print)
506 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
509 (bracket-flare . (0.5 . 0.5))
510 (meta . ((interfaces . (horizontal-bracket-interface
511 side-position-interface
513 spanner-interface))))
518 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self
519 ,Side_position_interface::aligned_on_support_refpoints))
520 ;; This direction is for aligned_on_support_refpoints
524 (left-edge . (extra-space . 1.0))
527 (self-alignment-Y . 0)
528 (print-function . ,Text_interface::print)
529 (break-align-symbol . instrument-name)
530 (break-visibility . ,begin-of-line-visible)
532 (meta . ((interfaces . (font-interface self-alignment-interface side-position-interface text-interface break-aligned-interface item-interface ))))
538 (Y-offset-callbacks . (,Side_position_interface::aligned_on_support_refpoints))
540 (space-alist . ((left-edge . (extra-space . 1.0))
542 (break-align-symbol . instrument-name)
543 (print-function . ,Text_interface::print)
544 (break-align-symbol . clef)
545 (break-visibility . ,begin-of-line-visible)
547 (meta . ((interfaces . (font-interface
548 self-alignment-interface
549 side-position-interface text-interface
550 break-aligned-interface item-interface ))))
554 (print-function . ,Key_signature_interface::print)
556 (time-signature . (extra-space . 1.25))
557 (staff-bar . (extra-space . 0.6))
558 (key-signature . (extra-space . 0.5))
559 (right-edge . (extra-space . 0.5))
560 (first-note . (fixed-space . 2.5))
562 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
563 (break-align-symbol . key-cancellation)
564 (break-visibility . ,begin-of-line-invisible)
567 (meta . ((interfaces . (key-signature-interface font-interface
568 break-aligned-interface item-interface ))))
572 (print-function . ,Key_signature_interface::print)
574 (time-signature . (extra-space . 1.25))
575 (staff-bar . (extra-space . 1.1))
576 (right-edge . (extra-space . 0.5))
577 (first-note . (fixed-space . 2.5))
579 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
580 (break-align-symbol . key-signature)
581 (break-visibility . ,begin-of-line-visible)
584 (meta . ((interfaces . (key-signature-interface font-interface
585 break-aligned-interface item-interface ))))
589 (print-function . ,Ledger_line_spanner::print)
590 (X-extent-callback . #f)
591 (Y-extent-callback . #f)
592 (minimum-length-fraction . 0.25)
593 (length-fraction . 0.25)
594 (spacing-procedure . ,Ledger_line_spanner::set_spacing_rods)
595 (print-function . ,Ledger_line_spanner::print)
597 (meta . ((interfaces . (spanner-interface ledger-line-interface))))
602 (ligature-primitive-callback . ,Note_head::print)
607 (edge-height . (0.7 . 0.7))
608 (shorten-pair . (-0.2 . -0.2))
609 (before-line-breaking-callback . ,Tuplet_bracket::before_line_breaking)
610 (after-line-breaking-callback . ,Tuplet_bracket::after_line_breaking)
611 (print-function . ,Tuplet_bracket::print)
612 (meta . ((interfaces . (tuplet-bracket-interface line-interface spanner-interface))))
621 (minimum-length . 0.3)
623 ; (spacing-procedure . ,Hyphen_spanner::set_spacing_rods)
624 (print-function . ,Hyphen_spanner::print)
626 (meta . ((interfaces . (lyric-interface lyric-hyphen-interface
627 spanner-interface))))
632 (print-function . ,Lyric_extender::print)
633 (thickness . 0.8) ; linethickness
634 (minimum-length . 1.5)
636 (meta . ((interfaces . (lyric-interface
637 lyric-extender-interface spanner-interface))))
641 . ((print-function . ,Text_interface::print)
642 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_parent))
643 (self-alignment-X . 0)
645 (font-series . bold-narrow)
647 (meta . ((interfaces . (rhythmic-grob-interface
648 lyric-syllable-interface
649 self-alignment-interface text-interface
650 font-interface item-interface ))))
657 (ligature-primitive-callback . ,Mensural_ligature::brew_ligature_primitive)
658 (print-function . ,Mensural_ligature::print)
659 (meta . ((interfaces . (mensural-ligature-interface font-interface))))
664 (print-function . ,Text_interface::print)
665 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
666 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
667 (after-line-breaking-callback . ,shift-right-at-line-begin)
668 (self-alignment-X . 0)
673 (break-visibility . ,end-of-line-invisible)
675 (meta . ((interfaces . (text-interface
676 side-position-interface font-interface mark-interface
677 self-alignment-interface item-interface ))))
681 (print-function . ,Text_interface::print)
682 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
685 (meta . ((interfaces . (text-interface
686 side-position-interface font-interface
687 metronome-mark-interface item-interface))))
691 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
692 (print-function . ,Measure_grouping::print)
698 (meta . ((interfaces . (spanner-interface side-position-interface
699 measure-grouping-interface))))
703 (spacing-procedure . ,Multi_measure_rest::set_spacing_rods)
704 (print-function . ,Multi_measure_rest::print)
705 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
708 (thick-thickness . 6.6)
709 (hair-thickness . 2.0)
711 (meta . ((interfaces . (multi-measure-rest-interface
712 multi-measure-interface rest-interface
713 font-interface staff-symbol-referencer-interface))))
716 (MultiMeasureRestNumber
718 (print-function . ,Text_interface::print)
719 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
720 ,Self_alignment_interface::centered_on_other_axis_parent))
721 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
722 (self-alignment-X . 0)
725 (staff-padding . 0.4)
726 (font-encoding . fetaNumber)
727 (meta . ((interfaces . (side-position-interface
728 multi-measure-interface self-alignment-interface
729 font-interface spanner-interface text-interface))))
731 (MultiMeasureRestText
733 (print-function . ,Text_interface::print)
734 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
735 ,Self_alignment_interface::centered_on_other_axis_parent))
736 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
737 (self-alignment-X . 0)
740 (staff-padding . 0.25)
741 (meta . ((interfaces . (side-position-interface
742 multi-measure-interface self-alignment-interface font-interface
743 spanner-interface text-interface))))
749 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
750 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
751 (meta . ((interfaces . (note-collision-interface axis-group-interface item-interface ))))
757 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
758 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
759 (meta . ((interfaces . (axis-group-interface note-column-interface item-interface ))))
765 (print-function . ,Note_head::print)
766 (ligature-primitive-callback . ,Note_head::print)
767 (glyph-name-procedure . ,find-notehead-symbol)
768 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
769 (stem-attachment-function . ,note-head-style->attachment-coordinates)
770 (meta . ((interfaces . (rhythmic-grob-interface
771 rhythmic-head-interface font-interface note-head-interface
773 staff-symbol-referencer-interface item-interface ))))
778 (stem-spacing-correction . 0.5)
779 (same-direction-correction . 0.25)
780 ;; Changed this from 0.75.
781 ;; If you ever change this back, please document! --hwn
782 (knee-spacing-correction . 1.0)
784 (meta . ((interfaces . (spacing-interface note-spacing-interface item-interface ))))
792 (X-extent-callback . #f)
793 (Y-extent-callback . #f)
794 (print-function . ,Line_spanner::print)
795 (after-line-breaking-callback . ,Line_spanner::after_line_breaking)
796 (meta . ((interfaces . (line-spanner-interface line-interface spanner-interface))))
801 (print-function . ,Text_interface::print)
802 (meta . ((interfaces . (note-name-interface
803 text-interface font-interface item-interface ))))
808 (self-alignment-X . 0)
809 (break-visibility . ,begin-of-line-visible)
810 (X-offset-callbacks . (,Self_alignment_interface::centered_on_parent ,Self_alignment_interface::aligned_on_self))
811 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
812 (print-function . ,Text_interface::print)
814 ;; no Y dimensions, because of lyrics under tenor clef.
816 (font-shape . italic)
818 (staff-padding . 0.2)
820 (meta . ((interfaces . (text-interface self-alignment-interface side-position-interface font-interface item-interface ))))
826 (before-line-breaking-callback . ,Paper_column::before_line_breaking)
827 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
829 ; (print-function . ,Paper_column::print) (font-name . "ecrm8") (Y-extent-callback . #f)
830 (meta . ((interfaces . (paper-column-interface axis-group-interface spaceable-grob-interface item-interface ))))
834 . ((slur-details . ,default-slur-details)
835 (print-function . ,Slur::print)
837 (spacing-procedure . ,Spanner::set_spacing_rods)
838 (minimum-length . 1.5)
839 (after-line-breaking-callback . ,Slur::after_line_breaking)
840 (Y-extent-callback . ,Slur::height)
843 (meta . ((interfaces . (slur-interface spanner-interface))))
846 (NonMusicalPaperColumn
849 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
850 (before-line-breaking-callback . ,Paper_column::before_line_breaking)
852 ;; debugging stuff: print column number.
853 ; (print-function . ,Paper_column::print) (font-name . "ecrm8") (Y-extent-callback . #f)
856 (meta . ((interfaces . (paper-column-interface axis-group-interface spaceable-grob-interface item-interface ))))
861 (spacing-procedure . ,Multi_measure_rest::set_spacing_rods)
862 (print-function . ,Multi_measure_rest::percent)
865 (font-encoding . fetaMusic)
866 (meta . ((interfaces . (multi-measure-rest-interface spanner-interface font-interface percent-repeat-interface))))
869 ;; an example of a text spanner
872 (print-function . ,Piano_pedal_bracket::print)
874 (bound-padding . 1.0)
876 (bracket-flare . (0.5 . 0.5))
877 (edge-height . (1.0 . 1.0))
878 (shorten-pair . (0.0 . 0.0))
880 (meta . ((interfaces . (line-interface piano-pedal-interface piano-pedal-bracket-interface spanner-interface))))
884 (RemoveEmptyVerticalGroup
886 (Y-offset-callbacks . (,Hara_kiri_group_spanner::force_hara_kiri_callback))
887 (Y-extent-callback . ,Hara_kiri_group_spanner::y_extent)
890 (meta . ((interfaces . (axis-group-interface vertically-spaceable-interface hara-kiri-group-interface item-interface spanner-interface))))
895 (print-function . ,Percent_repeat_item_interface::beat_slash)
898 (meta . ((interfaces . (percent-repeat-interface item-interface ))))
902 (after-line-breaking-callback . ,Rest::after_line_breaking)
903 (X-extent-callback . ,Rest::extent_callback)
904 (Y-extent-callback . ,Rest::extent_callback)
905 (print-function . ,Rest::print)
906 (Y-offset-callbacks . (,Staff_symbol_referencer::callback
907 ,Rest::polyphonic_offset_callback
909 (minimum-distance . 0.25)
911 (interfaces . (font-interface
912 rhythmic-head-interface
913 rhythmic-grob-interface
914 staff-symbol-referencer-interface
915 rest-interface item-interface ))
920 (minimum-distance . 0.75)
921 (meta . ((interfaces . (rest-collision-interface item-interface ))))
926 ;; don't set direction here: it breaks staccato.
927 (print-function . ,Script_interface::print)
929 ;; This value is sensitive: if too large, staccato dots will move a
932 (staff-padding . 0.25)
933 ;; (script-priority . 0) priorities for scripts, see script.scm
934 (X-offset-callbacks . (,Self_alignment_interface::centered_on_parent))
935 (before-line-breaking-callback . ,Script_interface::before_line_breaking)
936 (font-encoding . fetaMusic)
937 (meta . ((interfaces . (script-interface side-position-interface font-interface item-interface ))))
942 (before-line-breaking-callback . ,Script_column::before_line_breaking)
943 (meta . ((interfaces . (script-column-interface item-interface ))))
947 . ((slur-details . ,default-slur-details)
948 (print-function . ,Slur::print)
950 (spacing-procedure . ,Spanner::set_spacing_rods)
951 (minimum-length . 1.5)
952 (after-line-breaking-callback . ,Slur::after_line_breaking)
953 (Y-extent-callback . ,Slur::height)
957 (meta . ((interfaces . (slur-interface spanner-interface))))
962 (spacing-procedure . ,Spacing_spanner::set_springs)
963 (grace-space-factor . 0.6)
964 (shortest-duration-space . 2.0)
965 (spacing-increment . 1.2)
966 (base-shortest-duration . ,(ly:make-moment 3 16))
967 (meta . ((interfaces . (spacing-interface spacing-spanner-interface spanner-interface))))
972 (break-align-symbol . staff-bar)
973 (bar-size-procedure . ,Span_bar::get_bar_size)
974 (print-function . ,Span_bar::print)
975 (X-extent-callback . ,Span_bar::width_callback)
976 (Y-extent-callback . ())
978 (before-line-breaking-callback . ,Span_bar::before_line_breaking)
982 ;; Ross. page 151 lists other values, we opt for a leaner look
986 (hair-thickness . 1.6)
987 (thick-thickness . 6.0)
988 (meta . ((interfaces . (span-bar-interface font-interface
989 bar-line-interface item-interface ))))
993 . ((print-function . ,Text_interface::print)
996 (X-offset-callbacks . (,Side_position_interface::aligned_side))
998 (meta . ((interfaces . (side-position-interface stanza-number-interface text-interface font-interface item-interface ))))
1004 (stem-spacing-correction . 0.4)
1006 (meta . ((interfaces . (spacing-interface staff-spacing-interface item-interface ))))
1011 (print-function . ,Text_interface::print)
1013 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1014 (no-spacing-rods . #t)
1015 (padding . 0.0) ;; padding relative to SostenutoPedalLineSpanner
1016 (font-shape . italic)
1017 (self-alignment-X . 0)
1018 (meta . ((interfaces . (text-interface self-alignment-interface font-interface item-interface))))
1021 (SostenutoPedalLineSpanner
1024 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1025 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1029 (minimum-space . 1.0)
1031 (meta . ((interfaces . (piano-pedal-interface axis-group-interface side-position-interface spanner-interface))))
1036 (print-function . ,Staff_symbol::print)
1038 (ledger-line-thickness . (1.0 . 0.1))
1040 (meta . ((interfaces . (staff-symbol-interface spanner-interface))))
1045 ;; this list is rather long. Trim --hwn
1046 (before-line-breaking-callback . ,Stem::before_line_breaking)
1047 (print-function . ,Stem::print)
1050 ;; 3.5 (or 3 measured from note head) is standard length
1051 ;; 32nd, 64th flagged stems should be longer
1052 (lengths . (3.5 3.5 3.5 4.5 5.0))
1054 ;; Stems in unnatural (forced) direction should be shortened by
1055 ;; one staff space, according to [Roush & Gourlay].
1056 ;; Flagged stems we shorten only half a staff space.
1057 (stem-shorten . (1.0 0.5))
1059 ;; default stem direction for note on middle line
1060 (neutral-direction . -1)
1064 ;; FIXME. 3.5 yields too long beams (according to Ross and
1065 ;; looking at Baerenreiter examples) for a number of common
1066 ;; boundary cases. Subtracting half a beam thickness fixes
1067 ;; this, but the bug may well be somewhere else.
1069 ;; FIXME this should come from 'lengths
1071 (beamed-lengths . (3.26 3.5 3.6))
1073 ;; We use the normal minima as minimum for the ideal lengths,
1074 ;; and the extreme minima as abolute minimum length.
1076 ;; The 'normal' minima
1077 (beamed-minimum-free-lengths . (1.83 1.5 1.25))
1078 ;(beamed-minimum-free-lengths . (2.0 1.83 1.25))
1080 ;; The 'extreme case' minima
1081 (beamed-extreme-minimum-free-lengths . (2.0 1.25))
1083 (X-offset-callbacks . (,Stem::offset_callback))
1084 (X-extent-callback . ,Stem::width_callback)
1085 (Y-extent-callback . ,Stem::height)
1086 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
1087 (meta . ((interfaces . (stem-interface font-interface item-interface ))))
1092 (print-function . ,Stem_tremolo::print)
1093 (Y-extent-callback . ,Stem_tremolo::height)
1094 (X-extent-callback . #f)
1096 (beam-width . 1.6) ; staff-space
1097 (beam-thickness . 0.48) ; staff-space
1098 (meta . ((interfaces . (stem-tremolo-interface item-interface ))))
1103 (X-extent-callback . #f)
1104 (Y-extent-callback . #f)
1105 (meta . ((interfaces . (spacing-interface separation-item-interface item-interface ))))
1108 (SeparatingGroupSpanner
1110 (spacing-procedure . ,Separating_group_spanner::set_spacing_rods)
1111 (meta . ((interfaces . (only-prebreak-interface spacing-interface separation-spanner-interface spanner-interface))))
1116 (no-spacing-rods . #t)
1117 (print-function . ,Sustain_pedal::print)
1118 (self-alignment-X . 0)
1120 (padding . 0.0) ;; padding relative to SustainPedalLineSpanner
1121 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1122 (meta . ((interfaces . (piano-pedal-interface text-spanner-interface text-interface self-alignment-interface font-interface item-interface))))
1125 (SustainPedalLineSpanner
1128 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1129 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1132 (staff-padding . 1.2)
1133 (minimum-space . 1.0)
1135 (meta . ((interfaces . (piano-pedal-interface axis-group-interface side-position-interface spanner-interface))))
1141 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
1142 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1143 (meta . ((interfaces . (system-interface axis-group-interface spanner-interface))))
1149 (print-function . ,System_start_delimiter::print)
1150 (collapse-height . 5.0)
1151 (font-encoding . fetaBraces)
1152 (Y-extent-callback . #f)
1153 (meta . ((interfaces . (system-start-delimiter-interface font-interface))))
1158 (Y-extent-callback . #f)
1159 (print-function . ,System_start_delimiter::print)
1165 (collapse-height . 1)
1167 (meta . ((interfaces . (system-start-delimiter-interface spanner-interface))))
1172 (Y-extent-callback . #f)
1173 (print-function . ,System_start_delimiter::print)
1174 (glyph . "bar-line")
1176 (after-line-breaking-callback . ,System_start_delimiter::after_line_breaking)
1177 (meta . ((interfaces . (system-start-delimiter-interface spanner-interface))))
1182 (print-function . ,Text_interface::print)
1183 (no-spacing-rods . #t)
1184 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1187 ; sync with Fingering ?
1189 (staff-padding . 0.5)
1190 (script-priority . 200)
1191 ;; todo: add X self alignment?
1192 (meta . ((interfaces . (text-script-interface text-interface side-position-interface font-interface item-interface ))))
1196 (print-function . ,Text_interface::print)
1197 (no-spacing-rods . #t)
1198 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1199 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1202 (staff-padding . 0.5)
1203 (script-priority . 200)
1204 ;; todo: add X self alignment?
1206 (font-series . bold)
1207 (meta . ((interfaces . (text-script-interface text-interface side-position-interface font-interface item-interface ))))
1211 (print-function . ,Text_spanner::print)
1212 (font-shape . italic)
1213 (style . dashed-line)
1214 (staff-padding . 0.1)
1215 (dash-fraction . 0.2)
1218 (meta . ((interfaces . (text-spanner-interface side-position-interface font-interface spanner-interface))))
1222 (print-function . ,Dynamic_text_spanner::print)
1223 (edge-text . ,(cons (make-musicglyph-markup "scripts.trill")
1226 (staff-padding . 1.0)
1229 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1230 (meta . ((interfaces . (text-spanner-interface side-position-interface font-interface spanner-interface))))
1235 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1236 (print-function . ,Ottava_bracket::print)
1237 (font-shape . italic)
1238 (shorten-pair . (0.0 . -0.6))
1239 (staff-padding . 1.0)
1241 (minimum-length . 1.0)
1242 (dash-fraction . 0.3)
1243 (edge-height . (0 . 1.2))
1245 (meta . ((interfaces . (ottava-bracket-interface
1246 line-interface side-position-interface
1247 font-interface text-interface spanner-interface))))
1253 (print-function . ,Text_interface::print)
1254 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
1255 (stem-attachment-function . ,tablature-stem-attachment-function)
1256 (font-series . bold)
1257 (meta . ((interfaces
1258 . (rhythmic-head-interface
1260 note-head-interface staff-symbol-referencer-interface
1261 text-interface item-interface ))))
1267 (print-function . ,Tie::print)
1268 (spacing-procedure . ,Spanner::set_spacing_rods)
1269 (staffline-clearance . 0.35)
1270 (details . ((ratio . 0.333) (height-limit . 1.0)))
1274 (minimum-length . 2.5)
1275 (meta . ((interfaces . (tie-interface spanner-interface))))
1280 (after-line-breaking-callback . ,Tie_column::after_line_breaking)
1281 (before-line-breaking-callback . ,Tie_column::before_line_breaking)
1282 (X-extent-callback . #f)
1283 (Y-extent-callback . #f)
1284 (meta . ((interfaces . (tie-column-interface spanner-interface))))
1289 (print-function . ,Time_signature::print)
1290 ; (print-function . ,Text_interface::print)
1291 (break-align-symbol . time-signature)
1292 (break-visibility . ,all-visible)
1294 (first-note . (fixed-space . 2.0))
1295 (right-edge . (extra-space . 0.5))
1296 (staff-bar . (minimum-space . 2.0))
1300 ; (text . (,time-signature-glue-markup))
1301 (meta . ((interfaces . (time-signature-interface break-aligned-interface font-interface item-interface ))))
1308 (edge-height . (0.7 . 0.7))
1309 (shorten-pair . (-0.2 . -0.2))
1310 (before-line-breaking-callback . ,Tuplet_bracket::before_line_breaking)
1311 (after-line-breaking-callback . ,Tuplet_bracket::after_line_breaking)
1312 (print-function . ,Tuplet_bracket::print)
1313 (font-shape . italic)
1314 ; (font-series . bold)
1317 (meta . ((interfaces . (text-interface line-interface tuplet-bracket-interface font-interface spanner-interface))))
1322 (print-function . ,Text_interface::print)
1323 (font-shape . italic)
1324 (no-spacing-rods . #t)
1325 (self-alignment-X . 0)
1327 (padding . 0.0) ;; padding relative to UnaCordaPedalLineSpanner
1328 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1329 (meta . ((interfaces . (text-interface self-alignment-interface font-interface item-interface ))))
1332 (UnaCordaPedalLineSpanner
1335 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1336 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1338 (staff-padding . 1.2)
1339 (minimum-space . 1.0)
1341 (meta . ((interfaces . (piano-pedal-interface axis-group-interface side-position-interface spanner-interface))))
1348 (ligature-primitive-callback . ,Vaticana_ligature::brew_ligature_primitive)
1349 (print-function . ,Vaticana_ligature::print)
1350 (meta . ((interfaces . (vaticana-ligature-interface font-interface))))
1355 (print-function . ,Volta_bracket_interface::print)
1358 (font-encoding . fetaNumber)
1359 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1360 (thickness . 1.6) ;; linethickness
1361 (height . 2.0) ;; staffspace;
1364 (meta . ((interfaces . (volta-bracket-interface line-interface text-interface side-position-interface font-interface spanner-interface))))
1370 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1371 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
1373 ;; (threshold . (6 . 1000))
1374 (meta . ((interfaces . (align-interface axis-group-interface spanner-interface))))
1380 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1381 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
1383 (meta . ((interfaces . (axis-group-interface vertically-spaceable-interface spanner-interface))))
1391 (define (completize-grob-entry x)
1392 "transplant assoc key into 'name entry of 'meta of X
1394 (let* ((name-sym (car x))
1395 (grob-entry (cdr x))
1396 (metaentry (cdr (assoc 'meta grob-entry)))
1398 (cdr (assoc 'interfaces metaentry)))
1401 (set! metaentry (assoc-set! metaentry 'name name-sym))
1402 (set! metaentry (assoc-set! metaentry 'interfaces
1403 (cons 'grob-interface ifaces-entry)))
1404 (set! grob-entry (assoc-set! grob-entry 'meta metaentry))
1405 (cons name-sym grob-entry)))
1407 (set! all-grob-descriptions (map completize-grob-entry all-grob-descriptions))
1410 ;; (display (map pair? all-grob-descriptions))
1412 ;; make sure that \property Foo.Bar =\turnOff doesn't complain
1415 ;; (display (car x)) (newline)
1417 (set-object-property! (car x) 'translation-type? list?)
1418 (set-object-property! (car x) 'is-grob? #t))
1419 all-grob-descriptions)
1421 (set! all-grob-descriptions (sort all-grob-descriptions alist<?))