1 ;;;; define-grobs.scm --
3 ;;;; source file of the GNU LilyPond music typesetter
5 ;;;; (c) 1998--2005 Han-Wen Nienhuys <hanwen@cs.uu.nl>
6 ;;;; Jan Nieuwenhuizen <janneke@gnu.org>
8 ;;;; distances are given in linethickness (thicknesses) and
9 ;;;; staffspace (distances)
11 ;;;; WARNING: the meta field should be the last one.
12 ;;;; WARNING: don't use anonymous functions for initialization.
14 ;; TODO: junk the meta field in favor of something more compact?
16 ;;; todo:: reorder sensibly.
18 (define-public all-grob-descriptions
23 (cautionary-style . parentheses)
25 (stencil . ,Accidental_interface::print)
27 . ,Accidental_interface::after_line_breaking)
29 (meta . ((class . Item)
30 (interfaces . (accidental-interface
35 (stencil . ,Accidental_interface::print)
36 (X-offset . ,Self_alignment_interface::centered_on_x_parent)
37 (self-X-offset . Self_alignment_interface::x_aligned_on_self)
38 (self-alignment-X . ,CENTER)
40 (cautionary-style . smaller)
41 (Y-offset . ,Side_position_interface::y_aligned_side)
42 (cautionary-style . parentheses)
44 (staff-padding . 0.25)
46 (meta . ((class . Item)
47 (interfaces . (side-position-interface
50 accidental-suggestion-interface
51 self-alignment-interface
57 (positioning-done . ,Accidental_placement::calc_positioning_done)
58 (X-extent . ,Axis_group_interface::width)
60 ;; this is quite small, but it is very ugly to have
61 ;; accs closer to the previous note than to the next one.
62 (right-padding . 0.15)
63 (meta . ((class . Item)
64 (interfaces . (accidental-placement-interface))))))
68 (X-extent . ,Axis_group_interface::width)
69 (X-extent . ,Axis_group_interface::height)
72 (clef . (extra-space . 0.5))
73 (key-signature . (extra-space . 0.0))
74 (staff-bar . (extra-space . 0.0))
75 (time-signature . (extra-space . 0.0))
76 (first-note . (fixed-space . 0.0))))
78 (break-align-symbol . ambitus)
79 (break-visibility . ,begin-of-line-visible)
80 (meta . ((class . Item)
81 (interfaces . (axis-group-interface
82 break-aligned-interface
83 ambitus-interface))))))
88 (stencil . ,Ambitus::print)
92 (X-offset . ,Self_alignment_interface::centered_on_x_parent)
94 (meta . ((class . Item)
95 (interfaces . (ambitus-interface
96 staff-symbol-referencer-interface
100 (font-family . music)
102 (X-offset . ,Side_position_interface::x_aligned_side)
104 (cautionary-style . parentheses)
106 (stencil . ,Accidental_interface::print)
107 (after-line-breaking . ,Accidental_interface::after_line_breaking)
109 (meta . ((class . Item)
110 (interfaces . (item-interface
112 break-aligned-interface
113 side-position-interface
120 (stencil . ,Note_head::print)
121 (glyph-name . ,note-head::calc-glyph-name)
123 (Y-offset . ,Staff_symbol_referencer::callback)
124 (meta . ((class . Item)
125 (interfaces . (font-interface
128 staff-symbol-referencer-interface
129 rhythmic-head-interface
130 ledgered-interface))))))
135 (X-extent . ,Arpeggio::width)
136 (stencil . ,Arpeggio::print)
138 (Y-offset . ,Staff_symbol_referencer::callback)
139 (X-offset . ,Side_position_interface::x_aligned_side)
142 (staff-position . 0.0)
143 (meta . ((class . Item)
144 (interfaces . (arpeggio-interface
145 staff-symbol-referencer-interface
146 side-position-interface
151 (break-align-symbol . staff-bar)
154 (break-visibility . ,all-visible)
157 (stencil . ,Bar_line::print)
158 (glyph-name . ,bar-line::calc-glyph-name)
159 (bar-size . ,Bar_line::calc_bar_size)
162 (time-signature . (extra-space . 0.75))
163 (custos . (minimum-space . 2.0))
164 (clef . (minimum-space . 1.0))
165 (key-signature . (extra-space . 1.0))
166 (key-cancellation . (extra-space . 1.0))
167 (first-note . (fixed-space . 1.3))
168 (next-note . (semi-fixed-space . 1.3))
169 (right-edge . (extra-space . 0.0))))
172 ;; Ross. page 151 lists other values, we opt for a leaner look
175 ;; kern should scale with linethickness too.
178 (hair-thickness . 1.9)
179 (thick-thickness . 6.0)
180 (meta . ((class . Item)
181 (interfaces . (bar-line-interface
182 break-aligned-interface
188 (stencil . ,Text_interface::print)
191 (break-visibility . ,begin-of-line-visible)
194 (font-family . roman)
196 (Y-offset . ,Side_position_interface::y_aligned_side)
197 (X-offset . ,Self_alignment_interface::x_aligned_on_self)
198 (self-alignment-X . 1)
202 (interfaces . (side-position-interface
204 self-alignment-interface
206 break-aligned-interface))))
212 (stencil . ,Text_interface::print)
214 (Y-offset . ,Self_alignment_interface::y_aligned_on_self)
216 (font-family . number)
218 ;; We must do this, other BFs in
219 ;; layout16 become too small.
222 (meta . ((class . Item)
223 (interfaces . (text-interface
224 rhythmic-grob-interface
225 bass-figure-interface
226 self-alignment-interface
232 (stencil . ,Text_interface::print)
234 (meta . ((class . Item)
235 (interfaces . (text-interface
236 rhythmic-grob-interface
237 bass-figure-interface
242 (stencil . ,Enclosing_bracket::print)
244 (edge-height . (0.2 . 0.2))
245 (meta . ((class . Item)
246 (interfaces . (enclosing-bracket-interface)) ))
248 (BassFigureContinuation
251 (stencil . ,Figured_bass_continuation::print)
253 (Y-offset . ,Figured_bass_continuation::center_on_figures)
254 (meta . ((class . Spanner)
255 (interfaces . (figured-bass-continuation-interface))
261 (Y-extent . ,Axis_group_interface::height)
263 (meta . ((class . Spanner)
264 (interfaces . (axis-group-interface
270 (threshold . (2 . 1000))
272 (positioning-done . ,Align_interface::calc_positioning_done)
273 (Y-extent . ,Axis_group_interface::height)
276 (meta . ((class . Spanner)
277 (interfaces . (align-interface
278 axis-group-interface))))))
282 ;; todo: clean this up a bit: the list is getting
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
293 Beam::set_stem_lengths
296 (concaveness . ,Beam::calc_concaveness)
297 (direction . ,Beam::calc_direction)
298 (stencil . ,Beam::print)
300 ;; TODO: should be in SLT.
301 (thickness . 0.48) ; in staff-space
302 (neutral-direction . -1)
304 ;; Whe have some unreferenced problems here.
306 ;; If we shorten beamed stems less than normal stems (1 staffspace),
307 ;; or high order less than 8th beams, patterns like
308 ;; c''4 [c''8 c''] c''4 [c''16 c]
309 ;; are ugly (different stem lengths).
311 ;; But if we shorten 16th beams as much as 8th beams, a single
312 ;; forced 16th beam looks *very* short.
314 ;; We choose to shorten 8th beams the same as single stems,
315 ;; and high order beams less than 8th beams, so that all
316 ;; isolated shortened beams look nice and a bit shortened,
317 ;; sadly possibly breaking patterns with high order beams.
318 (beamed-stem-shorten . (1.0 0.5 0.25))
320 (auto-knee-gap . 5.5)
322 ;; only for debugging.
323 (font-family . roman)
324 (meta . ((class . Spanner)
325 (interfaces . (staff-symbol-referencer-interface
333 (positioning-done . ,Break_align_interface::calc_positioning_done)
334 (X-extent . ,Axis_group_interface::width)
336 (break-align-orders . ;; end of line
358 time-signature custos)
372 (meta . ((class . Item)
373 (interfaces . (break-alignment-interface
374 axis-group-interface))))))
380 (X-extent . ,Axis_group_interface::width)
382 (meta . ((class . Item)
383 (interfaces . (break-aligned-interface
384 axis-group-interface))))))
388 (break-align-symbol . breathing-sign)
391 (ambitus . (extra-space . 2.0))
392 (custos . (minimum-space . 1.0))
393 (key-signature . (minimum-space . 1.5))
394 (staff-bar . (minimum-space . 1.5))
395 (clef . (minimum-space . 2.0))
396 (first-note . (fixed-space . 1.0)) ;huh?
397 (right-edge . (extra-space . 0.1))))
399 (stencil . ,Text_interface::print)
401 (text . ,(make-musicglyph-markup "scripts.rcomma"))
402 (Y-offset . ,Breathing_sign::offset_callback)
403 (break-visibility . ,begin-of-line-invisible)
404 (meta . ((class . Item)
405 (interfaces . (break-aligned-interface
406 breathing-sign-interface
413 (stencil . ,Clef::print)
414 (glyph-name . ,Clef::calc_glyph_name)
417 (font-family . music)
418 (break-align-symbol . clef)
419 (break-visibility . ,begin-of-line-visible)
420 (space-alist . ((ambitus . (extra-space . 2.0))
421 (staff-bar . (extra-space . 0.7))
422 (key-cancellation . (minimum-space . 4.0))
423 (key-signature . (minimum-space . 4.0))
424 (time-signature . (minimum-space . 4.2))
425 (first-note . (minimum-fixed-space . 5.0))
426 (next-note . (extra-space . 0.5))
427 (right-edge . (extra-space . 0.5))))
428 (Y-offset . ,Staff_symbol_referencer::callback)
429 (meta . ((class . Item)
430 (interfaces . (clef-interface
431 staff-symbol-referencer-interface
433 break-aligned-interface))))))
435 (ClusterSpannerBeacon
438 (Y-extent . ,Cluster_beacon::height)
440 (meta . ((class . Item)
441 (interfaces . (cluster-beacon-interface))))))
446 (springs-and-rods . ,Spanner::set_spacing_rods)
447 (stencil . ,Cluster::print)
450 (minimum-length . 0.0)
453 (meta . ((class . Spanner)
454 (interfaces . (cluster-interface))))))
459 (stencil . ,Text_interface::print)
460 (after-line-breaking . ,Chord_name::after_line_breaking)
465 (meta . ((class . Item)
466 (interfaces . (font-interface
467 rhythmic-grob-interface
475 (stencil . ,Text_interface::print)
477 (no-spacing-rods . #t)
478 (Y-offset . ,Side_position_interface::y_aligned_side)
479 (self-X-offset . ,Self_alignment_interface::x_aligned_on_self)
482 (staff-padding . 0.5)
483 (script-priority . 200)
484 ;; todo: add X self alignment?
487 (meta . ((class . Item)
488 (interfaces . (text-script-interface
490 side-position-interface
495 (break-align-symbol . custos)
498 (stencil . ,Custos::print)
500 (break-visibility . ,end-of-line-visible)
502 (neutral-direction . -1)
503 (Y-offset . ,Staff_symbol_referencer::callback)
505 (first-note . (minimum-fixed-space . 0.0))
506 (right-edge . (extra-space . 0.1))))
507 (meta . ((class . Item)
510 staff-symbol-referencer-interface
512 break-aligned-interface))))))
519 (positioning-done . ,Dot_column::calc_positioning_done)
520 (X-extent . ,Axis_group_interface::width)
522 (X-offset . ,Dot_column::side_position)
523 (meta . ((class . Item)
524 (interfaces . (dot-column-interface
525 axis-group-interface))))))
530 (stencil . ,Dots::print)
533 (meta . ((class . Item)
534 (interfaces . (font-interface
535 staff-symbol-referencer-interface
541 (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)
560 (self-X-offset . ,Self_alignment_interface::x_aligned_on_self)
561 (X-offset . ,Self_alignment_interface::centered_on_y_parent)
562 (Y-offset . ,Side_position_interface::y_aligned_side)
563 (font-encoding . fetaNumber)
564 (self-alignment-X . 0)
568 (staff-padding . 0.25)
569 (meta . ((class . Item)
570 (interfaces . (side-position-interface
571 self-alignment-interface
572 percent-repeat-interface
578 (Y-offset . ,Side_position_interface::y_aligned_side)
579 (staff-padding . 0.1)
581 (avoid-slur . outside)
583 (minimum-space . 1.2)
586 (Y-extent . ,Axis_group_interface::height)
587 (X-extent . ,Axis_group_interface::width)
590 (meta . ((class . Spanner)
591 (interfaces . (axis-group-interface
593 dynamic-line-spanner-interface
594 side-position-interface))))))
601 (stencil . ,Text_interface::print)
602 (direction . ,Script_interface::calc_direction)
604 (self-X-offset . ,Self_alignment_interface::x_aligned_on_self)
605 (self-alignment-X . 0)
606 (self-Y-offset . ,Self_alignment_interface::y_aligned_on_self)
607 (self-alignment-Y . 0)
609 (font-encoding . fetaDynamic)
610 (font-shape . italic)
611 (no-spacing-rods . #t)
612 (script-priority . 100)
613 (meta . ((class . Item)
614 (interfaces . (font-interface
616 self-alignment-interface
618 script-interface))))))
623 (stencil . ,Dynamic_text_spanner::print)
625 ;; rather ugh with NCSB
626 ;; (font-series . bold)
627 (font-shape . italic)
628 (style . dashed-line)
630 ;; need to blend with dynamic texts.
632 (bound-padding . 0.75)
633 (dash-fraction . 0.2)
635 (meta . ((class . Spanner)
636 (interfaces . (font-interface
639 dynamic-text-spanner-interface
640 spanner-interface))))))
645 ;; sync with TextScript (?)
648 (avoid-slur . around)
650 (staff-padding . 0.5)
651 (self-alignment-X . 0)
652 (self-alignment-Y . 0)
653 (script-priority . 100)
655 (stencil . ,Text_interface::print)
656 (direction . ,Script_interface::calc_direction)
658 (font-encoding . fetaNumber)
659 (font-size . -5) ; don't overlap when next to heads.
660 (meta . ((class . Item)
661 (interfaces . (finger-interface
663 text-script-interface
665 side-position-interface
666 self-alignment-interface
672 (zigzag-width . 0.75)
677 (stencil . ,Line_spanner::print)
678 (after-line-breaking . ,Line_spanner::after_line_breaking)
681 (meta . ((class . Spanner)
682 (interfaces . (line-interface
683 line-spanner-interface))))))
689 (meta . ((class . Item)
690 (interfaces . (grid-point-interface))))))
695 (X-extent . ,Grid_line_interface::width)
696 (stencil . ,Grid_line_interface::print)
698 (self-alignment-X . ,CENTER)
699 (self-X-offset . ,Self_alignment_interface::x_aligned_on_self)
700 (X-offset . ,Self_alignment_interface::centered_on_x_parent)
703 (meta . ((class . Item)
704 (interfaces . (self-alignment-interface
705 grid-line-interface))))))
711 (stencil . ,Hairpin::print)
712 (springs-and-rods . ,Spanner::set_spacing_rods)
713 (after-line-breaking . ,Hairpin::after_line_breaking)
717 (minimum-length . 2.0)
718 (bound-padding . 1.0)
719 (self-alignment-Y . 0)
720 (self-Y-offset . ,Self_alignment_interface::y_aligned_on_self)
721 (meta . ((class . Spanner)
722 (interfaces . (hairpin-interface
724 self-alignment-interface
726 spanner-interface))))))
732 (stencil . ,Horizontal_bracket::print)
734 (Y-offset . ,Side_position_interface::y_aligned_side)
736 (staff-padding . 0.2)
738 (bracket-flare . (0.5 . 0.5))
739 (meta . ((class . Spanner)
740 (interfaces . (horizontal-bracket-interface
741 side-position-interface
743 spanner-interface))))))
747 (self-Y-offset . ,Self_alignment_interface::y_aligned_on_self)
748 (Y-offset . ,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.25))
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 (self-X-offset . ,Self_alignment_interface::y_aligned_on_self)
1000 (X-offset . ,Self_alignment_interface::centered_on_y_parent)
1001 (Y-offset . ,Side_position_interface::y_aligned_side)
1002 (self-alignment-X . 0)
1005 (staff-padding . 0.4)
1006 (font-encoding . fetaNumber)
1007 (meta . ((class . Spanner)
1008 (interfaces . (side-position-interface
1009 multi-measure-interface
1010 self-alignment-interface
1016 (MultiMeasureRestText
1018 (stencil . ,Text_interface::print)
1019 (X-offset . ,Self_alignment_interface::centered_on_y_parent)
1020 (self-X-offset . ,Self_alignment_interface::x_aligned_on_self)
1022 (Y-offset . ,Side_position_interface::y_aligned_side)
1023 (self-alignment-X . 0)
1026 (staff-padding . 0.25)
1027 (meta . ((class . Spanner)
1028 (interfaces . (side-position-interface
1029 multi-measure-interface
1030 self-alignment-interface
1032 text-interface))))))
1038 (X-extent . ,Axis_group_interface::width)
1039 (Y-extent . ,Axis_group_interface::height)
1040 (positioning-done . ,Note_collision_interface::calc_positioning_done)
1042 (meta . ((class . Item)
1043 (interfaces . (note-collision-interface
1044 axis-group-interface))))))
1049 (X-extent . ,Axis_group_interface::width)
1050 (Y-extent . ,Axis_group_interface::height)
1052 (meta . ((class . Item)
1053 (interfaces . (axis-group-interface
1054 note-column-interface))))))
1059 (stencil . ,Note_head::print)
1060 (stem-attachment . ,Note_head::calc_stem_attachment)
1061 (glyph-name . ,note-head::calc-glyph-name)
1062 (Y-offset . ,Staff_symbol_referencer::callback)
1063 (X-offset . ,Note_head::stem_x_shift)
1064 (meta . ((class . Item)
1065 (interfaces . (rhythmic-grob-interface
1066 rhythmic-head-interface
1070 staff-symbol-referencer-interface))))))
1074 (stem-spacing-correction . 0.5)
1075 (same-direction-correction . 0.25)
1076 ;; Changed this from 0.75.
1077 ;; If you ever change this back, please document! --hwn
1078 (knee-spacing-correction . 1.0)
1080 (meta . ((class . Item)
1081 (interfaces . (spacing-interface
1082 note-spacing-interface))))))
1087 (stencil . ,Text_interface::print)
1089 (meta . ((class . Item)
1090 (interfaces . (note-name-interface
1092 font-interface))))))
1096 (self-alignment-X . 0)
1097 (break-visibility . ,begin-of-line-visible)
1098 (X-offset . ,Self_alignment_interface::centered_on_x_parent)
1099 (self-X-offset . ,Self_alignment_interface::x_aligned_on_self)
1100 (Y-offset . ,Side_position_interface::y_aligned_side)
1102 (stencil . ,Text_interface::print)
1105 ;; no Y dimensions, because of lyrics under tenor clef.
1106 (Y-extent . (0 . 0))
1107 (font-shape . italic)
1109 (staff-padding . 0.2)
1111 (meta . ((class . Item)
1112 (interfaces . (text-interface
1113 self-alignment-interface
1114 side-position-interface
1115 font-interface))))))
1119 (Y-offset . ,Side_position_interface::y_aligned_side)
1121 (stencil . ,Ottava_bracket::print)
1123 (font-shape . italic)
1124 (shorten-pair . (0.0 . -0.6))
1125 (staff-padding . 1.0)
1127 (minimum-length . 1.0)
1128 (dash-fraction . 0.3)
1129 (edge-height . (0 . 1.2))
1131 (meta . ((class . Spanner)
1132 (interfaces . (ottava-bracket-interface
1133 horizontal-bracket-interface
1135 side-position-interface
1137 text-interface))))))
1143 (before-line-breaking . ,Paper_column::before_line_breaking)
1144 ;; (stencil . ,Paper_column::print)
1145 (X-extent . ,Axis_group_interface::width)
1149 ;; (font-size . -6) (font-name . "sans") (Y-extent . #f)
1150 (meta . ((class . Paper_column)
1151 (interfaces . (paper-column-interface
1152 axis-group-interface
1153 spaceable-grob-interface))))))
1156 . ((slur-details . ,default-slur-details)
1158 (control-points . ,Slur::calc_control_points)
1159 (direction . ,Slur::calc_direction)
1160 (springs-and-rods . ,Spanner::set_spacing_rods)
1161 (Y-extent . ,Slur::height)
1162 (stencil . ,Slur::print)
1166 (minimum-length . 1.5)
1167 (height-limit . 2.0)
1169 (meta . ((class . Spanner)
1170 (interfaces . (slur-interface))))))
1172 (NonMusicalPaperColumn
1176 (before-line-breaking . ,Paper_column::before_line_breaking)
1177 (X-extent . ,Axis_group_interface::width)
1178 ;; (stencil . ,Paper_column::print)
1182 ;; debugging stuff: print column number.
1183 ;; (font-size . -6) (font-name . "sans") (Y-extent . #f)
1185 (meta . ((class . Paper_column)
1186 (interfaces . (paper-column-interface
1187 axis-group-interface
1188 spaceable-grob-interface))))))
1193 (springs-and-rods . ,Multi_measure_rest::set_spacing_rods)
1194 (stencil . ,Multi_measure_rest::percent)
1198 (font-encoding . fetaMusic)
1199 (meta . ((class . Spanner)
1200 (interfaces . (multi-measure-rest-interface
1202 percent-repeat-interface))))))
1203 (PercentRepeatCounter
1206 (stencil . ,Text_interface::print)
1208 (self-X-offset . ,Self_alignment_interface::x_aligned_on_self)
1209 (X-offset . ,Self_alignment_interface::centered_on_y_parent)
1210 (Y-offset . ,Side_position_interface::y_aligned_side)
1211 (self-alignment-X . 0)
1214 (staff-padding . 0.25)
1216 (font-encoding . fetaNumber)
1217 (meta . ((class . Spanner)
1218 (interfaces . (side-position-interface
1219 self-alignment-interface
1220 percent-repeat-interface
1222 text-interface))))))
1224 ;; an example of a text spanner
1228 (stencil . ,Piano_pedal_bracket::print)
1231 (bound-padding . 1.0)
1233 (bracket-flare . (0.5 . 0.5))
1234 (edge-height . (1.0 . 1.0))
1235 (shorten-pair . (0.0 . 0.0))
1237 (meta . ((class . Spanner)
1238 (interfaces . (line-interface
1239 piano-pedal-interface
1240 piano-pedal-bracket-interface))))))
1245 (stencil . ,Text_interface::print)
1247 (self-X-offset . ,Self_alignment_interface::x_aligned_on_self)
1248 (Y-offset . ,Side_position_interface::y_aligned_side)
1250 (after-line-breaking . ,shift-right-at-line-begin)
1252 (self-alignment-X . 0)
1257 (break-visibility . ,end-of-line-invisible)
1259 (meta . ((class . Item)
1260 (interfaces . (text-interface
1261 side-position-interface
1264 self-alignment-interface))))))
1270 (stencil . ,Percent_repeat_item_interface::beat_slash)
1274 (meta . ((class . Item)
1275 (interfaces . (percent-repeat-interface))))))
1279 (stencil . ,Rest::print)
1280 (X-extent . ,Rest::width)
1281 (Y-extent . ,Rest::height)
1282 (Y-offset . ,Rest::y_offset_callback)
1283 (minimum-distance . 0.25)
1284 (meta . ((class . Item)
1285 (interfaces . (font-interface
1286 rhythmic-head-interface
1287 rhythmic-grob-interface
1288 staff-symbol-referencer-interface
1289 rest-interface))))))
1293 (minimum-distance . 0.75)
1294 (positioning-done . ,Rest_collision::calc_positioning_done)
1296 (meta . ((class . Item)
1297 (interfaces . (rest-collision-interface))))))
1301 ;; don't set direction here: it breaks staccato.
1303 ;; This value is sensitive: if too large, staccato dots will move a
1306 (staff-padding . 0.25)
1307 ;; (script-priority . 0) priorities for scripts, see script.scm
1308 (X-offset . ,Self_alignment_interface::centered_on_x_parent)
1310 (stencil . ,Script_interface::print)
1311 (direction . ,Script_interface::calc_direction)
1313 (font-encoding . fetaMusic)
1314 (meta . ((class . Item)
1315 (interfaces . (script-interface
1316 side-position-interface
1317 font-interface))))))
1322 (before-line-breaking . ,Script_column::before_line_breaking)
1324 (meta . ((class . Item)
1325 (interfaces . (script-column-interface))))))
1331 (meta . ((class . Item)
1332 (interfaces . (spacing-interface
1333 separation-item-interface))))))
1335 (SeparatingGroupSpanner
1338 (springs-and-rods . ,Separating_group_spanner::set_spacing_rods)
1340 (meta . ((class . Spanner)
1341 (interfaces . (only-prebreak-interface
1343 separation-spanner-interface))))))
1346 . ((slur-details . ,default-slur-details)
1348 (control-points . ,Slur::calc_control_points)
1349 (direction . ,Slur::calc_direction)
1350 (springs-and-rods . ,Spanner::set_spacing_rods)
1351 (Y-extent . ,Slur::height)
1352 (stencil . ,Slur::print)
1355 (minimum-length . 1.5)
1357 (height-limit . 2.0)
1359 (meta . ((class . Spanner)
1360 (interfaces . (slur-interface))))))
1365 (springs-and-rods . ,Spacing_spanner::set_springs)
1367 (grace-space-factor . 0.6)
1368 (shortest-duration-space . 2.0)
1369 (spacing-increment . 1.2)
1370 (base-shortest-duration . ,(ly:make-moment 3 16))
1371 (meta . ((class . Spanner)
1372 (interfaces . (spacing-interface
1373 spacing-spanner-interface))))))
1377 (break-align-symbol . staff-bar)
1382 (stencil . ,Span_bar::print)
1383 (bar-size . ,Span_bar::calc_bar_size)
1384 (X-extent . ,Span_bar::width)
1385 (glyph-name . ,Span_bar::calc_glyph_name)
1386 (before-line-breaking . ,Span_bar::before_line_breaking)
1391 ;; Ross. page 151 lists other values, we opt for a leaner look
1395 (hair-thickness . 1.6)
1396 (thick-thickness . 6.0)
1397 (meta . ((class . Item)
1398 (interfaces . (span-bar-interface
1400 bar-line-interface))))))
1404 (stencil . ,Text_interface::print)
1406 (font-series . bold)
1408 (X-offset . ,Side_position_interface::x_aligned_side)
1410 (meta . ((class . Item)
1411 (interfaces . (side-position-interface
1412 stanza-number-interface
1414 font-interface))))))
1419 (stencil . ,print-circled-text-callback)
1422 (staff-padding . 0.5)
1423 (self-alignment-X . 0)
1424 (self-alignment-Y . 0)
1425 (script-priority . 100)
1426 (font-encoding . fetaNumber)
1427 (font-size . -5) ; don't overlap when next to heads.
1428 (meta . ((class . Item)
1429 (interfaces . (string-number-interface
1431 text-script-interface
1433 side-position-interface
1434 self-alignment-interface
1435 item-interface))))))
1440 (stem-spacing-correction . 0.4)
1441 (meta . ((class . Item)
1442 (interfaces . (spacing-interface
1443 staff-spacing-interface))))))
1448 (stencil . ,Text_interface::print)
1451 (self-X-offset . ,Self_alignment_interface::x_aligned_on_self)
1452 (no-spacing-rods . #t)
1453 (padding . 0.0) ;; padding relative to SostenutoPedalLineSpanner
1454 (font-shape . italic)
1455 (self-alignment-X . 0)
1456 (meta . ((class . Item)
1457 (interfaces . (text-interface
1458 self-alignment-interface
1459 font-interface))))))
1461 (SostenutoPedalLineSpanner
1465 (X-extent . ,Axis_group_interface::height)
1467 (Y-offset . ,Side_position_interface::y_aligned_side)
1470 (minimum-space . 1.0)
1472 (meta . ((class . Spanner)
1473 (interfaces . (piano-pedal-interface
1474 axis-group-interface
1475 side-position-interface))))))
1480 (stencil . ,Staff_symbol::print)
1483 (ledger-line-thickness . (1.0 . 0.1))
1485 (meta . ((class . Spanner)
1486 (interfaces . (staff-symbol-interface))))))
1490 (direction . ,Stem::calc_direction)
1491 (stem-end-position . ,Stem::calc_stem_end_position)
1492 (stem-info . ,Stem::calc_stem_info)
1493 (positioning-done . ,Stem::calc_positioning_done)
1494 (stencil . ,Stem::print)
1495 (X-extent . ,Stem::width)
1496 (Y-extent . ,Stem::height)
1497 (length . ,Stem::calc_length)
1503 ;; 3.5 (or 3 measured from note head) is standard length
1504 ;; 32nd, 64th flagged stems should be longer
1505 (lengths . (3.5 3.5 3.5 4.5 5.0))
1507 ;; FIXME. 3.5 yields too long beams (according to Ross and
1508 ;; looking at Baerenreiter examples) for a number of common
1509 ;; boundary cases. Subtracting half a beam thickness fixes
1510 ;; this, but the bug may well be somewhere else.
1512 ;; FIXME this should come from 'lengths
1513 (beamed-lengths . (3.26 3.5 3.6))
1515 ;; The 'normal' minima
1516 (beamed-minimum-free-lengths . (1.83 1.5 1.25))
1517 ;(beamed-minimum-free-lengths . (2.0 1.83 1.25))
1519 ;; The 'extreme case' minima
1520 (beamed-extreme-minimum-free-lengths . (2.0 1.25))
1522 ;; Stems in unnatural (forced) direction should be shortened by
1523 ;; one staff space, according to [Roush & Gourlay].
1524 ;; Flagged stems we shorten only half a staff space.
1525 (stem-shorten . (1.0 0.5))
1530 ;; default stem direction for note on middle line
1531 (neutral-direction . -1)
1533 ;; We use the normal minima as minimum for the ideal lengths,
1534 ;; and the extreme minima as abolute minimum length.
1536 (X-offset . ,Stem::offset_callback)
1537 (Y-offset . ,Staff_symbol_referencer::callback)
1538 (meta . ((class . Item)
1539 (interfaces . (stem-interface
1540 font-interface))))))
1544 (Y-extent . ,Stem_tremolo::height)
1545 (stencil . ,Stem_tremolo::print)
1547 (beam-width . 1.6) ; staff-space
1548 (beam-thickness . 0.48) ; staff-space
1549 (meta . ((class . Item)
1550 (interfaces . (stem-tremolo-interface))))))
1554 (no-spacing-rods . #t)
1555 (stencil . ,Sustain_pedal::print)
1556 (self-alignment-X . 0)
1558 (padding . 0.0) ;; padding relative to SustainPedalLineSpanner
1559 (self-X-offset . ,Self_alignment_interface::x_aligned_on_self)
1560 (meta . ((class . Item)
1561 (interfaces . (piano-pedal-interface
1562 text-spanner-interface
1564 self-alignment-interface
1565 font-interface))))))
1567 (SustainPedalLineSpanner
1570 (X-extent . ,Axis_group_interface::height)
1571 (Y-offset . ,Side_position_interface::y_aligned_side)
1573 (staff-padding . 1.2)
1574 (minimum-space . 1.0)
1576 (meta . ((class . Spanner)
1577 (interfaces . (piano-pedal-interface
1578 axis-group-interface
1579 side-position-interface))))))
1584 (X-extent . ,Axis_group_interface::width)
1585 (Y-extent . ,Axis_group_interface::height)
1586 (meta . ((class . System)
1587 (interfaces . (system-interface
1588 axis-group-interface))))))
1593 (stencil . ,System_start_delimiter::print)
1594 (collapse-height . 5.0)
1595 (font-encoding . fetaBraces)
1597 (meta . ((class . Spanner)
1598 (interfaces . (system-start-delimiter-interface
1599 font-interface))))))
1605 (stencil . ,System_start_delimiter::print)
1607 (collapse-height . 5.0)
1609 (meta . ((class . Spanner)
1610 (interfaces . (font-interface
1611 system-start-delimiter-interface))))))
1616 (glyph . "bar-line")
1618 (stencil . ,System_start_delimiter::print)
1619 (meta . ((class . Spanner)
1620 (interfaces . (system-start-delimiter-interface))))))
1625 (stencil . ,Text_interface::print)
1626 (Y-offset . ,Staff_symbol_referencer::callback)
1628 (stem-attachment . (1.0 . 1.35))
1629 (font-series . bold)
1630 (meta . ((class . Item)
1632 . (rhythmic-head-interface
1635 staff-symbol-referencer-interface
1636 text-interface))))))
1640 (no-spacing-rods . #t)
1641 (self-X-offset . ,Self_alignment_interface::x_aligned_on_self)
1644 ;; sync with Fingering ?
1646 (staff-padding . 0.5)
1648 (stencil . ,Text_interface::print)
1649 (direction . ,Script_interface::calc_direction)
1651 (avoid-slur . around)
1652 (slur-padding . 0.5)
1653 (script-priority . 200)
1654 ;; todo: add X self alignment?
1655 (meta . ((class . Item)
1656 (interfaces . (text-script-interface
1658 side-position-interface
1659 font-interface))))))
1663 (stencil . ,Text_spanner::print)
1664 (font-shape . italic)
1665 (style . dashed-line)
1666 (staff-padding . 0.8)
1667 (dash-fraction . 0.2)
1670 (meta . ((class . Spanner)
1671 (interfaces . (text-spanner-interface
1672 side-position-interface
1673 font-interface))))))
1677 (control-points . ,Tie::calc_control_points)
1678 (direction . ,Tie::calc_direction)
1679 (stencil . ,Tie::print)
1680 (details . ((ratio . 0.333)
1681 (height-limit . 1.0)
1682 (between-length-limit . 1.0)))
1684 (meta . ((class . Spanner)
1685 (interfaces . (tie-interface))))
1690 (positioning-done . ,Tie_column::calc_positioning_done)
1691 (before-line-breaking . ,Tie_column::before_line_breaking)
1694 (meta . ((class . Spanner)
1695 (interfaces . (tie-column-interface))))))
1699 (stencil . ,Time_signature::print)
1700 (break-align-symbol . time-signature)
1701 (break-visibility . ,all-visible)
1703 (first-note . (fixed-space . 2.0))
1704 (right-edge . (extra-space . 0.5))
1705 (staff-bar . (minimum-space . 2.0))))
1708 (meta . ((class . Item)
1709 (interfaces . (time-signature-interface
1710 break-aligned-interface
1711 font-interface))))))
1715 (stencil . ,Dynamic_text_spanner::print)
1716 (edge-text . ,(cons (make-musicglyph-markup "scripts.trill")
1719 (staff-padding . 1.0)
1722 (Y-offset . ,Side_position_interface::y_aligned_side)
1723 (meta . ((class . Spanner)
1724 (interfaces . (text-spanner-interface
1725 side-position-interface
1726 font-interface))))))
1728 (TrillPitchAccidental
1729 . ((X-offset . ,Side_position_interface::x_aligned_side)
1733 (stencil . ,Accidental_interface::print)
1734 (meta . ((class . Item)
1735 (interfaces . (item-interface
1736 accidental-interface
1737 side-position-interface
1738 font-interface))))))
1741 . ((X-offset . ,Side_position_interface::x_aligned_side)
1744 (stencil . ,parenthesize-elements)
1745 (direction . ,RIGHT)
1747 (meta . ((class . Item)
1748 (interfaces . (side-position-interface
1750 rhythmic-head-interface
1752 accidental-interface
1753 axis-group-interface))))))
1757 (stencil . ,Note_head::print)
1759 (Y-offset . ,Staff_symbol_referencer::callback)
1761 (meta . ((class . Item)
1762 (interfaces . (item-interface
1763 rhythmic-head-interface
1765 pitched-trill-interface
1767 staff-symbol-referencer-interface))))))
1773 (edge-height . (0.7 . 0.7))
1774 (shorten-pair . (-0.2 . -0.2))
1775 (direction . ,Tuplet_bracket::calc_direction)
1776 (positions . ,Tuplet_bracket::calc_positions)
1777 (stencil . ,Tuplet_bracket::print)
1778 (font-shape . italic)
1780 (meta . ((class . Spanner)
1781 (interfaces . (text-interface
1783 tuplet-bracket-interface
1784 font-interface))))))
1788 (stencil . ,Text_interface::print)
1789 (font-shape . italic)
1790 (no-spacing-rods . #t)
1791 (self-alignment-X . 0)
1793 (padding . 0.0) ;; padding relative to UnaCordaPedalLineSpanner
1794 (self-X-offset . ,Self_alignment_interface::x_aligned_on_self)
1795 (meta . ((class . Item)
1796 (interfaces . (text-interface
1797 self-alignment-interface
1798 font-interface))))))
1800 (UnaCordaPedalLineSpanner
1803 (X-extent . ,Axis_group_interface::height)
1804 (Y-offset . ,Side_position_interface::y_aligned_side)
1806 (staff-padding . 1.2)
1807 (minimum-space . 1.0)
1809 (meta . ((class . Spanner)
1810 (interfaces . (piano-pedal-interface
1811 axis-group-interface
1812 side-position-interface))))))
1818 (stencil . ,Vaticana_ligature::print)
1819 (meta . ((class . Spanner)
1820 (interfaces . (vaticana-ligature-interface
1821 font-interface))))))
1826 (positioning-done . ,Align_interface::calc_positioning_done)
1827 (after-line-breaking . ,Align_interface::stretch_after_break)
1828 (Y-extent . ,Axis_group_interface::height)
1829 (X-extent . ,Axis_group_interface::width)
1831 (meta . ((class . Spanner)
1832 (interfaces . (align-interface
1833 axis-group-interface))))))
1837 (Y-offset . ,Hara_kiri_group_spanner::force_hara_kiri_callback)
1838 (Y-extent . ,Hara_kiri_group_spanner::y_extent)
1839 (X-extent . ,Axis_group_interface::width)
1840 (meta . ((class . Spanner)
1841 (interfaces . (axis-group-interface
1842 vertically-spaceable-interface))))))
1847 (Y-offset . ,Side_position_interface::y_aligned_on_support_refpoints)
1849 (space-alist . ((left-edge . (extra-space . 1.0))))
1850 (break-align-symbol . instrument-name)
1851 (stencil . ,Text_interface::print)
1852 (break-align-symbol . clef)
1853 (break-visibility . ,begin-of-line-visible)
1855 (meta . ((class . Item)
1856 (interfaces . (font-interface
1857 self-alignment-interface
1858 side-position-interface
1860 break-aligned-interface))))))
1864 (stencil . ,Volta_bracket_interface::print)
1865 (after-line-breaking . ,Volta_bracket_interface::after_line_breaking)
1868 (font-encoding . fetaNumber)
1869 (Y-offset . ,Side_position_interface::y_aligned_side)
1870 (thickness . 1.6) ;; linethickness
1871 (edge-height . (2.0 . 2.0)) ;; staffspace;
1874 (meta . ((class . Spanner)
1875 (interfaces . (volta-bracket-interface
1876 horizontal-bracket-interface
1879 side-position-interface
1891 (stencil . ,Line_spanner::print)
1892 (after-line-breaking . ,Line_spanner::after_line_breaking)
1893 (meta . ((class . Spanner)
1894 (interfaces . (line-spanner-interface
1900 (define (completize-grob-entry x)
1901 "Transplant assoc key into 'name entry of 'meta of X. Set interfaces for Item, Spanner etc.
1903 ;; (display (car x))
1905 (let* ((name-sym (car x))
1906 (grob-entry (cdr x))
1907 (meta-entry (cdr (assoc 'meta grob-entry)))
1908 (class (cdr (assoc 'class meta-entry)))
1910 (cdr (assoc 'interfaces meta-entry))))
1914 (set! ifaces-entry (cons 'item-interface ifaces-entry)))
1915 ((eq? 'Spanner class)
1916 (set! ifaces-entry (cons 'spanner-interface ifaces-entry)))
1917 ((eq? 'Paper_column class)
1918 (set! ifaces-entry (cons 'item-interface
1919 (cons 'paper-column-interface ifaces-entry))))
1920 ((eq? 'System class)
1921 (set! ifaces-entry (cons 'system-interface
1922 (cons 'spanner-interface ifaces-entry))))
1924 (ly:warning "Unknown class ~a" class)))
1925 (set! ifaces-entry (cons 'grob-interface ifaces-entry))
1927 (set! meta-entry (assoc-set! meta-entry 'name name-sym))
1928 (set! meta-entry (assoc-set! meta-entry 'interfaces
1930 (set! grob-entry (assoc-set! grob-entry 'meta meta-entry))
1931 (cons name-sym grob-entry)))
1933 (set! all-grob-descriptions (map completize-grob-entry all-grob-descriptions))
1935 ;; (display (map pair? all-grob-descriptions))
1937 ;; make sure that \property Foo.Bar =\turnOff doesn't complain
1940 ;; (display (car x)) (newline)
1942 (set-object-property! (car x) 'translation-type? list?)
1943 (set-object-property! (car x) 'is-grob? #t))
1944 all-grob-descriptions)
1946 (set! all-grob-descriptions (sort all-grob-descriptions alist<?))