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
38 ,(ly:make-simple-closure (list Self_alignment_interface::centered_on_x_parent))
39 ,(ly:make-simple-closure (list Self_alignment_interface::x_aligned_on_self)))))
40 (self-alignment-X . ,CENTER)
42 (cautionary-style . smaller)
43 (Y-offset . ,Side_position_interface::y_aligned_side)
44 (cautionary-style . parentheses)
46 (staff-padding . 0.25)
49 (meta . ((class . Item)
50 (interfaces . (side-position-interface
53 accidental-suggestion-interface
54 self-alignment-interface
60 (positioning-done . ,Accidental_placement::calc_positioning_done)
61 (X-extent . ,Axis_group_interface::width)
63 ;; this is quite small, but it is very ugly to have
64 ;; accs closer to the previous note than to the next one.
65 (right-padding . 0.15)
66 (meta . ((class . Item)
67 (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 . ,Self_alignment_interface::centered_on_x_parent)
97 (meta . ((class . Item)
98 (interfaces . (ambitus-interface
99 staff-symbol-referencer-interface
103 (font-family . music)
105 (X-offset . ,Side_position_interface::x_aligned_side)
107 (cautionary-style . parentheses)
109 (stencil . ,Accidental_interface::print)
110 (after-line-breaking . ,Accidental_interface::after_line_breaking)
113 (meta . ((class . Item)
114 (interfaces . (item-interface
116 break-aligned-interface
117 side-position-interface
124 (stencil . ,Note_head::print)
125 (glyph-name . ,note-head::calc-glyph-name)
127 (Y-offset . ,Staff_symbol_referencer::callback)
128 (meta . ((class . Item)
129 (interfaces . (font-interface
132 staff-symbol-referencer-interface
133 rhythmic-head-interface
134 ledgered-interface))))))
139 (X-extent . ,Arpeggio::width)
140 (stencil . ,Arpeggio::print)
142 (Y-offset . ,Staff_symbol_referencer::callback)
143 (X-offset . ,Side_position_interface::x_aligned_side)
147 (staff-position . 0.0)
148 (meta . ((class . Item)
149 (interfaces . (arpeggio-interface
150 staff-symbol-referencer-interface
151 side-position-interface
156 (break-align-symbol . staff-bar)
159 (break-visibility . ,all-visible)
162 (stencil . ,Bar_line::print)
163 (glyph-name . ,bar-line::calc-glyph-name)
164 (bar-size . ,Bar_line::calc_bar_size)
167 (time-signature . (extra-space . 0.75))
168 (custos . (minimum-space . 2.0))
169 (clef . (minimum-space . 1.0))
170 (key-signature . (extra-space . 1.0))
171 (key-cancellation . (extra-space . 1.0))
172 (first-note . (fixed-space . 1.3))
173 (next-note . (semi-fixed-space . 1.3))
174 (right-edge . (extra-space . 0.0))))
177 ;; Ross. page 151 lists other values, we opt for a leaner look
180 ;; kern should scale with linethickness too.
183 (hair-thickness . 1.9)
184 (thick-thickness . 6.0)
185 (meta . ((class . Item)
186 (interfaces . (bar-line-interface
187 break-aligned-interface
192 (stencil . ,Text_interface::print)
194 (break-visibility . ,begin-of-line-visible)
197 (font-family . roman)
199 (Y-offset . ,Side_position_interface::y_aligned_side)
201 (X-offset . ,Self_alignment_interface::x_aligned_on_self)
202 (self-alignment-X . 1)
206 (interfaces . (side-position-interface
208 self-alignment-interface
210 break-aligned-interface))))
216 (stencil . ,Text_interface::print)
218 (meta . ((class . Item)
219 (interfaces . (text-interface
220 rhythmic-grob-interface
221 bass-figure-interface
226 (stencil . ,Enclosing_bracket::print)
228 (edge-height . (0.2 . 0.2))
229 (meta . ((class . Item)
230 (interfaces . (enclosing-bracket-interface)) ))
232 (BassFigureContinuation
235 (stencil . ,Figured_bass_continuation::print)
237 (Y-offset . ,Figured_bass_continuation::center_on_figures)
238 (meta . ((class . Spanner)
239 (interfaces . (figured-bass-continuation-interface))
245 (Y-extent . ,Axis_group_interface::height)
247 (meta . ((class . Spanner)
248 (interfaces . (axis-group-interface
254 (threshold . (2 . 1000))
256 (positioning-done . ,Align_interface::calc_positioning_done)
257 (Y-extent . ,Axis_group_interface::height)
260 (meta . ((class . Spanner)
261 (interfaces . (align-interface
262 axis-group-interface))))))
266 ;; todo: clean this up a bit: the list is getting
269 (positions . ,(ly:make-simple-closure
270 (ly:make-simple-closure
271 (list chain-grob-member-functions
273 Beam::calc_least_squares_positions
275 Beam::shift_region_to_valid
279 ;; this is a hack to set stem lengths, if positions is set.
280 (quantized-positions . ,Beam::set_stem_lengths)
281 (concaveness . ,Beam::calc_concaveness)
282 (direction . ,Beam::calc_direction)
283 (shorten . ,Beam::calc_stem_shorten)
284 (beaming . ,Beam::calc_beaming)
285 (stencil . ,Beam::print)
287 ;; TODO: should be in SLT.
288 (thickness . 0.48) ; in staff-space
289 (neutral-direction . -1)
291 ;; Whe have some unreferenced problems here.
293 ;; If we shorten beamed stems less than normal stems (1 staffspace),
294 ;; or high order less than 8th beams, patterns like
295 ;; c''4 [c''8 c''] c''4 [c''16 c]
296 ;; are ugly (different stem lengths).
298 ;; But if we shorten 16th beams as much as 8th beams, a single
299 ;; forced 16th beam looks *very* short.
301 ;; We choose to shorten 8th beams the same as single stems,
302 ;; and high order beams less than 8th beams, so that all
303 ;; isolated shortened beams look nice and a bit shortened,
304 ;; sadly possibly breaking patterns with high order beams.
305 (beamed-stem-shorten . (1.0 0.5 0.25))
307 (auto-knee-gap . 5.5)
309 ;; only for debugging.
310 (font-family . roman)
311 (meta . ((class . Spanner)
312 (interfaces . (staff-symbol-referencer-interface
320 (positioning-done . ,Break_align_interface::calc_positioning_done)
321 (X-extent . ,Axis_group_interface::width)
323 (break-align-orders . ;; end of line
345 time-signature custos)
359 (meta . ((class . Item)
360 (interfaces . (break-alignment-interface
361 axis-group-interface))))))
367 (X-extent . ,Axis_group_interface::width)
369 (meta . ((class . Item)
370 (interfaces . (break-aligned-interface
371 axis-group-interface))))))
375 (break-align-symbol . breathing-sign)
378 (ambitus . (extra-space . 2.0))
379 (custos . (minimum-space . 1.0))
380 (key-signature . (minimum-space . 1.5))
381 (time-signature . (minimum-space . 1.5))
382 (staff-bar . (minimum-space . 1.5))
383 (clef . (minimum-space . 2.0))
384 (first-note . (fixed-space . 1.0)) ;huh?
385 (right-edge . (extra-space . 0.1))))
387 (stencil . ,Text_interface::print)
389 (text . ,(make-musicglyph-markup "scripts.rcomma"))
390 (Y-offset . ,Breathing_sign::offset_callback)
391 (break-visibility . ,begin-of-line-invisible)
392 (meta . ((class . Item)
393 (interfaces . (break-aligned-interface
394 breathing-sign-interface
401 (stencil . ,Clef::print)
402 (glyph-name . ,Clef::calc_glyph_name)
405 (font-family . music)
406 (break-align-symbol . clef)
407 (break-visibility . ,begin-of-line-visible)
408 (space-alist . ((ambitus . (extra-space . 2.0))
409 (staff-bar . (extra-space . 0.7))
410 (key-cancellation . (minimum-space . 3.5))
411 (key-signature . (minimum-space . 3.5))
412 (time-signature . (minimum-space . 4.2))
413 (first-note . (minimum-fixed-space . 5.0))
414 (next-note . (extra-space . 0.5))
415 (right-edge . (extra-space . 0.5))))
416 (Y-offset . ,Staff_symbol_referencer::callback)
417 (meta . ((class . Item)
418 (interfaces . (clef-interface
419 staff-symbol-referencer-interface
421 break-aligned-interface))))))
423 (ClusterSpannerBeacon
426 (Y-extent . ,Cluster_beacon::height)
428 (meta . ((class . Item)
429 (interfaces . (cluster-beacon-interface))))))
434 (springs-and-rods . ,Spanner::set_spacing_rods)
435 (stencil . ,Cluster::print)
438 (minimum-length . 0.0)
441 (meta . ((class . Spanner)
442 (interfaces . (cluster-interface))))))
447 (stencil . ,Text_interface::print)
448 (after-line-breaking . ,Chord_name::after_line_breaking)
453 (meta . ((class . Item)
454 (interfaces . (font-interface
455 rhythmic-grob-interface
463 (stencil . ,Text_interface::print)
465 (no-spacing-rods . #t)
466 (Y-offset . ,Side_position_interface::y_aligned_side)
467 (X-offset . ,Self_alignment_interface::x_aligned_on_self)
470 (staff-padding . 0.5)
471 (script-priority . 200)
472 ;; todo: add X self alignment?
476 (meta . ((class . Item)
477 (interfaces . (text-script-interface
479 side-position-interface
484 (break-align-symbol . custos)
487 (stencil . ,Custos::print)
489 (break-visibility . ,end-of-line-visible)
491 (neutral-direction . -1)
492 (Y-offset . ,Staff_symbol_referencer::callback)
494 (first-note . (minimum-fixed-space . 0.0))
495 (right-edge . (extra-space . 0.1))))
496 (meta . ((class . Item)
499 staff-symbol-referencer-interface
501 break-aligned-interface))))))
508 (positioning-done . ,Dot_column::calc_positioning_done)
509 (X-extent . ,Axis_group_interface::width)
511 (X-offset . ,Dot_column::side_position)
512 (meta . ((class . Item)
513 (interfaces . (dot-column-interface
514 axis-group-interface))))))
519 (stencil . ,Dots::print)
522 (meta . ((class . Item)
523 (interfaces . (font-interface
524 staff-symbol-referencer-interface
529 (stencil . ,Percent_repeat_item_interface::double_percent)
532 (font-encoding . fetaMusic)
535 (break-align-symbol . staff-bar)
536 (break-visibility . ,begin-of-line-invisible)
537 (meta . ((class . Item)
538 (interfaces . (font-interface
539 break-aligned-interface
540 percent-repeat-interface))))))
542 (DoublePercentRepeatCounter
545 (stencil . ,Text_interface::print)
546 (X-offset . ,(ly:make-simple-closure `(,+ ,(ly:make-simple-closure (list Self_alignment_interface::centered_on_y_parent))
547 ,(ly:make-simple-closure (list Self_alignment_interface::x_aligned_on_self)))))
548 (Y-offset . ,Side_position_interface::y_aligned_side)
549 (font-encoding . fetaNumber)
550 (self-alignment-X . 0)
554 (staff-padding . 0.25)
556 (meta . ((class . Item)
557 (interfaces . (side-position-interface
558 self-alignment-interface
559 percent-repeat-interface
565 (Y-offset . ,Side_position_interface::y_aligned_side)
566 (staff-padding . 0.1)
568 (avoid-slur . outside)
570 (minimum-space . 1.2)
574 (Y-extent . ,Axis_group_interface::height)
575 (X-extent . ,Axis_group_interface::width)
578 (meta . ((class . Spanner)
579 (interfaces . (axis-group-interface
581 dynamic-line-spanner-interface
582 side-position-interface))))))
589 (stencil . ,Text_interface::print)
590 (direction . ,Script_interface::calc_direction)
592 (X-offset . ,Self_alignment_interface::x_aligned_on_self)
593 (self-alignment-X . 0)
594 (Y-offset . ,Self_alignment_interface::y_aligned_on_self)
595 (self-alignment-Y . 0)
597 (font-encoding . fetaDynamic)
598 (font-shape . italic)
599 (no-spacing-rods . #t)
600 (script-priority . 100)
601 (meta . ((class . Item)
602 (interfaces . (font-interface
604 self-alignment-interface
606 script-interface))))))
611 (stencil . ,Dynamic_text_spanner::print)
613 ;; rather ugh with NCSB
614 ;; (font-series . bold)
615 (font-shape . italic)
616 (style . dashed-line)
618 ;; need to blend with dynamic texts.
620 (bound-padding . 0.75)
621 (dash-fraction . 0.2)
623 (meta . ((class . Spanner)
624 (interfaces . (font-interface
627 dynamic-text-spanner-interface
628 spanner-interface))))))
633 ;; sync with TextScript (?)
636 (avoid-slur . around)
638 (staff-padding . 0.5)
639 (self-alignment-X . 0)
640 (self-alignment-Y . 0)
641 (script-priority . 100)
643 (stencil . ,Text_interface::print)
644 (direction . ,Script_interface::calc_direction)
646 (font-encoding . fetaNumber)
647 (font-size . -5) ; don't overlap when next to heads.
648 (meta . ((class . Item)
649 (interfaces . (finger-interface
651 text-script-interface
653 side-position-interface
654 self-alignment-interface
660 (zigzag-width . 0.75)
665 (stencil . ,Line_spanner::print)
666 (after-line-breaking . ,Line_spanner::after_line_breaking)
669 (meta . ((class . Spanner)
670 (interfaces . (line-interface
671 line-spanner-interface))))))
677 (meta . ((class . Item)
678 (interfaces . (grid-point-interface))))))
683 (X-extent . ,Grid_line_interface::width)
684 (stencil . ,Grid_line_interface::print)
686 (self-alignment-X . ,CENTER)
687 (X-offset . ,(ly:make-simple-closure
688 `(,+ ,(ly:make-simple-closure (list Self_alignment_interface::centered_on_x_parent))
689 ,(ly:make-simple-closure (list Self_alignment_interface::x_aligned_on_self)))))
691 (meta . ((class . Item)
692 (interfaces . (self-alignment-interface
693 grid-line-interface))))))
699 (stencil . ,Hairpin::print)
700 (springs-and-rods . ,Spanner::set_spacing_rods)
701 (after-line-breaking . ,Hairpin::after_line_breaking)
705 (minimum-length . 2.0)
706 (bound-padding . 1.0)
707 (self-alignment-Y . 0)
708 (Y-offset . ,Self_alignment_interface::y_aligned_on_self)
709 (meta . ((class . Spanner)
710 (interfaces . (hairpin-interface
712 self-alignment-interface
714 spanner-interface))))))
719 (stencil . ,Horizontal_bracket::print)
720 (Y-offset . ,Side_position_interface::y_aligned_side)
722 (staff-padding . 0.2)
725 (bracket-flare . (0.5 . 0.5))
726 (meta . ((class . Spanner)
727 (interfaces . (horizontal-bracket-interface
728 side-position-interface
730 spanner-interface))))))
734 (Y-offset . ,(ly:make-simple-closure `(,+ ,(ly:make-simple-closure (list Self_alignment_interface::y_aligned_on_self))
735 ,(ly:make-simple-closure (list Side_position_interface::y_aligned_on_support_refpoints)))))
737 ;; This direction is for aligned_on_support_refpoints
741 (left-edge . (extra-space . 1.0))))
743 (self-alignment-Y . 0)
744 (stencil . ,Text_interface::print)
745 (break-align-symbol . instrument-name)
746 (break-visibility . ,begin-of-line-visible)
749 (meta . ((class . Item)
750 (interfaces . (font-interface
751 self-alignment-interface
752 side-position-interface
754 break-aligned-interface))))))
759 (stencil . ,Key_signature_interface::print)
762 (time-signature . (extra-space . 1.25))
763 (staff-bar . (extra-space . 0.6))
764 (key-signature . (extra-space . 0.5))
765 (right-edge . (extra-space . 0.5))
766 (first-note . (fixed-space . 2.5))))
767 (Y-offset . ,Staff_symbol_referencer::callback)
768 (break-align-symbol . key-cancellation)
769 (break-visibility . ,begin-of-line-invisible)
772 (meta . ((class . Item)
773 (interfaces . (key-signature-interface
775 break-aligned-interface))))))
779 (stencil . ,Key_signature_interface::print)
782 (time-signature . (extra-space . 1.15))
783 (staff-bar . (extra-space . 1.1))
784 (right-edge . (extra-space . 0.5))
785 (first-note . (fixed-space . 2.5))))
786 (Y-offset . ,Staff_symbol_referencer::callback)
787 (break-align-symbol . key-signature)
788 (break-visibility . ,begin-of-line-visible)
791 (meta . ((class . Item)
792 (interfaces . (key-signature-interface
794 break-aligned-interface))))))
798 (stencil . ,Tie::print)
799 (control-points . ,Laissez_vibrer_tie::calc_control_points)
800 (direction . ,Laissez_vibrer_tie::calc_direction)
802 (details . ((ratio . 0.333)
803 (height-limit . 1.0)))
805 (meta . ((class . Item)
806 (interfaces . (laissez-vibrer-tie-interface))
810 (LaissezVibrerTieColumn
815 (positioning-done . ,Laissez_vibrer_tie_column::calc_positioning_done)
817 (meta . ((class . Item)
818 (interfaces . (laissez-vibrer-tie-column-interface))
825 (springs-and-rods . ,Ledger_line_spanner::set_spacing_rods)
827 (stencil . ,Ledger_line_spanner::print)
831 (minimum-length-fraction . 0.25)
832 (length-fraction . 0.25)
834 (meta . ((class . Spanner)
835 (interfaces . (ledger-line-interface))))))
839 (break-align-symbol . left-edge)
842 (break-visibility . ,center-invisible)
844 (custos . (extra-space . 0.0))
845 (ambitus . (extra-space . 2.0))
846 (time-signature . (extra-space . 1.0))
847 (staff-bar . (extra-space . 0.0))
848 (breathing-sign . (minimum-space . 0.0))
849 (clef . (extra-space . 0.8))
850 (first-note . (fixed-space . 2.0))
851 (right-edge . (extra-space . 0.0))
852 (key-signature . (extra-space . 0.0))
853 (key-cancellation . (extra-space . 0.0))
855 (meta . ((class . Item)
856 (interfaces . (break-aligned-interface))))))
860 ;; ugh. A ligature bracket is totally different from
865 (edge-height . (0.7 . 0.7))
866 (shorten-pair . (-0.2 . -0.2))
868 (positions . ,Tuplet_bracket::calc_positions)
869 (stencil . ,Tuplet_bracket::print)
871 (meta . ((class . Spanner)
872 (interfaces . (tuplet-bracket-interface
881 (minimum-length . 0.3)
882 (minimum-distance . 0.5)
884 (springs-and-rods . ,Hyphen_spanner::set_spacing_rods)
886 (stencil . ,Hyphen_spanner::print)
889 (meta . ((class . Spanner)
890 (interfaces . (lyric-interface
891 lyric-hyphen-interface
892 spanner-interface))))))
897 (stencil . ,Lyric_extender::print)
899 (thickness . 0.8) ; linethickness
900 (minimum-length . 1.5)
902 (meta . ((class . Spanner)
903 (interfaces . (lyric-interface
904 lyric-extender-interface))))))
907 . ((minimum-distance . 0.3)
908 (springs-and-rods . ,Hyphen_spanner::set_spacing_rods)
912 (meta . ((class . Spanner)
913 (interfaces . (spanner-interface spacing-interface))
919 (stencil . ,Text_interface::print)
921 (X-offset . ,Self_alignment_interface::aligned_on_x_parent)
922 (self-alignment-X . 0)
924 (font-series . bold-narrow)
926 (meta . ((class . Item)
927 (interfaces . (rhythmic-grob-interface
928 lyric-syllable-interface
929 self-alignment-interface
937 (stencil . ,Mensural_ligature::print)
939 (meta . ((class . Spanner)
940 (interfaces . (mensural-ligature-interface
946 (stencil . ,Text_interface::print)
948 (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)
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 . ,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 . ,(ly:make-simple-closure
998 `(,+ ,(ly:make-simple-closure (list Self_alignment_interface::x_aligned_on_self))
999 ,(ly:make-simple-closure (list Self_alignment_interface::x_centered_on_y_parent)))))
1000 (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))))))
1246 (stencil . ,Text_interface::print)
1247 (X-offset . ,(ly:make-simple-closure
1248 `(,+ ,(ly:make-simple-closure
1249 `(,Self_alignment_interface::x_aligned_on_self))
1250 ,(ly:make-simple-closure
1251 `(,Self_alignment_interface::centered_on_x_parent)))
1253 (Y-offset . ,Side_position_interface::y_aligned_side)
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))))))
1280 (stencil . ,Rest::print)
1281 (X-extent . ,Rest::width)
1282 (Y-extent . ,Rest::height)
1283 (Y-offset . ,Rest::y_offset_callback)
1284 (minimum-distance . 0.25)
1285 (meta . ((class . Item)
1286 (interfaces . (font-interface
1287 rhythmic-head-interface
1288 rhythmic-grob-interface
1289 staff-symbol-referencer-interface
1290 rest-interface))))))
1294 (minimum-distance . 0.75)
1295 (positioning-done . ,Rest_collision::calc_positioning_done)
1297 (meta . ((class . Item)
1298 (interfaces . (rest-collision-interface))))))
1302 ;; don't set direction here: it breaks staccato.
1304 ;; This value is sensitive: if too large, staccato dots will move a
1307 (staff-padding . 0.25)
1308 ;; (script-priority . 0) priorities for scripts, see script.scm
1309 (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)
1368 (average-spacing-wishes . #t)
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)
1413 (meta . ((class . Item)
1414 (interfaces . (side-position-interface
1415 stanza-number-interface
1417 font-interface))))))
1422 (stencil . ,print-circled-text-callback)
1425 (staff-padding . 0.5)
1426 (self-alignment-X . 0)
1427 (self-alignment-Y . 0)
1428 (script-priority . 100)
1429 (font-encoding . fetaNumber)
1430 (font-size . -5) ; don't overlap when next to heads.
1431 (meta . ((class . Item)
1432 (interfaces . (string-number-interface
1434 text-script-interface
1436 side-position-interface
1437 self-alignment-interface
1438 item-interface))))))
1443 (stem-spacing-correction . 0.4)
1444 (meta . ((class . Item)
1445 (interfaces . (spacing-interface
1446 staff-spacing-interface))))))
1451 (stencil . ,Text_interface::print)
1454 (X-offset . ,Self_alignment_interface::x_aligned_on_self)
1455 (no-spacing-rods . #t)
1456 (padding . 0.0) ;; padding relative to SostenutoPedalLineSpanner
1457 (font-shape . italic)
1458 (self-alignment-X . 0)
1459 (meta . ((class . Item)
1460 (interfaces . (text-interface
1461 self-alignment-interface
1462 font-interface))))))
1464 (SostenutoPedalLineSpanner
1468 (X-extent . ,Axis_group_interface::height)
1470 (Y-offset . ,Side_position_interface::y_aligned_side)
1474 (minimum-space . 1.0)
1476 (meta . ((class . Spanner)
1477 (interfaces . (piano-pedal-interface
1478 axis-group-interface
1479 side-position-interface))))))
1484 (stencil . ,Staff_symbol::print)
1487 (ledger-line-thickness . (1.0 . 0.1))
1489 (meta . ((class . Spanner)
1490 (interfaces . (staff-symbol-interface))))))
1494 (direction . ,Stem::calc_direction)
1495 (stem-end-position . ,Stem::calc_stem_end_position)
1496 (stem-info . ,Stem::calc_stem_info)
1497 (positioning-done . ,Stem::calc_positioning_done)
1498 (stencil . ,Stem::print)
1499 (X-extent . ,Stem::width)
1500 (Y-extent . ,Stem::height)
1501 (length . ,Stem::calc_length)
1507 ;; 3.5 (or 3 measured from note head) is standard length
1508 ;; 32nd, 64th flagged stems should be longer
1509 (lengths . (3.5 3.5 3.5 4.5 5.0))
1511 ;; FIXME. 3.5 yields too long beams (according to Ross and
1512 ;; looking at Baerenreiter examples) for a number of common
1513 ;; boundary cases. Subtracting half a beam thickness fixes
1514 ;; this, but the bug may well be somewhere else.
1516 ;; FIXME this should come from 'lengths
1517 (beamed-lengths . (3.26 3.5 3.6))
1519 ;; The 'normal' minima
1520 (beamed-minimum-free-lengths . (1.83 1.5 1.25))
1521 ;(beamed-minimum-free-lengths . (2.0 1.83 1.25))
1523 ;; The 'extreme case' minima
1524 (beamed-extreme-minimum-free-lengths . (2.0 1.25))
1526 ;; Stems in unnatural (forced) direction should be shortened by
1527 ;; one staff space, according to [Roush & Gourlay].
1528 ;; Flagged stems we shorten only half a staff space.
1529 (stem-shorten . (1.0 0.5))
1534 ;; default stem direction for note on middle line
1535 (neutral-direction . -1)
1537 ;; We use the normal minima as minimum for the ideal lengths,
1538 ;; and the extreme minima as abolute minimum length.
1540 (X-offset . ,Stem::offset_callback)
1541 (Y-offset . ,Staff_symbol_referencer::callback)
1542 (meta . ((class . Item)
1543 (interfaces . (stem-interface
1544 font-interface))))))
1548 (Y-extent . ,Stem_tremolo::height)
1549 (stencil . ,Stem_tremolo::print)
1551 (beam-width . 1.6) ; staff-space
1552 (beam-thickness . 0.48) ; staff-space
1553 (meta . ((class . Item)
1554 (interfaces . (stem-tremolo-interface))))))
1558 (no-spacing-rods . #t)
1559 (stencil . ,Sustain_pedal::print)
1560 (self-alignment-X . 0)
1562 (padding . 0.0) ;; padding relative to SustainPedalLineSpanner
1563 (X-offset . ,Self_alignment_interface::x_aligned_on_self)
1564 (meta . ((class . Item)
1565 (interfaces . (piano-pedal-interface
1566 text-spanner-interface
1568 self-alignment-interface
1569 font-interface))))))
1571 (SustainPedalLineSpanner
1574 (X-extent . ,Axis_group_interface::height)
1575 (Y-offset . ,Side_position_interface::y_aligned_side)
1578 (staff-padding . 1.2)
1579 (minimum-space . 1.0)
1581 (meta . ((class . Spanner)
1582 (interfaces . (piano-pedal-interface
1583 axis-group-interface
1584 side-position-interface))))))
1589 (X-extent . ,Axis_group_interface::width)
1590 (Y-extent . ,Axis_group_interface::height)
1591 (meta . ((class . System)
1592 (interfaces . (system-interface
1593 axis-group-interface))))))
1599 (stencil . ,System_start_delimiter::print)
1600 (collapse-height . 5.0)
1601 (X-offset . ,Side_position_interface::x_aligned_side)
1603 (font-encoding . fetaBraces)
1605 (meta . ((class . Spanner)
1606 (interfaces . (system-start-delimiter-interface
1607 side-position-interface
1608 font-interface))))))
1613 (X-offset . ,Side_position_interface::x_aligned_side)
1615 (stencil . ,System_start_delimiter::print)
1616 (style . line-bracket)
1618 (meta . ((class . Spanner)
1619 (interfaces . (font-interface
1620 side-position-interface
1621 system-start-delimiter-interface))))))
1626 (X-offset . ,Side_position_interface::x_aligned_side)
1628 (stencil . ,System_start_delimiter::print)
1630 (collapse-height . 5.0)
1632 (meta . ((class . Spanner)
1633 (interfaces . (font-interface
1634 side-position-interface
1635 system-start-delimiter-interface))))))
1641 (X-offset . ,Side_position_interface::x_aligned_side)
1645 (stencil . ,System_start_delimiter::print)
1646 (meta . ((class . Spanner)
1647 (interfaces . (side-position-interface
1648 system-start-delimiter-interface))))))
1654 (stencil . ,Text_interface::print)
1655 (Y-offset . ,Staff_symbol_referencer::callback)
1657 (stem-attachment . (1.0 . 1.35))
1658 (font-series . bold)
1659 (meta . ((class . Item)
1661 . (rhythmic-head-interface
1662 font-interface rhythmic-grob-interface
1664 staff-symbol-referencer-interface
1665 text-interface))))))
1669 (no-spacing-rods . #t)
1670 (X-offset . ,Self_alignment_interface::x_aligned_on_self)
1673 ;; sync with Fingering ?
1675 (staff-padding . 0.5)
1677 (stencil . ,Text_interface::print)
1678 (direction . ,Script_interface::calc_direction)
1680 (avoid-slur . around)
1681 (slur-padding . 0.5)
1682 (script-priority . 200)
1683 ;; todo: add X self alignment?
1684 (meta . ((class . Item)
1685 (interfaces . (text-script-interface
1687 side-position-interface
1688 font-interface))))))
1692 (stencil . ,Text_spanner::print)
1693 (Y-offset . ,Side_position_interface::y_aligned_side)
1694 (font-shape . italic)
1695 (style . dashed-line)
1696 (staff-padding . 0.8)
1697 (dash-fraction . 0.2)
1701 (meta . ((class . Spanner)
1702 (interfaces . (text-spanner-interface
1703 side-position-interface
1704 font-interface))))))
1708 (control-points . ,Tie::calc_control_points)
1709 (direction . ,Tie::calc_direction)
1710 (stencil . ,Tie::print)
1711 (details . ((ratio . 0.333)
1712 (height-limit . 1.0)
1713 (between-length-limit . 1.0)))
1715 (meta . ((class . Spanner)
1716 (interfaces . (tie-interface))))
1721 (positioning-done . ,Tie_column::calc_positioning_done)
1722 (before-line-breaking . ,Tie_column::before_line_breaking)
1725 (meta . ((class . Spanner)
1726 (interfaces . (tie-column-interface))))))
1730 (stencil . ,Time_signature::print)
1731 (break-align-symbol . time-signature)
1732 (break-visibility . ,all-visible)
1734 (first-note . (fixed-space . 2.0))
1735 (right-edge . (extra-space . 0.5))
1736 (staff-bar . (minimum-space . 2.0))))
1739 (meta . ((class . Item)
1740 (interfaces . (time-signature-interface
1741 break-aligned-interface
1742 font-interface))))))
1746 (stencil . ,Dynamic_text_spanner::print)
1747 (edge-text . ,(cons (make-musicglyph-markup "scripts.trill")
1750 (staff-padding . 1.0)
1753 (Y-offset . ,Side_position_interface::y_aligned_side)
1755 (meta . ((class . Spanner)
1756 (interfaces . (text-spanner-interface
1757 side-position-interface
1758 font-interface))))))
1760 (TrillPitchAccidental
1761 . ((X-offset . ,Side_position_interface::x_aligned_side)
1766 (stencil . ,Accidental_interface::print)
1767 (meta . ((class . Item)
1768 (interfaces . (item-interface
1769 accidental-interface
1770 side-position-interface
1771 font-interface))))))
1774 . ((X-offset . ,Side_position_interface::x_aligned_side)
1777 (stencil . ,parenthesize-elements)
1778 (direction . ,RIGHT)
1781 (meta . ((class . Item)
1782 (interfaces . (side-position-interface
1784 rhythmic-head-interface
1786 accidental-interface
1787 axis-group-interface))))))
1791 (stencil . ,Note_head::print)
1793 (Y-offset . ,Staff_symbol_referencer::callback)
1795 (meta . ((class . Item)
1796 (interfaces . (item-interface
1797 rhythmic-head-interface
1799 pitched-trill-interface
1801 staff-symbol-referencer-interface))))))
1807 (edge-height . (0.7 . 0.7))
1808 (shorten-pair . (-0.2 . -0.2))
1809 (direction . ,Tuplet_bracket::calc_direction)
1810 (positions . ,Tuplet_bracket::calc_positions)
1811 (stencil . ,Tuplet_bracket::print)
1812 (font-shape . italic)
1814 (meta . ((class . Spanner)
1815 (interfaces . (text-interface
1817 tuplet-bracket-interface
1818 font-interface))))))
1822 (stencil . ,Text_interface::print)
1823 (font-shape . italic)
1824 (no-spacing-rods . #t)
1825 (self-alignment-X . 0)
1827 (padding . 0.0) ;; padding relative to UnaCordaPedalLineSpanner
1828 (X-offset . ,Self_alignment_interface::x_aligned_on_self)
1829 (meta . ((class . Item)
1830 (interfaces . (text-interface
1831 self-alignment-interface
1832 font-interface))))))
1834 (UnaCordaPedalLineSpanner
1837 (X-extent . ,Axis_group_interface::height)
1838 (Y-offset . ,Side_position_interface::y_aligned_side)
1841 (staff-padding . 1.2)
1842 (minimum-space . 1.0)
1844 (meta . ((class . Spanner)
1845 (interfaces . (piano-pedal-interface
1846 axis-group-interface
1847 side-position-interface))))))
1853 (stencil . ,Vaticana_ligature::print)
1854 (meta . ((class . Spanner)
1855 (interfaces . (vaticana-ligature-interface
1856 font-interface))))))
1861 (positioning-done . ,Align_interface::calc_positioning_done)
1862 (after-line-breaking . ,Align_interface::stretch_after_break)
1863 (Y-extent . ,Axis_group_interface::height)
1864 (X-extent . ,Axis_group_interface::width)
1866 (meta . ((class . Spanner)
1867 (interfaces . (align-interface
1868 axis-group-interface))))))
1872 (Y-offset . ,Hara_kiri_group_spanner::force_hara_kiri_callback)
1873 (Y-extent . ,Hara_kiri_group_spanner::y_extent)
1874 (X-extent . ,Axis_group_interface::width)
1875 (meta . ((class . Spanner)
1876 (interfaces . (axis-group-interface
1877 hara-kiri-group-interface
1878 vertically-spaceable-interface))))))
1883 (Y-offset . ,Side_position_interface::y_aligned_on_support_refpoints)
1885 (space-alist . ((left-edge . (extra-space . 1.0))))
1886 (break-align-symbol . instrument-name)
1887 (stencil . ,Text_interface::print)
1888 (break-align-symbol . clef)
1889 (break-visibility . ,begin-of-line-visible)
1892 (meta . ((class . Item)
1893 (interfaces . (font-interface
1894 self-alignment-interface
1895 side-position-interface
1897 break-aligned-interface))))))
1901 (stencil . ,Volta_bracket_interface::print)
1902 (after-line-breaking . ,Volta_bracket_interface::after_line_breaking)
1905 (font-encoding . fetaNumber)
1906 (Y-offset . ,Side_position_interface::y_aligned_side)
1908 (thickness . 1.6) ;; linethickness
1909 (edge-height . (2.0 . 2.0)) ;; staffspace;
1912 (meta . ((class . Spanner)
1913 (interfaces . (volta-bracket-interface
1914 horizontal-bracket-interface
1917 side-position-interface
1929 (stencil . ,Line_spanner::print)
1930 (after-line-breaking . ,Line_spanner::after_line_breaking)
1931 (meta . ((class . Spanner)
1932 (interfaces . (line-spanner-interface
1938 (define (completize-grob-entry x)
1939 "Transplant assoc key into 'name entry of 'meta of X. Set interfaces for Item, Spanner etc.
1941 ;; (display (car x))
1943 (let* ((name-sym (car x))
1944 (grob-entry (cdr x))
1945 (meta-entry (cdr (assoc 'meta grob-entry)))
1946 (class (cdr (assoc 'class meta-entry)))
1948 (cdr (assoc 'interfaces meta-entry))))
1952 (set! ifaces-entry (cons 'item-interface ifaces-entry)))
1953 ((eq? 'Spanner class)
1954 (set! ifaces-entry (cons 'spanner-interface ifaces-entry)))
1955 ((eq? 'Paper_column class)
1956 (set! ifaces-entry (cons 'item-interface
1957 (cons 'paper-column-interface ifaces-entry))))
1958 ((eq? 'System class)
1959 (set! ifaces-entry (cons 'system-interface
1960 (cons 'spanner-interface ifaces-entry))))
1962 (ly:warning "Unknown class ~a" class)))
1963 (set! ifaces-entry (cons 'grob-interface ifaces-entry))
1965 (set! meta-entry (assoc-set! meta-entry 'name name-sym))
1966 (set! meta-entry (assoc-set! meta-entry 'interfaces
1968 (set! grob-entry (assoc-set! grob-entry 'meta meta-entry))
1969 (cons name-sym grob-entry)))
1971 (set! all-grob-descriptions (map completize-grob-entry all-grob-descriptions))
1973 ;; (display (map pair? all-grob-descriptions))
1975 ;; make sure that \property Foo.Bar =\turnOff doesn't complain
1978 ;; (display (car x)) (newline)
1980 (set-object-property! (car x) 'translation-type? list?)
1981 (set-object-property! (car x) 'is-grob? #t))
1982 all-grob-descriptions)
1984 (set! all-grob-descriptions (sort all-grob-descriptions alist<?))