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
23 (cautionary-style . parentheses)
25 (stencil . ,Accidental_interface::print)
27 . ,Accidental_interface::after_line_breaking)
29 (meta . ((class . Item)
30 (interfaces . (accidental-interface
36 (stencil . ,Accidental_interface::print)
38 (X-offset-callbacks . (,Self_alignment_interface::centered_on_parent
39 ,Self_alignment_interface::aligned_on_self))
40 (self-alignment-X . ,CENTER)
42 (cautionary-style . smaller)
43 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
44 (cautionary-style . parentheses)
46 (staff-padding . 0.25)
48 (meta . ((class . Item)
49 (interfaces . (side-position-interface
52 accidental-suggestion-interface
53 self-alignment-interface
59 (positioning-done . ,Accidental_placement::calc_positioning_done)
60 (X-extent . ,Axis_group_interface::width)
62 ;; this is quite small, but it is very ugly to have
63 ;; accs closer to the previous note than to the next one.
64 (right-padding . 0.15)
65 (meta . ((class . Item)
66 (interfaces . (accidental-placement-interface))))))
71 (X-extent . ,Axis_group_interface::width)
72 (X-extent . ,Axis_group_interface::height)
75 (clef . (extra-space . 0.5))
76 (key-signature . (extra-space . 0.0))
77 (staff-bar . (extra-space . 0.0))
78 (time-signature . (extra-space . 0.0))
79 (first-note . (fixed-space . 0.0))))
81 (break-align-symbol . ambitus)
82 (break-visibility . ,begin-of-line-visible)
83 (meta . ((class . Item)
84 (interfaces . (axis-group-interface
85 break-aligned-interface
86 ambitus-interface))))))
91 (stencil . ,Ambitus::print)
95 (X-offset-callbacks . (,Self_alignment_interface::centered_on_parent))
97 (meta . ((class . Item)
98 (interfaces . (ambitus-interface
99 staff-symbol-referencer-interface
103 (font-family . music)
105 (X-offset-callbacks . (,Side_position_interface::aligned_side))
107 (cautionary-style . parentheses)
109 (stencil . ,Accidental_interface::print)
110 (after-line-breaking . ,Accidental_interface::after_line_breaking)
112 (meta . ((class . Item)
113 (interfaces . (item-interface
115 break-aligned-interface
116 side-position-interface
123 (stencil . ,Note_head::print)
124 (glyph-name . ,note-head::calc-glyph-name)
126 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
127 (meta . ((class . Item)
128 (interfaces . (font-interface
131 staff-symbol-referencer-interface
132 rhythmic-head-interface
133 ledgered-interface))))))
138 (X-extent . ,Arpeggio::width)
139 (stencil . ,Arpeggio::print)
141 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
142 (X-offset-callbacks . (,Side_position_interface::aligned_side))
145 (staff-position . 0.0)
146 (meta . ((class . Item)
147 (interfaces . (arpeggio-interface
148 staff-symbol-referencer-interface
149 side-position-interface
154 (break-align-symbol . staff-bar)
157 (break-visibility . ,all-visible)
160 (stencil . ,Bar_line::print)
161 (glyph-name . ,bar-line::calc-glyph-name)
162 (bar-size . ,Bar_line::calc_bar_size)
165 (time-signature . (extra-space . 0.75))
166 (custos . (minimum-space . 2.0))
167 (clef . (minimum-space . 1.0))
168 (key-signature . (extra-space . 1.0))
169 (key-cancellation . (extra-space . 1.0))
170 (first-note . (fixed-space . 1.3))
171 (next-note . (semi-fixed-space . 1.3))
172 (right-edge . (extra-space . 0.0))))
175 ;; Ross. page 151 lists other values, we opt for a leaner look
178 ;; kern should scale with linethickness too.
181 (hair-thickness . 1.9)
182 (thick-thickness . 6.0)
183 (meta . ((class . Item)
184 (interfaces . (bar-line-interface
185 break-aligned-interface
191 (stencil . ,Text_interface::print)
194 (break-visibility . ,begin-of-line-visible)
197 (font-family . roman)
199 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
200 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
201 (self-alignment-X . 1)
205 (interfaces . (side-position-interface
207 self-alignment-interface
209 break-aligned-interface))))
215 (stencil . ,Text_interface::print)
217 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
219 (font-family . number)
221 ;; We must do this, other BFs in
222 ;; layout16 become too small.
225 (meta . ((class . Item)
226 (interfaces . (text-interface
227 rhythmic-grob-interface
228 bass-figure-interface
229 self-alignment-interface
235 (stencil . ,Text_interface::print)
237 (meta . ((class . Item)
238 (interfaces . (text-interface
239 rhythmic-grob-interface
240 bass-figure-interface
245 (stencil . ,Enclosing_bracket::print)
247 (edge-height . (0.2 . 0.2))
248 (meta . ((class . Item)
249 (interfaces . (enclosing-bracket-interface)) ))
251 (BassFigureContinuation
254 (stencil . ,Figured_bass_continuation::print)
256 (Y-offset-callbacks . (,Figured_bass_continuation::center_on_figures))
257 (meta . ((class . Spanner)
258 (interfaces . (figured-bass-continuation-interface))
264 (Y-extent . ,Axis_group_interface::height)
266 (meta . ((class . Spanner)
267 (interfaces . (axis-group-interface
273 (threshold . (2 . 1000))
275 (positioning-done . ,Align_interface::calc_positioning_done)
276 (Y-extent . ,Axis_group_interface::height)
279 (meta . ((class . Spanner)
280 (interfaces . (align-interface
281 axis-group-interface))))))
285 ;; todo: clean this up a bit: the list is getting
288 (position-callbacks . (,Beam::least_squares
291 ,Beam::shift_region_to_valid
294 (positions . ,Beam::calc_positions)
295 (direction . ,Beam::calc_direction)
296 (stencil . ,Beam::print)
299 ;; TODO: should be in SLT.
300 (thickness . 0.48) ; in staff-space
301 (neutral-direction . -1)
303 ;; Whe have some unreferenced problems here.
305 ;; If we shorten beamed stems less than normal stems (1 staffspace),
306 ;; or high order less than 8th beams, patterns like
307 ;; c''4 [c''8 c''] c''4 [c''16 c]
308 ;; are ugly (different stem lengths).
310 ;; But if we shorten 16th beams as much as 8th beams, a single
311 ;; forced 16th beam looks *very* short.
313 ;; We choose to shorten 8th beams the same as single stems,
314 ;; and high order beams less than 8th beams, so that all
315 ;; isolated shortened beams look nice and a bit shortened,
316 ;; sadly possibly breaking patterns with high order beams.
317 (beamed-stem-shorten . (1.0 0.5 0.25))
319 (auto-knee-gap . 5.5)
321 ;; only for debugging.
322 (font-family . roman)
323 (meta . ((class . Spanner)
324 (interfaces . (staff-symbol-referencer-interface
332 (positioning-done . ,Break_align_interface::calc_positioning_done)
333 (X-extent . ,Axis_group_interface::width)
335 (break-align-orders . ;; end of line
357 time-signature custos)
371 (meta . ((class . Item)
372 (interfaces . (break-alignment-interface
373 axis-group-interface))))))
379 (X-extent . ,Axis_group_interface::width)
381 (meta . ((class . Item)
382 (interfaces . (break-aligned-interface
383 axis-group-interface))))))
387 (break-align-symbol . breathing-sign)
390 (ambitus . (extra-space . 2.0))
391 (custos . (minimum-space . 1.0))
392 (key-signature . (minimum-space . 1.5))
393 (staff-bar . (minimum-space . 1.5))
394 (clef . (minimum-space . 2.0))
395 (first-note . (fixed-space . 1.0)) ;huh?
396 (right-edge . (extra-space . 0.1))))
398 (stencil . ,Text_interface::print)
400 (text . ,(make-musicglyph-markup "scripts.rcomma"))
401 (Y-offset-callbacks . (,Breathing_sign::offset_callback))
402 (break-visibility . ,begin-of-line-invisible)
403 (meta . ((class . Item)
404 (interfaces . (break-aligned-interface
405 breathing-sign-interface
412 (stencil . ,Clef::print)
413 (glyph-name . ,Clef::calc_glyph_name)
416 (font-family . music)
417 (break-align-symbol . clef)
418 (break-visibility . ,begin-of-line-visible)
419 (space-alist . ((ambitus . (extra-space . 2.0))
420 (staff-bar . (extra-space . 0.7))
421 (key-cancellation . (minimum-space . 4.0))
422 (key-signature . (minimum-space . 4.0))
423 (time-signature . (minimum-space . 4.2))
424 (first-note . (minimum-fixed-space . 5.0))
425 (next-note . (extra-space . 0.5))
426 (right-edge . (extra-space . 0.5))))
427 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
428 (meta . ((class . Item)
429 (interfaces . (clef-interface
430 staff-symbol-referencer-interface
432 break-aligned-interface))))))
434 (ClusterSpannerBeacon
437 (Y-extent . ,Cluster_beacon::height)
439 (meta . ((class . Item)
440 (interfaces . (cluster-beacon-interface))))))
445 (springs-and-rods . ,Spanner::set_spacing_rods)
446 (stencil . ,Cluster::print)
449 (minimum-length . 0.0)
452 (meta . ((class . Spanner)
453 (interfaces . (cluster-interface))))))
458 (stencil . ,Text_interface::print)
459 (after-line-breaking . ,Chord_name::after_line_breaking)
464 (meta . ((class . Item)
465 (interfaces . (font-interface
466 rhythmic-grob-interface
474 (stencil . ,Text_interface::print)
476 (no-spacing-rods . #t)
477 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
478 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
481 (staff-padding . 0.5)
482 (script-priority . 200)
483 ;; todo: add X self alignment?
486 (meta . ((class . Item)
487 (interfaces . (text-script-interface
489 side-position-interface
494 (break-align-symbol . custos)
497 (stencil . ,Custos::print)
499 (break-visibility . ,end-of-line-visible)
501 (neutral-direction . -1)
502 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
504 (first-note . (minimum-fixed-space . 0.0))
505 (right-edge . (extra-space . 0.1))))
506 (meta . ((class . Item)
509 staff-symbol-referencer-interface
511 break-aligned-interface))))))
518 (positioning-done . ,Dot_column::calc_positioning_done)
519 (X-extent . ,Axis_group_interface::width)
521 (X-offset-callbacks . (,Dot_column::side_position))
522 (meta . ((class . Item)
523 (interfaces . (dot-column-interface
524 axis-group-interface))))))
529 (stencil . ,Dots::print)
532 (meta . ((class . Item)
533 (interfaces . (font-interface
534 staff-symbol-referencer-interface
540 (stencil . ,Percent_repeat_item_interface::double_percent)
544 (font-encoding . fetaMusic)
547 (break-align-symbol . staff-bar)
548 (break-visibility . ,begin-of-line-invisible)
549 (meta . ((class . Item)
550 (interfaces . (font-interface
551 break-aligned-interface
552 percent-repeat-interface))))))
554 (DoublePercentRepeatCounter
557 (stencil . ,Text_interface::print)
559 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
560 ,Self_alignment_interface::centered_on_other_axis_parent))
561 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
562 (font-encoding . fetaNumber)
563 (self-alignment-X . 0)
567 (staff-padding . 0.25)
568 (meta . ((class . Item)
569 (interfaces . (side-position-interface
570 self-alignment-interface
571 percent-repeat-interface
577 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
578 (staff-padding . 0.1)
580 (avoid-slur . outside)
582 (minimum-space . 1.2)
585 (Y-extent . ,Axis_group_interface::height)
586 (X-extent . ,Axis_group_interface::width)
589 (meta . ((class . Spanner)
590 (interfaces . (axis-group-interface
592 dynamic-line-spanner-interface
593 side-position-interface))))))
600 (stencil . ,Text_interface::print)
601 (direction . ,Script_interface::calc_direction)
603 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
604 (self-alignment-X . 0)
605 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
606 (self-alignment-Y . 0)
608 (font-encoding . fetaDynamic)
609 (font-shape . italic)
610 (no-spacing-rods . #t)
611 (script-priority . 100)
612 (meta . ((class . Item)
613 (interfaces . (font-interface
615 self-alignment-interface
617 script-interface))))))
622 (stencil . ,Dynamic_text_spanner::print)
624 ;; rather ugh with NCSB
625 ;; (font-series . bold)
626 (font-shape . italic)
627 (style . dashed-line)
629 ;; need to blend with dynamic texts.
631 (bound-padding . 0.75)
632 (dash-fraction . 0.2)
634 (meta . ((class . Spanner)
635 (interfaces . (font-interface
638 dynamic-text-spanner-interface
639 spanner-interface))))))
644 ;; sync with TextScript (?)
647 (avoid-slur . around)
649 (staff-padding . 0.5)
650 (self-alignment-X . 0)
651 (self-alignment-Y . 0)
652 (script-priority . 100)
654 (stencil . ,Text_interface::print)
655 (direction . ,Script_interface::calc_direction)
657 (font-encoding . fetaNumber)
658 (font-size . -5) ; don't overlap when next to heads.
659 (meta . ((class . Item)
660 (interfaces . (finger-interface
662 text-script-interface
664 side-position-interface
665 self-alignment-interface
671 (zigzag-width . 0.75)
676 (stencil . ,Line_spanner::print)
677 (after-line-breaking . ,Line_spanner::after_line_breaking)
680 (meta . ((class . Spanner)
681 (interfaces . (line-interface
682 line-spanner-interface))))))
688 (meta . ((class . Item)
689 (interfaces . (grid-point-interface))))))
694 (X-extent . ,Grid_line_interface::width)
695 (stencil . ,Grid_line_interface::print)
697 (self-alignment-X . ,CENTER)
698 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
699 ,Self_alignment_interface::centered_on_parent))
701 (meta . ((class . Item)
702 (interfaces . (self-alignment-interface
703 grid-line-interface))))))
709 (stencil . ,Hairpin::print)
710 (springs-and-rods . ,Spanner::set_spacing_rods)
711 (after-line-breaking . ,Hairpin::after_line_breaking)
715 (minimum-length . 2.0)
716 (bound-padding . 1.0)
717 (self-alignment-Y . 0)
718 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
719 (meta . ((class . Spanner)
720 (interfaces . (hairpin-interface
722 self-alignment-interface
724 spanner-interface))))))
730 (stencil . ,Horizontal_bracket::print)
732 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
734 (staff-padding . 0.2)
736 (bracket-flare . (0.5 . 0.5))
737 (meta . ((class . Spanner)
738 (interfaces . (horizontal-bracket-interface
739 side-position-interface
741 spanner-interface))))))
745 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self
746 ,Side_position_interface::aligned_on_support_refpoints))
747 ;; This direction is for aligned_on_support_refpoints
751 (left-edge . (extra-space . 1.0))))
753 (self-alignment-Y . 0)
755 (stencil . ,Text_interface::print)
757 (break-align-symbol . instrument-name)
758 (break-visibility . ,begin-of-line-visible)
760 (meta . ((class . Item)
761 (interfaces . (font-interface
762 self-alignment-interface
763 side-position-interface
765 break-aligned-interface))))))
770 (stencil . ,Key_signature_interface::print)
773 (time-signature . (extra-space . 1.25))
774 (staff-bar . (extra-space . 0.6))
775 (key-signature . (extra-space . 0.5))
776 (right-edge . (extra-space . 0.5))
777 (first-note . (fixed-space . 2.5))))
778 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
779 (break-align-symbol . key-cancellation)
780 (break-visibility . ,begin-of-line-invisible)
783 (meta . ((class . Item)
784 (interfaces . (key-signature-interface
786 break-aligned-interface))))))
790 (stencil . ,Key_signature_interface::print)
793 (time-signature . (extra-space . 1.25))
794 (staff-bar . (extra-space . 1.1))
795 (right-edge . (extra-space . 0.5))
796 (first-note . (fixed-space . 2.5))))
797 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
798 (break-align-symbol . key-signature)
799 (break-visibility . ,begin-of-line-visible)
802 (meta . ((class . Item)
803 (interfaces . (key-signature-interface
805 break-aligned-interface))))))
809 (stencil . ,Tie::print)
810 (control-points . ,Laissez_vibrer_tie::calc_control_points)
811 (direction . ,Laissez_vibrer_tie::calc_direction)
813 (details . ((ratio . 0.333)
814 (height-limit . 1.0)))
816 (meta . ((class . Item)
817 (interfaces . (laissez-vibrer-tie-interface))
821 (LaissezVibrerTieColumn
826 (positioning-done . ,Laissez_vibrer_tie_column::calc_positioning_done)
828 (meta . ((class . Item)
829 (interfaces . (laissez-vibrer-tie-column-interface))
836 (springs-and-rods . ,Ledger_line_spanner::set_spacing_rods)
838 (stencil . ,Ledger_line_spanner::print)
842 (minimum-length-fraction . 0.25)
843 (length-fraction . 0.25)
845 (meta . ((class . Spanner)
846 (interfaces . (ledger-line-interface))))))
850 (break-align-symbol . left-edge)
853 (break-visibility . ,center-invisible)
855 (custos . (extra-space . 0.0))
856 (ambitus . (extra-space . 2.0))
857 (time-signature . (extra-space . 1.0))
858 (staff-bar . (extra-space . 0.0))
859 (breathing-sign . (minimum-space . 0.0))
860 (clef . (extra-space . 0.8))
861 (first-note . (fixed-space . 2.0))
862 (right-edge . (extra-space . 0.0))
863 (key-signature . (extra-space . 0.0))
864 (key-cancellation . (extra-space . 0.0))
866 (meta . ((class . Item)
867 (interfaces . (break-aligned-interface))))))
871 ;; ugh. A ligature bracket is totally different from
874 (direction . ,Tuplet_bracket::calc_direction)
875 (positions . ,Tuplet_bracket::calc_positions)
876 (stencil . ,Tuplet_bracket::print)
882 (edge-height . (0.7 . 0.7))
883 (shorten-pair . (-0.2 . -0.2))
884 (meta . ((class . Spanner)
885 (interfaces . (tuplet-bracket-interface
894 (minimum-length . 0.3)
896 ; (springs-and-rods . ,Hyphen_spanner::set_spacing_rods)
898 (stencil . ,Hyphen_spanner::print)
901 (meta . ((class . Spanner)
902 (interfaces . (lyric-interface
903 lyric-hyphen-interface
904 spanner-interface))))))
909 (stencil . ,Lyric_extender::print)
911 (thickness . 0.8) ; linethickness
912 (minimum-length . 1.5)
914 (meta . ((class . Spanner)
915 (interfaces . (lyric-interface
916 lyric-extender-interface))))))
921 (stencil . ,Text_interface::print)
923 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_parent))
924 (self-alignment-X . 0)
926 (font-series . bold-narrow)
928 (meta . ((class . Item)
929 (interfaces . (rhythmic-grob-interface
930 lyric-syllable-interface
931 self-alignment-interface
939 (stencil . ,Mensural_ligature::print)
941 (meta . ((class . Spanner)
942 (interfaces . (mensural-ligature-interface
948 (stencil . ,Text_interface::print)
950 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
953 (meta . ((class . Item)
954 (interfaces . (text-interface
955 side-position-interface
957 metronome-mark-interface))))))
961 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
963 (stencil . ,Measure_grouping::print)
970 (meta . ((class . Spanner)
971 (interfaces . (side-position-interface
972 measure-grouping-interface))))))
977 (stencil . ,Multi_measure_rest::print)
979 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
982 (thick-thickness . 6.6)
983 (hair-thickness . 2.0)
985 (meta . ((class . Spanner)
986 (interfaces . (multi-measure-rest-interface
987 multi-measure-interface
990 staff-symbol-referencer-interface))))))
993 (MultiMeasureRestNumber
995 (springs-and-rods . ,Multi_measure_rest::set_spacing_rods)
996 (stencil . ,Text_interface::print)
997 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
998 ,Self_alignment_interface::centered_on_other_axis_parent))
999 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1000 (self-alignment-X . 0)
1003 (staff-padding . 0.4)
1004 (font-encoding . fetaNumber)
1005 (meta . ((class . Spanner)
1006 (interfaces . (side-position-interface
1007 multi-measure-interface
1008 self-alignment-interface
1014 (MultiMeasureRestText
1017 (stencil . ,Text_interface::print)
1019 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
1020 ,Self_alignment_interface::centered_on_other_axis_parent))
1021 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1022 (self-alignment-X . 0)
1025 (staff-padding . 0.25)
1026 (meta . ((class . Spanner)
1027 (interfaces . (side-position-interface
1028 multi-measure-interface
1029 self-alignment-interface
1031 text-interface))))))
1037 (X-extent . ,Axis_group_interface::width)
1038 (Y-extent . ,Axis_group_interface::height)
1039 (positioning-done . ,Note_collision_interface::calc_positioning_done)
1041 (meta . ((class . Item)
1042 (interfaces . (note-collision-interface
1043 axis-group-interface))))))
1048 (X-extent . ,Axis_group_interface::width)
1049 (Y-extent . ,Axis_group_interface::height)
1051 (meta . ((class . Item)
1052 (interfaces . (axis-group-interface
1053 note-column-interface))))))
1058 (stencil . ,Note_head::print)
1059 (stem-attachment . ,Note_head::calc_stem_attachment)
1060 (glyph-name . ,note-head::calc-glyph-name)
1061 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
1062 (X-offset-callbacks . (,Note_head::stem_x_shift))
1063 (meta . ((class . Item)
1064 (interfaces . (rhythmic-grob-interface
1065 rhythmic-head-interface
1069 staff-symbol-referencer-interface))))))
1073 (stem-spacing-correction . 0.5)
1074 (same-direction-correction . 0.25)
1075 ;; Changed this from 0.75.
1076 ;; If you ever change this back, please document! --hwn
1077 (knee-spacing-correction . 1.0)
1079 (meta . ((class . Item)
1080 (interfaces . (spacing-interface
1081 note-spacing-interface))))))
1086 (stencil . ,Text_interface::print)
1088 (meta . ((class . Item)
1089 (interfaces . (note-name-interface
1091 font-interface))))))
1095 (self-alignment-X . 0)
1096 (break-visibility . ,begin-of-line-visible)
1097 (X-offset-callbacks . (,Self_alignment_interface::centered_on_parent
1098 ,Self_alignment_interface::aligned_on_self))
1099 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1101 (stencil . ,Text_interface::print)
1104 ;; no Y dimensions, because of lyrics under tenor clef.
1105 (Y-extent . (0 . 0))
1106 (font-shape . italic)
1108 (staff-padding . 0.2)
1110 (meta . ((class . Item)
1111 (interfaces . (text-interface
1112 self-alignment-interface
1113 side-position-interface
1114 font-interface))))))
1118 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1120 (stencil . ,Ottava_bracket::print)
1122 (font-shape . italic)
1123 (shorten-pair . (0.0 . -0.6))
1124 (staff-padding . 1.0)
1126 (minimum-length . 1.0)
1127 (dash-fraction . 0.3)
1128 (edge-height . (0 . 1.2))
1130 (meta . ((class . Spanner)
1131 (interfaces . (ottava-bracket-interface
1132 horizontal-bracket-interface
1134 side-position-interface
1136 text-interface))))))
1142 (before-line-breaking . ,Paper_column::before_line_breaking)
1143 ;; (stencil . ,Paper_column::print)
1144 (X-extent . ,Axis_group_interface::width)
1148 ;; (font-size . -6) (font-name . "sans") (Y-extent . #f)
1149 (meta . ((class . Paper_column)
1150 (interfaces . (paper-column-interface
1151 axis-group-interface
1152 spaceable-grob-interface))))))
1155 . ((slur-details . ,default-slur-details)
1157 (control-points . ,Slur::calc_control_points)
1158 (direction . ,Slur::calc_direction)
1159 (springs-and-rods . ,Spanner::set_spacing_rods)
1160 (Y-extent . ,Slur::height)
1161 (stencil . ,Slur::print)
1165 (minimum-length . 1.5)
1166 (height-limit . 2.0)
1168 (meta . ((class . Spanner)
1169 (interfaces . (slur-interface))))))
1171 (NonMusicalPaperColumn
1175 (before-line-breaking . ,Paper_column::before_line_breaking)
1176 (X-extent . ,Axis_group_interface::width)
1177 ;; (stencil . ,Paper_column::print)
1181 ;; debugging stuff: print column number.
1182 ;; (font-size . -6) (font-name . "sans") (Y-extent . #f)
1184 (meta . ((class . Paper_column)
1185 (interfaces . (paper-column-interface
1186 axis-group-interface
1187 spaceable-grob-interface))))))
1192 (springs-and-rods . ,Multi_measure_rest::set_spacing_rods)
1193 (stencil . ,Multi_measure_rest::percent)
1197 (font-encoding . fetaMusic)
1198 (meta . ((class . Spanner)
1199 (interfaces . (multi-measure-rest-interface
1201 percent-repeat-interface))))))
1202 (PercentRepeatCounter
1205 (stencil . ,Text_interface::print)
1207 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
1208 ,Self_alignment_interface::centered_on_other_axis_parent))
1209 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1210 (self-alignment-X . 0)
1213 (staff-padding . 0.25)
1215 (font-encoding . fetaNumber)
1216 (meta . ((class . Spanner)
1217 (interfaces . (side-position-interface
1218 self-alignment-interface
1219 percent-repeat-interface
1221 text-interface))))))
1223 ;; an example of a text spanner
1227 (stencil . ,Piano_pedal_bracket::print)
1230 (bound-padding . 1.0)
1232 (bracket-flare . (0.5 . 0.5))
1233 (edge-height . (1.0 . 1.0))
1234 (shorten-pair . (0.0 . 0.0))
1236 (meta . ((class . Spanner)
1237 (interfaces . (line-interface
1238 piano-pedal-interface
1239 piano-pedal-bracket-interface))))))
1244 (stencil . ,Text_interface::print)
1246 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1247 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1249 (after-line-breaking . ,shift-right-at-line-begin)
1251 (self-alignment-X . 0)
1256 (break-visibility . ,end-of-line-invisible)
1258 (meta . ((class . Item)
1259 (interfaces . (text-interface
1260 side-position-interface
1263 self-alignment-interface))))))
1265 (RemoveEmptyVerticalGroup
1267 (Y-offset-callbacks . (,Hara_kiri_group_spanner::force_hara_kiri_callback))
1269 (Y-extent . ,Hara_kiri_group_spanner::y_extent)
1272 (meta . ((class . Spanner)
1273 (interfaces . (axis-group-interface
1274 vertically-spaceable-interface
1275 hara-kiri-group-interface
1276 spanner-interface))))))
1281 (stencil . ,Percent_repeat_item_interface::beat_slash)
1285 (meta . ((class . Item)
1286 (interfaces . (percent-repeat-interface))))))
1290 (stencil . ,Rest::print)
1291 (X-extent . ,Rest::width)
1292 (Y-extent . ,Rest::height)
1294 (Y-offset-callbacks . (
1295 ,Staff_symbol_referencer::callback
1296 ,Rest::polyphonic_offset_callback
1297 ,Rest::y_offset_callback
1299 (minimum-distance . 0.25)
1300 (meta . ((class . Item)
1301 (interfaces . (font-interface
1302 rhythmic-head-interface
1303 rhythmic-grob-interface
1304 staff-symbol-referencer-interface
1305 rest-interface))))))
1309 (minimum-distance . 0.75)
1310 (positioning-done . ,Rest_collision::calc_positioning_done)
1312 (meta . ((class . Item)
1313 (interfaces . (rest-collision-interface))))))
1317 ;; don't set direction here: it breaks staccato.
1319 ;; This value is sensitive: if too large, staccato dots will move a
1322 (staff-padding . 0.25)
1323 ;; (script-priority . 0) priorities for scripts, see script.scm
1324 (X-offset-callbacks . (,Self_alignment_interface::centered_on_parent))
1326 (stencil . ,Script_interface::print)
1327 (direction . ,Script_interface::calc_direction)
1329 (font-encoding . fetaMusic)
1330 (meta . ((class . Item)
1331 (interfaces . (script-interface
1332 side-position-interface
1333 font-interface))))))
1338 (before-line-breaking . ,Script_column::before_line_breaking)
1340 (meta . ((class . Item)
1341 (interfaces . (script-column-interface))))))
1347 (meta . ((class . Item)
1348 (interfaces . (spacing-interface
1349 separation-item-interface))))))
1351 (SeparatingGroupSpanner
1354 (springs-and-rods . ,Separating_group_spanner::set_spacing_rods)
1356 (meta . ((class . Spanner)
1357 (interfaces . (only-prebreak-interface
1359 separation-spanner-interface))))))
1362 . ((slur-details . ,default-slur-details)
1364 (control-points . ,Slur::calc_control_points)
1365 (direction . ,Slur::calc_direction)
1366 (springs-and-rods . ,Spanner::set_spacing_rods)
1367 (Y-extent . ,Slur::height)
1368 (stencil . ,Slur::print)
1371 (minimum-length . 1.5)
1373 (height-limit . 2.0)
1375 (meta . ((class . Spanner)
1376 (interfaces . (slur-interface))))))
1381 (springs-and-rods . ,Spacing_spanner::set_springs)
1383 (grace-space-factor . 0.6)
1384 (shortest-duration-space . 2.0)
1385 (spacing-increment . 1.2)
1386 (base-shortest-duration . ,(ly:make-moment 3 16))
1387 (meta . ((class . Spanner)
1388 (interfaces . (spacing-interface
1389 spacing-spanner-interface))))))
1393 (break-align-symbol . staff-bar)
1398 (stencil . ,Span_bar::print)
1399 (bar-size . ,Span_bar::calc_bar_size)
1400 (X-extent . ,Span_bar::width)
1401 (glyph-name . ,Span_bar::calc_glyph_name)
1402 (before-line-breaking . ,Span_bar::before_line_breaking)
1407 ;; Ross. page 151 lists other values, we opt for a leaner look
1411 (hair-thickness . 1.6)
1412 (thick-thickness . 6.0)
1413 (meta . ((class . Item)
1414 (interfaces . (span-bar-interface
1416 bar-line-interface))))))
1420 (stencil . ,Text_interface::print)
1422 (font-series . bold)
1424 (X-offset-callbacks . (,Side_position_interface::aligned_side))
1426 (meta . ((class . Item)
1427 (interfaces . (side-position-interface
1428 stanza-number-interface
1430 font-interface))))))
1435 (stencil . ,print-circled-text-callback)
1438 (staff-padding . 0.5)
1439 (self-alignment-X . 0)
1440 (self-alignment-Y . 0)
1441 (script-priority . 100)
1442 (font-encoding . fetaNumber)
1443 (font-size . -5) ; don't overlap when next to heads.
1444 (meta . ((class . Item)
1445 (interfaces . (string-number-interface
1447 text-script-interface
1449 side-position-interface
1450 self-alignment-interface
1451 item-interface))))))
1456 (stem-spacing-correction . 0.4)
1457 (meta . ((class . Item)
1458 (interfaces . (spacing-interface
1459 staff-spacing-interface))))))
1464 (stencil . ,Text_interface::print)
1467 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1468 (no-spacing-rods . #t)
1469 (padding . 0.0) ;; padding relative to SostenutoPedalLineSpanner
1470 (font-shape . italic)
1471 (self-alignment-X . 0)
1472 (meta . ((class . Item)
1473 (interfaces . (text-interface
1474 self-alignment-interface
1475 font-interface))))))
1477 (SostenutoPedalLineSpanner
1481 (X-extent . ,Axis_group_interface::height)
1483 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1486 (minimum-space . 1.0)
1488 (meta . ((class . Spanner)
1489 (interfaces . (piano-pedal-interface
1490 axis-group-interface
1491 side-position-interface))))))
1496 (stencil . ,Staff_symbol::print)
1499 (ledger-line-thickness . (1.0 . 0.1))
1501 (meta . ((class . Spanner)
1502 (interfaces . (staff-symbol-interface))))))
1506 (direction . ,Stem::calc_direction)
1507 (stem-end-position . ,Stem::calc_stem_end_position)
1508 (stem-info . ,Stem::calc_stem_info)
1509 (positioning-done . ,Stem::calc_positioning_done)
1510 (stencil . ,Stem::print)
1511 (X-extent . ,Stem::width)
1512 (Y-extent . ,Stem::height)
1513 (length . ,Stem::calc_length)
1519 ;; 3.5 (or 3 measured from note head) is standard length
1520 ;; 32nd, 64th flagged stems should be longer
1521 (lengths . (3.5 3.5 3.5 4.5 5.0))
1523 ;; FIXME. 3.5 yields too long beams (according to Ross and
1524 ;; looking at Baerenreiter examples) for a number of common
1525 ;; boundary cases. Subtracting half a beam thickness fixes
1526 ;; this, but the bug may well be somewhere else.
1528 ;; FIXME this should come from 'lengths
1529 (beamed-lengths . (3.26 3.5 3.6))
1531 ;; The 'normal' minima
1532 (beamed-minimum-free-lengths . (1.83 1.5 1.25))
1533 ;(beamed-minimum-free-lengths . (2.0 1.83 1.25))
1535 ;; The 'extreme case' minima
1536 (beamed-extreme-minimum-free-lengths . (2.0 1.25))
1538 ;; Stems in unnatural (forced) direction should be shortened by
1539 ;; one staff space, according to [Roush & Gourlay].
1540 ;; Flagged stems we shorten only half a staff space.
1541 (stem-shorten . (1.0 0.5))
1546 ;; default stem direction for note on middle line
1547 (neutral-direction . -1)
1549 ;; We use the normal minima as minimum for the ideal lengths,
1550 ;; and the extreme minima as abolute minimum length.
1552 (X-offset-callbacks . (,Stem::offset_callback))
1553 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
1554 (meta . ((class . Item)
1555 (interfaces . (stem-interface
1556 font-interface))))))
1560 (Y-extent . ,Stem_tremolo::height)
1561 (stencil . ,Stem_tremolo::print)
1563 (beam-width . 1.6) ; staff-space
1564 (beam-thickness . 0.48) ; staff-space
1565 (meta . ((class . Item)
1566 (interfaces . (stem-tremolo-interface))))))
1570 (no-spacing-rods . #t)
1571 (stencil . ,Sustain_pedal::print)
1572 (self-alignment-X . 0)
1574 (padding . 0.0) ;; padding relative to SustainPedalLineSpanner
1575 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1576 (meta . ((class . Item)
1577 (interfaces . (piano-pedal-interface
1578 text-spanner-interface
1580 self-alignment-interface
1581 font-interface))))))
1583 (SustainPedalLineSpanner
1586 (X-extent . ,Axis_group_interface::height)
1587 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1589 (staff-padding . 1.2)
1590 (minimum-space . 1.0)
1592 (meta . ((class . Spanner)
1593 (interfaces . (piano-pedal-interface
1594 axis-group-interface
1595 side-position-interface))))))
1600 (X-extent . ,Axis_group_interface::width)
1601 (Y-extent . ,Axis_group_interface::height)
1602 (meta . ((class . System)
1603 (interfaces . (system-interface
1604 axis-group-interface))))))
1609 (stencil . ,System_start_delimiter::print)
1610 (collapse-height . 5.0)
1611 (font-encoding . fetaBraces)
1613 (meta . ((class . Spanner)
1614 (interfaces . (system-start-delimiter-interface
1615 font-interface))))))
1620 (X-offset-callbacks . (,(lambda (g a) -0.8)))
1621 (stencil . ,System_start_delimiter::print)
1623 (collapse-height . 5.0)
1625 (meta . ((class . Spanner)
1626 (interfaces . (font-interface
1627 system-start-delimiter-interface))))))
1632 (glyph . "bar-line")
1634 (stencil . ,System_start_delimiter::print)
1635 (meta . ((class . Spanner)
1636 (interfaces . (system-start-delimiter-interface))))))
1641 (stencil . ,Text_interface::print)
1642 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
1644 (stem-attachment . (1.0 . 1.35))
1645 (font-series . bold)
1646 (meta . ((class . Item)
1648 . (rhythmic-head-interface
1651 staff-symbol-referencer-interface
1652 text-interface))))))
1656 (no-spacing-rods . #t)
1657 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1660 ;; sync with Fingering ?
1662 (staff-padding . 0.5)
1664 (stencil . ,Text_interface::print)
1665 (direction . ,Script_interface::calc_direction)
1667 (avoid-slur . around)
1668 (slur-padding . 0.5)
1669 (script-priority . 200)
1670 ;; todo: add X self alignment?
1671 (meta . ((class . Item)
1672 (interfaces . (text-script-interface
1674 side-position-interface
1675 font-interface))))))
1679 (stencil . ,Text_spanner::print)
1680 (font-shape . italic)
1681 (style . dashed-line)
1682 (staff-padding . 0.8)
1683 (dash-fraction . 0.2)
1686 (meta . ((class . Spanner)
1687 (interfaces . (text-spanner-interface
1688 side-position-interface
1689 font-interface))))))
1693 (control-points . ,Tie::calc_control_points)
1694 (direction . ,Tie::calc_direction)
1695 (stencil . ,Tie::print)
1696 (details . ((ratio . 0.333)
1697 (height-limit . 1.0)
1698 (between-length-limit . 1.0)))
1700 (meta . ((class . Spanner)
1701 (interfaces . (tie-interface))))
1706 (positioning-done . ,Tie_column::calc_positioning_done)
1707 (before-line-breaking . ,Tie_column::before_line_breaking)
1710 (meta . ((class . Spanner)
1711 (interfaces . (tie-column-interface))))))
1715 (stencil . ,Time_signature::print)
1716 (break-align-symbol . time-signature)
1717 (break-visibility . ,all-visible)
1719 (first-note . (fixed-space . 2.0))
1720 (right-edge . (extra-space . 0.5))
1721 (staff-bar . (minimum-space . 2.0))))
1724 (meta . ((class . Item)
1725 (interfaces . (time-signature-interface
1726 break-aligned-interface
1727 font-interface))))))
1731 (stencil . ,Dynamic_text_spanner::print)
1732 (edge-text . ,(cons (make-musicglyph-markup "scripts.trill")
1735 (staff-padding . 1.0)
1738 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1739 (meta . ((class . Spanner)
1740 (interfaces . (text-spanner-interface
1741 side-position-interface
1742 font-interface))))))
1744 (TrillPitchAccidental
1745 . ((X-offset-callbacks . (,Side_position_interface::aligned_side))
1749 (stencil . ,Accidental_interface::print)
1750 (meta . ((class . Item)
1751 (interfaces . (item-interface
1752 accidental-interface
1753 side-position-interface
1754 font-interface))))))
1757 . ((X-offset-callbacks . (,Side_position_interface::aligned_side))
1760 (stencil . ,parenthesize-elements)
1761 (direction . ,RIGHT)
1763 (meta . ((class . Item)
1764 (interfaces . (side-position-interface
1766 rhythmic-head-interface
1768 accidental-interface
1769 axis-group-interface))))))
1773 (stencil . ,Note_head::print)
1775 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
1777 (meta . ((class . Item)
1778 (interfaces . (item-interface
1779 rhythmic-head-interface
1781 pitched-trill-interface
1783 staff-symbol-referencer-interface))))))
1789 (edge-height . (0.7 . 0.7))
1790 (shorten-pair . (-0.2 . -0.2))
1791 (direction . ,Tuplet_bracket::calc_direction)
1792 (positions . ,Tuplet_bracket::calc_positions)
1793 (stencil . ,Tuplet_bracket::print)
1794 (font-shape . italic)
1796 (meta . ((class . Spanner)
1797 (interfaces . (text-interface
1799 tuplet-bracket-interface
1800 font-interface))))))
1804 (stencil . ,Text_interface::print)
1805 (font-shape . italic)
1806 (no-spacing-rods . #t)
1807 (self-alignment-X . 0)
1809 (padding . 0.0) ;; padding relative to UnaCordaPedalLineSpanner
1810 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1811 (meta . ((class . Item)
1812 (interfaces . (text-interface
1813 self-alignment-interface
1814 font-interface))))))
1816 (UnaCordaPedalLineSpanner
1819 (X-extent . ,Axis_group_interface::height)
1820 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1822 (staff-padding . 1.2)
1823 (minimum-space . 1.0)
1825 (meta . ((class . Spanner)
1826 (interfaces . (piano-pedal-interface
1827 axis-group-interface
1828 side-position-interface))))))
1834 (stencil . ,Vaticana_ligature::print)
1835 (meta . ((class . Spanner)
1836 (interfaces . (vaticana-ligature-interface
1837 font-interface))))))
1842 (positioning-done . ,Align_interface::calc_positioning_done)
1843 (after-line-breaking . ,Align_interface::stretch_after_break)
1844 (Y-extent . ,Axis_group_interface::height)
1845 (X-extent . ,Axis_group_interface::width)
1847 (meta . ((class . Spanner)
1848 (interfaces . (align-interface
1849 axis-group-interface))))))
1853 (Y-extent . ,Axis_group_interface::height)
1854 (X-extent . ,Axis_group_interface::width)
1855 (meta . ((class . Spanner)
1856 (interfaces . (axis-group-interface
1857 vertically-spaceable-interface))))))
1862 (Y-offset-callbacks . (,Side_position_interface::aligned_on_support_refpoints))
1864 (space-alist . ((left-edge . (extra-space . 1.0))))
1865 (break-align-symbol . instrument-name)
1866 (stencil . ,Text_interface::print)
1867 (break-align-symbol . clef)
1868 (break-visibility . ,begin-of-line-visible)
1870 (meta . ((class . Item)
1871 (interfaces . (font-interface
1872 self-alignment-interface
1873 side-position-interface
1875 break-aligned-interface))))))
1879 (stencil . ,Volta_bracket_interface::print)
1880 (after-line-breaking . ,Volta_bracket_interface::after_line_breaking)
1883 (font-encoding . fetaNumber)
1884 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1885 (thickness . 1.6) ;; linethickness
1886 (edge-height . (2.0 . 2.0)) ;; staffspace;
1889 (meta . ((class . Spanner)
1890 (interfaces . (volta-bracket-interface
1891 horizontal-bracket-interface
1894 side-position-interface
1906 (stencil . ,Line_spanner::print)
1907 (after-line-breaking . ,Line_spanner::after_line_breaking)
1908 (meta . ((class . Spanner)
1909 (interfaces . (line-spanner-interface
1915 (define (completize-grob-entry x)
1916 "Transplant assoc key into 'name entry of 'meta of X. Set interfaces for Item, Spanner etc.
1918 ;; (display (car x))
1920 (let* ((name-sym (car x))
1921 (grob-entry (cdr x))
1922 (meta-entry (cdr (assoc 'meta grob-entry)))
1923 (class (cdr (assoc 'class meta-entry)))
1925 (cdr (assoc 'interfaces meta-entry))))
1929 (set! ifaces-entry (cons 'item-interface ifaces-entry)))
1930 ((eq? 'Spanner class)
1931 (set! ifaces-entry (cons 'spanner-interface ifaces-entry)))
1932 ((eq? 'Paper_column class)
1933 (set! ifaces-entry (cons 'item-interface
1934 (cons 'paper-column-interface ifaces-entry))))
1935 ((eq? 'System class)
1936 (set! ifaces-entry (cons 'system-interface
1937 (cons 'spanner-interface ifaces-entry))))
1939 (ly:warning "Unknown class ~a" class)))
1940 (set! ifaces-entry (cons 'grob-interface ifaces-entry))
1942 (set! meta-entry (assoc-set! meta-entry 'name name-sym))
1943 (set! meta-entry (assoc-set! meta-entry 'interfaces
1945 (set! grob-entry (assoc-set! grob-entry 'meta meta-entry))
1946 (cons name-sym grob-entry)))
1948 (set! all-grob-descriptions (map completize-grob-entry all-grob-descriptions))
1950 ;; (display (map pair? all-grob-descriptions))
1952 ;; make sure that \property Foo.Bar =\turnOff doesn't complain
1955 ;; (display (car x)) (newline)
1957 (set-object-property! (car x) 'translation-type? list?)
1958 (set-object-property! (car x) 'is-grob? #t))
1959 all-grob-descriptions)
1961 (set! all-grob-descriptions (sort all-grob-descriptions alist<?))