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.1)
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
914 lyric-hyphen-interface spacing-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)
953 (meta . ((class . Item)
954 (interfaces . (text-interface
955 side-position-interface
957 metronome-mark-interface))))))
961 (Y-offset . ,Side_position_interface::y_aligned_side)
964 (stencil . ,Measure_grouping::print)
971 (meta . ((class . Spanner)
972 (interfaces . (side-position-interface
973 measure-grouping-interface))))))
978 (stencil . ,Multi_measure_rest::print)
980 (Y-offset . ,Staff_symbol_referencer::callback)
983 (thick-thickness . 6.6)
984 (hair-thickness . 2.0)
986 (meta . ((class . Spanner)
987 (interfaces . (multi-measure-rest-interface
988 multi-measure-interface
991 staff-symbol-referencer-interface))))))
994 (MultiMeasureRestNumber
996 (springs-and-rods . ,Multi_measure_rest::set_spacing_rods)
997 (stencil . ,Text_interface::print)
998 (X-offset . ,(ly:make-simple-closure
999 `(,+ ,(ly:make-simple-closure (list Self_alignment_interface::x_aligned_on_self))
1000 ,(ly:make-simple-closure (list Self_alignment_interface::x_centered_on_y_parent)))))
1001 (Y-offset . ,Side_position_interface::y_aligned_side)
1004 (self-alignment-X . 0)
1007 (staff-padding . 0.4)
1008 (font-encoding . fetaNumber)
1009 (meta . ((class . Spanner)
1010 (interfaces . (side-position-interface
1011 multi-measure-interface
1012 self-alignment-interface
1017 (MultiMeasureRestText
1019 (stencil . ,Text_interface::print)
1020 (X-offset . ,(ly:make-simple-closure
1021 `(,+ ,(ly:make-simple-closure (list Self_alignment_interface::x_centered_on_y_parent))
1022 ,(ly:make-simple-closure (list Self_alignment_interface::x_aligned_on_self)))))
1024 (Y-offset . ,Side_position_interface::y_aligned_side)
1025 (self-alignment-X . 0)
1028 (staff-padding . 0.25)
1029 (meta . ((class . Spanner)
1030 (interfaces . (side-position-interface
1031 multi-measure-interface
1032 self-alignment-interface
1034 text-interface))))))
1040 (X-extent . ,Axis_group_interface::width)
1041 (Y-extent . ,Axis_group_interface::height)
1042 (positioning-done . ,Note_collision_interface::calc_positioning_done)
1044 (meta . ((class . Item)
1045 (interfaces . (note-collision-interface
1046 axis-group-interface))))))
1051 (X-extent . ,Axis_group_interface::width)
1052 (Y-extent . ,Axis_group_interface::height)
1054 (meta . ((class . Item)
1055 (interfaces . (axis-group-interface
1056 note-column-interface))))))
1061 (stencil . ,Note_head::print)
1062 (stem-attachment . ,Note_head::calc_stem_attachment)
1063 (glyph-name . ,note-head::calc-glyph-name)
1064 (Y-offset . ,Staff_symbol_referencer::callback)
1065 (X-offset . ,Note_head::stem_x_shift)
1066 (meta . ((class . Item)
1067 (interfaces . (rhythmic-grob-interface
1068 rhythmic-head-interface
1072 staff-symbol-referencer-interface))))))
1076 (stem-spacing-correction . 0.5)
1077 (same-direction-correction . 0.25)
1078 ;; Changed this from 0.75.
1079 ;; If you ever change this back, please document! --hwn
1080 (knee-spacing-correction . 1.0)
1082 (meta . ((class . Item)
1083 (interfaces . (spacing-interface
1084 note-spacing-interface))))))
1089 (stencil . ,Text_interface::print)
1091 (meta . ((class . Item)
1092 (interfaces . (note-name-interface
1094 font-interface))))))
1098 (self-alignment-X . 0)
1099 (break-visibility . ,begin-of-line-visible)
1100 (X-offset . ,(ly:make-simple-closure
1101 `(,+ ,(ly:make-simple-closure (list Self_alignment_interface::x_aligned_on_self))
1102 ,(ly:make-simple-closure (list Self_alignment_interface::centered_on_x_parent)))))
1104 (Y-offset . ,Side_position_interface::y_aligned_side)
1106 (stencil . ,Text_interface::print)
1109 ;; no Y dimensions, because of lyrics under tenor clef.
1110 (Y-extent . (0 . 0))
1111 (font-shape . italic)
1113 (staff-padding . 0.2)
1115 (meta . ((class . Item)
1116 (interfaces . (text-interface
1117 self-alignment-interface
1118 side-position-interface
1119 font-interface))))))
1123 (Y-offset . ,Side_position_interface::y_aligned_side)
1125 (stencil . ,Ottava_bracket::print)
1127 (font-shape . italic)
1128 (shorten-pair . (0.0 . -0.6))
1129 (staff-padding . 1.0)
1131 (minimum-length . 1.0)
1132 (dash-fraction . 0.3)
1133 (edge-height . (0 . 1.2))
1135 (meta . ((class . Spanner)
1136 (interfaces . (ottava-bracket-interface
1137 horizontal-bracket-interface
1139 side-position-interface
1141 text-interface))))))
1147 (before-line-breaking . ,Paper_column::before_line_breaking)
1148 ;; (stencil . ,Paper_column::print)
1149 (X-extent . ,Axis_group_interface::width)
1153 ;; (font-size . -6) (font-name . "sans") (Y-extent . #f)
1154 (meta . ((class . Paper_column)
1155 (interfaces . (paper-column-interface
1156 axis-group-interface
1157 spaceable-grob-interface))))))
1160 . ((slur-details . ,default-slur-details)
1162 (control-points . ,Slur::calc_control_points)
1163 (direction . ,Slur::calc_direction)
1164 (springs-and-rods . ,Spanner::set_spacing_rods)
1165 (Y-extent . ,Slur::height)
1166 (stencil . ,Slur::print)
1170 (minimum-length . 1.5)
1171 (height-limit . 2.0)
1173 (meta . ((class . Spanner)
1174 (interfaces . (slur-interface))))))
1176 (NonMusicalPaperColumn
1180 (before-line-breaking . ,Paper_column::before_line_breaking)
1181 (X-extent . ,Axis_group_interface::width)
1182 ;; (stencil . ,Paper_column::print)
1186 ;; debugging stuff: print column number.
1187 ;; (font-size . -6) (font-name . "sans") (Y-extent . #f)
1189 (meta . ((class . Paper_column)
1190 (interfaces . (paper-column-interface
1191 axis-group-interface
1192 spaceable-grob-interface))))))
1197 (springs-and-rods . ,Multi_measure_rest::set_spacing_rods)
1198 (stencil . ,Multi_measure_rest::percent)
1202 (font-encoding . fetaMusic)
1203 (meta . ((class . Spanner)
1204 (interfaces . (multi-measure-rest-interface
1206 percent-repeat-interface))))))
1207 (PercentRepeatCounter
1209 (stencil . ,Text_interface::print)
1210 (X-offset . ,(ly:make-simple-closure
1211 `(,+ ,(ly:make-simple-closure (list Self_alignment_interface::x_centered_on_y_parent))
1212 ,(ly:make-simple-closure (list Self_alignment_interface::x_aligned_on_self)))))
1213 (Y-offset . ,Side_position_interface::y_aligned_side)
1214 (self-alignment-X . 0)
1217 (staff-padding . 0.25)
1219 (font-encoding . fetaNumber)
1220 (meta . ((class . Spanner)
1221 (interfaces . (side-position-interface
1222 self-alignment-interface
1223 percent-repeat-interface
1225 text-interface))))))
1227 ;; an example of a text spanner
1231 (stencil . ,Piano_pedal_bracket::print)
1234 (bound-padding . 1.0)
1236 (bracket-flare . (0.5 . 0.5))
1237 (edge-height . (1.0 . 1.0))
1238 (shorten-pair . (0.0 . 0.0))
1240 (meta . ((class . Spanner)
1241 (interfaces . (line-interface
1242 piano-pedal-interface
1243 piano-pedal-bracket-interface))))))
1247 (stencil . ,Text_interface::print)
1248 (X-offset . ,(ly:make-simple-closure
1249 `(,+ ,(ly:make-simple-closure
1250 `(,Self_alignment_interface::x_aligned_on_self))
1251 ,(ly:make-simple-closure
1252 `(,Self_alignment_interface::centered_on_x_parent)))
1254 (Y-offset . ,Side_position_interface::y_aligned_side)
1255 (self-alignment-X . 0)
1260 (break-visibility . ,end-of-line-invisible)
1262 (meta . ((class . Item)
1263 (interfaces . (text-interface
1264 side-position-interface
1267 self-alignment-interface))))))
1273 (stencil . ,Percent_repeat_item_interface::beat_slash)
1277 (meta . ((class . Item)
1278 (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)
1313 (stencil . ,Script_interface::print)
1314 (direction . ,Script_interface::calc_direction)
1316 (font-encoding . fetaMusic)
1317 (meta . ((class . Item)
1318 (interfaces . (script-interface
1319 side-position-interface
1320 font-interface))))))
1325 (before-line-breaking . ,Script_column::before_line_breaking)
1327 (meta . ((class . Item)
1328 (interfaces . (script-column-interface))))))
1334 (meta . ((class . Item)
1335 (interfaces . (spacing-interface
1336 separation-item-interface))))))
1338 (SeparatingGroupSpanner
1341 (springs-and-rods . ,Separating_group_spanner::set_spacing_rods)
1343 (meta . ((class . Spanner)
1344 (interfaces . (only-prebreak-interface
1346 separation-spanner-interface))))))
1349 . ((slur-details . ,default-slur-details)
1351 (control-points . ,Slur::calc_control_points)
1352 (direction . ,Slur::calc_direction)
1353 (springs-and-rods . ,Spanner::set_spacing_rods)
1354 (Y-extent . ,Slur::height)
1355 (stencil . ,Slur::print)
1358 (minimum-length . 1.5)
1360 (height-limit . 2.0)
1362 (meta . ((class . Spanner)
1363 (interfaces . (slur-interface))))))
1368 (springs-and-rods . ,Spacing_spanner::set_springs)
1369 (average-spacing-wishes . #t)
1370 (grace-space-factor . 0.6)
1371 (shortest-duration-space . 2.0)
1372 (spacing-increment . 1.2)
1373 (base-shortest-duration . ,(ly:make-moment 3 16))
1374 (meta . ((class . Spanner)
1375 (interfaces . (spacing-interface
1376 spacing-spanner-interface))))))
1380 (break-align-symbol . staff-bar)
1385 (stencil . ,Span_bar::print)
1386 (bar-size . ,Span_bar::calc_bar_size)
1387 (X-extent . ,Span_bar::width)
1388 (glyph-name . ,Span_bar::calc_glyph_name)
1389 (before-line-breaking . ,Span_bar::before_line_breaking)
1394 ;; Ross. page 151 lists other values, we opt for a leaner look
1398 (hair-thickness . 1.6)
1399 (thick-thickness . 6.0)
1400 (meta . ((class . Item)
1401 (interfaces . (span-bar-interface
1403 bar-line-interface))))))
1407 (stencil . ,Text_interface::print)
1409 (font-series . bold)
1411 (X-offset . ,Side_position_interface::x_aligned_side)
1414 (meta . ((class . Item)
1415 (interfaces . (side-position-interface
1416 stanza-number-interface
1418 font-interface))))))
1423 (stencil . ,print-circled-text-callback)
1426 (staff-padding . 0.5)
1427 (self-alignment-X . 0)
1428 (self-alignment-Y . 0)
1429 (script-priority . 100)
1430 (font-encoding . fetaNumber)
1431 (font-size . -5) ; don't overlap when next to heads.
1432 (meta . ((class . Item)
1433 (interfaces . (string-number-interface
1435 text-script-interface
1437 side-position-interface
1438 self-alignment-interface
1439 item-interface))))))
1444 (stem-spacing-correction . 0.4)
1445 (meta . ((class . Item)
1446 (interfaces . (spacing-interface
1447 staff-spacing-interface))))))
1452 (stencil . ,Text_interface::print)
1455 (X-offset . ,Self_alignment_interface::x_aligned_on_self)
1456 (no-spacing-rods . #t)
1457 (padding . 0.0) ;; padding relative to SostenutoPedalLineSpanner
1458 (font-shape . italic)
1459 (self-alignment-X . 0)
1460 (meta . ((class . Item)
1461 (interfaces . (text-interface
1462 self-alignment-interface
1463 font-interface))))))
1465 (SostenutoPedalLineSpanner
1469 (X-extent . ,Axis_group_interface::height)
1471 (Y-offset . ,Side_position_interface::y_aligned_side)
1475 (minimum-space . 1.0)
1477 (meta . ((class . Spanner)
1478 (interfaces . (piano-pedal-interface
1479 axis-group-interface
1480 side-position-interface))))))
1485 (stencil . ,Staff_symbol::print)
1488 (ledger-line-thickness . (1.0 . 0.1))
1490 (meta . ((class . Spanner)
1491 (interfaces . (staff-symbol-interface))))))
1495 (direction . ,Stem::calc_direction)
1496 (stem-end-position . ,Stem::calc_stem_end_position)
1497 (stem-info . ,Stem::calc_stem_info)
1498 (positioning-done . ,Stem::calc_positioning_done)
1499 (stencil . ,Stem::print)
1500 (X-extent . ,Stem::width)
1501 (Y-extent . ,Stem::height)
1502 (length . ,Stem::calc_length)
1508 ;; 3.5 (or 3 measured from note head) is standard length
1509 ;; 32nd, 64th flagged stems should be longer
1510 (lengths . (3.5 3.5 3.5 4.5 5.0))
1512 ;; FIXME. 3.5 yields too long beams (according to Ross and
1513 ;; looking at Baerenreiter examples) for a number of common
1514 ;; boundary cases. Subtracting half a beam thickness fixes
1515 ;; this, but the bug may well be somewhere else.
1517 ;; FIXME this should come from 'lengths
1518 (beamed-lengths . (3.26 3.5 3.6))
1520 ;; The 'normal' minima
1521 (beamed-minimum-free-lengths . (1.83 1.5 1.25))
1522 ;(beamed-minimum-free-lengths . (2.0 1.83 1.25))
1524 ;; The 'extreme case' minima
1525 (beamed-extreme-minimum-free-lengths . (2.0 1.25))
1527 ;; Stems in unnatural (forced) direction should be shortened by
1528 ;; one staff space, according to [Roush & Gourlay].
1529 ;; Flagged stems we shorten only half a staff space.
1530 (stem-shorten . (1.0 0.5))
1535 ;; default stem direction for note on middle line
1536 (neutral-direction . -1)
1538 ;; We use the normal minima as minimum for the ideal lengths,
1539 ;; and the extreme minima as abolute minimum length.
1541 (X-offset . ,Stem::offset_callback)
1542 (Y-offset . ,Staff_symbol_referencer::callback)
1543 (meta . ((class . Item)
1544 (interfaces . (stem-interface
1545 font-interface))))))
1549 (Y-extent . ,Stem_tremolo::height)
1550 (stencil . ,Stem_tremolo::print)
1552 (beam-width . 1.6) ; staff-space
1553 (beam-thickness . 0.48) ; staff-space
1554 (meta . ((class . Item)
1555 (interfaces . (stem-tremolo-interface))))))
1559 (no-spacing-rods . #t)
1560 (stencil . ,Sustain_pedal::print)
1561 (self-alignment-X . 0)
1563 (padding . 0.0) ;; padding relative to SustainPedalLineSpanner
1564 (X-offset . ,Self_alignment_interface::x_aligned_on_self)
1565 (meta . ((class . Item)
1566 (interfaces . (piano-pedal-interface
1567 text-spanner-interface
1569 self-alignment-interface
1570 font-interface))))))
1572 (SustainPedalLineSpanner
1575 (X-extent . ,Axis_group_interface::height)
1576 (Y-offset . ,Side_position_interface::y_aligned_side)
1579 (staff-padding . 1.2)
1580 (minimum-space . 1.0)
1582 (meta . ((class . Spanner)
1583 (interfaces . (piano-pedal-interface
1584 axis-group-interface
1585 side-position-interface))))))
1590 (X-extent . ,Axis_group_interface::width)
1591 (Y-extent . ,Axis_group_interface::height)
1592 (meta . ((class . System)
1593 (interfaces . (system-interface
1594 axis-group-interface))))))
1600 (stencil . ,System_start_delimiter::print)
1601 (collapse-height . 5.0)
1602 (X-offset . ,Side_position_interface::x_aligned_side)
1604 (font-encoding . fetaBraces)
1606 (meta . ((class . Spanner)
1607 (interfaces . (system-start-delimiter-interface
1608 side-position-interface
1609 font-interface))))))
1614 (X-offset . ,Side_position_interface::x_aligned_side)
1616 (stencil . ,System_start_delimiter::print)
1617 (style . line-bracket)
1619 (meta . ((class . Spanner)
1620 (interfaces . (font-interface
1621 side-position-interface
1622 system-start-delimiter-interface))))))
1627 (X-offset . ,Side_position_interface::x_aligned_side)
1629 (stencil . ,System_start_delimiter::print)
1631 (collapse-height . 5.0)
1633 (meta . ((class . Spanner)
1634 (interfaces . (font-interface
1635 side-position-interface
1636 system-start-delimiter-interface))))))
1642 (X-offset . ,Side_position_interface::x_aligned_side)
1646 (stencil . ,System_start_delimiter::print)
1647 (meta . ((class . Spanner)
1648 (interfaces . (side-position-interface
1649 system-start-delimiter-interface))))))
1655 (stencil . ,Text_interface::print)
1656 (Y-offset . ,Staff_symbol_referencer::callback)
1658 (stem-attachment . (1.0 . 1.35))
1659 (font-series . bold)
1660 (meta . ((class . Item)
1662 . (rhythmic-head-interface
1663 font-interface rhythmic-grob-interface
1665 staff-symbol-referencer-interface
1666 text-interface))))))
1670 (no-spacing-rods . #t)
1671 (X-offset . ,Self_alignment_interface::x_aligned_on_self)
1674 ;; sync with Fingering ?
1676 (staff-padding . 0.5)
1678 (stencil . ,Text_interface::print)
1679 (direction . ,Script_interface::calc_direction)
1681 (avoid-slur . around)
1682 (slur-padding . 0.5)
1683 (script-priority . 200)
1684 ;; todo: add X self alignment?
1685 (meta . ((class . Item)
1686 (interfaces . (text-script-interface
1688 side-position-interface
1689 font-interface))))))
1693 (stencil . ,Text_spanner::print)
1694 (Y-offset . ,Side_position_interface::y_aligned_side)
1695 (font-shape . italic)
1696 (style . dashed-line)
1697 (staff-padding . 0.8)
1698 (dash-fraction . 0.2)
1702 (meta . ((class . Spanner)
1703 (interfaces . (text-spanner-interface
1704 side-position-interface
1705 font-interface))))))
1709 (control-points . ,Tie::calc_control_points)
1710 (direction . ,Tie::calc_direction)
1711 (stencil . ,Tie::print)
1712 (details . ((ratio . 0.333)
1713 (height-limit . 1.0)
1714 (between-length-limit . 1.0)))
1716 (meta . ((class . Spanner)
1717 (interfaces . (tie-interface))))
1722 (positioning-done . ,Tie_column::calc_positioning_done)
1723 (before-line-breaking . ,Tie_column::before_line_breaking)
1726 (meta . ((class . Spanner)
1727 (interfaces . (tie-column-interface))))))
1731 (stencil . ,Time_signature::print)
1732 (break-align-symbol . time-signature)
1733 (break-visibility . ,all-visible)
1735 (first-note . (fixed-space . 2.0))
1736 (right-edge . (extra-space . 0.5))
1737 (staff-bar . (minimum-space . 2.0))))
1740 (meta . ((class . Item)
1741 (interfaces . (time-signature-interface
1742 break-aligned-interface
1743 font-interface))))))
1747 (stencil . ,Dynamic_text_spanner::print)
1748 (edge-text . ,(cons (make-musicglyph-markup "scripts.trill")
1751 (staff-padding . 1.0)
1754 (Y-offset . ,Side_position_interface::y_aligned_side)
1756 (meta . ((class . Spanner)
1757 (interfaces . (text-spanner-interface
1758 side-position-interface
1759 font-interface))))))
1761 (TrillPitchAccidental
1762 . ((X-offset . ,Side_position_interface::x_aligned_side)
1767 (stencil . ,Accidental_interface::print)
1768 (meta . ((class . Item)
1769 (interfaces . (item-interface
1770 accidental-interface
1771 side-position-interface
1772 font-interface))))))
1775 . ((X-offset . ,Side_position_interface::x_aligned_side)
1778 (stencil . ,parenthesize-elements)
1779 (direction . ,RIGHT)
1782 (meta . ((class . Item)
1783 (interfaces . (side-position-interface
1785 rhythmic-head-interface
1787 accidental-interface
1788 axis-group-interface))))))
1792 (stencil . ,Note_head::print)
1794 (Y-offset . ,Staff_symbol_referencer::callback)
1796 (meta . ((class . Item)
1797 (interfaces . (item-interface
1798 rhythmic-head-interface
1800 pitched-trill-interface
1802 staff-symbol-referencer-interface))))))
1808 (edge-height . (0.7 . 0.7))
1809 (shorten-pair . (-0.2 . -0.2))
1810 (direction . ,Tuplet_bracket::calc_direction)
1811 (positions . ,Tuplet_bracket::calc_positions)
1812 (stencil . ,Tuplet_bracket::print)
1813 (font-shape . italic)
1815 (meta . ((class . Spanner)
1816 (interfaces . (text-interface
1818 tuplet-bracket-interface
1819 font-interface))))))
1823 (stencil . ,Text_interface::print)
1824 (font-shape . italic)
1825 (no-spacing-rods . #t)
1826 (self-alignment-X . 0)
1828 (padding . 0.0) ;; padding relative to UnaCordaPedalLineSpanner
1829 (X-offset . ,Self_alignment_interface::x_aligned_on_self)
1830 (meta . ((class . Item)
1831 (interfaces . (text-interface
1832 self-alignment-interface
1833 font-interface))))))
1835 (UnaCordaPedalLineSpanner
1838 (X-extent . ,Axis_group_interface::height)
1839 (Y-offset . ,Side_position_interface::y_aligned_side)
1842 (staff-padding . 1.2)
1843 (minimum-space . 1.0)
1845 (meta . ((class . Spanner)
1846 (interfaces . (piano-pedal-interface
1847 axis-group-interface
1848 side-position-interface))))))
1854 (stencil . ,Vaticana_ligature::print)
1855 (meta . ((class . Spanner)
1856 (interfaces . (vaticana-ligature-interface
1857 font-interface))))))
1862 (positioning-done . ,Align_interface::calc_positioning_done)
1863 (after-line-breaking . ,Align_interface::stretch_after_break)
1864 (Y-extent . ,Axis_group_interface::height)
1865 (X-extent . ,Axis_group_interface::width)
1867 (meta . ((class . Spanner)
1868 (interfaces . (align-interface
1869 axis-group-interface))))))
1873 (Y-offset . ,Hara_kiri_group_spanner::force_hara_kiri_callback)
1874 (Y-extent . ,Hara_kiri_group_spanner::y_extent)
1875 (X-extent . ,Axis_group_interface::width)
1876 (meta . ((class . Spanner)
1877 (interfaces . (axis-group-interface
1878 hara-kiri-group-interface
1879 vertically-spaceable-interface))))))
1884 (Y-offset . ,Side_position_interface::y_aligned_on_support_refpoints)
1886 (space-alist . ((left-edge . (extra-space . 1.0))))
1887 (break-align-symbol . instrument-name)
1888 (stencil . ,Text_interface::print)
1889 (break-align-symbol . clef)
1890 (break-visibility . ,begin-of-line-visible)
1893 (meta . ((class . Item)
1894 (interfaces . (font-interface
1895 self-alignment-interface
1896 side-position-interface
1898 break-aligned-interface))))))
1902 (stencil . ,Volta_bracket_interface::print)
1903 (after-line-breaking . ,Volta_bracket_interface::after_line_breaking)
1906 (font-encoding . fetaNumber)
1907 (Y-offset . ,Side_position_interface::y_aligned_side)
1909 (thickness . 1.6) ;; linethickness
1910 (edge-height . (2.0 . 2.0)) ;; staffspace;
1913 (meta . ((class . Spanner)
1914 (interfaces . (volta-bracket-interface
1915 horizontal-bracket-interface
1918 side-position-interface
1930 (stencil . ,Line_spanner::print)
1931 (after-line-breaking . ,Line_spanner::after_line_breaking)
1932 (meta . ((class . Spanner)
1933 (interfaces . (line-spanner-interface
1939 (define (completize-grob-entry x)
1940 "Transplant assoc key into 'name entry of 'meta of X. Set interfaces for Item, Spanner etc.
1942 ;; (display (car x))
1944 (let* ((name-sym (car x))
1945 (grob-entry (cdr x))
1946 (meta-entry (cdr (assoc 'meta grob-entry)))
1947 (class (cdr (assoc 'class meta-entry)))
1949 (cdr (assoc 'interfaces meta-entry))))
1953 (set! ifaces-entry (cons 'item-interface ifaces-entry)))
1954 ((eq? 'Spanner class)
1955 (set! ifaces-entry (cons 'spanner-interface ifaces-entry)))
1956 ((eq? 'Paper_column class)
1957 (set! ifaces-entry (cons 'item-interface
1958 (cons 'paper-column-interface ifaces-entry))))
1959 ((eq? 'System class)
1960 (set! ifaces-entry (cons 'system-interface
1961 (cons 'spanner-interface ifaces-entry))))
1963 (ly:warning "Unknown class ~a" class)))
1964 (set! ifaces-entry (cons 'grob-interface ifaces-entry))
1966 (set! meta-entry (assoc-set! meta-entry 'name name-sym))
1967 (set! meta-entry (assoc-set! meta-entry 'interfaces
1969 (set! grob-entry (assoc-set! grob-entry 'meta meta-entry))
1970 (cons name-sym grob-entry)))
1972 (set! all-grob-descriptions (map completize-grob-entry all-grob-descriptions))
1974 ;; (display (map pair? all-grob-descriptions))
1976 ;; make sure that \property Foo.Bar =\turnOff doesn't complain
1979 ;; (display (car x)) (newline)
1981 (set-object-property! (car x) 'translation-type? list?)
1982 (set-object-property! (car x) 'is-grob? #t))
1983 all-grob-descriptions)
1985 (set! all-grob-descriptions (sort all-grob-descriptions alist<?))