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?
16 ;;; todo:: reorder sensibly.
18 (define-public all-grob-descriptions
22 (print-function . ,Accidental_interface::print)
24 (cautionary-style . parentheses)
25 (after-line-breaking-callback . ,Accidental_interface::after_line_breaking)
26 (meta . ((class . Item)
27 (interfaces . (accidental-interface
31 . ((print-function . ,Accidental_interface::print)
32 (X-offset-callbacks . (,Self_alignment_interface::centered_on_parent
33 ,Self_alignment_interface::aligned_on_self))
34 (self-alignment-X . ,CENTER)
36 (cautionary-style . smaller)
37 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
38 (cautionary-style . parentheses)
40 (staff-padding . 0.25)
42 (meta . ((class . Item)
43 (interfaces . (side-position-interface
46 accidental-suggestion-interface
47 self-alignment-interface
50 . ((X-extent-callback . ,Axis_group_interface::group_extent_callback)
53 ;; this is quite small, but it is very ugly to have
54 ;; accs closer to the previous note than to the next one.
55 (right-padding . 0.15)
56 (meta . ((class . Item)
57 (interfaces . (accidental-placement-interface))))))
61 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
62 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
64 (clef . (extra-space . 0.5))
65 (key-signature . (extra-space . 0.0))
66 (staff-bar . (extra-space . 0.0))
67 (time-signature . (extra-space . 0.0))
68 (first-note . (fixed-space . 0.0))))
70 (break-align-symbol . ambitus)
71 (break-visibility . ,begin-of-line-visible)
72 (meta . ((class . Item)
73 (interfaces . (axis-group-interface
74 break-aligned-interface
75 ambitus-interface))))))
79 (print-function . ,Ambitus::print)
82 (X-offset-callbacks . (,Self_alignment_interface::centered_on_parent))
84 (meta . ((class . Item)
85 (interfaces . (ambitus-interface
86 staff-symbol-referencer-interface
90 (print-function . ,Accidental_interface::print)
93 (X-offset-callbacks . (,Side_position_interface::aligned_side))
95 (cautionary-style . parentheses)
96 (after-line-breaking-callback . ,Accidental_interface::after_line_breaking)
97 (meta . ((class . Item)
98 (interfaces . (item-interface
100 break-aligned-interface
101 side-position-interface
107 (print-function . ,Note_head::print)
108 (glyph-name-procedure . ,find-notehead-symbol)
109 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
110 (meta . ((class . Item)
111 (interfaces . (font-interface
114 staff-symbol-referencer-interface
115 rhythmic-head-interface
116 ledgered-interface))))))
120 (X-extent-callback . ,Arpeggio::width_callback)
121 (print-function . ,Arpeggio::print)
122 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
123 (X-offset-callbacks . (,Side_position_interface::aligned_side))
126 (staff-position . 0.0)
127 (meta . ((class . Item)
128 (interfaces . (arpeggio-interface
129 staff-symbol-referencer-interface
130 side-position-interface
135 (break-align-symbol . staff-bar)
137 (break-glyph-function . ,default-break-barline)
139 (bar-size-procedure . ,Bar_line::get_staff_bar_size)
140 (print-function . ,Bar_line::print)
141 (break-visibility . ,all-visible)
143 (before-line-breaking-callback . ,Bar_line::before_line_breaking)
145 (time-signature . (extra-space . 0.75))
146 (custos . (minimum-space . 2.0))
147 (clef . (minimum-space . 1.0))
148 (key-signature . (extra-space . 1.0))
149 (key-cancellation . (extra-space . 1.0))
150 (first-note . (fixed-space . 1.3))
151 (next-note . (semi-fixed-space . 1.3))
152 (right-edge . (extra-space . 0.0))))
155 ;; Ross. page 151 lists other values, we opt for a leaner look
158 ;; kern should scale with linethickness too.
161 (hair-thickness . 1.9)
162 (thick-thickness . 6.0)
163 (meta . ((class . Item)
164 (interfaces . (bar-line-interface
165 break-aligned-interface
170 (print-function . ,Text_interface::print)
172 (break-visibility . ,begin-of-line-visible)
175 (font-family . roman)
177 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
178 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
179 (self-alignment-X . 1)
183 (interfaces . (side-position-interface
185 self-alignment-interface
187 break-aligned-interface))))
192 (print-function . ,Text_interface::print)
193 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
195 (font-family . number)
197 ;; We must do this, other BFs in
198 ;; layout16 become too small.
201 (meta . ((class . Item)
202 (interfaces . (text-interface
203 rhythmic-grob-interface
204 bass-figure-interface
205 self-alignment-interface
209 ;; todo: clean this up a bit: the list is getting
211 (print-function . ,Beam::print)
213 (positions . (#f . #f))
214 (position-callbacks . (,Beam::least_squares
217 ,Beam::shift_region_to_valid
220 ;; TODO: should be in SLT.
221 (thickness . 0.48) ; in staff-space
222 (before-line-breaking-callback . ,Beam::before_line_breaking)
223 (after-line-breaking-callback . ,Beam::after_line_breaking)
224 (neutral-direction . -1)
225 (dir-function . ,beam-dir-majority-median)
227 ;; Whe have some unreferenced problems here.
229 ;; If we shorten beamed stems less than normal stems (1 staffspace),
230 ;; or high order less than 8th beams, patterns like
231 ;; c''4 [c''8 c''] c''4 [c''16 c]
232 ;; are ugly (different stem lengths).
234 ;; But if we shorten 16th beams as much as 8th beams, a single
235 ;; forced 16th beam looks *very* short.
237 ;; We choose to shorten 8th beams the same as single stems,
238 ;; and high order beams less than 8th beams, so that all
239 ;; isolated shortened beams look nice and a bit shortened,
240 ;; sadly possibly breaking patterns with high order beams.
241 (beamed-stem-shorten . (1.0 0.5 0.25))
243 (flag-width-function . ,beam-flag-width-function)
245 (auto-knee-gap . 5.5)
247 ;; only for debugging.
248 (font-family . roman)
250 (space-function . ,Beam::space_function)
251 (meta . ((class . Spanner)
252 (interfaces . (staff-symbol-referencer-interface
259 (break-align-orders . ;; end of line
281 time-signature custos)
295 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
296 (meta . ((class . Item)
297 (interfaces . (break-alignment-interface
298 axis-group-interface))))))
303 (X-offset-callbacks . (,Break_align_interface::alignment_callback))
304 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
305 (meta . ((class . Item)
306 (interfaces . (break-aligned-interface
307 axis-group-interface))))))
311 (break-align-symbol . breathing-sign)
314 (ambitus . (extra-space . 2.0))
315 (custos . (minimum-space . 1.0))
316 (key-signature . (minimum-space . 1.5))
317 (staff-bar . (minimum-space . 1.5))
318 (clef . (minimum-space . 2.0))
319 (first-note . (fixed-space . 1.0)) ;huh?
320 (right-edge . (extra-space . 0.1))))
321 (print-function . ,Text_interface::print)
322 (text . ,(make-musicglyph-markup "scripts.rcomma"))
323 (Y-offset-callbacks . (,Breathing_sign::offset_callback))
324 (break-visibility . ,begin-of-line-invisible)
325 (meta . ((class . Item)
326 (interfaces . (break-aligned-interface
327 breathing-sign-interface
333 (print-function . ,Clef::print)
334 (before-line-breaking-callback . ,Clef::before_line_breaking)
336 (font-family . music)
337 (break-align-symbol . clef)
338 (break-visibility . ,begin-of-line-visible)
339 (space-alist . ((ambitus . (extra-space . 2.0))
340 (staff-bar . (extra-space . 0.7))
341 (key-cancellation . (minimum-space . 4.0))
342 (key-signature . (minimum-space . 4.0))
343 (time-signature . (minimum-space . 4.2))
344 (first-note . (minimum-fixed-space . 5.0))
345 (next-note . (extra-space . 0.5))
346 (right-edge . (extra-space . 0.5))))
347 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
348 (meta . ((class . Item)
349 (interfaces . (clef-interface
350 staff-symbol-referencer-interface
352 break-aligned-interface))))))
354 (ClusterSpannerBeacon
356 (print-function . #f)
357 (Y-extent-callback . ,Cluster_beacon::height)
358 (meta . ((class . Item)
359 (interfaces . (cluster-beacon-interface))))))
363 (print-function . ,Cluster::print)
364 (spacing-procedure . ,Spanner::set_spacing_rods)
365 (minimum-length . 0.0)
368 (meta . ((class . Spanner)
369 (interfaces . (cluster-interface))))))
373 (print-function . ,Text_interface::print)
374 (after-line-breaking-callback . ,Chord_name::after_line_breaking)
378 (meta . ((class . Item)
379 (interfaces . (font-interface
380 rhythmic-grob-interface
387 (print-function . ,Text_interface::print)
388 (no-spacing-rods . #t)
389 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
390 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
393 (staff-padding . 0.5)
394 (script-priority . 200)
395 ;; todo: add X self alignment?
398 (meta . ((class . Item)
399 (interfaces . (text-script-interface
401 side-position-interface
406 (break-align-symbol . custos)
408 (print-function . ,Custos::print)
409 (break-visibility . ,end-of-line-visible)
411 (neutral-direction . -1)
412 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
414 (first-note . (minimum-fixed-space . 0.0))
415 (right-edge . (extra-space . 0.1))))
416 (meta . ((class . Item)
419 staff-symbol-referencer-interface
421 break-aligned-interface))))))
427 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
428 (X-offset-callbacks . (,Dot_column::side_position))
429 (meta . ((class . Item)
430 (interfaces . (dot-column-interface
431 axis-group-interface))))))
435 (print-function . ,Dots::print)
437 (meta . ((class . Item)
438 (interfaces . (font-interface
439 staff-symbol-referencer-interface
444 (print-function . ,Percent_repeat_item_interface::double_percent)
447 (font-encoding . fetaMusic)
450 (break-align-symbol . staff-bar)
451 (break-visibility . ,begin-of-line-invisible)
452 (meta . ((class . Item)
453 (interfaces . (font-interface
454 break-aligned-interface
455 percent-repeat-interface))))))
457 (DoublePercentRepeatCounter
458 . ((print-function . ,Text_interface::print)
459 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
460 ,Self_alignment_interface::centered_on_other_axis_parent))
461 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
462 (font-encoding . fetaNumber)
463 (self-alignment-X . 0)
467 (staff-padding . 0.25)
468 (meta . ((class . Item)
469 (interfaces . (side-position-interface
470 self-alignment-interface
471 percent-repeat-interface
477 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
478 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
479 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
480 (staff-padding . 0.1)
482 (avoid-slur . outside)
484 (minimum-space . 1.2)
487 (meta . ((class . Spanner)
488 (interfaces . (axis-group-interface
490 dynamic-line-spanner-interface
491 side-position-interface))))))
495 (print-function . ,Text_interface::print)
496 (before-line-breaking-callback . ,Script_interface::before_line_breaking)
497 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
498 (self-alignment-X . 0)
499 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
500 (self-alignment-Y . 0)
502 (font-encoding . fetaDynamic)
503 (font-shape . italic)
504 (no-spacing-rods . #t)
505 (script-priority . 100)
506 (meta . ((class . Item)
507 (interfaces . (font-interface
509 self-alignment-interface
511 script-interface))))))
514 . ((print-function . ,Dynamic_text_spanner::print)
516 ;; rather ugh with NCSB
517 ;; (font-series . bold)
518 (font-shape . italic)
519 (style . dashed-line)
521 ;; need to blend with dynamic texts.
523 (bound-padding . 0.75)
524 (dash-fraction . 0.2)
526 (meta . ((class . Spanner)
527 (interfaces . (font-interface
530 dynamic-text-spanner-interface
531 spanner-interface))))))
535 (print-function . ,Text_interface::print)
537 ;; sync with TextScript (?)
540 (avoid-slur . around)
542 (staff-padding . 0.5)
543 (self-alignment-X . 0)
544 (self-alignment-Y . 0)
545 (script-priority . 100)
546 (before-line-breaking-callback . ,Script_interface::before_line_breaking)
547 (font-encoding . fetaNumber)
548 (font-size . -5) ; don't overlap when next to heads.
549 (meta . ((class . Item)
550 (interfaces . (finger-interface
552 text-script-interface
554 side-position-interface
555 self-alignment-interface
561 (zigzag-width . 0.75)
563 (X-extent-callback . #f)
564 (Y-extent-callback . #f)
565 (after-line-breaking-callback . ,Line_spanner::after_line_breaking)
566 (print-function . ,Line_spanner::print)
567 (meta . ((class . Spanner)
568 (interfaces . (line-interface
569 line-spanner-interface))))))
575 (meta . ((class . Item)
576 (interfaces . (grid-point-interface))))))
580 (print-function . ,Grid_line_interface::print)
581 (X-extent-callback . ,Grid_line_interface::width_callback)
582 (self-alignment-X . ,CENTER)
583 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
584 ,Self_alignment_interface::centered_on_parent))
586 (meta . ((class . Item)
587 (interfaces . (self-alignment-interface
588 grid-line-interface))))))
592 (print-function . ,Hairpin::print)
593 (after-line-breaking-callback . ,Hairpin::after_line_breaking)
596 (spacing-procedure . ,Spanner::set_spacing_rods)
597 (minimum-length . 2.0)
598 (bound-padding . 1.0)
599 (self-alignment-Y . 0)
600 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
601 (meta . ((class . Spanner)
602 (interfaces . (hairpin-interface
604 self-alignment-interface
606 spanner-interface))))))
611 (print-function . ,Horizontal_bracket::print)
612 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
614 (staff-padding . 0.2)
616 (bracket-flare . (0.5 . 0.5))
617 (meta . ((class . Spanner)
618 (interfaces . (horizontal-bracket-interface
619 side-position-interface
621 spanner-interface))))))
625 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self
626 ,Side_position_interface::aligned_on_support_refpoints))
627 ;; This direction is for aligned_on_support_refpoints
631 (left-edge . (extra-space . 1.0))))
633 (self-alignment-Y . 0)
634 (print-function . ,Text_interface::print)
635 (break-align-symbol . instrument-name)
636 (break-visibility . ,begin-of-line-visible)
638 (meta . ((class . Item)
639 (interfaces . (font-interface
640 self-alignment-interface
641 side-position-interface
643 break-aligned-interface))))))
647 (print-function . ,Key_signature_interface::print)
649 (time-signature . (extra-space . 1.25))
650 (staff-bar . (extra-space . 0.6))
651 (key-signature . (extra-space . 0.5))
652 (right-edge . (extra-space . 0.5))
653 (first-note . (fixed-space . 2.5))))
654 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
655 (break-align-symbol . key-cancellation)
656 (break-visibility . ,begin-of-line-invisible)
659 (meta . ((class . Item)
660 (interfaces . (key-signature-interface
662 break-aligned-interface))))))
665 (print-function . ,Key_signature_interface::print)
667 (time-signature . (extra-space . 1.25))
668 (staff-bar . (extra-space . 1.1))
669 (right-edge . (extra-space . 0.5))
670 (first-note . (fixed-space . 2.5))))
671 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
672 (break-align-symbol . key-signature)
673 (break-visibility . ,begin-of-line-visible)
676 (meta . ((class . Item)
677 (interfaces . (key-signature-interface
679 break-aligned-interface))))))
682 (print-function . ,Laissez_vibrer_tie::print)
683 (details . ((ratio . 0.333)
684 (height-limit . 1.0)))
686 (meta . ((class . Item)
687 (interfaces . (laissez-vibrer-tie-interface))
691 (LaissezVibrerTieColumn
693 (X-extent-callback . #f)
694 (Y-extent-callback . #f)
695 (meta . ((class . Item)
696 (interfaces . (laissez-vibrer-tie-column-interface))
702 (print-function . ,Ledger_line_spanner::print)
703 (X-extent-callback . #f)
704 (Y-extent-callback . #f)
705 (minimum-length-fraction . 0.25)
706 (length-fraction . 0.25)
707 (spacing-procedure . ,Ledger_line_spanner::set_spacing_rods)
708 (print-function . ,Ledger_line_spanner::print)
710 (meta . ((class . Spanner)
711 (interfaces . (ledger-line-interface))))))
715 (break-align-symbol . left-edge)
718 (break-visibility . ,center-invisible)
720 (custos . (extra-space . 0.0))
721 (ambitus . (extra-space . 2.0))
722 (time-signature . (extra-space . 1.0))
723 (staff-bar . (extra-space . 0.0))
724 (breathing-sign . (minimum-space . 0.0))
725 (clef . (extra-space . 0.8))
726 (first-note . (fixed-space . 2.0))
727 (right-edge . (extra-space . 0.0))
728 (key-signature . (extra-space . 0.0))
729 (key-cancellation . (extra-space . 0.0))
731 (meta . ((class . Item)
732 (interfaces . (break-aligned-interface))))))
736 (ligature-primitive-callback . ,Note_head::print)
741 (edge-height . (0.7 . 0.7))
742 (shorten-pair . (-0.2 . -0.2))
743 (before-line-breaking-callback . ,Tuplet_bracket::before_line_breaking)
744 (after-line-breaking-callback . ,Tuplet_bracket::after_line_breaking)
745 (print-function . ,Tuplet_bracket::print)
746 (meta . ((class . Spanner)
747 (interfaces . (tuplet-bracket-interface
756 (minimum-length . 0.3)
758 ; (spacing-procedure . ,Hyphen_spanner::set_spacing_rods)
759 (print-function . ,Hyphen_spanner::print)
761 (meta . ((class . Spanner)
762 (interfaces . (lyric-interface
763 lyric-hyphen-interface
764 spanner-interface))))))
768 (print-function . ,Lyric_extender::print)
769 (thickness . 0.8) ; linethickness
770 (minimum-length . 1.5)
772 (meta . ((class . Spanner)
773 (interfaces . (lyric-interface
774 lyric-extender-interface))))))
777 . ((print-function . ,Text_interface::print)
778 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_parent))
779 (self-alignment-X . 0)
781 (font-series . bold-narrow)
783 (meta . ((class . Item)
784 (interfaces . (rhythmic-grob-interface
785 lyric-syllable-interface
786 self-alignment-interface
794 (ligature-primitive-callback . ,Mensural_ligature::brew_ligature_primitive)
795 (print-function . ,Mensural_ligature::print)
796 (meta . ((class . Spanner)
797 (interfaces . (mensural-ligature-interface
802 (print-function . ,Text_interface::print)
803 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
806 (meta . ((class . Item)
807 (interfaces . (text-interface
808 side-position-interface
810 metronome-mark-interface))))))
813 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
814 (print-function . ,Measure_grouping::print)
820 (meta . ((class . Spanner)
821 (interfaces . (side-position-interface
822 measure-grouping-interface))))))
825 (print-function . ,Multi_measure_rest::print)
826 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
829 (thick-thickness . 6.6)
830 (hair-thickness . 2.0)
832 (meta . ((class . Spanner)
833 (interfaces . (multi-measure-rest-interface
834 multi-measure-interface
837 staff-symbol-referencer-interface))))))
839 (MultiMeasureRestNumber
841 (print-function . ,Text_interface::print)
842 (spacing-procedure . ,Multi_measure_rest::set_spacing_rods)
843 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
844 ,Self_alignment_interface::centered_on_other_axis_parent))
845 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
846 (self-alignment-X . 0)
849 (staff-padding . 0.4)
850 (font-encoding . fetaNumber)
851 (meta . ((class . Spanner)
852 (interfaces . (side-position-interface
853 multi-measure-interface
854 self-alignment-interface
858 (MultiMeasureRestText
860 (print-function . ,Text_interface::print)
861 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
862 ,Self_alignment_interface::centered_on_other_axis_parent))
863 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
864 (self-alignment-X . 0)
867 (staff-padding . 0.25)
868 (meta . ((class . Spanner)
869 (interfaces . (side-position-interface
870 multi-measure-interface
871 self-alignment-interface
878 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
879 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
880 (meta . ((class . Item)
881 (interfaces . (note-collision-interface
882 axis-group-interface))))))
887 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
888 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
889 (meta . ((class . Item)
890 (interfaces . (axis-group-interface
891 note-column-interface))))))
895 (print-function . ,Note_head::print)
896 (ligature-primitive-callback . ,Note_head::print)
897 (glyph-name-procedure . ,find-notehead-symbol)
898 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
899 (stem-attachment-function . ,note-head-style->attachment-coordinates)
900 (meta . ((class . Item)
901 (interfaces . (rhythmic-grob-interface
902 rhythmic-head-interface
906 staff-symbol-referencer-interface))))))
910 (stem-spacing-correction . 0.5)
911 (same-direction-correction . 0.25)
912 ;; Changed this from 0.75.
913 ;; If you ever change this back, please document! --hwn
914 (knee-spacing-correction . 1.0)
916 (meta . ((class . Item)
917 (interfaces . (spacing-interface
918 note-spacing-interface))))))
922 (print-function . ,Text_interface::print)
923 (meta . ((class . Item)
924 (interfaces . (note-name-interface
930 (self-alignment-X . 0)
931 (break-visibility . ,begin-of-line-visible)
932 (X-offset-callbacks . (,Self_alignment_interface::centered_on_parent
933 ,Self_alignment_interface::aligned_on_self))
934 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
935 (print-function . ,Text_interface::print)
937 ;; no Y dimensions, because of lyrics under tenor clef.
939 (font-shape . italic)
941 (staff-padding . 0.2)
943 (meta . ((class . Item)
944 (interfaces . (text-interface
945 self-alignment-interface
946 side-position-interface
951 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
952 (print-function . ,Ottava_bracket::print)
953 (font-shape . italic)
954 (shorten-pair . (0.0 . -0.6))
955 (staff-padding . 1.0)
957 (minimum-length . 1.0)
958 (dash-fraction . 0.3)
959 (edge-height . (0 . 1.2))
961 (meta . ((class . Spanner)
962 (interfaces . (ottava-bracket-interface
964 side-position-interface
971 (before-line-breaking-callback . ,Paper_column::before_line_breaking)
972 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
975 ;; (print-function . ,Paper_column::print) (font-size . -6) (font-name . "sans") (Y-extent-callback . #f)
976 (meta . ((class . Paper_column)
977 (interfaces . (paper-column-interface
979 spaceable-grob-interface))))))
982 . ((slur-details . ,default-slur-details)
983 (print-function . ,Slur::print)
985 (spacing-procedure . ,Spanner::set_spacing_rods)
986 (minimum-length . 1.5)
987 (after-line-breaking-callback . ,Slur::after_line_breaking)
988 (Y-extent-callback . ,Slur::height)
991 (meta . ((class . Spanner)
992 (interfaces . (slur-interface))))))
994 (NonMusicalPaperColumn
997 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
998 (before-line-breaking-callback . ,Paper_column::before_line_breaking)
1001 ;; debugging stuff: print column number.
1002 ;; (print-function . ,Paper_column::print) (font-size . -6) (font-name . "sans") (Y-extent-callback . #f)
1004 (meta . ((class . Paper_column)
1005 (interfaces . (paper-column-interface
1006 axis-group-interface
1007 spaceable-grob-interface))))))
1011 (spacing-procedure . ,Multi_measure_rest::set_spacing_rods)
1012 (print-function . ,Multi_measure_rest::percent)
1015 (font-encoding . fetaMusic)
1016 (meta . ((class . Spanner)
1017 (interfaces . (multi-measure-rest-interface
1019 percent-repeat-interface))))))
1020 (PercentRepeatCounter
1021 . ((print-function . ,Text_interface::print)
1022 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
1023 ,Self_alignment_interface::centered_on_other_axis_parent))
1024 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1025 (self-alignment-X . 0)
1028 (staff-padding . 0.25)
1030 (font-encoding . fetaNumber)
1031 (meta . ((class . Spanner)
1032 (interfaces . (side-position-interface
1033 self-alignment-interface
1034 percent-repeat-interface
1036 text-interface))))))
1038 ;; an example of a text spanner
1041 (print-function . ,Piano_pedal_bracket::print)
1043 (bound-padding . 1.0)
1045 (bracket-flare . (0.5 . 0.5))
1046 (edge-height . (1.0 . 1.0))
1047 (shorten-pair . (0.0 . 0.0))
1049 (meta . ((class . Spanner)
1050 (interfaces . (line-interface
1051 piano-pedal-interface
1052 piano-pedal-bracket-interface))))))
1056 (print-function . ,Text_interface::print)
1057 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1058 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1059 (after-line-breaking-callback . ,shift-right-at-line-begin)
1060 (self-alignment-X . 0)
1065 (break-visibility . ,end-of-line-invisible)
1067 (meta . ((class . Item)
1068 (interfaces . (text-interface
1069 side-position-interface
1072 self-alignment-interface))))))
1074 (RemoveEmptyVerticalGroup
1076 (Y-offset-callbacks . (,Hara_kiri_group_spanner::force_hara_kiri_callback))
1077 (Y-extent-callback . ,Hara_kiri_group_spanner::y_extent)
1079 (meta . ((class . Spanner)
1080 (interfaces . (axis-group-interface
1081 vertically-spaceable-interface
1082 hara-kiri-group-interface
1083 spanner-interface))))))
1087 (print-function . ,Percent_repeat_item_interface::beat_slash)
1090 (meta . ((class . Item)
1091 (interfaces . (percent-repeat-interface))))))
1094 (after-line-breaking-callback . ,Rest::after_line_breaking)
1095 (X-extent-callback . ,Rest::extent_callback)
1096 (Y-extent-callback . ,Rest::extent_callback)
1097 (print-function . ,Rest::print)
1098 (Y-offset-callbacks . (,Staff_symbol_referencer::callback
1099 ,Rest::polyphonic_offset_callback))
1100 (minimum-distance . 0.25)
1101 (meta . ((class . Item)
1102 (interfaces . (font-interface
1103 rhythmic-head-interface
1104 rhythmic-grob-interface
1105 staff-symbol-referencer-interface
1106 rest-interface))))))
1110 (minimum-distance . 0.75)
1111 (meta . ((class . Item)
1112 (interfaces . (rest-collision-interface))))))
1116 ;; don't set direction here: it breaks staccato.
1117 (print-function . ,Script_interface::print)
1119 ;; This value is sensitive: if too large, staccato dots will move a
1122 (staff-padding . 0.25)
1123 ;; (script-priority . 0) priorities for scripts, see script.scm
1124 (X-offset-callbacks . (,Self_alignment_interface::centered_on_parent))
1125 (before-line-breaking-callback . ,Script_interface::before_line_breaking)
1126 (font-encoding . fetaMusic)
1127 (meta . ((class . Item)
1128 (interfaces . (script-interface
1129 side-position-interface
1130 font-interface))))))
1134 (before-line-breaking-callback . ,Script_column::before_line_breaking)
1135 (meta . ((class . Item)
1136 (interfaces . (script-column-interface))))))
1140 (X-extent-callback . #f)
1141 (Y-extent-callback . #f)
1142 (meta . ((class . Item)
1143 (interfaces . (spacing-interface
1144 separation-item-interface))))))
1146 (SeparatingGroupSpanner
1148 (spacing-procedure . ,Separating_group_spanner::set_spacing_rods)
1149 (meta . ((class . Spanner)
1150 (interfaces . (only-prebreak-interface
1152 separation-spanner-interface))))))
1155 . ((slur-details . ,default-slur-details)
1156 (print-function . ,Slur::print)
1158 (spacing-procedure . ,Spanner::set_spacing_rods)
1159 (minimum-length . 1.5)
1160 (after-line-breaking-callback . ,Slur::after_line_breaking)
1161 (Y-extent-callback . ,Slur::height)
1163 (height-limit . 2.0)
1165 (meta . ((class . Spanner)
1166 (interfaces . (slur-interface))))))
1170 (spacing-procedure . ,Spacing_spanner::set_springs)
1171 (grace-space-factor . 0.6)
1172 (shortest-duration-space . 2.0)
1173 (spacing-increment . 1.2)
1174 (base-shortest-duration . ,(ly:make-moment 3 16))
1175 (meta . ((class . Spanner)
1176 (interfaces . (spacing-interface
1177 spacing-spanner-interface))))))
1181 (break-align-symbol . staff-bar)
1182 (bar-size-procedure . ,Span_bar::get_bar_size)
1183 (print-function . ,Span_bar::print)
1184 (X-extent-callback . ,Span_bar::width_callback)
1185 (Y-extent-callback . ())
1188 (before-line-breaking-callback . ,Span_bar::before_line_breaking)
1192 ;; Ross. page 151 lists other values, we opt for a leaner look
1196 (hair-thickness . 1.6)
1197 (thick-thickness . 6.0)
1198 (meta . ((class . Item)
1199 (interfaces . (span-bar-interface
1201 bar-line-interface))))))
1204 . ((print-function . ,Text_interface::print)
1205 (font-series . bold)
1207 (X-offset-callbacks . (,Side_position_interface::aligned_side))
1209 (meta . ((class . Item)
1210 (interfaces . (side-position-interface
1211 stanza-number-interface
1213 font-interface))))))
1217 (print-function . ,print-circled-text-callback)
1219 (staff-padding . 0.5)
1220 (self-alignment-X . 0)
1221 (self-alignment-Y . 0)
1222 (script-priority . 100)
1223 (font-encoding . fetaNumber)
1224 (font-size . -5) ; don't overlap when next to heads.
1225 (meta . ((class . Item)
1226 (interfaces . (string-number-interface
1228 text-script-interface
1230 side-position-interface
1231 self-alignment-interface
1232 item-interface))))))
1237 (stem-spacing-correction . 0.4)
1239 (meta . ((class . Item)
1240 (interfaces . (spacing-interface
1241 staff-spacing-interface))))))
1245 (print-function . ,Text_interface::print)
1247 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1248 (no-spacing-rods . #t)
1249 (padding . 0.0) ;; padding relative to SostenutoPedalLineSpanner
1250 (font-shape . italic)
1251 (self-alignment-X . 0)
1252 (meta . ((class . Item)
1253 (interfaces . (text-interface
1254 self-alignment-interface
1255 font-interface))))))
1257 (SostenutoPedalLineSpanner
1260 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1261 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1264 (minimum-space . 1.0)
1266 (meta . ((class . Spanner)
1267 (interfaces . (piano-pedal-interface
1268 axis-group-interface
1269 side-position-interface))))))
1273 (print-function . ,Staff_symbol::print)
1275 (ledger-line-thickness . (1.0 . 0.1))
1277 (meta . ((class . Spanner)
1278 (interfaces . (staff-symbol-interface))))))
1282 ;; this list is rather long. Trim --hwn
1283 (before-line-breaking-callback . ,Stem::before_line_breaking)
1284 (print-function . ,Stem::print)
1287 ;; 3.5 (or 3 measured from note head) is standard length
1288 ;; 32nd, 64th flagged stems should be longer
1289 (lengths . (3.5 3.5 3.5 4.5 5.0))
1291 ;; Stems in unnatural (forced) direction should be shortened by
1292 ;; one staff space, according to [Roush & Gourlay].
1293 ;; Flagged stems we shorten only half a staff space.
1294 (stem-shorten . (1.0 0.5))
1296 ;; default stem direction for note on middle line
1297 (neutral-direction . -1)
1299 ;; FIXME. 3.5 yields too long beams (according to Ross and
1300 ;; looking at Baerenreiter examples) for a number of common
1301 ;; boundary cases. Subtracting half a beam thickness fixes
1302 ;; this, but the bug may well be somewhere else.
1304 ;; FIXME this should come from 'lengths
1306 (beamed-lengths . (3.26 3.5 3.6))
1308 ;; We use the normal minima as minimum for the ideal lengths,
1309 ;; and the extreme minima as abolute minimum length.
1311 ;; The 'normal' minima
1312 (beamed-minimum-free-lengths . (1.83 1.5 1.25))
1313 ;(beamed-minimum-free-lengths . (2.0 1.83 1.25))
1315 ;; The 'extreme case' minima
1316 (beamed-extreme-minimum-free-lengths . (2.0 1.25))
1318 (X-offset-callbacks . (,Stem::offset_callback))
1319 (X-extent-callback . ,Stem::width_callback)
1320 (Y-extent-callback . ,Stem::height)
1321 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
1322 (meta . ((class . Item)
1323 (interfaces . (stem-interface
1324 font-interface))))))
1328 (print-function . ,Stem_tremolo::print)
1329 (Y-extent-callback . ,Stem_tremolo::height)
1330 (X-extent-callback . #f)
1332 (beam-width . 1.6) ; staff-space
1333 (beam-thickness . 0.48) ; staff-space
1334 (meta . ((class . Item)
1335 (interfaces . (stem-tremolo-interface))))))
1339 (no-spacing-rods . #t)
1340 (print-function . ,Sustain_pedal::print)
1341 (self-alignment-X . 0)
1343 (padding . 0.0) ;; padding relative to SustainPedalLineSpanner
1344 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1345 (meta . ((class . Item)
1346 (interfaces . (piano-pedal-interface
1347 text-spanner-interface
1349 self-alignment-interface
1350 font-interface))))))
1352 (SustainPedalLineSpanner
1355 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1356 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1359 (staff-padding . 1.2)
1360 (minimum-space . 1.0)
1362 (meta . ((class . Spanner)
1363 (interfaces . (piano-pedal-interface
1364 axis-group-interface
1365 side-position-interface))))))
1370 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
1371 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1372 (meta . ((class . System)
1373 (interfaces . (system-interface
1374 axis-group-interface))))))
1379 (print-function . ,System_start_delimiter::print)
1380 (collapse-height . 5.0)
1381 (font-encoding . fetaBraces)
1382 (Y-extent-callback . #f)
1383 (meta . ((class . Spanner)
1384 (interfaces . (system-start-delimiter-interface
1385 font-interface))))))
1389 (Y-extent-callback . #f)
1390 (X-offset-callbacks . (,(lambda (g a) -0.8)))
1391 (print-function . ,System_start_delimiter::print)
1393 (collapse-height . 1)
1395 (meta . ((class . Spanner)
1396 (interfaces . (font-interface
1397 system-start-delimiter-interface))))))
1401 (Y-extent-callback . #f)
1402 (print-function . ,System_start_delimiter::print)
1403 (glyph . "bar-line")
1405 (after-line-breaking-callback . ,System_start_delimiter::after_line_breaking)
1406 (meta . ((class . Spanner)
1407 (interfaces . (system-start-delimiter-interface))))))
1411 (print-function . ,Text_interface::print)
1412 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
1414 (stem-attachment-function . ,tablature-stem-attachment-function)
1415 (font-series . bold)
1416 (meta . ((class . Item)
1418 . (rhythmic-head-interface
1421 staff-symbol-referencer-interface
1422 text-interface))))))
1426 (print-function . ,Text_interface::print)
1427 (no-spacing-rods . #t)
1428 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1431 ;; sync with Fingering ?
1433 (staff-padding . 0.5)
1434 (before-line-breaking-callback . ,Script_interface::before_line_breaking)
1435 (avoid-slur . around)
1436 (slur-padding . 0.5)
1437 (script-priority . 200)
1438 ;; todo: add X self alignment?
1439 (meta . ((class . Item)
1440 (interfaces . (text-script-interface
1442 side-position-interface
1443 font-interface))))))
1447 (print-function . ,Text_spanner::print)
1448 (font-shape . italic)
1449 (style . dashed-line)
1450 (staff-padding . 0.8)
1451 (dash-fraction . 0.2)
1454 (meta . ((class . Spanner)
1455 (interfaces . (text-spanner-interface
1456 side-position-interface
1457 font-interface))))))
1461 (print-function . ,Tie::print)
1462 (details . ((ratio . 0.333) (height-limit . 1.0)))
1464 (meta . ((class . Spanner)
1465 (interfaces . (tie-interface))))))
1469 (after-line-breaking-callback . ,Tie_column::after_line_breaking)
1470 (before-line-breaking-callback . ,Tie_column::before_line_breaking)
1471 (X-extent-callback . #f)
1472 (Y-extent-callback . #f)
1473 (meta . ((class . Spanner)
1474 (interfaces . (tie-column-interface))))))
1478 (print-function . ,Time_signature::print)
1479 (break-align-symbol . time-signature)
1480 (break-visibility . ,all-visible)
1482 (first-note . (fixed-space . 2.0))
1483 (right-edge . (extra-space . 0.5))
1484 (staff-bar . (minimum-space . 2.0))))
1487 (meta . ((class . Item)
1488 (interfaces . (time-signature-interface
1489 break-aligned-interface
1490 font-interface))))))
1494 (print-function . ,Dynamic_text_spanner::print)
1495 (edge-text . ,(cons (make-musicglyph-markup "scripts.trill")
1498 (staff-padding . 1.0)
1501 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1502 (meta . ((class . Spanner)
1503 (interfaces . (text-spanner-interface
1504 side-position-interface
1505 font-interface))))))
1507 (TrillPitchAccidental
1508 . ((X-offset-callbacks . (,Side_position_interface::aligned_side))
1512 (print-function . ,Accidental_interface::print)
1513 (meta . ((class . Item)
1514 (interfaces . (item-interface
1515 accidental-interface
1516 side-position-interface
1517 font-interface))))))
1520 . ((X-offset-callbacks . (,Side_position_interface::aligned_side))
1523 (print-function . ,parenthesize-elements)
1524 (direction . ,RIGHT)
1526 (meta . ((class . Item)
1527 (interfaces . (side-position-interface
1529 rhythmic-head-interface
1531 accidental-interface
1532 axis-group-interface))))))
1535 . ((print-function . ,Note_head::print)
1537 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
1539 (meta . ((class . Item)
1540 (interfaces . (item-interface
1541 rhythmic-head-interface
1543 pitched-trill-interface
1545 staff-symbol-referencer-interface))))))
1551 (edge-height . (0.7 . 0.7))
1552 (shorten-pair . (-0.2 . -0.2))
1553 (before-line-breaking-callback . ,Tuplet_bracket::before_line_breaking)
1554 (after-line-breaking-callback . ,Tuplet_bracket::after_line_breaking)
1555 (print-function . ,Tuplet_bracket::print)
1556 (font-shape . italic)
1559 (meta . ((class . Spanner)
1560 (interfaces . (text-interface
1562 tuplet-bracket-interface
1563 font-interface))))))
1567 (print-function . ,Text_interface::print)
1568 (font-shape . italic)
1569 (no-spacing-rods . #t)
1570 (self-alignment-X . 0)
1572 (padding . 0.0) ;; padding relative to UnaCordaPedalLineSpanner
1573 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1574 (meta . ((class . Item)
1575 (interfaces . (text-interface
1576 self-alignment-interface
1577 font-interface))))))
1579 (UnaCordaPedalLineSpanner
1582 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1583 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1585 (staff-padding . 1.2)
1586 (minimum-space . 1.0)
1588 (meta . ((class . Spanner)
1589 (interfaces . (piano-pedal-interface
1590 axis-group-interface
1591 side-position-interface))))))
1597 (ligature-primitive-callback . ,Vaticana_ligature::brew_ligature_primitive)
1598 (print-function . ,Vaticana_ligature::print)
1599 (meta . ((class . Spanner)
1600 (interfaces . (vaticana-ligature-interface
1601 font-interface))))))
1606 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1607 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
1609 (meta . ((class . Spanner)
1610 (interfaces . (align-interface
1611 axis-group-interface))))))
1616 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1617 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
1619 (meta . ((class . Spanner)
1620 (interfaces . (axis-group-interface
1621 vertically-spaceable-interface))))))
1626 (Y-offset-callbacks . (,Side_position_interface::aligned_on_support_refpoints))
1628 (space-alist . ((left-edge . (extra-space . 1.0))))
1629 (break-align-symbol . instrument-name)
1630 (print-function . ,Text_interface::print)
1631 (break-align-symbol . clef)
1632 (break-visibility . ,begin-of-line-visible)
1634 (meta . ((class . Item)
1635 (interfaces . (font-interface
1636 self-alignment-interface
1637 side-position-interface
1639 break-aligned-interface))))))
1643 (print-function . ,Volta_bracket_interface::print)
1646 (font-encoding . fetaNumber)
1647 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1648 (thickness . 1.6) ;; linethickness
1649 (height . 2.0) ;; staffspace;
1652 (meta . ((class . Spanner)
1653 (interfaces . (volta-bracket-interface
1656 side-position-interface
1657 font-interface))))))
1664 (X-extent-callback . #f)
1665 (Y-extent-callback . #f)
1666 (print-function . ,Line_spanner::print)
1667 (after-line-breaking-callback . ,Line_spanner::after_line_breaking)
1668 (meta . ((class . Spanner)
1669 (interfaces . (line-spanner-interface
1670 line-interface))))))))
1672 (define (completize-grob-entry x)
1673 "Transplant assoc key into 'name entry of 'meta of X. Set interfaces for Item, Spanner etc.
1675 ;; (display (car x))
1677 (let* ((name-sym (car x))
1678 (grob-entry (cdr x))
1679 (meta-entry (cdr (assoc 'meta grob-entry)))
1680 (class (cdr (assoc 'class meta-entry)))
1682 (cdr (assoc 'interfaces meta-entry))))
1686 (set! ifaces-entry (cons 'item-interface ifaces-entry)))
1687 ((eq? 'Spanner class)
1688 (set! ifaces-entry (cons 'spanner-interface ifaces-entry)))
1689 ((eq? 'Paper_column class)
1690 (set! ifaces-entry (cons 'item-interface
1691 (cons 'paper-column-interface ifaces-entry))))
1692 ((eq? 'System class)
1693 (set! ifaces-entry (cons 'system-interface
1694 (cons 'spanner-interface ifaces-entry))))
1696 (ly:warning "Unknown class ~a" class)))
1697 (set! ifaces-entry (cons 'grob-interface ifaces-entry))
1699 (set! meta-entry (assoc-set! meta-entry 'name name-sym))
1700 (set! meta-entry (assoc-set! meta-entry 'interfaces
1702 (set! grob-entry (assoc-set! grob-entry 'meta meta-entry))
1703 (cons name-sym grob-entry)))
1705 (set! all-grob-descriptions (map completize-grob-entry all-grob-descriptions))
1707 ;; (display (map pair? all-grob-descriptions))
1709 ;; make sure that \property Foo.Bar =\turnOff doesn't complain
1712 ;; (display (car x)) (newline)
1714 (set-object-property! (car x) 'translation-type? list?)
1715 (set-object-property! (car x) 'is-grob? #t))
1716 all-grob-descriptions)
1718 (set! all-grob-descriptions (sort all-grob-descriptions alist<?))