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 . ,(ly:make-simple-closure `(,+ ,(ly:make-simple-closure (list Self_alignment_interface::centered_on_x_parent))
37 ,(ly:make-simple-closure (list 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
285 (positions . ,(ly:make-simple-closure
286 (ly:make-simple-closure
287 (list chain-grob-member-functions
289 Beam::calc_least_squares_positions
291 Beam::shift_region_to_valid
295 ;; this is a hack to set stem lengths, if positions is set.
296 (quantized-positions . ,Beam::set_stem_lengths)
297 (concaveness . ,Beam::calc_concaveness)
298 (direction . ,Beam::calc_direction)
299 (stencil . ,Beam::print)
301 ;; TODO: should be in SLT.
302 (thickness . 0.48) ; in staff-space
303 (neutral-direction . -1)
305 ;; Whe have some unreferenced problems here.
307 ;; If we shorten beamed stems less than normal stems (1 staffspace),
308 ;; or high order less than 8th beams, patterns like
309 ;; c''4 [c''8 c''] c''4 [c''16 c]
310 ;; are ugly (different stem lengths).
312 ;; But if we shorten 16th beams as much as 8th beams, a single
313 ;; forced 16th beam looks *very* short.
315 ;; We choose to shorten 8th beams the same as single stems,
316 ;; and high order beams less than 8th beams, so that all
317 ;; isolated shortened beams look nice and a bit shortened,
318 ;; sadly possibly breaking patterns with high order beams.
319 (beamed-stem-shorten . (1.0 0.5 0.25))
321 (auto-knee-gap . 5.5)
323 ;; only for debugging.
324 (font-family . roman)
325 (meta . ((class . Spanner)
326 (interfaces . (staff-symbol-referencer-interface
334 (positioning-done . ,Break_align_interface::calc_positioning_done)
335 (X-extent . ,Axis_group_interface::width)
337 (break-align-orders . ;; end of line
359 time-signature custos)
373 (meta . ((class . Item)
374 (interfaces . (break-alignment-interface
375 axis-group-interface))))))
381 (X-extent . ,Axis_group_interface::width)
383 (meta . ((class . Item)
384 (interfaces . (break-aligned-interface
385 axis-group-interface))))))
389 (break-align-symbol . breathing-sign)
392 (ambitus . (extra-space . 2.0))
393 (custos . (minimum-space . 1.0))
394 (key-signature . (minimum-space . 1.5))
395 (time-signature . (minimum-space . 1.5))
396 (staff-bar . (minimum-space . 1.5))
397 (clef . (minimum-space . 2.0))
398 (first-note . (fixed-space . 1.0)) ;huh?
399 (right-edge . (extra-space . 0.1))))
401 (stencil . ,Text_interface::print)
403 (text . ,(make-musicglyph-markup "scripts.rcomma"))
404 (Y-offset . ,Breathing_sign::offset_callback)
405 (break-visibility . ,begin-of-line-invisible)
406 (meta . ((class . Item)
407 (interfaces . (break-aligned-interface
408 breathing-sign-interface
415 (stencil . ,Clef::print)
416 (glyph-name . ,Clef::calc_glyph_name)
419 (font-family . music)
420 (break-align-symbol . clef)
421 (break-visibility . ,begin-of-line-visible)
422 (space-alist . ((ambitus . (extra-space . 2.0))
423 (staff-bar . (extra-space . 0.7))
424 (key-cancellation . (minimum-space . 3.5))
425 (key-signature . (minimum-space . 3.5))
426 (time-signature . (minimum-space . 4.2))
427 (first-note . (minimum-fixed-space . 5.0))
428 (next-note . (extra-space . 0.5))
429 (right-edge . (extra-space . 0.5))))
430 (Y-offset . ,Staff_symbol_referencer::callback)
431 (meta . ((class . Item)
432 (interfaces . (clef-interface
433 staff-symbol-referencer-interface
435 break-aligned-interface))))))
437 (ClusterSpannerBeacon
440 (Y-extent . ,Cluster_beacon::height)
442 (meta . ((class . Item)
443 (interfaces . (cluster-beacon-interface))))))
448 (springs-and-rods . ,Spanner::set_spacing_rods)
449 (stencil . ,Cluster::print)
452 (minimum-length . 0.0)
455 (meta . ((class . Spanner)
456 (interfaces . (cluster-interface))))))
461 (stencil . ,Text_interface::print)
462 (after-line-breaking . ,Chord_name::after_line_breaking)
467 (meta . ((class . Item)
468 (interfaces . (font-interface
469 rhythmic-grob-interface
477 (stencil . ,Text_interface::print)
479 (no-spacing-rods . #t)
480 (Y-offset . ,Side_position_interface::y_aligned_side)
481 (X-offset . ,Self_alignment_interface::x_aligned_on_self)
484 (staff-padding . 0.5)
485 (script-priority . 200)
486 ;; todo: add X self alignment?
489 (meta . ((class . Item)
490 (interfaces . (text-script-interface
492 side-position-interface
497 (break-align-symbol . custos)
500 (stencil . ,Custos::print)
502 (break-visibility . ,end-of-line-visible)
504 (neutral-direction . -1)
505 (Y-offset . ,Staff_symbol_referencer::callback)
507 (first-note . (minimum-fixed-space . 0.0))
508 (right-edge . (extra-space . 0.1))))
509 (meta . ((class . Item)
512 staff-symbol-referencer-interface
514 break-aligned-interface))))))
521 (positioning-done . ,Dot_column::calc_positioning_done)
522 (X-extent . ,Axis_group_interface::width)
524 (X-offset . ,Dot_column::side_position)
525 (meta . ((class . Item)
526 (interfaces . (dot-column-interface
527 axis-group-interface))))))
532 (stencil . ,Dots::print)
535 (meta . ((class . Item)
536 (interfaces . (font-interface
537 staff-symbol-referencer-interface
542 (stencil . ,Percent_repeat_item_interface::double_percent)
545 (font-encoding . fetaMusic)
548 (break-align-symbol . staff-bar)
549 (break-visibility . ,begin-of-line-invisible)
550 (meta . ((class . Item)
551 (interfaces . (font-interface
552 break-aligned-interface
553 percent-repeat-interface))))))
555 (DoublePercentRepeatCounter
558 (stencil . ,Text_interface::print)
559 (X-offset . ,(ly:make-simple-closure `(,+ ,(ly:make-simple-closure (list Self_alignment_interface::centered_on_y_parent))
560 ,(ly:make-simple-closure (list Self_alignment_interface::x_aligned_on_self)))))
561 (Y-offset . ,Side_position_interface::y_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 . ,Side_position_interface::y_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 . ,Self_alignment_interface::x_aligned_on_self)
604 (self-alignment-X . 0)
605 (Y-offset . ,Self_alignment_interface::y_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 . ,(ly:make-simple-closure
699 `(,+ ,(ly:make-simple-closure (list Self_alignment_interface::centered_on_x_parent))
700 ,(ly:make-simple-closure (list Self_alignment_interface::x_aligned_on_self)))))
702 (meta . ((class . Item)
703 (interfaces . (self-alignment-interface
704 grid-line-interface))))))
710 (stencil . ,Hairpin::print)
711 (springs-and-rods . ,Spanner::set_spacing_rods)
712 (after-line-breaking . ,Hairpin::after_line_breaking)
716 (minimum-length . 2.0)
717 (bound-padding . 1.0)
718 (self-alignment-Y . 0)
719 (Y-offset . ,Self_alignment_interface::y_aligned_on_self)
720 (meta . ((class . Spanner)
721 (interfaces . (hairpin-interface
723 self-alignment-interface
725 spanner-interface))))))
731 (stencil . ,Horizontal_bracket::print)
733 (Y-offset . ,Side_position_interface::y_aligned_side)
735 (staff-padding . 0.2)
737 (bracket-flare . (0.5 . 0.5))
738 (meta . ((class . Spanner)
739 (interfaces . (horizontal-bracket-interface
740 side-position-interface
742 spanner-interface))))))
746 (Y-offset . ,(ly:make-simple-closure `(,+ ,(ly:make-simple-closure (list Self_alignment_interface::y_aligned_on_self))
747 ,(ly:make-simple-closure (list Side_position_interface::y_aligned_on_support_refpoints)))))
749 ;; This direction is for aligned_on_support_refpoints
753 (left-edge . (extra-space . 1.0))))
755 (self-alignment-Y . 0)
757 (stencil . ,Text_interface::print)
759 (break-align-symbol . instrument-name)
760 (break-visibility . ,begin-of-line-visible)
762 (meta . ((class . Item)
763 (interfaces . (font-interface
764 self-alignment-interface
765 side-position-interface
767 break-aligned-interface))))))
772 (stencil . ,Key_signature_interface::print)
775 (time-signature . (extra-space . 1.25))
776 (staff-bar . (extra-space . 0.6))
777 (key-signature . (extra-space . 0.5))
778 (right-edge . (extra-space . 0.5))
779 (first-note . (fixed-space . 2.5))))
780 (Y-offset . ,Staff_symbol_referencer::callback)
781 (break-align-symbol . key-cancellation)
782 (break-visibility . ,begin-of-line-invisible)
785 (meta . ((class . Item)
786 (interfaces . (key-signature-interface
788 break-aligned-interface))))))
792 (stencil . ,Key_signature_interface::print)
795 (time-signature . (extra-space . 1.15))
796 (staff-bar . (extra-space . 1.1))
797 (right-edge . (extra-space . 0.5))
798 (first-note . (fixed-space . 2.5))))
799 (Y-offset . ,Staff_symbol_referencer::callback)
800 (break-align-symbol . key-signature)
801 (break-visibility . ,begin-of-line-visible)
804 (meta . ((class . Item)
805 (interfaces . (key-signature-interface
807 break-aligned-interface))))))
811 (stencil . ,Tie::print)
812 (control-points . ,Laissez_vibrer_tie::calc_control_points)
813 (direction . ,Laissez_vibrer_tie::calc_direction)
815 (details . ((ratio . 0.333)
816 (height-limit . 1.0)))
818 (meta . ((class . Item)
819 (interfaces . (laissez-vibrer-tie-interface))
823 (LaissezVibrerTieColumn
828 (positioning-done . ,Laissez_vibrer_tie_column::calc_positioning_done)
830 (meta . ((class . Item)
831 (interfaces . (laissez-vibrer-tie-column-interface))
838 (springs-and-rods . ,Ledger_line_spanner::set_spacing_rods)
840 (stencil . ,Ledger_line_spanner::print)
844 (minimum-length-fraction . 0.25)
845 (length-fraction . 0.25)
847 (meta . ((class . Spanner)
848 (interfaces . (ledger-line-interface))))))
852 (break-align-symbol . left-edge)
855 (break-visibility . ,center-invisible)
857 (custos . (extra-space . 0.0))
858 (ambitus . (extra-space . 2.0))
859 (time-signature . (extra-space . 1.0))
860 (staff-bar . (extra-space . 0.0))
861 (breathing-sign . (minimum-space . 0.0))
862 (clef . (extra-space . 0.8))
863 (first-note . (fixed-space . 2.0))
864 (right-edge . (extra-space . 0.0))
865 (key-signature . (extra-space . 0.0))
866 (key-cancellation . (extra-space . 0.0))
868 (meta . ((class . Item)
869 (interfaces . (break-aligned-interface))))))
873 ;; ugh. A ligature bracket is totally different from
876 (direction . ,Tuplet_bracket::calc_direction)
877 (positions . ,Tuplet_bracket::calc_positions)
878 (stencil . ,Tuplet_bracket::print)
884 (edge-height . (0.7 . 0.7))
885 (shorten-pair . (-0.2 . -0.2))
886 (meta . ((class . Spanner)
887 (interfaces . (tuplet-bracket-interface
896 (minimum-length . 0.3)
898 ; (springs-and-rods . ,Hyphen_spanner::set_spacing_rods)
900 (stencil . ,Hyphen_spanner::print)
903 (meta . ((class . Spanner)
904 (interfaces . (lyric-interface
905 lyric-hyphen-interface
906 spanner-interface))))))
911 (stencil . ,Lyric_extender::print)
913 (thickness . 0.8) ; linethickness
914 (minimum-length . 1.5)
916 (meta . ((class . Spanner)
917 (interfaces . (lyric-interface
918 lyric-extender-interface))))))
923 (stencil . ,Text_interface::print)
925 (X-offset . ,Self_alignment_interface::aligned_on_x_parent)
926 (self-alignment-X . 0)
928 (font-series . bold-narrow)
930 (meta . ((class . Item)
931 (interfaces . (rhythmic-grob-interface
932 lyric-syllable-interface
933 self-alignment-interface
941 (stencil . ,Mensural_ligature::print)
943 (meta . ((class . Spanner)
944 (interfaces . (mensural-ligature-interface
950 (stencil . ,Text_interface::print)
952 (Y-offset . ,Side_position_interface::y_aligned_side)
955 (meta . ((class . Item)
956 (interfaces . (text-interface
957 side-position-interface
959 metronome-mark-interface))))))
963 (Y-offset . ,Side_position_interface::y_aligned_side)
965 (stencil . ,Measure_grouping::print)
972 (meta . ((class . Spanner)
973 (interfaces . (side-position-interface
974 measure-grouping-interface))))))
979 (stencil . ,Multi_measure_rest::print)
981 (Y-offset . ,Staff_symbol_referencer::callback)
984 (thick-thickness . 6.6)
985 (hair-thickness . 2.0)
987 (meta . ((class . Spanner)
988 (interfaces . (multi-measure-rest-interface
989 multi-measure-interface
992 staff-symbol-referencer-interface))))))
995 (MultiMeasureRestNumber
997 (springs-and-rods . ,Multi_measure_rest::set_spacing_rods)
998 (stencil . ,Text_interface::print)
999 (X-offset . ,(ly:make-simple-closure
1000 `(,+ ,(ly:make-simple-closure (list Self_alignment_interface::x_aligned_on_self))
1001 ,(ly:make-simple-closure (list Self_alignment_interface::x_centered_on_y_parent)))))
1002 (Y-offset . ,Side_position_interface::y_aligned_side)
1003 (self-alignment-X . 0)
1006 (staff-padding . 0.4)
1007 (font-encoding . fetaNumber)
1008 (meta . ((class . Spanner)
1009 (interfaces . (side-position-interface
1010 multi-measure-interface
1011 self-alignment-interface
1016 (MultiMeasureRestText
1018 (stencil . ,Text_interface::print)
1019 (X-offset . ,(ly:make-simple-closure
1020 `(,+ ,(ly:make-simple-closure (list Self_alignment_interface::x_centered_on_y_parent))
1021 ,(ly:make-simple-closure (list Self_alignment_interface::x_aligned_on_self)))))
1023 (Y-offset . ,Side_position_interface::y_aligned_side)
1024 (self-alignment-X . 0)
1027 (staff-padding . 0.25)
1028 (meta . ((class . Spanner)
1029 (interfaces . (side-position-interface
1030 multi-measure-interface
1031 self-alignment-interface
1033 text-interface))))))
1039 (X-extent . ,Axis_group_interface::width)
1040 (Y-extent . ,Axis_group_interface::height)
1041 (positioning-done . ,Note_collision_interface::calc_positioning_done)
1043 (meta . ((class . Item)
1044 (interfaces . (note-collision-interface
1045 axis-group-interface))))))
1050 (X-extent . ,Axis_group_interface::width)
1051 (Y-extent . ,Axis_group_interface::height)
1053 (meta . ((class . Item)
1054 (interfaces . (axis-group-interface
1055 note-column-interface))))))
1060 (stencil . ,Note_head::print)
1061 (stem-attachment . ,Note_head::calc_stem_attachment)
1062 (glyph-name . ,note-head::calc-glyph-name)
1063 (Y-offset . ,Staff_symbol_referencer::callback)
1064 (X-offset . ,Note_head::stem_x_shift)
1065 (meta . ((class . Item)
1066 (interfaces . (rhythmic-grob-interface
1067 rhythmic-head-interface
1071 staff-symbol-referencer-interface))))))
1075 (stem-spacing-correction . 0.5)
1076 (same-direction-correction . 0.25)
1077 ;; Changed this from 0.75.
1078 ;; If you ever change this back, please document! --hwn
1079 (knee-spacing-correction . 1.0)
1081 (meta . ((class . Item)
1082 (interfaces . (spacing-interface
1083 note-spacing-interface))))))
1088 (stencil . ,Text_interface::print)
1090 (meta . ((class . Item)
1091 (interfaces . (note-name-interface
1093 font-interface))))))
1097 (self-alignment-X . 0)
1098 (break-visibility . ,begin-of-line-visible)
1099 (X-offset . ,(ly:make-simple-closure
1100 `(,+ ,(ly:make-simple-closure (list Self_alignment_interface::x_aligned_on_self))
1101 ,(ly:make-simple-closure (list Self_alignment_interface::centered_on_x_parent)))))
1103 (Y-offset . ,Side_position_interface::y_aligned_side)
1105 (stencil . ,Text_interface::print)
1108 ;; no Y dimensions, because of lyrics under tenor clef.
1109 (Y-extent . (0 . 0))
1110 (font-shape . italic)
1112 (staff-padding . 0.2)
1114 (meta . ((class . Item)
1115 (interfaces . (text-interface
1116 self-alignment-interface
1117 side-position-interface
1118 font-interface))))))
1122 (Y-offset . ,Side_position_interface::y_aligned_side)
1124 (stencil . ,Ottava_bracket::print)
1126 (font-shape . italic)
1127 (shorten-pair . (0.0 . -0.6))
1128 (staff-padding . 1.0)
1130 (minimum-length . 1.0)
1131 (dash-fraction . 0.3)
1132 (edge-height . (0 . 1.2))
1134 (meta . ((class . Spanner)
1135 (interfaces . (ottava-bracket-interface
1136 horizontal-bracket-interface
1138 side-position-interface
1140 text-interface))))))
1146 (before-line-breaking . ,Paper_column::before_line_breaking)
1147 ;; (stencil . ,Paper_column::print)
1148 (X-extent . ,Axis_group_interface::width)
1152 ;; (font-size . -6) (font-name . "sans") (Y-extent . #f)
1153 (meta . ((class . Paper_column)
1154 (interfaces . (paper-column-interface
1155 axis-group-interface
1156 spaceable-grob-interface))))))
1159 . ((slur-details . ,default-slur-details)
1161 (control-points . ,Slur::calc_control_points)
1162 (direction . ,Slur::calc_direction)
1163 (springs-and-rods . ,Spanner::set_spacing_rods)
1164 (Y-extent . ,Slur::height)
1165 (stencil . ,Slur::print)
1169 (minimum-length . 1.5)
1170 (height-limit . 2.0)
1172 (meta . ((class . Spanner)
1173 (interfaces . (slur-interface))))))
1175 (NonMusicalPaperColumn
1179 (before-line-breaking . ,Paper_column::before_line_breaking)
1180 (X-extent . ,Axis_group_interface::width)
1181 ;; (stencil . ,Paper_column::print)
1185 ;; debugging stuff: print column number.
1186 ;; (font-size . -6) (font-name . "sans") (Y-extent . #f)
1188 (meta . ((class . Paper_column)
1189 (interfaces . (paper-column-interface
1190 axis-group-interface
1191 spaceable-grob-interface))))))
1196 (springs-and-rods . ,Multi_measure_rest::set_spacing_rods)
1197 (stencil . ,Multi_measure_rest::percent)
1201 (font-encoding . fetaMusic)
1202 (meta . ((class . Spanner)
1203 (interfaces . (multi-measure-rest-interface
1205 percent-repeat-interface))))))
1206 (PercentRepeatCounter
1208 (stencil . ,Text_interface::print)
1209 (X-offset . ,(ly:make-simple-closure
1210 `(,+ ,(ly:make-simple-closure (list Self_alignment_interface::x_centered_on_y_parent))
1211 ,(ly:make-simple-closure (list Self_alignment_interface::x_aligned_on_self)))))
1212 (Y-offset . ,Side_position_interface::y_aligned_side)
1213 (self-alignment-X . 0)
1216 (staff-padding . 0.25)
1218 (font-encoding . fetaNumber)
1219 (meta . ((class . Spanner)
1220 (interfaces . (side-position-interface
1221 self-alignment-interface
1222 percent-repeat-interface
1224 text-interface))))))
1226 ;; an example of a text spanner
1230 (stencil . ,Piano_pedal_bracket::print)
1233 (bound-padding . 1.0)
1235 (bracket-flare . (0.5 . 0.5))
1236 (edge-height . (1.0 . 1.0))
1237 (shorten-pair . (0.0 . 0.0))
1239 (meta . ((class . Spanner)
1240 (interfaces . (line-interface
1241 piano-pedal-interface
1242 piano-pedal-bracket-interface))))))
1247 (stencil . ,Text_interface::print)
1249 (X-offset . ,Self_alignment_interface::x_aligned_on_self)
1250 (Y-offset . ,Side_position_interface::y_aligned_side)
1252 (after-line-breaking . ,shift-right-at-line-begin)
1254 (self-alignment-X . 0)
1259 (break-visibility . ,end-of-line-invisible)
1261 (meta . ((class . Item)
1262 (interfaces . (text-interface
1263 side-position-interface
1266 self-alignment-interface))))))
1272 (stencil . ,Percent_repeat_item_interface::beat_slash)
1276 (meta . ((class . Item)
1277 (interfaces . (percent-repeat-interface))))))
1281 (stencil . ,Rest::print)
1282 (X-extent . ,Rest::width)
1283 (Y-extent . ,Rest::height)
1284 (Y-offset . ,Rest::y_offset_callback)
1285 (minimum-distance . 0.25)
1286 (meta . ((class . Item)
1287 (interfaces . (font-interface
1288 rhythmic-head-interface
1289 rhythmic-grob-interface
1290 staff-symbol-referencer-interface
1291 rest-interface))))))
1295 (minimum-distance . 0.75)
1296 (positioning-done . ,Rest_collision::calc_positioning_done)
1298 (meta . ((class . Item)
1299 (interfaces . (rest-collision-interface))))))
1303 ;; don't set direction here: it breaks staccato.
1305 ;; This value is sensitive: if too large, staccato dots will move a
1308 (staff-padding . 0.25)
1309 ;; (script-priority . 0) priorities for scripts, see script.scm
1310 (X-offset . ,Self_alignment_interface::centered_on_x_parent)
1312 (stencil . ,Script_interface::print)
1313 (direction . ,Script_interface::calc_direction)
1315 (font-encoding . fetaMusic)
1316 (meta . ((class . Item)
1317 (interfaces . (script-interface
1318 side-position-interface
1319 font-interface))))))
1324 (before-line-breaking . ,Script_column::before_line_breaking)
1326 (meta . ((class . Item)
1327 (interfaces . (script-column-interface))))))
1333 (meta . ((class . Item)
1334 (interfaces . (spacing-interface
1335 separation-item-interface))))))
1337 (SeparatingGroupSpanner
1340 (springs-and-rods . ,Separating_group_spanner::set_spacing_rods)
1342 (meta . ((class . Spanner)
1343 (interfaces . (only-prebreak-interface
1345 separation-spanner-interface))))))
1348 . ((slur-details . ,default-slur-details)
1350 (control-points . ,Slur::calc_control_points)
1351 (direction . ,Slur::calc_direction)
1352 (springs-and-rods . ,Spanner::set_spacing_rods)
1353 (Y-extent . ,Slur::height)
1354 (stencil . ,Slur::print)
1357 (minimum-length . 1.5)
1359 (height-limit . 2.0)
1361 (meta . ((class . Spanner)
1362 (interfaces . (slur-interface))))))
1367 (springs-and-rods . ,Spacing_spanner::set_springs)
1369 (grace-space-factor . 0.6)
1370 (shortest-duration-space . 2.0)
1371 (spacing-increment . 1.2)
1372 (base-shortest-duration . ,(ly:make-moment 3 16))
1373 (meta . ((class . Spanner)
1374 (interfaces . (spacing-interface
1375 spacing-spanner-interface))))))
1379 (break-align-symbol . staff-bar)
1384 (stencil . ,Span_bar::print)
1385 (bar-size . ,Span_bar::calc_bar_size)
1386 (X-extent . ,Span_bar::width)
1387 (glyph-name . ,Span_bar::calc_glyph_name)
1388 (before-line-breaking . ,Span_bar::before_line_breaking)
1393 ;; Ross. page 151 lists other values, we opt for a leaner look
1397 (hair-thickness . 1.6)
1398 (thick-thickness . 6.0)
1399 (meta . ((class . Item)
1400 (interfaces . (span-bar-interface
1402 bar-line-interface))))))
1406 (stencil . ,Text_interface::print)
1408 (font-series . bold)
1410 (X-offset . ,Side_position_interface::x_aligned_side)
1412 (meta . ((class . Item)
1413 (interfaces . (side-position-interface
1414 stanza-number-interface
1416 font-interface))))))
1421 (stencil . ,print-circled-text-callback)
1424 (staff-padding . 0.5)
1425 (self-alignment-X . 0)
1426 (self-alignment-Y . 0)
1427 (script-priority . 100)
1428 (font-encoding . fetaNumber)
1429 (font-size . -5) ; don't overlap when next to heads.
1430 (meta . ((class . Item)
1431 (interfaces . (string-number-interface
1433 text-script-interface
1435 side-position-interface
1436 self-alignment-interface
1437 item-interface))))))
1442 (stem-spacing-correction . 0.4)
1443 (meta . ((class . Item)
1444 (interfaces . (spacing-interface
1445 staff-spacing-interface))))))
1450 (stencil . ,Text_interface::print)
1453 (X-offset . ,Self_alignment_interface::x_aligned_on_self)
1454 (no-spacing-rods . #t)
1455 (padding . 0.0) ;; padding relative to SostenutoPedalLineSpanner
1456 (font-shape . italic)
1457 (self-alignment-X . 0)
1458 (meta . ((class . Item)
1459 (interfaces . (text-interface
1460 self-alignment-interface
1461 font-interface))))))
1463 (SostenutoPedalLineSpanner
1467 (X-extent . ,Axis_group_interface::height)
1469 (Y-offset . ,Side_position_interface::y_aligned_side)
1472 (minimum-space . 1.0)
1474 (meta . ((class . Spanner)
1475 (interfaces . (piano-pedal-interface
1476 axis-group-interface
1477 side-position-interface))))))
1482 (stencil . ,Staff_symbol::print)
1485 (ledger-line-thickness . (1.0 . 0.1))
1487 (meta . ((class . Spanner)
1488 (interfaces . (staff-symbol-interface))))))
1492 (direction . ,Stem::calc_direction)
1493 (stem-end-position . ,Stem::calc_stem_end_position)
1494 (stem-info . ,Stem::calc_stem_info)
1495 (positioning-done . ,Stem::calc_positioning_done)
1496 (stencil . ,Stem::print)
1497 (X-extent . ,Stem::width)
1498 (Y-extent . ,Stem::height)
1499 (length . ,Stem::calc_length)
1505 ;; 3.5 (or 3 measured from note head) is standard length
1506 ;; 32nd, 64th flagged stems should be longer
1507 (lengths . (3.5 3.5 3.5 4.5 5.0))
1509 ;; FIXME. 3.5 yields too long beams (according to Ross and
1510 ;; looking at Baerenreiter examples) for a number of common
1511 ;; boundary cases. Subtracting half a beam thickness fixes
1512 ;; this, but the bug may well be somewhere else.
1514 ;; FIXME this should come from 'lengths
1515 (beamed-lengths . (3.26 3.5 3.6))
1517 ;; The 'normal' minima
1518 (beamed-minimum-free-lengths . (1.83 1.5 1.25))
1519 ;(beamed-minimum-free-lengths . (2.0 1.83 1.25))
1521 ;; The 'extreme case' minima
1522 (beamed-extreme-minimum-free-lengths . (2.0 1.25))
1524 ;; Stems in unnatural (forced) direction should be shortened by
1525 ;; one staff space, according to [Roush & Gourlay].
1526 ;; Flagged stems we shorten only half a staff space.
1527 (stem-shorten . (1.0 0.5))
1532 ;; default stem direction for note on middle line
1533 (neutral-direction . -1)
1535 ;; We use the normal minima as minimum for the ideal lengths,
1536 ;; and the extreme minima as abolute minimum length.
1538 (X-offset . ,Stem::offset_callback)
1539 (Y-offset . ,Staff_symbol_referencer::callback)
1540 (meta . ((class . Item)
1541 (interfaces . (stem-interface
1542 font-interface))))))
1546 (Y-extent . ,Stem_tremolo::height)
1547 (stencil . ,Stem_tremolo::print)
1549 (beam-width . 1.6) ; staff-space
1550 (beam-thickness . 0.48) ; staff-space
1551 (meta . ((class . Item)
1552 (interfaces . (stem-tremolo-interface))))))
1556 (no-spacing-rods . #t)
1557 (stencil . ,Sustain_pedal::print)
1558 (self-alignment-X . 0)
1560 (padding . 0.0) ;; padding relative to SustainPedalLineSpanner
1561 (X-offset . ,Self_alignment_interface::x_aligned_on_self)
1562 (meta . ((class . Item)
1563 (interfaces . (piano-pedal-interface
1564 text-spanner-interface
1566 self-alignment-interface
1567 font-interface))))))
1569 (SustainPedalLineSpanner
1572 (X-extent . ,Axis_group_interface::height)
1573 (Y-offset . ,Side_position_interface::y_aligned_side)
1575 (staff-padding . 1.2)
1576 (minimum-space . 1.0)
1578 (meta . ((class . Spanner)
1579 (interfaces . (piano-pedal-interface
1580 axis-group-interface
1581 side-position-interface))))))
1586 (X-extent . ,Axis_group_interface::width)
1587 (Y-extent . ,Axis_group_interface::height)
1588 (meta . ((class . System)
1589 (interfaces . (system-interface
1590 axis-group-interface))))))
1595 (stencil . ,System_start_delimiter::print)
1596 (collapse-height . 5.0)
1597 (font-encoding . fetaBraces)
1599 (meta . ((class . Spanner)
1600 (interfaces . (system-start-delimiter-interface
1601 font-interface))))))
1607 (stencil . ,System_start_delimiter::print)
1609 (collapse-height . 5.0)
1611 (meta . ((class . Spanner)
1612 (interfaces . (font-interface
1613 system-start-delimiter-interface))))))
1618 (glyph . "bar-line")
1620 (stencil . ,System_start_delimiter::print)
1621 (meta . ((class . Spanner)
1622 (interfaces . (system-start-delimiter-interface))))))
1627 (stencil . ,Text_interface::print)
1628 (Y-offset . ,Staff_symbol_referencer::callback)
1630 (stem-attachment . (1.0 . 1.35))
1631 (font-series . bold)
1632 (meta . ((class . Item)
1634 . (rhythmic-head-interface
1637 staff-symbol-referencer-interface
1638 text-interface))))))
1642 (no-spacing-rods . #t)
1643 (X-offset . ,Self_alignment_interface::x_aligned_on_self)
1646 ;; sync with Fingering ?
1648 (staff-padding . 0.5)
1650 (stencil . ,Text_interface::print)
1651 (direction . ,Script_interface::calc_direction)
1653 (avoid-slur . around)
1654 (slur-padding . 0.5)
1655 (script-priority . 200)
1656 ;; todo: add X self alignment?
1657 (meta . ((class . Item)
1658 (interfaces . (text-script-interface
1660 side-position-interface
1661 font-interface))))))
1665 (stencil . ,Text_spanner::print)
1666 (font-shape . italic)
1667 (style . dashed-line)
1668 (staff-padding . 0.8)
1669 (dash-fraction . 0.2)
1672 (meta . ((class . Spanner)
1673 (interfaces . (text-spanner-interface
1674 side-position-interface
1675 font-interface))))))
1679 (control-points . ,Tie::calc_control_points)
1680 (direction . ,Tie::calc_direction)
1681 (stencil . ,Tie::print)
1682 (details . ((ratio . 0.333)
1683 (height-limit . 1.0)
1684 (between-length-limit . 1.0)))
1686 (meta . ((class . Spanner)
1687 (interfaces . (tie-interface))))
1692 (positioning-done . ,Tie_column::calc_positioning_done)
1693 (before-line-breaking . ,Tie_column::before_line_breaking)
1696 (meta . ((class . Spanner)
1697 (interfaces . (tie-column-interface))))))
1701 (stencil . ,Time_signature::print)
1702 (break-align-symbol . time-signature)
1703 (break-visibility . ,all-visible)
1705 (first-note . (fixed-space . 2.0))
1706 (right-edge . (extra-space . 0.5))
1707 (staff-bar . (minimum-space . 2.0))))
1710 (meta . ((class . Item)
1711 (interfaces . (time-signature-interface
1712 break-aligned-interface
1713 font-interface))))))
1717 (stencil . ,Dynamic_text_spanner::print)
1718 (edge-text . ,(cons (make-musicglyph-markup "scripts.trill")
1721 (staff-padding . 1.0)
1724 (Y-offset . ,Side_position_interface::y_aligned_side)
1725 (meta . ((class . Spanner)
1726 (interfaces . (text-spanner-interface
1727 side-position-interface
1728 font-interface))))))
1730 (TrillPitchAccidental
1731 . ((X-offset . ,Side_position_interface::x_aligned_side)
1735 (stencil . ,Accidental_interface::print)
1736 (meta . ((class . Item)
1737 (interfaces . (item-interface
1738 accidental-interface
1739 side-position-interface
1740 font-interface))))))
1743 . ((X-offset . ,Side_position_interface::x_aligned_side)
1746 (stencil . ,parenthesize-elements)
1747 (direction . ,RIGHT)
1749 (meta . ((class . Item)
1750 (interfaces . (side-position-interface
1752 rhythmic-head-interface
1754 accidental-interface
1755 axis-group-interface))))))
1759 (stencil . ,Note_head::print)
1761 (Y-offset . ,Staff_symbol_referencer::callback)
1763 (meta . ((class . Item)
1764 (interfaces . (item-interface
1765 rhythmic-head-interface
1767 pitched-trill-interface
1769 staff-symbol-referencer-interface))))))
1775 (edge-height . (0.7 . 0.7))
1776 (shorten-pair . (-0.2 . -0.2))
1777 (direction . ,Tuplet_bracket::calc_direction)
1778 (positions . ,Tuplet_bracket::calc_positions)
1779 (stencil . ,Tuplet_bracket::print)
1780 (font-shape . italic)
1782 (meta . ((class . Spanner)
1783 (interfaces . (text-interface
1785 tuplet-bracket-interface
1786 font-interface))))))
1790 (stencil . ,Text_interface::print)
1791 (font-shape . italic)
1792 (no-spacing-rods . #t)
1793 (self-alignment-X . 0)
1795 (padding . 0.0) ;; padding relative to UnaCordaPedalLineSpanner
1796 (X-offset . ,Self_alignment_interface::x_aligned_on_self)
1797 (meta . ((class . Item)
1798 (interfaces . (text-interface
1799 self-alignment-interface
1800 font-interface))))))
1802 (UnaCordaPedalLineSpanner
1805 (X-extent . ,Axis_group_interface::height)
1806 (Y-offset . ,Side_position_interface::y_aligned_side)
1808 (staff-padding . 1.2)
1809 (minimum-space . 1.0)
1811 (meta . ((class . Spanner)
1812 (interfaces . (piano-pedal-interface
1813 axis-group-interface
1814 side-position-interface))))))
1820 (stencil . ,Vaticana_ligature::print)
1821 (meta . ((class . Spanner)
1822 (interfaces . (vaticana-ligature-interface
1823 font-interface))))))
1828 (positioning-done . ,Align_interface::calc_positioning_done)
1829 (after-line-breaking . ,Align_interface::stretch_after_break)
1830 (Y-extent . ,Axis_group_interface::height)
1831 (X-extent . ,Axis_group_interface::width)
1833 (meta . ((class . Spanner)
1834 (interfaces . (align-interface
1835 axis-group-interface))))))
1839 (Y-offset . ,Hara_kiri_group_spanner::force_hara_kiri_callback)
1840 (Y-extent . ,Hara_kiri_group_spanner::y_extent)
1841 (X-extent . ,Axis_group_interface::width)
1842 (meta . ((class . Spanner)
1843 (interfaces . (axis-group-interface
1844 hara-kiri-group-interface
1845 vertically-spaceable-interface))))))
1850 (Y-offset . ,Side_position_interface::y_aligned_on_support_refpoints)
1852 (space-alist . ((left-edge . (extra-space . 1.0))))
1853 (break-align-symbol . instrument-name)
1854 (stencil . ,Text_interface::print)
1855 (break-align-symbol . clef)
1856 (break-visibility . ,begin-of-line-visible)
1858 (meta . ((class . Item)
1859 (interfaces . (font-interface
1860 self-alignment-interface
1861 side-position-interface
1863 break-aligned-interface))))))
1867 (stencil . ,Volta_bracket_interface::print)
1868 (after-line-breaking . ,Volta_bracket_interface::after_line_breaking)
1871 (font-encoding . fetaNumber)
1872 (Y-offset . ,Side_position_interface::y_aligned_side)
1873 (thickness . 1.6) ;; linethickness
1874 (edge-height . (2.0 . 2.0)) ;; staffspace;
1877 (meta . ((class . Spanner)
1878 (interfaces . (volta-bracket-interface
1879 horizontal-bracket-interface
1882 side-position-interface
1894 (stencil . ,Line_spanner::print)
1895 (after-line-breaking . ,Line_spanner::after_line_breaking)
1896 (meta . ((class . Spanner)
1897 (interfaces . (line-spanner-interface
1903 (define (completize-grob-entry x)
1904 "Transplant assoc key into 'name entry of 'meta of X. Set interfaces for Item, Spanner etc.
1906 ;; (display (car x))
1908 (let* ((name-sym (car x))
1909 (grob-entry (cdr x))
1910 (meta-entry (cdr (assoc 'meta grob-entry)))
1911 (class (cdr (assoc 'class meta-entry)))
1913 (cdr (assoc 'interfaces meta-entry))))
1917 (set! ifaces-entry (cons 'item-interface ifaces-entry)))
1918 ((eq? 'Spanner class)
1919 (set! ifaces-entry (cons 'spanner-interface ifaces-entry)))
1920 ((eq? 'Paper_column class)
1921 (set! ifaces-entry (cons 'item-interface
1922 (cons 'paper-column-interface ifaces-entry))))
1923 ((eq? 'System class)
1924 (set! ifaces-entry (cons 'system-interface
1925 (cons 'spanner-interface ifaces-entry))))
1927 (ly:warning "Unknown class ~a" class)))
1928 (set! ifaces-entry (cons 'grob-interface ifaces-entry))
1930 (set! meta-entry (assoc-set! meta-entry 'name name-sym))
1931 (set! meta-entry (assoc-set! meta-entry 'interfaces
1933 (set! grob-entry (assoc-set! grob-entry 'meta meta-entry))
1934 (cons name-sym grob-entry)))
1936 (set! all-grob-descriptions (map completize-grob-entry all-grob-descriptions))
1938 ;; (display (map pair? all-grob-descriptions))
1940 ;; make sure that \property Foo.Bar =\turnOff doesn't complain
1943 ;; (display (car x)) (newline)
1945 (set-object-property! (car x) 'translation-type? list?)
1946 (set-object-property! (car x) 'is-grob? #t))
1947 all-grob-descriptions)
1949 (set! all-grob-descriptions (sort all-grob-descriptions alist<?))