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
35 (stencil . ,Accidental_interface::print)
36 (X-offset . ,Self_alignment_interface::centered_on_x_parent)
37 (self-X-offset . Self_alignment_interface::x_aligned_on_self)
38 (self-alignment-X . ,CENTER)
40 (cautionary-style . smaller)
41 (Y-offset . ,Side_position_interface::y_aligned_side)
42 (cautionary-style . parentheses)
44 (staff-padding . 0.25)
46 (meta . ((class . Item)
47 (interfaces . (side-position-interface
50 accidental-suggestion-interface
51 self-alignment-interface
57 (positioning-done . ,Accidental_placement::calc_positioning_done)
58 (X-extent . ,Axis_group_interface::width)
60 ;; this is quite small, but it is very ugly to have
61 ;; accs closer to the previous note than to the next one.
62 (right-padding . 0.15)
63 (meta . ((class . Item)
64 (interfaces . (accidental-placement-interface))))))
68 (X-extent . ,Axis_group_interface::width)
69 (X-extent . ,Axis_group_interface::height)
72 (clef . (extra-space . 0.5))
73 (key-signature . (extra-space . 0.0))
74 (staff-bar . (extra-space . 0.0))
75 (time-signature . (extra-space . 0.0))
76 (first-note . (fixed-space . 0.0))))
78 (break-align-symbol . ambitus)
79 (break-visibility . ,begin-of-line-visible)
80 (meta . ((class . Item)
81 (interfaces . (axis-group-interface
82 break-aligned-interface
83 ambitus-interface))))))
88 (stencil . ,Ambitus::print)
92 (X-offset . ,Self_alignment_interface::centered_on_x_parent)
94 (meta . ((class . Item)
95 (interfaces . (ambitus-interface
96 staff-symbol-referencer-interface
100 (font-family . music)
102 (X-offset . ,Side_position_interface::x_aligned_side)
104 (cautionary-style . parentheses)
106 (stencil . ,Accidental_interface::print)
107 (after-line-breaking . ,Accidental_interface::after_line_breaking)
109 (meta . ((class . Item)
110 (interfaces . (item-interface
112 break-aligned-interface
113 side-position-interface
120 (stencil . ,Note_head::print)
121 (glyph-name . ,note-head::calc-glyph-name)
123 (Y-offset . ,Staff_symbol_referencer::callback)
124 (meta . ((class . Item)
125 (interfaces . (font-interface
128 staff-symbol-referencer-interface
129 rhythmic-head-interface
130 ledgered-interface))))))
135 (X-extent . ,Arpeggio::width)
136 (stencil . ,Arpeggio::print)
138 (Y-offset . ,Staff_symbol_referencer::callback)
139 (X-offset . ,Side_position_interface::x_aligned_side)
142 (staff-position . 0.0)
143 (meta . ((class . Item)
144 (interfaces . (arpeggio-interface
145 staff-symbol-referencer-interface
146 side-position-interface
151 (break-align-symbol . staff-bar)
154 (break-visibility . ,all-visible)
157 (stencil . ,Bar_line::print)
158 (glyph-name . ,bar-line::calc-glyph-name)
159 (bar-size . ,Bar_line::calc_bar_size)
162 (time-signature . (extra-space . 0.75))
163 (custos . (minimum-space . 2.0))
164 (clef . (minimum-space . 1.0))
165 (key-signature . (extra-space . 1.0))
166 (key-cancellation . (extra-space . 1.0))
167 (first-note . (fixed-space . 1.3))
168 (next-note . (semi-fixed-space . 1.3))
169 (right-edge . (extra-space . 0.0))))
172 ;; Ross. page 151 lists other values, we opt for a leaner look
175 ;; kern should scale with linethickness too.
178 (hair-thickness . 1.9)
179 (thick-thickness . 6.0)
180 (meta . ((class . Item)
181 (interfaces . (bar-line-interface
182 break-aligned-interface
188 (stencil . ,Text_interface::print)
191 (break-visibility . ,begin-of-line-visible)
194 (font-family . roman)
196 (Y-offset . ,Side_position_interface::y_aligned_side)
197 (X-offset . ,Self_alignment_interface::x_aligned_on_self)
198 (self-alignment-X . 1)
202 (interfaces . (side-position-interface
204 self-alignment-interface
206 break-aligned-interface))))
212 (stencil . ,Text_interface::print)
214 (Y-offset . ,Self_alignment_interface::y_aligned_on_self)
216 (font-family . number)
218 ;; We must do this, other BFs in
219 ;; layout16 become too small.
222 (meta . ((class . Item)
223 (interfaces . (text-interface
224 rhythmic-grob-interface
225 bass-figure-interface
226 self-alignment-interface
232 (stencil . ,Text_interface::print)
234 (meta . ((class . Item)
235 (interfaces . (text-interface
236 rhythmic-grob-interface
237 bass-figure-interface
242 (stencil . ,Enclosing_bracket::print)
244 (edge-height . (0.2 . 0.2))
245 (meta . ((class . Item)
246 (interfaces . (enclosing-bracket-interface)) ))
248 (BassFigureContinuation
251 (stencil . ,Figured_bass_continuation::print)
253 (Y-offset . ,Figured_bass_continuation::center_on_figures)
254 (meta . ((class . Spanner)
255 (interfaces . (figured-bass-continuation-interface))
261 (Y-extent . ,Axis_group_interface::height)
263 (meta . ((class . Spanner)
264 (interfaces . (axis-group-interface
270 (threshold . (2 . 1000))
272 (positioning-done . ,Align_interface::calc_positioning_done)
273 (Y-extent . ,Axis_group_interface::height)
276 (meta . ((class . Spanner)
277 (interfaces . (align-interface
278 axis-group-interface))))))
282 ;; todo: clean this up a bit: the list is getting
286 (positions . ,(ly:make-callback-chain
287 Beam::calc_least_squares_positions
289 Beam::shift_region_to_valid
291 Beam::set_stem_lengths
293 (concaveness . ,Beam::calc_concaveness)
294 (direction . ,Beam::calc_direction)
295 (stencil . ,Beam::print)
297 ;; TODO: should be in SLT.
298 (thickness . 0.48) ; in staff-space
299 (neutral-direction . -1)
301 ;; Whe have some unreferenced problems here.
303 ;; If we shorten beamed stems less than normal stems (1 staffspace),
304 ;; or high order less than 8th beams, patterns like
305 ;; c''4 [c''8 c''] c''4 [c''16 c]
306 ;; are ugly (different stem lengths).
308 ;; But if we shorten 16th beams as much as 8th beams, a single
309 ;; forced 16th beam looks *very* short.
311 ;; We choose to shorten 8th beams the same as single stems,
312 ;; and high order beams less than 8th beams, so that all
313 ;; isolated shortened beams look nice and a bit shortened,
314 ;; sadly possibly breaking patterns with high order beams.
315 (beamed-stem-shorten . (1.0 0.5 0.25))
317 (auto-knee-gap . 5.5)
319 ;; only for debugging.
320 (font-family . roman)
321 (meta . ((class . Spanner)
322 (interfaces . (staff-symbol-referencer-interface
330 (positioning-done . ,Break_align_interface::calc_positioning_done)
331 (X-extent . ,Axis_group_interface::width)
333 (break-align-orders . ;; end of line
355 time-signature custos)
369 (meta . ((class . Item)
370 (interfaces . (break-alignment-interface
371 axis-group-interface))))))
377 (X-extent . ,Axis_group_interface::width)
379 (meta . ((class . Item)
380 (interfaces . (break-aligned-interface
381 axis-group-interface))))))
385 (break-align-symbol . breathing-sign)
388 (ambitus . (extra-space . 2.0))
389 (custos . (minimum-space . 1.0))
390 (key-signature . (minimum-space . 1.5))
391 (staff-bar . (minimum-space . 1.5))
392 (clef . (minimum-space . 2.0))
393 (first-note . (fixed-space . 1.0)) ;huh?
394 (right-edge . (extra-space . 0.1))))
396 (stencil . ,Text_interface::print)
398 (text . ,(make-musicglyph-markup "scripts.rcomma"))
399 (Y-offset . ,Breathing_sign::offset_callback)
400 (break-visibility . ,begin-of-line-invisible)
401 (meta . ((class . Item)
402 (interfaces . (break-aligned-interface
403 breathing-sign-interface
410 (stencil . ,Clef::print)
411 (glyph-name . ,Clef::calc_glyph_name)
414 (font-family . music)
415 (break-align-symbol . clef)
416 (break-visibility . ,begin-of-line-visible)
417 (space-alist . ((ambitus . (extra-space . 2.0))
418 (staff-bar . (extra-space . 0.7))
419 (key-cancellation . (minimum-space . 4.0))
420 (key-signature . (minimum-space . 4.0))
421 (time-signature . (minimum-space . 4.2))
422 (first-note . (minimum-fixed-space . 5.0))
423 (next-note . (extra-space . 0.5))
424 (right-edge . (extra-space . 0.5))))
425 (Y-offset . ,Staff_symbol_referencer::callback)
426 (meta . ((class . Item)
427 (interfaces . (clef-interface
428 staff-symbol-referencer-interface
430 break-aligned-interface))))))
432 (ClusterSpannerBeacon
435 (Y-extent . ,Cluster_beacon::height)
437 (meta . ((class . Item)
438 (interfaces . (cluster-beacon-interface))))))
443 (springs-and-rods . ,Spanner::set_spacing_rods)
444 (stencil . ,Cluster::print)
447 (minimum-length . 0.0)
450 (meta . ((class . Spanner)
451 (interfaces . (cluster-interface))))))
456 (stencil . ,Text_interface::print)
457 (after-line-breaking . ,Chord_name::after_line_breaking)
462 (meta . ((class . Item)
463 (interfaces . (font-interface
464 rhythmic-grob-interface
472 (stencil . ,Text_interface::print)
474 (no-spacing-rods . #t)
475 (Y-offset . ,Side_position_interface::y_aligned_side)
476 (self-X-offset . ,Self_alignment_interface::x_aligned_on_self)
479 (staff-padding . 0.5)
480 (script-priority . 200)
481 ;; todo: add X self alignment?
484 (meta . ((class . Item)
485 (interfaces . (text-script-interface
487 side-position-interface
492 (break-align-symbol . custos)
495 (stencil . ,Custos::print)
497 (break-visibility . ,end-of-line-visible)
499 (neutral-direction . -1)
500 (Y-offset . ,Staff_symbol_referencer::callback)
502 (first-note . (minimum-fixed-space . 0.0))
503 (right-edge . (extra-space . 0.1))))
504 (meta . ((class . Item)
507 staff-symbol-referencer-interface
509 break-aligned-interface))))))
516 (positioning-done . ,Dot_column::calc_positioning_done)
517 (X-extent . ,Axis_group_interface::width)
519 (X-offset . ,Dot_column::side_position)
520 (meta . ((class . Item)
521 (interfaces . (dot-column-interface
522 axis-group-interface))))))
527 (stencil . ,Dots::print)
530 (meta . ((class . Item)
531 (interfaces . (font-interface
532 staff-symbol-referencer-interface
538 (stencil . ,Percent_repeat_item_interface::double_percent)
542 (font-encoding . fetaMusic)
545 (break-align-symbol . staff-bar)
546 (break-visibility . ,begin-of-line-invisible)
547 (meta . ((class . Item)
548 (interfaces . (font-interface
549 break-aligned-interface
550 percent-repeat-interface))))))
552 (DoublePercentRepeatCounter
555 (stencil . ,Text_interface::print)
557 (self-X-offset . ,Self_alignment_interface::x_aligned_on_self)
558 (X-offset . ,Self_alignment_interface::centered_on_y_parent)
559 (Y-offset . ,Side_position_interface::y_aligned_side)
560 (font-encoding . fetaNumber)
561 (self-alignment-X . 0)
565 (staff-padding . 0.25)
566 (meta . ((class . Item)
567 (interfaces . (side-position-interface
568 self-alignment-interface
569 percent-repeat-interface
575 (Y-offset . ,Side_position_interface::y_aligned_side)
576 (staff-padding . 0.1)
578 (avoid-slur . outside)
580 (minimum-space . 1.2)
583 (Y-extent . ,Axis_group_interface::height)
584 (X-extent . ,Axis_group_interface::width)
587 (meta . ((class . Spanner)
588 (interfaces . (axis-group-interface
590 dynamic-line-spanner-interface
591 side-position-interface))))))
598 (stencil . ,Text_interface::print)
599 (direction . ,Script_interface::calc_direction)
601 (self-X-offset . ,Self_alignment_interface::x_aligned_on_self)
602 (self-alignment-X . 0)
603 (self-Y-offset . ,Self_alignment_interface::y_aligned_on_self)
604 (self-alignment-Y . 0)
606 (font-encoding . fetaDynamic)
607 (font-shape . italic)
608 (no-spacing-rods . #t)
609 (script-priority . 100)
610 (meta . ((class . Item)
611 (interfaces . (font-interface
613 self-alignment-interface
615 script-interface))))))
620 (stencil . ,Dynamic_text_spanner::print)
622 ;; rather ugh with NCSB
623 ;; (font-series . bold)
624 (font-shape . italic)
625 (style . dashed-line)
627 ;; need to blend with dynamic texts.
629 (bound-padding . 0.75)
630 (dash-fraction . 0.2)
632 (meta . ((class . Spanner)
633 (interfaces . (font-interface
636 dynamic-text-spanner-interface
637 spanner-interface))))))
642 ;; sync with TextScript (?)
645 (avoid-slur . around)
647 (staff-padding . 0.5)
648 (self-alignment-X . 0)
649 (self-alignment-Y . 0)
650 (script-priority . 100)
652 (stencil . ,Text_interface::print)
653 (direction . ,Script_interface::calc_direction)
655 (font-encoding . fetaNumber)
656 (font-size . -5) ; don't overlap when next to heads.
657 (meta . ((class . Item)
658 (interfaces . (finger-interface
660 text-script-interface
662 side-position-interface
663 self-alignment-interface
669 (zigzag-width . 0.75)
674 (stencil . ,Line_spanner::print)
675 (after-line-breaking . ,Line_spanner::after_line_breaking)
678 (meta . ((class . Spanner)
679 (interfaces . (line-interface
680 line-spanner-interface))))))
686 (meta . ((class . Item)
687 (interfaces . (grid-point-interface))))))
692 (X-extent . ,Grid_line_interface::width)
693 (stencil . ,Grid_line_interface::print)
695 (self-alignment-X . ,CENTER)
696 (self-X-offset . ,Self_alignment_interface::x_aligned_on_self)
697 (X-offset . ,Self_alignment_interface::centered_on_x_parent)
700 (meta . ((class . Item)
701 (interfaces . (self-alignment-interface
702 grid-line-interface))))))
708 (stencil . ,Hairpin::print)
709 (springs-and-rods . ,Spanner::set_spacing_rods)
710 (after-line-breaking . ,Hairpin::after_line_breaking)
714 (minimum-length . 2.0)
715 (bound-padding . 1.0)
716 (self-alignment-Y . 0)
717 (self-Y-offset . ,Self_alignment_interface::y_aligned_on_self)
718 (meta . ((class . Spanner)
719 (interfaces . (hairpin-interface
721 self-alignment-interface
723 spanner-interface))))))
729 (stencil . ,Horizontal_bracket::print)
731 (Y-offset . ,Side_position_interface::y_aligned_side)
733 (staff-padding . 0.2)
735 (bracket-flare . (0.5 . 0.5))
736 (meta . ((class . Spanner)
737 (interfaces . (horizontal-bracket-interface
738 side-position-interface
740 spanner-interface))))))
744 (self-Y-offset . ,Self_alignment_interface::y_aligned_on_self)
745 (Y-offset . ,Side_position_interface::y_aligned_on_support_refpoints)
746 ;; This direction is for aligned_on_support_refpoints
750 (left-edge . (extra-space . 1.0))))
752 (self-alignment-Y . 0)
754 (stencil . ,Text_interface::print)
756 (break-align-symbol . instrument-name)
757 (break-visibility . ,begin-of-line-visible)
759 (meta . ((class . Item)
760 (interfaces . (font-interface
761 self-alignment-interface
762 side-position-interface
764 break-aligned-interface))))))
769 (stencil . ,Key_signature_interface::print)
772 (time-signature . (extra-space . 1.25))
773 (staff-bar . (extra-space . 0.6))
774 (key-signature . (extra-space . 0.5))
775 (right-edge . (extra-space . 0.5))
776 (first-note . (fixed-space . 2.5))))
777 (Y-offset . ,Staff_symbol_referencer::callback)
778 (break-align-symbol . key-cancellation)
779 (break-visibility . ,begin-of-line-invisible)
782 (meta . ((class . Item)
783 (interfaces . (key-signature-interface
785 break-aligned-interface))))))
789 (stencil . ,Key_signature_interface::print)
792 (time-signature . (extra-space . 1.25))
793 (staff-bar . (extra-space . 1.1))
794 (right-edge . (extra-space . 0.5))
795 (first-note . (fixed-space . 2.5))))
796 (Y-offset . ,Staff_symbol_referencer::callback)
797 (break-align-symbol . key-signature)
798 (break-visibility . ,begin-of-line-visible)
801 (meta . ((class . Item)
802 (interfaces . (key-signature-interface
804 break-aligned-interface))))))
808 (stencil . ,Tie::print)
809 (control-points . ,Laissez_vibrer_tie::calc_control_points)
810 (direction . ,Laissez_vibrer_tie::calc_direction)
812 (details . ((ratio . 0.333)
813 (height-limit . 1.0)))
815 (meta . ((class . Item)
816 (interfaces . (laissez-vibrer-tie-interface))
820 (LaissezVibrerTieColumn
825 (positioning-done . ,Laissez_vibrer_tie_column::calc_positioning_done)
827 (meta . ((class . Item)
828 (interfaces . (laissez-vibrer-tie-column-interface))
835 (springs-and-rods . ,Ledger_line_spanner::set_spacing_rods)
837 (stencil . ,Ledger_line_spanner::print)
841 (minimum-length-fraction . 0.25)
842 (length-fraction . 0.25)
844 (meta . ((class . Spanner)
845 (interfaces . (ledger-line-interface))))))
849 (break-align-symbol . left-edge)
852 (break-visibility . ,center-invisible)
854 (custos . (extra-space . 0.0))
855 (ambitus . (extra-space . 2.0))
856 (time-signature . (extra-space . 1.0))
857 (staff-bar . (extra-space . 0.0))
858 (breathing-sign . (minimum-space . 0.0))
859 (clef . (extra-space . 0.8))
860 (first-note . (fixed-space . 2.0))
861 (right-edge . (extra-space . 0.0))
862 (key-signature . (extra-space . 0.0))
863 (key-cancellation . (extra-space . 0.0))
865 (meta . ((class . Item)
866 (interfaces . (break-aligned-interface))))))
870 ;; ugh. A ligature bracket is totally different from
873 (direction . ,Tuplet_bracket::calc_direction)
874 (positions . ,Tuplet_bracket::calc_positions)
875 (stencil . ,Tuplet_bracket::print)
881 (edge-height . (0.7 . 0.7))
882 (shorten-pair . (-0.2 . -0.2))
883 (meta . ((class . Spanner)
884 (interfaces . (tuplet-bracket-interface
893 (minimum-length . 0.3)
895 ; (springs-and-rods . ,Hyphen_spanner::set_spacing_rods)
897 (stencil . ,Hyphen_spanner::print)
900 (meta . ((class . Spanner)
901 (interfaces . (lyric-interface
902 lyric-hyphen-interface
903 spanner-interface))))))
908 (stencil . ,Lyric_extender::print)
910 (thickness . 0.8) ; linethickness
911 (minimum-length . 1.5)
913 (meta . ((class . Spanner)
914 (interfaces . (lyric-interface
915 lyric-extender-interface))))))
920 (stencil . ,Text_interface::print)
922 (X-offset . ,Self_alignment_interface::aligned_on_x_parent)
923 (self-alignment-X . 0)
925 (font-series . bold-narrow)
927 (meta . ((class . Item)
928 (interfaces . (rhythmic-grob-interface
929 lyric-syllable-interface
930 self-alignment-interface
938 (stencil . ,Mensural_ligature::print)
940 (meta . ((class . Spanner)
941 (interfaces . (mensural-ligature-interface
947 (stencil . ,Text_interface::print)
949 (Y-offset . ,Side_position_interface::y_aligned_side)
952 (meta . ((class . Item)
953 (interfaces . (text-interface
954 side-position-interface
956 metronome-mark-interface))))))
960 (Y-offset . ,Side_position_interface::y_aligned_side)
962 (stencil . ,Measure_grouping::print)
969 (meta . ((class . Spanner)
970 (interfaces . (side-position-interface
971 measure-grouping-interface))))))
976 (stencil . ,Multi_measure_rest::print)
978 (Y-offset . ,Staff_symbol_referencer::callback)
981 (thick-thickness . 6.6)
982 (hair-thickness . 2.0)
984 (meta . ((class . Spanner)
985 (interfaces . (multi-measure-rest-interface
986 multi-measure-interface
989 staff-symbol-referencer-interface))))))
992 (MultiMeasureRestNumber
994 (springs-and-rods . ,Multi_measure_rest::set_spacing_rods)
995 (stencil . ,Text_interface::print)
996 (self-X-offset . ,Self_alignment_interface::y_aligned_on_self)
997 (X-offset . ,Self_alignment_interface::centered_on_y_parent)
998 (Y-offset . ,Side_position_interface::y_aligned_side)
999 (self-alignment-X . 0)
1002 (staff-padding . 0.4)
1003 (font-encoding . fetaNumber)
1004 (meta . ((class . Spanner)
1005 (interfaces . (side-position-interface
1006 multi-measure-interface
1007 self-alignment-interface
1013 (MultiMeasureRestText
1015 (stencil . ,Text_interface::print)
1016 (X-offset . ,Self_alignment_interface::centered_on_y_parent)
1017 (self-X-offset . ,Self_alignment_interface::x_aligned_on_self)
1019 (Y-offset . ,Side_position_interface::y_aligned_side)
1020 (self-alignment-X . 0)
1023 (staff-padding . 0.25)
1024 (meta . ((class . Spanner)
1025 (interfaces . (side-position-interface
1026 multi-measure-interface
1027 self-alignment-interface
1029 text-interface))))))
1035 (X-extent . ,Axis_group_interface::width)
1036 (Y-extent . ,Axis_group_interface::height)
1037 (positioning-done . ,Note_collision_interface::calc_positioning_done)
1039 (meta . ((class . Item)
1040 (interfaces . (note-collision-interface
1041 axis-group-interface))))))
1046 (X-extent . ,Axis_group_interface::width)
1047 (Y-extent . ,Axis_group_interface::height)
1049 (meta . ((class . Item)
1050 (interfaces . (axis-group-interface
1051 note-column-interface))))))
1056 (stencil . ,Note_head::print)
1057 (stem-attachment . ,Note_head::calc_stem_attachment)
1058 (glyph-name . ,note-head::calc-glyph-name)
1059 (Y-offset . ,Staff_symbol_referencer::callback)
1060 (X-offset . ,Note_head::stem_x_shift)
1061 (meta . ((class . Item)
1062 (interfaces . (rhythmic-grob-interface
1063 rhythmic-head-interface
1067 staff-symbol-referencer-interface))))))
1071 (stem-spacing-correction . 0.5)
1072 (same-direction-correction . 0.25)
1073 ;; Changed this from 0.75.
1074 ;; If you ever change this back, please document! --hwn
1075 (knee-spacing-correction . 1.0)
1077 (meta . ((class . Item)
1078 (interfaces . (spacing-interface
1079 note-spacing-interface))))))
1084 (stencil . ,Text_interface::print)
1086 (meta . ((class . Item)
1087 (interfaces . (note-name-interface
1089 font-interface))))))
1093 (self-alignment-X . 0)
1094 (break-visibility . ,begin-of-line-visible)
1095 (X-offset . ,Self_alignment_interface::centered_on_x_parent)
1096 (self-X-offset . ,Self_alignment_interface::x_aligned_on_self)
1097 (Y-offset . ,Side_position_interface::y_aligned_side)
1099 (stencil . ,Text_interface::print)
1102 ;; no Y dimensions, because of lyrics under tenor clef.
1103 (Y-extent . (0 . 0))
1104 (font-shape . italic)
1106 (staff-padding . 0.2)
1108 (meta . ((class . Item)
1109 (interfaces . (text-interface
1110 self-alignment-interface
1111 side-position-interface
1112 font-interface))))))
1116 (Y-offset . ,Side_position_interface::y_aligned_side)
1118 (stencil . ,Ottava_bracket::print)
1120 (font-shape . italic)
1121 (shorten-pair . (0.0 . -0.6))
1122 (staff-padding . 1.0)
1124 (minimum-length . 1.0)
1125 (dash-fraction . 0.3)
1126 (edge-height . (0 . 1.2))
1128 (meta . ((class . Spanner)
1129 (interfaces . (ottava-bracket-interface
1130 horizontal-bracket-interface
1132 side-position-interface
1134 text-interface))))))
1140 (before-line-breaking . ,Paper_column::before_line_breaking)
1141 ;; (stencil . ,Paper_column::print)
1142 (X-extent . ,Axis_group_interface::width)
1146 ;; (font-size . -6) (font-name . "sans") (Y-extent . #f)
1147 (meta . ((class . Paper_column)
1148 (interfaces . (paper-column-interface
1149 axis-group-interface
1150 spaceable-grob-interface))))))
1153 . ((slur-details . ,default-slur-details)
1155 (control-points . ,Slur::calc_control_points)
1156 (direction . ,Slur::calc_direction)
1157 (springs-and-rods . ,Spanner::set_spacing_rods)
1158 (Y-extent . ,Slur::height)
1159 (stencil . ,Slur::print)
1163 (minimum-length . 1.5)
1164 (height-limit . 2.0)
1166 (meta . ((class . Spanner)
1167 (interfaces . (slur-interface))))))
1169 (NonMusicalPaperColumn
1173 (before-line-breaking . ,Paper_column::before_line_breaking)
1174 (X-extent . ,Axis_group_interface::width)
1175 ;; (stencil . ,Paper_column::print)
1179 ;; debugging stuff: print column number.
1180 ;; (font-size . -6) (font-name . "sans") (Y-extent . #f)
1182 (meta . ((class . Paper_column)
1183 (interfaces . (paper-column-interface
1184 axis-group-interface
1185 spaceable-grob-interface))))))
1190 (springs-and-rods . ,Multi_measure_rest::set_spacing_rods)
1191 (stencil . ,Multi_measure_rest::percent)
1195 (font-encoding . fetaMusic)
1196 (meta . ((class . Spanner)
1197 (interfaces . (multi-measure-rest-interface
1199 percent-repeat-interface))))))
1200 (PercentRepeatCounter
1203 (stencil . ,Text_interface::print)
1205 (self-X-offset . ,Self_alignment_interface::x_aligned_on_self)
1206 (X-offset . ,Self_alignment_interface::centered_on_y_parent)
1207 (Y-offset . ,Side_position_interface::y_aligned_side)
1208 (self-alignment-X . 0)
1211 (staff-padding . 0.25)
1213 (font-encoding . fetaNumber)
1214 (meta . ((class . Spanner)
1215 (interfaces . (side-position-interface
1216 self-alignment-interface
1217 percent-repeat-interface
1219 text-interface))))))
1221 ;; an example of a text spanner
1225 (stencil . ,Piano_pedal_bracket::print)
1228 (bound-padding . 1.0)
1230 (bracket-flare . (0.5 . 0.5))
1231 (edge-height . (1.0 . 1.0))
1232 (shorten-pair . (0.0 . 0.0))
1234 (meta . ((class . Spanner)
1235 (interfaces . (line-interface
1236 piano-pedal-interface
1237 piano-pedal-bracket-interface))))))
1242 (stencil . ,Text_interface::print)
1244 (self-X-offset . ,Self_alignment_interface::x_aligned_on_self)
1245 (Y-offset . ,Side_position_interface::y_aligned_side)
1247 (after-line-breaking . ,shift-right-at-line-begin)
1249 (self-alignment-X . 0)
1254 (break-visibility . ,end-of-line-invisible)
1256 (meta . ((class . Item)
1257 (interfaces . (text-interface
1258 side-position-interface
1261 self-alignment-interface))))))
1267 (stencil . ,Percent_repeat_item_interface::beat_slash)
1271 (meta . ((class . Item)
1272 (interfaces . (percent-repeat-interface))))))
1276 (stencil . ,Rest::print)
1277 (X-extent . ,Rest::width)
1278 (Y-extent . ,Rest::height)
1279 (Y-offset . ,Rest::y_offset_callback)
1280 (minimum-distance . 0.25)
1281 (meta . ((class . Item)
1282 (interfaces . (font-interface
1283 rhythmic-head-interface
1284 rhythmic-grob-interface
1285 staff-symbol-referencer-interface
1286 rest-interface))))))
1290 (minimum-distance . 0.75)
1291 (positioning-done . ,Rest_collision::calc_positioning_done)
1293 (meta . ((class . Item)
1294 (interfaces . (rest-collision-interface))))))
1298 ;; don't set direction here: it breaks staccato.
1300 ;; This value is sensitive: if too large, staccato dots will move a
1303 (staff-padding . 0.25)
1304 ;; (script-priority . 0) priorities for scripts, see script.scm
1305 (X-offset . ,Self_alignment_interface::centered_on_x_parent)
1307 (stencil . ,Script_interface::print)
1308 (direction . ,Script_interface::calc_direction)
1310 (font-encoding . fetaMusic)
1311 (meta . ((class . Item)
1312 (interfaces . (script-interface
1313 side-position-interface
1314 font-interface))))))
1319 (before-line-breaking . ,Script_column::before_line_breaking)
1321 (meta . ((class . Item)
1322 (interfaces . (script-column-interface))))))
1328 (meta . ((class . Item)
1329 (interfaces . (spacing-interface
1330 separation-item-interface))))))
1332 (SeparatingGroupSpanner
1335 (springs-and-rods . ,Separating_group_spanner::set_spacing_rods)
1337 (meta . ((class . Spanner)
1338 (interfaces . (only-prebreak-interface
1340 separation-spanner-interface))))))
1343 . ((slur-details . ,default-slur-details)
1345 (control-points . ,Slur::calc_control_points)
1346 (direction . ,Slur::calc_direction)
1347 (springs-and-rods . ,Spanner::set_spacing_rods)
1348 (Y-extent . ,Slur::height)
1349 (stencil . ,Slur::print)
1352 (minimum-length . 1.5)
1354 (height-limit . 2.0)
1356 (meta . ((class . Spanner)
1357 (interfaces . (slur-interface))))))
1362 (springs-and-rods . ,Spacing_spanner::set_springs)
1364 (grace-space-factor . 0.6)
1365 (shortest-duration-space . 2.0)
1366 (spacing-increment . 1.2)
1367 (base-shortest-duration . ,(ly:make-moment 3 16))
1368 (meta . ((class . Spanner)
1369 (interfaces . (spacing-interface
1370 spacing-spanner-interface))))))
1374 (break-align-symbol . staff-bar)
1379 (stencil . ,Span_bar::print)
1380 (bar-size . ,Span_bar::calc_bar_size)
1381 (X-extent . ,Span_bar::width)
1382 (glyph-name . ,Span_bar::calc_glyph_name)
1383 (before-line-breaking . ,Span_bar::before_line_breaking)
1388 ;; Ross. page 151 lists other values, we opt for a leaner look
1392 (hair-thickness . 1.6)
1393 (thick-thickness . 6.0)
1394 (meta . ((class . Item)
1395 (interfaces . (span-bar-interface
1397 bar-line-interface))))))
1401 (stencil . ,Text_interface::print)
1403 (font-series . bold)
1405 (X-offset . ,Side_position_interface::x_aligned_side)
1407 (meta . ((class . Item)
1408 (interfaces . (side-position-interface
1409 stanza-number-interface
1411 font-interface))))))
1416 (stencil . ,print-circled-text-callback)
1419 (staff-padding . 0.5)
1420 (self-alignment-X . 0)
1421 (self-alignment-Y . 0)
1422 (script-priority . 100)
1423 (font-encoding . fetaNumber)
1424 (font-size . -5) ; don't overlap when next to heads.
1425 (meta . ((class . Item)
1426 (interfaces . (string-number-interface
1428 text-script-interface
1430 side-position-interface
1431 self-alignment-interface
1432 item-interface))))))
1437 (stem-spacing-correction . 0.4)
1438 (meta . ((class . Item)
1439 (interfaces . (spacing-interface
1440 staff-spacing-interface))))))
1445 (stencil . ,Text_interface::print)
1448 (self-X-offset . ,Self_alignment_interface::x_aligned_on_self)
1449 (no-spacing-rods . #t)
1450 (padding . 0.0) ;; padding relative to SostenutoPedalLineSpanner
1451 (font-shape . italic)
1452 (self-alignment-X . 0)
1453 (meta . ((class . Item)
1454 (interfaces . (text-interface
1455 self-alignment-interface
1456 font-interface))))))
1458 (SostenutoPedalLineSpanner
1462 (X-extent . ,Axis_group_interface::height)
1464 (Y-offset . ,Side_position_interface::y_aligned_side)
1467 (minimum-space . 1.0)
1469 (meta . ((class . Spanner)
1470 (interfaces . (piano-pedal-interface
1471 axis-group-interface
1472 side-position-interface))))))
1477 (stencil . ,Staff_symbol::print)
1480 (ledger-line-thickness . (1.0 . 0.1))
1482 (meta . ((class . Spanner)
1483 (interfaces . (staff-symbol-interface))))))
1487 (direction . ,Stem::calc_direction)
1488 (stem-end-position . ,Stem::calc_stem_end_position)
1489 (stem-info . ,Stem::calc_stem_info)
1490 (positioning-done . ,Stem::calc_positioning_done)
1491 (stencil . ,Stem::print)
1492 (X-extent . ,Stem::width)
1493 (Y-extent . ,Stem::height)
1494 (length . ,Stem::calc_length)
1500 ;; 3.5 (or 3 measured from note head) is standard length
1501 ;; 32nd, 64th flagged stems should be longer
1502 (lengths . (3.5 3.5 3.5 4.5 5.0))
1504 ;; FIXME. 3.5 yields too long beams (according to Ross and
1505 ;; looking at Baerenreiter examples) for a number of common
1506 ;; boundary cases. Subtracting half a beam thickness fixes
1507 ;; this, but the bug may well be somewhere else.
1509 ;; FIXME this should come from 'lengths
1510 (beamed-lengths . (3.26 3.5 3.6))
1512 ;; The 'normal' minima
1513 (beamed-minimum-free-lengths . (1.83 1.5 1.25))
1514 ;(beamed-minimum-free-lengths . (2.0 1.83 1.25))
1516 ;; The 'extreme case' minima
1517 (beamed-extreme-minimum-free-lengths . (2.0 1.25))
1519 ;; Stems in unnatural (forced) direction should be shortened by
1520 ;; one staff space, according to [Roush & Gourlay].
1521 ;; Flagged stems we shorten only half a staff space.
1522 (stem-shorten . (1.0 0.5))
1527 ;; default stem direction for note on middle line
1528 (neutral-direction . -1)
1530 ;; We use the normal minima as minimum for the ideal lengths,
1531 ;; and the extreme minima as abolute minimum length.
1533 (X-offset . ,Stem::offset_callback)
1534 (Y-offset . ,Staff_symbol_referencer::callback)
1535 (meta . ((class . Item)
1536 (interfaces . (stem-interface
1537 font-interface))))))
1541 (Y-extent . ,Stem_tremolo::height)
1542 (stencil . ,Stem_tremolo::print)
1544 (beam-width . 1.6) ; staff-space
1545 (beam-thickness . 0.48) ; staff-space
1546 (meta . ((class . Item)
1547 (interfaces . (stem-tremolo-interface))))))
1551 (no-spacing-rods . #t)
1552 (stencil . ,Sustain_pedal::print)
1553 (self-alignment-X . 0)
1555 (padding . 0.0) ;; padding relative to SustainPedalLineSpanner
1556 (self-X-offset . ,Self_alignment_interface::x_aligned_on_self)
1557 (meta . ((class . Item)
1558 (interfaces . (piano-pedal-interface
1559 text-spanner-interface
1561 self-alignment-interface
1562 font-interface))))))
1564 (SustainPedalLineSpanner
1567 (X-extent . ,Axis_group_interface::height)
1568 (Y-offset . ,Side_position_interface::y_aligned_side)
1570 (staff-padding . 1.2)
1571 (minimum-space . 1.0)
1573 (meta . ((class . Spanner)
1574 (interfaces . (piano-pedal-interface
1575 axis-group-interface
1576 side-position-interface))))))
1581 (X-extent . ,Axis_group_interface::width)
1582 (Y-extent . ,Axis_group_interface::height)
1583 (meta . ((class . System)
1584 (interfaces . (system-interface
1585 axis-group-interface))))))
1590 (stencil . ,System_start_delimiter::print)
1591 (collapse-height . 5.0)
1592 (font-encoding . fetaBraces)
1594 (meta . ((class . Spanner)
1595 (interfaces . (system-start-delimiter-interface
1596 font-interface))))))
1602 (stencil . ,System_start_delimiter::print)
1604 (collapse-height . 5.0)
1606 (meta . ((class . Spanner)
1607 (interfaces . (font-interface
1608 system-start-delimiter-interface))))))
1613 (glyph . "bar-line")
1615 (stencil . ,System_start_delimiter::print)
1616 (meta . ((class . Spanner)
1617 (interfaces . (system-start-delimiter-interface))))))
1622 (stencil . ,Text_interface::print)
1623 (Y-offset . ,Staff_symbol_referencer::callback)
1625 (stem-attachment . (1.0 . 1.35))
1626 (font-series . bold)
1627 (meta . ((class . Item)
1629 . (rhythmic-head-interface
1632 staff-symbol-referencer-interface
1633 text-interface))))))
1637 (no-spacing-rods . #t)
1638 (self-X-offset . ,Self_alignment_interface::x_aligned_on_self)
1641 ;; sync with Fingering ?
1643 (staff-padding . 0.5)
1645 (stencil . ,Text_interface::print)
1646 (direction . ,Script_interface::calc_direction)
1648 (avoid-slur . around)
1649 (slur-padding . 0.5)
1650 (script-priority . 200)
1651 ;; todo: add X self alignment?
1652 (meta . ((class . Item)
1653 (interfaces . (text-script-interface
1655 side-position-interface
1656 font-interface))))))
1660 (stencil . ,Text_spanner::print)
1661 (font-shape . italic)
1662 (style . dashed-line)
1663 (staff-padding . 0.8)
1664 (dash-fraction . 0.2)
1667 (meta . ((class . Spanner)
1668 (interfaces . (text-spanner-interface
1669 side-position-interface
1670 font-interface))))))
1674 (control-points . ,Tie::calc_control_points)
1675 (direction . ,Tie::calc_direction)
1676 (stencil . ,Tie::print)
1677 (details . ((ratio . 0.333)
1678 (height-limit . 1.0)
1679 (between-length-limit . 1.0)))
1681 (meta . ((class . Spanner)
1682 (interfaces . (tie-interface))))
1687 (positioning-done . ,Tie_column::calc_positioning_done)
1688 (before-line-breaking . ,Tie_column::before_line_breaking)
1691 (meta . ((class . Spanner)
1692 (interfaces . (tie-column-interface))))))
1696 (stencil . ,Time_signature::print)
1697 (break-align-symbol . time-signature)
1698 (break-visibility . ,all-visible)
1700 (first-note . (fixed-space . 2.0))
1701 (right-edge . (extra-space . 0.5))
1702 (staff-bar . (minimum-space . 2.0))))
1705 (meta . ((class . Item)
1706 (interfaces . (time-signature-interface
1707 break-aligned-interface
1708 font-interface))))))
1712 (stencil . ,Dynamic_text_spanner::print)
1713 (edge-text . ,(cons (make-musicglyph-markup "scripts.trill")
1716 (staff-padding . 1.0)
1719 (Y-offset . ,Side_position_interface::y_aligned_side)
1720 (meta . ((class . Spanner)
1721 (interfaces . (text-spanner-interface
1722 side-position-interface
1723 font-interface))))))
1725 (TrillPitchAccidental
1726 . ((X-offset . ,Side_position_interface::x_aligned_side)
1730 (stencil . ,Accidental_interface::print)
1731 (meta . ((class . Item)
1732 (interfaces . (item-interface
1733 accidental-interface
1734 side-position-interface
1735 font-interface))))))
1738 . ((X-offset . ,Side_position_interface::x_aligned_side)
1741 (stencil . ,parenthesize-elements)
1742 (direction . ,RIGHT)
1744 (meta . ((class . Item)
1745 (interfaces . (side-position-interface
1747 rhythmic-head-interface
1749 accidental-interface
1750 axis-group-interface))))))
1754 (stencil . ,Note_head::print)
1756 (Y-offset . ,Staff_symbol_referencer::callback)
1758 (meta . ((class . Item)
1759 (interfaces . (item-interface
1760 rhythmic-head-interface
1762 pitched-trill-interface
1764 staff-symbol-referencer-interface))))))
1770 (edge-height . (0.7 . 0.7))
1771 (shorten-pair . (-0.2 . -0.2))
1772 (direction . ,Tuplet_bracket::calc_direction)
1773 (positions . ,Tuplet_bracket::calc_positions)
1774 (stencil . ,Tuplet_bracket::print)
1775 (font-shape . italic)
1777 (meta . ((class . Spanner)
1778 (interfaces . (text-interface
1780 tuplet-bracket-interface
1781 font-interface))))))
1785 (stencil . ,Text_interface::print)
1786 (font-shape . italic)
1787 (no-spacing-rods . #t)
1788 (self-alignment-X . 0)
1790 (padding . 0.0) ;; padding relative to UnaCordaPedalLineSpanner
1791 (self-X-offset . ,Self_alignment_interface::x_aligned_on_self)
1792 (meta . ((class . Item)
1793 (interfaces . (text-interface
1794 self-alignment-interface
1795 font-interface))))))
1797 (UnaCordaPedalLineSpanner
1800 (X-extent . ,Axis_group_interface::height)
1801 (Y-offset . ,Side_position_interface::y_aligned_side)
1803 (staff-padding . 1.2)
1804 (minimum-space . 1.0)
1806 (meta . ((class . Spanner)
1807 (interfaces . (piano-pedal-interface
1808 axis-group-interface
1809 side-position-interface))))))
1815 (stencil . ,Vaticana_ligature::print)
1816 (meta . ((class . Spanner)
1817 (interfaces . (vaticana-ligature-interface
1818 font-interface))))))
1823 (positioning-done . ,Align_interface::calc_positioning_done)
1824 (after-line-breaking . ,Align_interface::stretch_after_break)
1825 (Y-extent . ,Axis_group_interface::height)
1826 (X-extent . ,Axis_group_interface::width)
1828 (meta . ((class . Spanner)
1829 (interfaces . (align-interface
1830 axis-group-interface))))))
1834 (Y-offset . ,Hara_kiri_group_spanner::force_hara_kiri_callback)
1835 (Y-extent . ,Hara_kiri_group_spanner::y_extent)
1836 (X-extent . ,Axis_group_interface::width)
1837 (meta . ((class . Spanner)
1838 (interfaces . (axis-group-interface
1839 vertically-spaceable-interface))))))
1844 (Y-offset . ,Side_position_interface::y_aligned_on_support_refpoints)
1846 (space-alist . ((left-edge . (extra-space . 1.0))))
1847 (break-align-symbol . instrument-name)
1848 (stencil . ,Text_interface::print)
1849 (break-align-symbol . clef)
1850 (break-visibility . ,begin-of-line-visible)
1852 (meta . ((class . Item)
1853 (interfaces . (font-interface
1854 self-alignment-interface
1855 side-position-interface
1857 break-aligned-interface))))))
1861 (stencil . ,Volta_bracket_interface::print)
1862 (after-line-breaking . ,Volta_bracket_interface::after_line_breaking)
1865 (font-encoding . fetaNumber)
1866 (Y-offset . ,Side_position_interface::y_aligned_side)
1867 (thickness . 1.6) ;; linethickness
1868 (edge-height . (2.0 . 2.0)) ;; staffspace;
1871 (meta . ((class . Spanner)
1872 (interfaces . (volta-bracket-interface
1873 horizontal-bracket-interface
1876 side-position-interface
1888 (stencil . ,Line_spanner::print)
1889 (after-line-breaking . ,Line_spanner::after_line_breaking)
1890 (meta . ((class . Spanner)
1891 (interfaces . (line-spanner-interface
1897 (define (completize-grob-entry x)
1898 "Transplant assoc key into 'name entry of 'meta of X. Set interfaces for Item, Spanner etc.
1900 ;; (display (car x))
1902 (let* ((name-sym (car x))
1903 (grob-entry (cdr x))
1904 (meta-entry (cdr (assoc 'meta grob-entry)))
1905 (class (cdr (assoc 'class meta-entry)))
1907 (cdr (assoc 'interfaces meta-entry))))
1911 (set! ifaces-entry (cons 'item-interface ifaces-entry)))
1912 ((eq? 'Spanner class)
1913 (set! ifaces-entry (cons 'spanner-interface ifaces-entry)))
1914 ((eq? 'Paper_column class)
1915 (set! ifaces-entry (cons 'item-interface
1916 (cons 'paper-column-interface ifaces-entry))))
1917 ((eq? 'System class)
1918 (set! ifaces-entry (cons 'system-interface
1919 (cons 'spanner-interface ifaces-entry))))
1921 (ly:warning "Unknown class ~a" class)))
1922 (set! ifaces-entry (cons 'grob-interface ifaces-entry))
1924 (set! meta-entry (assoc-set! meta-entry 'name name-sym))
1925 (set! meta-entry (assoc-set! meta-entry 'interfaces
1927 (set! grob-entry (assoc-set! grob-entry 'meta meta-entry))
1928 (cons name-sym grob-entry)))
1930 (set! all-grob-descriptions (map completize-grob-entry all-grob-descriptions))
1932 ;; (display (map pair? all-grob-descriptions))
1934 ;; make sure that \property Foo.Bar =\turnOff doesn't complain
1937 ;; (display (car x)) (newline)
1939 (set-object-property! (car x) 'translation-type? list?)
1940 (set-object-property! (car x) 'is-grob? #t))
1941 all-grob-descriptions)
1943 (set! all-grob-descriptions (sort all-grob-descriptions alist<?))