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
22 (print-function . ,Accidental_interface::print)
24 (cautionary-style . parentheses)
25 (after-line-breaking-callback . ,Accidental_interface::after_line_breaking)
26 (meta . ((class . Item)
27 (interfaces . (accidental-interface
31 . ((print-function . ,Accidental_interface::print)
32 (X-offset-callbacks . (,Self_alignment_interface::centered_on_parent
33 ,Self_alignment_interface::aligned_on_self))
34 (self-alignment-X . ,CENTER)
36 (cautionary-style . smaller)
37 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
38 (cautionary-style . parentheses)
40 (staff-padding . 0.25)
42 (meta . ((class . Item)
43 (interfaces . (side-position-interface
46 accidental-suggestion-interface
47 self-alignment-interface
50 . ((X-extent-callback . ,Axis_group_interface::group_extent_callback)
53 ;; this is quite small, but it is very ugly to have
54 ;; accs closer to the previous note than to the next one.
55 (right-padding . 0.15)
56 (meta . ((class . Item)
57 (interfaces . (accidental-placement-interface))))))
61 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
62 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
64 (clef . (extra-space . 0.5))
65 (key-signature . (extra-space . 0.0))
66 (staff-bar . (extra-space . 0.0))
67 (time-signature . (extra-space . 0.0))
68 (first-note . (fixed-space . 0.0))))
70 (break-align-symbol . ambitus)
71 (break-visibility . ,begin-of-line-visible)
72 (meta . ((class . Item)
73 (interfaces . (axis-group-interface
74 break-aligned-interface
75 ambitus-interface))))))
79 (print-function . ,Ambitus::print)
82 (X-offset-callbacks . (,Self_alignment_interface::centered_on_parent))
84 (meta . ((class . Item)
85 (interfaces . (ambitus-interface
86 staff-symbol-referencer-interface
90 (print-function . ,Accidental_interface::print)
93 (X-offset-callbacks . (,Side_position_interface::aligned_side))
95 (cautionary-style . parentheses)
96 (after-line-breaking-callback . ,Accidental_interface::after_line_breaking)
97 (meta . ((class . Item)
98 (interfaces . (item-interface
100 break-aligned-interface
101 side-position-interface
107 (print-function . ,Note_head::print)
108 (glyph-name-procedure . ,find-notehead-symbol)
109 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
110 (meta . ((class . Item)
111 (interfaces . (font-interface
114 staff-symbol-referencer-interface
115 rhythmic-head-interface
116 ledgered-interface))))))
120 (X-extent-callback . ,Arpeggio::width_callback)
121 (print-function . ,Arpeggio::print)
122 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
123 (X-offset-callbacks . (,Side_position_interface::aligned_side))
126 (staff-position . 0.0)
127 (meta . ((class . Item)
128 (interfaces . (arpeggio-interface
129 staff-symbol-referencer-interface
130 side-position-interface
135 (break-align-symbol . staff-bar)
137 (break-glyph-function . ,default-break-barline)
139 (bar-size-procedure . ,Bar_line::get_staff_bar_size)
140 (print-function . ,Bar_line::print)
141 (break-visibility . ,all-visible)
143 (before-line-breaking-callback . ,Bar_line::before_line_breaking)
145 (time-signature . (extra-space . 0.75))
146 (custos . (minimum-space . 2.0))
147 (clef . (minimum-space . 1.0))
148 (key-signature . (extra-space . 1.0))
149 (key-cancellation . (extra-space . 1.0))
150 (first-note . (fixed-space . 1.3))
151 (next-note . (semi-fixed-space . 1.3))
152 (right-edge . (extra-space . 0.0))))
155 ;; Ross. page 151 lists other values, we opt for a leaner look
158 ;; kern should scale with linethickness too.
161 (hair-thickness . 1.9)
162 (thick-thickness . 6.0)
163 (meta . ((class . Item)
164 (interfaces . (bar-line-interface
165 break-aligned-interface
170 (print-function . ,Text_interface::print)
172 (break-visibility . ,begin-of-line-visible)
175 (font-family . roman)
177 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
178 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
179 (self-alignment-X . 1)
183 (interfaces . (side-position-interface
185 self-alignment-interface
187 break-aligned-interface))))
192 (print-function . ,Text_interface::print)
193 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
195 (font-family . number)
197 ;; We must do this, other BFs in
198 ;; layout16 become too small.
201 (meta . ((class . Item)
202 (interfaces . (text-interface
203 rhythmic-grob-interface
204 bass-figure-interface
205 self-alignment-interface
209 ;; todo: clean this up a bit: the list is getting
211 (print-function . ,Beam::print)
213 (positions . (#f . #f))
214 (position-callbacks . (,Beam::least_squares
217 ,Beam::shift_region_to_valid
220 ;; TODO: should be in SLT.
221 (thickness . 0.48) ; in staff-space
222 (before-line-breaking-callback . ,Beam::before_line_breaking)
223 (after-line-breaking-callback . ,Beam::after_line_breaking)
224 (neutral-direction . -1)
225 (dir-function . ,beam-dir-majority-median)
227 ;; Whe have some unreferenced problems here.
229 ;; If we shorten beamed stems less than normal stems (1 staffspace),
230 ;; or high order less than 8th beams, patterns like
231 ;; c''4 [c''8 c''] c''4 [c''16 c]
232 ;; are ugly (different stem lengths).
234 ;; But if we shorten 16th beams as much as 8th beams, a single
235 ;; forced 16th beam looks *very* short.
237 ;; We choose to shorten 8th beams the same as single stems,
238 ;; and high order beams less than 8th beams, so that all
239 ;; isolated shortened beams look nice and a bit shortened,
240 ;; sadly possibly breaking patterns with high order beams.
241 (beamed-stem-shorten . (1.0 0.5 0.25))
243 (flag-width-function . ,beam-flag-width-function)
245 (auto-knee-gap . 5.5)
247 ;; only for debugging.
248 (font-family . roman)
250 (space-function . ,Beam::space_function)
251 (meta . ((class . Spanner)
252 (interfaces . (staff-symbol-referencer-interface
259 (break-align-orders . ;; end of line
281 time-signature custos)
295 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
296 (meta . ((class . Item)
297 (interfaces . (break-alignment-interface
298 axis-group-interface))))))
303 (X-offset-callbacks . (,Break_align_interface::alignment_callback))
304 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
305 (meta . ((class . Item)
306 (interfaces . (break-aligned-interface
307 axis-group-interface))))))
311 (break-align-symbol . breathing-sign)
314 (ambitus . (extra-space . 2.0))
315 (custos . (minimum-space . 1.0))
316 (key-signature . (minimum-space . 1.5))
317 (staff-bar . (minimum-space . 1.5))
318 (clef . (minimum-space . 2.0))
319 (first-note . (fixed-space . 1.0)) ;huh?
320 (right-edge . (extra-space . 0.1))))
321 (print-function . ,Text_interface::print)
322 (text . ,(make-musicglyph-markup "scripts.rcomma"))
323 (Y-offset-callbacks . (,Breathing_sign::offset_callback))
324 (break-visibility . ,begin-of-line-invisible)
325 (meta . ((class . Item)
326 (interfaces . (break-aligned-interface
327 breathing-sign-interface
333 (print-function . ,Clef::print)
334 (before-line-breaking-callback . ,Clef::before_line_breaking)
336 (font-family . music)
337 (break-align-symbol . clef)
338 (break-visibility . ,begin-of-line-visible)
339 (space-alist . ((ambitus . (extra-space . 2.0))
340 (staff-bar . (extra-space . 0.7))
341 (key-cancellation . (minimum-space . 4.0))
342 (key-signature . (minimum-space . 4.0))
343 (time-signature . (minimum-space . 4.2))
344 (first-note . (minimum-fixed-space . 5.0))
345 (next-note . (extra-space . 0.5))
346 (right-edge . (extra-space . 0.5))))
347 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
348 (meta . ((class . Item)
349 (interfaces . (clef-interface
350 staff-symbol-referencer-interface
352 break-aligned-interface))))))
354 (ClusterSpannerBeacon
356 (print-function . #f)
357 (Y-extent-callback . ,Cluster_beacon::height)
358 (meta . ((class . Item)
359 (interfaces . (cluster-beacon-interface))))))
363 (print-function . ,Cluster::print)
364 (spacing-procedure . ,Spanner::set_spacing_rods)
365 (minimum-length . 0.0)
368 (meta . ((class . Spanner)
369 (interfaces . (cluster-interface))))))
373 (print-function . ,Text_interface::print)
374 (after-line-breaking-callback . ,Chord_name::after_line_breaking)
378 (meta . ((class . Item)
379 (interfaces . (font-interface
380 rhythmic-grob-interface
387 (print-function . ,Text_interface::print)
388 (no-spacing-rods . #t)
389 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
390 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
393 (staff-padding . 0.5)
394 (script-priority . 200)
395 ;; todo: add X self alignment?
398 (meta . ((class . Item)
399 (interfaces . (text-script-interface
401 side-position-interface
406 (break-align-symbol . custos)
408 (print-function . ,Custos::print)
409 (break-visibility . ,end-of-line-visible)
411 (neutral-direction . -1)
412 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
414 (first-note . (minimum-fixed-space . 0.0))
415 (right-edge . (extra-space . 0.1))))
416 (meta . ((class . Item)
419 staff-symbol-referencer-interface
421 break-aligned-interface))))))
427 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
428 (X-offset-callbacks . (,Dot_column::side_position))
429 (meta . ((class . Item)
430 (interfaces . (dot-column-interface
431 axis-group-interface))))))
435 (print-function . ,Dots::print)
437 (meta . ((class . Item)
438 (interfaces . (font-interface
439 staff-symbol-referencer-interface
444 (print-function . ,Percent_repeat_item_interface::double_percent)
447 (font-encoding . fetaMusic)
450 (break-align-symbol . staff-bar)
451 (break-visibility . ,begin-of-line-invisible)
452 (meta . ((class . Item)
453 (interfaces . (font-interface
454 break-aligned-interface
455 percent-repeat-interface))))))
460 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
461 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
462 (staff-padding . 0.1)
465 (minimum-space . 1.2)
468 (meta . ((class . Spanner)
469 (interfaces . (axis-group-interface
471 dynamic-line-spanner-interface
472 side-position-interface))))))
476 (print-function . ,Text_interface::print)
477 (before-line-breaking-callback . ,Script_interface::before_line_breaking)
478 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
479 (self-alignment-X . 0)
480 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
481 (self-alignment-Y . 0)
483 (font-encoding . fetaDynamic)
484 (font-shape . italic)
485 (no-spacing-rods . #t)
486 (script-priority . 100)
487 (meta . ((class . Item)
488 (interfaces . (font-interface
490 self-alignment-interface
492 script-interface))))))
495 . ((print-function . ,Dynamic_text_spanner::print)
497 ;; rather ugh with NCSB
498 ;; (font-series . bold)
499 (font-shape . italic)
500 (style . dashed-line)
502 ;; need to blend with dynamic texts.
504 (bound-padding . 0.75)
505 (dash-fraction . 0.2)
507 (meta . ((class . Spanner)
508 (interfaces . (font-interface
511 dynamic-text-spanner-interface
512 spanner-interface))))))
516 (print-function . ,Text_interface::print)
518 ; sync with TextScript (?)
521 (staff-padding . 0.5)
522 (self-alignment-X . 0)
523 (self-alignment-Y . 0)
524 (script-priority . 100)
525 (before-line-breaking-callback . ,Script_interface::before_line_breaking)
526 (font-encoding . fetaNumber)
527 (font-size . -5) ; don't overlap when next to heads.
528 (meta . ((class . Item)
529 (interfaces . (finger-interface
531 text-script-interface
533 side-position-interface
534 self-alignment-interface
540 (zigzag-width . 0.75)
542 (X-extent-callback . #f)
543 (Y-extent-callback . #f)
544 (after-line-breaking-callback . ,Line_spanner::after_line_breaking)
545 (print-function . ,Line_spanner::print)
546 (meta . ((class . Spanner)
547 (interfaces . (line-interface
548 line-spanner-interface))))))
554 (meta . ((class . Item)
555 (interfaces . (grid-point-interface))))))
559 (print-function . ,Grid_line_interface::print)
560 (X-extent-callback . ,Grid_line_interface::width_callback)
561 (self-alignment-X . ,CENTER)
562 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
563 ,Self_alignment_interface::centered_on_parent))
565 (meta . ((class . Item)
566 (interfaces . (self-alignment-interface
567 grid-line-interface))))))
571 (print-function . ,Hairpin::print)
572 (after-line-breaking-callback . ,Hairpin::after_line_breaking)
575 (spacing-procedure . ,Spanner::set_spacing_rods)
576 (minimum-length . 2.0)
577 (bound-padding . 1.0)
578 (self-alignment-Y . 0)
579 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
580 (meta . ((class . Spanner)
581 (interfaces . (hairpin-interface
583 self-alignment-interface
585 spanner-interface))))))
590 (print-function . ,Horizontal_bracket::print)
591 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
593 (staff-padding . 0.2)
595 (bracket-flare . (0.5 . 0.5))
596 (meta . ((class . Spanner)
597 (interfaces . (horizontal-bracket-interface
598 side-position-interface
600 spanner-interface))))))
604 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self
605 ,Side_position_interface::aligned_on_support_refpoints))
606 ;; This direction is for aligned_on_support_refpoints
610 (left-edge . (extra-space . 1.0))))
612 (self-alignment-Y . 0)
613 (print-function . ,Text_interface::print)
614 (break-align-symbol . instrument-name)
615 (break-visibility . ,begin-of-line-visible)
617 (meta . ((class . Item)
618 (interfaces . (font-interface
619 self-alignment-interface
620 side-position-interface
622 break-aligned-interface))))))
626 (print-function . ,Key_signature_interface::print)
628 (time-signature . (extra-space . 1.25))
629 (staff-bar . (extra-space . 0.6))
630 (key-signature . (extra-space . 0.5))
631 (right-edge . (extra-space . 0.5))
632 (first-note . (fixed-space . 2.5))))
633 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
634 (break-align-symbol . key-cancellation)
635 (break-visibility . ,begin-of-line-invisible)
638 (meta . ((class . Item)
639 (interfaces . (key-signature-interface
641 break-aligned-interface))))))
644 (print-function . ,Key_signature_interface::print)
646 (time-signature . (extra-space . 1.25))
647 (staff-bar . (extra-space . 1.1))
648 (right-edge . (extra-space . 0.5))
649 (first-note . (fixed-space . 2.5))))
650 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
651 (break-align-symbol . key-signature)
652 (break-visibility . ,begin-of-line-visible)
655 (meta . ((class . Item)
656 (interfaces . (key-signature-interface
658 break-aligned-interface))))))
661 (print-function . ,Ledger_line_spanner::print)
662 (X-extent-callback . #f)
663 (Y-extent-callback . #f)
664 (minimum-length-fraction . 0.25)
665 (length-fraction . 0.25)
666 (spacing-procedure . ,Ledger_line_spanner::set_spacing_rods)
667 (print-function . ,Ledger_line_spanner::print)
669 (meta . ((class . Spanner)
670 (interfaces . (ledger-line-interface))))))
674 (break-align-symbol . left-edge)
677 (break-visibility . ,center-invisible)
679 (custos . (extra-space . 0.0))
680 (ambitus . (extra-space . 2.0))
681 (time-signature . (extra-space . 1.0))
682 (staff-bar . (extra-space . 0.0))
683 (breathing-sign . (minimum-space . 0.0))
684 (clef . (extra-space . 0.8))
685 (first-note . (fixed-space . 2.0))
686 (right-edge . (extra-space . 0.0))
687 (key-signature . (extra-space . 0.0))
688 (key-cancellation . (extra-space . 0.0))
690 (meta . ((class . Item)
691 (interfaces . (break-aligned-interface))))))
695 (ligature-primitive-callback . ,Note_head::print)
700 (edge-height . (0.7 . 0.7))
701 (shorten-pair . (-0.2 . -0.2))
702 (before-line-breaking-callback . ,Tuplet_bracket::before_line_breaking)
703 (after-line-breaking-callback . ,Tuplet_bracket::after_line_breaking)
704 (print-function . ,Tuplet_bracket::print)
705 (meta . ((class . Spanner)
706 (interfaces . (tuplet-bracket-interface
715 (minimum-length . 0.3)
717 ; (spacing-procedure . ,Hyphen_spanner::set_spacing_rods)
718 (print-function . ,Hyphen_spanner::print)
720 (meta . ((class . Spanner)
721 (interfaces . (lyric-interface
722 lyric-hyphen-interface
723 spanner-interface))))))
727 (print-function . ,Lyric_extender::print)
728 (thickness . 0.8) ; linethickness
729 (minimum-length . 1.5)
731 (meta . ((class . Spanner)
732 (interfaces . (lyric-interface
733 lyric-extender-interface))))))
736 . ((print-function . ,Text_interface::print)
737 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_parent))
738 (self-alignment-X . 0)
740 (font-series . bold-narrow)
742 (meta . ((class . Item)
743 (interfaces . (rhythmic-grob-interface
744 lyric-syllable-interface
745 self-alignment-interface
753 (ligature-primitive-callback . ,Mensural_ligature::brew_ligature_primitive)
754 (print-function . ,Mensural_ligature::print)
755 (meta . ((class . Spanner)
756 (interfaces . (mensural-ligature-interface
761 (print-function . ,Text_interface::print)
762 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
765 (meta . ((class . Item)
766 (interfaces . (text-interface
767 side-position-interface
769 metronome-mark-interface))))))
772 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
773 (print-function . ,Measure_grouping::print)
779 (meta . ((class . Spanner)
780 (interfaces . (side-position-interface
781 measure-grouping-interface))))))
784 (spacing-procedure . ,Multi_measure_rest::set_spacing_rods)
785 (print-function . ,Multi_measure_rest::print)
786 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
789 (thick-thickness . 6.6)
790 (hair-thickness . 2.0)
792 (meta . ((class . Spanner)
793 (interfaces . (multi-measure-rest-interface
794 multi-measure-interface
797 staff-symbol-referencer-interface))))))
799 (MultiMeasureRestNumber
801 (print-function . ,Text_interface::print)
802 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
803 ,Self_alignment_interface::centered_on_other_axis_parent))
804 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
805 (self-alignment-X . 0)
808 (staff-padding . 0.4)
809 (font-encoding . fetaNumber)
810 (meta . ((class . Spanner)
811 (interfaces . (side-position-interface
812 multi-measure-interface
813 self-alignment-interface
816 (MultiMeasureRestText
818 (print-function . ,Text_interface::print)
819 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
820 ,Self_alignment_interface::centered_on_other_axis_parent))
821 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
822 (self-alignment-X . 0)
825 (staff-padding . 0.25)
826 (meta . ((class . Spanner)
827 (interfaces . (side-position-interface
828 multi-measure-interface
829 self-alignment-interface
836 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
837 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
838 (meta . ((class . Item)
839 (interfaces . (note-collision-interface
840 axis-group-interface))))))
845 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
846 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
847 (meta . ((class . Item)
848 (interfaces . (axis-group-interface
849 note-column-interface))))))
853 (print-function . ,Note_head::print)
854 (ligature-primitive-callback . ,Note_head::print)
855 (glyph-name-procedure . ,find-notehead-symbol)
856 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
857 (stem-attachment-function . ,note-head-style->attachment-coordinates)
858 (meta . ((class . Item)
859 (interfaces . (rhythmic-grob-interface
860 rhythmic-head-interface
864 staff-symbol-referencer-interface))))))
868 (stem-spacing-correction . 0.5)
869 (same-direction-correction . 0.25)
870 ;; Changed this from 0.75.
871 ;; If you ever change this back, please document! --hwn
872 (knee-spacing-correction . 1.0)
874 (meta . ((class . Item)
875 (interfaces . (spacing-interface
876 note-spacing-interface))))))
880 (print-function . ,Text_interface::print)
881 (meta . ((class . Item)
882 (interfaces . (note-name-interface
888 (self-alignment-X . 0)
889 (break-visibility . ,begin-of-line-visible)
890 (X-offset-callbacks . (,Self_alignment_interface::centered_on_parent ,Self_alignment_interface::aligned_on_self))
891 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
892 (print-function . ,Text_interface::print)
894 ;; no Y dimensions, because of lyrics under tenor clef.
896 (font-shape . italic)
898 (staff-padding . 0.2)
900 (meta . ((class . Item)
901 (interfaces . (text-interface
902 self-alignment-interface
903 side-position-interface
908 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
909 (print-function . ,Ottava_bracket::print)
910 (font-shape . italic)
911 (shorten-pair . (0.0 . -0.6))
912 (staff-padding . 1.0)
914 (minimum-length . 1.0)
915 (dash-fraction . 0.3)
916 (edge-height . (0 . 1.2))
918 (meta . ((class . Spanner)
919 (interfaces . (ottava-bracket-interface
921 side-position-interface
928 (before-line-breaking-callback . ,Paper_column::before_line_breaking)
929 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
932 ;; (print-function . ,Paper_column::print) (font-size . -6) (font-name . "sans") (Y-extent-callback . #f)
933 (meta . ((class . Paper_column)
934 (interfaces . (paper-column-interface
936 spaceable-grob-interface))))))
939 . ((slur-details . ,default-slur-details)
940 (print-function . ,Slur::print)
942 (spacing-procedure . ,Spanner::set_spacing_rods)
943 (minimum-length . 1.5)
944 (after-line-breaking-callback . ,Slur::after_line_breaking)
945 (Y-extent-callback . ,Slur::height)
948 (meta . ((class . Spanner)
949 (interfaces . (slur-interface))))))
951 (NonMusicalPaperColumn
954 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
955 (before-line-breaking-callback . ,Paper_column::before_line_breaking)
958 ;; debugging stuff: print column number.
959 ;; (print-function . ,Paper_column::print) (font-size . -6) (font-name . "sans") (Y-extent-callback . #f)
961 (meta . ((class . Paper_column)
962 (interfaces . (paper-column-interface
964 spaceable-grob-interface))))))
968 (spacing-procedure . ,Multi_measure_rest::set_spacing_rods)
969 (print-function . ,Multi_measure_rest::percent)
972 (font-encoding . fetaMusic)
973 (meta . ((class . Spanner)
974 (interfaces . (multi-measure-rest-interface
976 percent-repeat-interface))))))
978 ;; an example of a text spanner
981 (print-function . ,Piano_pedal_bracket::print)
983 (bound-padding . 1.0)
985 (bracket-flare . (0.5 . 0.5))
986 (edge-height . (1.0 . 1.0))
987 (shorten-pair . (0.0 . 0.0))
989 (meta . ((class . Spanner)
990 (interfaces . (line-interface
991 piano-pedal-interface
992 piano-pedal-bracket-interface))))))
996 (print-function . ,Text_interface::print)
997 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
998 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
999 (after-line-breaking-callback . ,shift-right-at-line-begin)
1000 (self-alignment-X . 0)
1005 (break-visibility . ,end-of-line-invisible)
1007 (meta . ((class . Item)
1008 (interfaces . (text-interface
1009 side-position-interface
1012 self-alignment-interface))))))
1014 (RemoveEmptyVerticalGroup
1016 (Y-offset-callbacks . (,Hara_kiri_group_spanner::force_hara_kiri_callback))
1017 (Y-extent-callback . ,Hara_kiri_group_spanner::y_extent)
1019 (meta . ((class . Spanner)
1020 (interfaces . (axis-group-interface
1021 vertically-spaceable-interface
1022 hara-kiri-group-interface
1023 spanner-interface))))))
1027 (print-function . ,Percent_repeat_item_interface::beat_slash)
1030 (meta . ((class . Item)
1031 (interfaces . (percent-repeat-interface))))))
1034 (after-line-breaking-callback . ,Rest::after_line_breaking)
1035 (X-extent-callback . ,Rest::extent_callback)
1036 (Y-extent-callback . ,Rest::extent_callback)
1037 (print-function . ,Rest::print)
1038 (Y-offset-callbacks . (,Staff_symbol_referencer::callback
1039 ,Rest::polyphonic_offset_callback))
1040 (minimum-distance . 0.25)
1041 (meta . ((class . Item)
1042 (interfaces . (font-interface
1043 rhythmic-head-interface
1044 rhythmic-grob-interface
1045 staff-symbol-referencer-interface
1046 rest-interface))))))
1050 (minimum-distance . 0.75)
1051 (meta . ((class . Item)
1052 (interfaces . (rest-collision-interface))))))
1056 ;; don't set direction here: it breaks staccato.
1057 (print-function . ,Script_interface::print)
1059 ;; This value is sensitive: if too large, staccato dots will move a
1062 (staff-padding . 0.25)
1063 (slur-padding . 0.5)
1064 ;; (script-priority . 0) priorities for scripts, see script.scm
1065 (X-offset-callbacks . (,Self_alignment_interface::centered_on_parent))
1066 (before-line-breaking-callback . ,Script_interface::before_line_breaking)
1067 (font-encoding . fetaMusic)
1068 (meta . ((class . Item)
1069 (interfaces . (script-interface
1070 side-position-interface
1071 font-interface))))))
1075 (before-line-breaking-callback . ,Script_column::before_line_breaking)
1076 (meta . ((class . Item)
1077 (interfaces . (script-column-interface))))))
1081 (X-extent-callback . #f)
1082 (Y-extent-callback . #f)
1083 (meta . ((class . Item)
1084 (interfaces . (spacing-interface
1085 separation-item-interface))))))
1087 (SeparatingGroupSpanner
1089 (spacing-procedure . ,Separating_group_spanner::set_spacing_rods)
1090 (meta . ((class . Spanner)
1091 (interfaces . (only-prebreak-interface
1093 separation-spanner-interface))))))
1096 . ((slur-details . ,default-slur-details)
1097 (print-function . ,Slur::print)
1099 (spacing-procedure . ,Spanner::set_spacing_rods)
1100 (minimum-length . 1.5)
1101 (after-line-breaking-callback . ,Slur::after_line_breaking)
1102 (Y-extent-callback . ,Slur::height)
1104 (height-limit . 2.0)
1106 (meta . ((class . Spanner)
1107 (interfaces . (slur-interface))))))
1111 (spacing-procedure . ,Spacing_spanner::set_springs)
1112 (grace-space-factor . 0.6)
1113 (shortest-duration-space . 2.0)
1114 (spacing-increment . 1.2)
1115 (base-shortest-duration . ,(ly:make-moment 3 16))
1116 (meta . ((class . Spanner)
1117 (interfaces . (spacing-interface
1118 spacing-spanner-interface))))))
1122 (break-align-symbol . staff-bar)
1123 (bar-size-procedure . ,Span_bar::get_bar_size)
1124 (print-function . ,Span_bar::print)
1125 (X-extent-callback . ,Span_bar::width_callback)
1126 (Y-extent-callback . ())
1129 (before-line-breaking-callback . ,Span_bar::before_line_breaking)
1133 ;; Ross. page 151 lists other values, we opt for a leaner look
1137 (hair-thickness . 1.6)
1138 (thick-thickness . 6.0)
1139 (meta . ((class . Item)
1140 (interfaces . (span-bar-interface
1142 bar-line-interface))))))
1145 . ((print-function . ,Text_interface::print)
1146 (font-series . bold)
1148 (X-offset-callbacks . (,Side_position_interface::aligned_side))
1150 (meta . ((class . Item)
1151 (interfaces . (side-position-interface
1152 stanza-number-interface
1154 font-interface))))))
1158 (print-function . ,print-circled-text-callback)
1160 (staff-padding . 0.5)
1161 (self-alignment-X . 0)
1162 (self-alignment-Y . 0)
1163 (script-priority . 100)
1164 (font-encoding . fetaNumber)
1165 (font-size . -5) ; don't overlap when next to heads.
1166 (meta . ((class . Item)
1167 (interfaces . (string-number-interface
1169 text-script-interface
1171 side-position-interface
1172 self-alignment-interface
1173 item-interface))))))
1178 (stem-spacing-correction . 0.4)
1180 (meta . ((class . Item)
1181 (interfaces . (spacing-interface
1182 staff-spacing-interface))))))
1186 (print-function . ,Text_interface::print)
1188 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1189 (no-spacing-rods . #t)
1190 (padding . 0.0) ;; padding relative to SostenutoPedalLineSpanner
1191 (font-shape . italic)
1192 (self-alignment-X . 0)
1193 (meta . ((class . Item)
1194 (interfaces . (text-interface
1195 self-alignment-interface
1196 font-interface))))))
1198 (SostenutoPedalLineSpanner
1201 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1202 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1205 (minimum-space . 1.0)
1207 (meta . ((class . Spanner)
1208 (interfaces . (piano-pedal-interface
1209 axis-group-interface
1210 side-position-interface))))))
1214 (print-function . ,Staff_symbol::print)
1216 (ledger-line-thickness . (1.0 . 0.1))
1218 (meta . ((class . Spanner)
1219 (interfaces . (staff-symbol-interface))))))
1223 ;; this list is rather long. Trim --hwn
1224 (before-line-breaking-callback . ,Stem::before_line_breaking)
1225 (print-function . ,Stem::print)
1228 ;; 3.5 (or 3 measured from note head) is standard length
1229 ;; 32nd, 64th flagged stems should be longer
1230 (lengths . (3.5 3.5 3.5 4.5 5.0))
1232 ;; Stems in unnatural (forced) direction should be shortened by
1233 ;; one staff space, according to [Roush & Gourlay].
1234 ;; Flagged stems we shorten only half a staff space.
1235 (stem-shorten . (1.0 0.5))
1237 ;; default stem direction for note on middle line
1238 (neutral-direction . -1)
1240 ;; FIXME. 3.5 yields too long beams (according to Ross and
1241 ;; looking at Baerenreiter examples) for a number of common
1242 ;; boundary cases. Subtracting half a beam thickness fixes
1243 ;; this, but the bug may well be somewhere else.
1245 ;; FIXME this should come from 'lengths
1247 (beamed-lengths . (3.26 3.5 3.6))
1249 ;; We use the normal minima as minimum for the ideal lengths,
1250 ;; and the extreme minima as abolute minimum length.
1252 ;; The 'normal' minima
1253 (beamed-minimum-free-lengths . (1.83 1.5 1.25))
1254 ;(beamed-minimum-free-lengths . (2.0 1.83 1.25))
1256 ;; The 'extreme case' minima
1257 (beamed-extreme-minimum-free-lengths . (2.0 1.25))
1259 (X-offset-callbacks . (,Stem::offset_callback))
1260 (X-extent-callback . ,Stem::width_callback)
1261 (Y-extent-callback . ,Stem::height)
1262 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
1263 (meta . ((class . Item)
1264 (interfaces . (stem-interface
1265 font-interface))))))
1269 (print-function . ,Stem_tremolo::print)
1270 (Y-extent-callback . ,Stem_tremolo::height)
1271 (X-extent-callback . #f)
1273 (beam-width . 1.6) ; staff-space
1274 (beam-thickness . 0.48) ; staff-space
1275 (meta . ((class . Item)
1276 (interfaces . (stem-tremolo-interface))))))
1280 (no-spacing-rods . #t)
1281 (print-function . ,Sustain_pedal::print)
1282 (self-alignment-X . 0)
1284 (padding . 0.0) ;; padding relative to SustainPedalLineSpanner
1285 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1286 (meta . ((class . Item)
1287 (interfaces . (piano-pedal-interface
1288 text-spanner-interface
1290 self-alignment-interface
1291 font-interface))))))
1293 (SustainPedalLineSpanner
1296 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1297 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1300 (staff-padding . 1.2)
1301 (minimum-space . 1.0)
1303 (meta . ((class . Spanner)
1304 (interfaces . (piano-pedal-interface
1305 axis-group-interface
1306 side-position-interface))))))
1311 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
1312 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1313 (meta . ((class . System)
1314 (interfaces . (system-interface
1315 axis-group-interface))))))
1320 (print-function . ,System_start_delimiter::print)
1321 (collapse-height . 5.0)
1322 (font-encoding . fetaBraces)
1323 (Y-extent-callback . #f)
1324 (meta . ((class . Spanner)
1325 (interfaces . (system-start-delimiter-interface
1326 font-interface))))))
1330 (Y-extent-callback . #f)
1331 (X-offset-callbacks . (,(lambda (g a) -0.8)))
1332 (print-function . ,System_start_delimiter::print)
1334 (collapse-height . 1)
1336 (meta . ((class . Spanner)
1337 (interfaces . (font-interface
1338 system-start-delimiter-interface))))))
1342 (Y-extent-callback . #f)
1343 (print-function . ,System_start_delimiter::print)
1344 (glyph . "bar-line")
1346 (after-line-breaking-callback . ,System_start_delimiter::after_line_breaking)
1347 (meta . ((class . Spanner)
1348 (interfaces . (system-start-delimiter-interface))))))
1352 (print-function . ,Text_interface::print)
1353 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
1355 (stem-attachment-function . ,tablature-stem-attachment-function)
1356 (font-series . bold)
1357 (meta . ((class . Item)
1359 . (rhythmic-head-interface
1362 staff-symbol-referencer-interface
1363 text-interface))))))
1367 (print-function . ,Text_interface::print)
1368 (no-spacing-rods . #t)
1369 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1372 ;; sync with Fingering ?
1374 (staff-padding . 0.5)
1375 (before-line-breaking-callback . ,Script_interface::before_line_breaking)
1376 (slur-padding . 0.5)
1377 (script-priority . 200)
1378 ;; todo: add X self alignment?
1379 (meta . ((class . Item)
1380 (interfaces . (text-script-interface
1382 side-position-interface
1383 font-interface))))))
1387 (print-function . ,Text_spanner::print)
1388 (font-shape . italic)
1389 (style . dashed-line)
1390 (staff-padding . 0.8)
1391 (dash-fraction . 0.2)
1394 (meta . ((class . Spanner)
1395 (interfaces . (text-spanner-interface
1396 side-position-interface
1397 font-interface))))))
1401 (print-function . ,Tie::print)
1402 (spacing-procedure . ,Spanner::set_spacing_rods)
1403 (staffline-clearance . 0.35)
1404 (details . ((ratio . 0.333) (height-limit . 1.0)))
1408 (minimum-length . 2.5)
1409 (meta . ((class . Spanner)
1410 (interfaces . (tie-interface))))))
1414 (after-line-breaking-callback . ,Tie_column::after_line_breaking)
1415 (before-line-breaking-callback . ,Tie_column::before_line_breaking)
1416 (X-extent-callback . #f)
1417 (Y-extent-callback . #f)
1418 (meta . ((class . Spanner)
1419 (interfaces . (tie-column-interface))))))
1423 (print-function . ,Time_signature::print)
1424 (break-align-symbol . time-signature)
1425 (break-visibility . ,all-visible)
1427 (first-note . (fixed-space . 2.0))
1428 (right-edge . (extra-space . 0.5))
1429 (staff-bar . (minimum-space . 2.0))))
1432 (meta . ((class . Item)
1433 (interfaces . (time-signature-interface
1434 break-aligned-interface
1435 font-interface))))))
1439 (print-function . ,Dynamic_text_spanner::print)
1440 (edge-text . ,(cons (make-musicglyph-markup "scripts.trill")
1443 (staff-padding . 1.0)
1446 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1447 (meta . ((class . Spanner)
1448 (interfaces . (text-spanner-interface
1449 side-position-interface
1450 font-interface))))))
1452 (TrillPitchAccidental
1453 . ((X-offset-callbacks . (,Side_position_interface::aligned_side))
1457 (print-function . ,Accidental_interface::print)
1458 (meta . ((class . Item)
1459 (interfaces . (item-interface
1460 accidental-interface
1461 side-position-interface
1462 font-interface))))))
1465 . ((X-offset-callbacks . (,Side_position_interface::aligned_side))
1468 (print-function . ,parenthesize-elements)
1469 (direction . ,RIGHT)
1471 (meta . ((class . Item)
1472 (interfaces . (side-position-interface
1474 rhythmic-head-interface
1476 accidental-interface
1477 axis-group-interface))))))
1480 . ((print-function . ,Note_head::print)
1482 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
1484 (meta . ((class . Item)
1485 (interfaces . (item-interface
1486 rhythmic-head-interface
1488 pitched-trill-interface
1490 staff-symbol-referencer-interface))))))
1496 (edge-height . (0.7 . 0.7))
1497 (shorten-pair . (-0.2 . -0.2))
1498 (before-line-breaking-callback . ,Tuplet_bracket::before_line_breaking)
1499 (after-line-breaking-callback . ,Tuplet_bracket::after_line_breaking)
1500 (print-function . ,Tuplet_bracket::print)
1501 (font-shape . italic)
1504 (meta . ((class . Spanner)
1505 (interfaces . (text-interface
1507 tuplet-bracket-interface
1508 font-interface))))))
1512 (print-function . ,Text_interface::print)
1513 (font-shape . italic)
1514 (no-spacing-rods . #t)
1515 (self-alignment-X . 0)
1517 (padding . 0.0) ;; padding relative to UnaCordaPedalLineSpanner
1518 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1519 (meta . ((class . Item)
1520 (interfaces . (text-interface
1521 self-alignment-interface
1522 font-interface))))))
1524 (UnaCordaPedalLineSpanner
1527 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1528 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1530 (staff-padding . 1.2)
1531 (minimum-space . 1.0)
1533 (meta . ((class . Spanner)
1534 (interfaces . (piano-pedal-interface
1535 axis-group-interface
1536 side-position-interface))))))
1542 (ligature-primitive-callback . ,Vaticana_ligature::brew_ligature_primitive)
1543 (print-function . ,Vaticana_ligature::print)
1544 (meta . ((class . Spanner)
1545 (interfaces . (vaticana-ligature-interface
1546 font-interface))))))
1551 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1552 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
1554 (meta . ((class . Spanner)
1555 (interfaces . (align-interface
1556 axis-group-interface))))))
1561 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1562 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
1564 (meta . ((class . Spanner)
1565 (interfaces . (axis-group-interface
1566 vertically-spaceable-interface))))))
1571 (Y-offset-callbacks . (,Side_position_interface::aligned_on_support_refpoints))
1573 (space-alist . ((left-edge . (extra-space . 1.0))))
1574 (break-align-symbol . instrument-name)
1575 (print-function . ,Text_interface::print)
1576 (break-align-symbol . clef)
1577 (break-visibility . ,begin-of-line-visible)
1579 (meta . ((class . Item)
1580 (interfaces . (font-interface
1581 self-alignment-interface
1582 side-position-interface
1584 break-aligned-interface))))))
1588 (print-function . ,Volta_bracket_interface::print)
1591 (font-encoding . fetaNumber)
1592 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1593 (thickness . 1.6) ;; linethickness
1594 (height . 2.0) ;; staffspace;
1597 (meta . ((class . Spanner)
1598 (interfaces . (volta-bracket-interface
1601 side-position-interface
1602 font-interface))))))
1609 (X-extent-callback . #f)
1610 (Y-extent-callback . #f)
1611 (print-function . ,Line_spanner::print)
1612 (after-line-breaking-callback . ,Line_spanner::after_line_breaking)
1613 (meta . ((class . Spanner)
1614 (interfaces . (line-spanner-interface
1615 line-interface))))))))
1617 (define (completize-grob-entry x)
1618 "Transplant assoc key into 'name entry of 'meta of X. Set interfaces for Item, Spanner etc.
1620 ;; (display (car x))
1622 (let* ((name-sym (car x))
1623 (grob-entry (cdr x))
1624 (meta-entry (cdr (assoc 'meta grob-entry)))
1625 (class (cdr (assoc 'class meta-entry)))
1627 (cdr (assoc 'interfaces meta-entry))))
1631 (set! ifaces-entry (cons 'item-interface ifaces-entry)))
1632 ((eq? 'Spanner class)
1633 (set! ifaces-entry (cons 'spanner-interface ifaces-entry)))
1634 ((eq? 'Paper_column class)
1635 (set! ifaces-entry (cons 'item-interface
1636 (cons 'paper-column-interface ifaces-entry))))
1637 ((eq? 'System class)
1638 (set! ifaces-entry (cons 'system-interface
1639 (cons 'spanner-interface ifaces-entry))))
1641 (ly:warning "Unknown class ~a" class)))
1642 (set! ifaces-entry (cons 'grob-interface ifaces-entry))
1644 (set! meta-entry (assoc-set! meta-entry 'name name-sym))
1645 (set! meta-entry (assoc-set! meta-entry 'interfaces
1647 (set! grob-entry (assoc-set! grob-entry 'meta meta-entry))
1648 (cons name-sym grob-entry)))
1650 (set! all-grob-descriptions (map completize-grob-entry all-grob-descriptions))
1652 ;; (display (map pair? all-grob-descriptions))
1654 ;; make sure that \property Foo.Bar =\turnOff doesn't complain
1657 ;; (display (car x)) (newline)
1659 (set-object-property! (car x) 'translation-type? list?)
1660 (set-object-property! (car x) 'is-grob? #t))
1661 all-grob-descriptions)
1663 (set! all-grob-descriptions (sort all-grob-descriptions alist<?))