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))))))
457 (DoublePercentRepeatCounter
458 . ((print-function . ,Text_interface::print)
459 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
460 ,Self_alignment_interface::centered_on_other_axis_parent))
461 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
462 (font-encoding . fetaNumber)
463 (self-alignment-X . 0)
467 (staff-padding . 0.25)
468 (meta . ((class . Item)
469 (interfaces . (side-position-interface
470 self-alignment-interface
471 percent-repeat-interface
477 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
478 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
479 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
480 (staff-padding . 0.1)
482 (avoid-slur . outside)
484 (minimum-space . 1.2)
487 (meta . ((class . Spanner)
488 (interfaces . (axis-group-interface
490 dynamic-line-spanner-interface
491 side-position-interface))))))
495 (print-function . ,Text_interface::print)
496 (before-line-breaking-callback . ,Script_interface::before_line_breaking)
497 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
498 (self-alignment-X . 0)
499 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
500 (self-alignment-Y . 0)
502 (font-encoding . fetaDynamic)
503 (font-shape . italic)
504 (no-spacing-rods . #t)
505 (script-priority . 100)
506 (meta . ((class . Item)
507 (interfaces . (font-interface
509 self-alignment-interface
511 script-interface))))))
514 . ((print-function . ,Dynamic_text_spanner::print)
516 ;; rather ugh with NCSB
517 ;; (font-series . bold)
518 (font-shape . italic)
519 (style . dashed-line)
521 ;; need to blend with dynamic texts.
523 (bound-padding . 0.75)
524 (dash-fraction . 0.2)
526 (meta . ((class . Spanner)
527 (interfaces . (font-interface
530 dynamic-text-spanner-interface
531 spanner-interface))))))
535 (print-function . ,Text_interface::print)
537 ;; sync with TextScript (?)
540 (avoid-slur . around)
542 (staff-padding . 0.5)
543 (self-alignment-X . 0)
544 (self-alignment-Y . 0)
545 (script-priority . 100)
546 (before-line-breaking-callback . ,Script_interface::before_line_breaking)
547 (font-encoding . fetaNumber)
548 (font-size . -5) ; don't overlap when next to heads.
549 (meta . ((class . Item)
550 (interfaces . (finger-interface
552 text-script-interface
554 side-position-interface
555 self-alignment-interface
561 (zigzag-width . 0.75)
563 (X-extent-callback . #f)
564 (Y-extent-callback . #f)
565 (after-line-breaking-callback . ,Line_spanner::after_line_breaking)
566 (print-function . ,Line_spanner::print)
567 (meta . ((class . Spanner)
568 (interfaces . (line-interface
569 line-spanner-interface))))))
575 (meta . ((class . Item)
576 (interfaces . (grid-point-interface))))))
580 (print-function . ,Grid_line_interface::print)
581 (X-extent-callback . ,Grid_line_interface::width_callback)
582 (self-alignment-X . ,CENTER)
583 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
584 ,Self_alignment_interface::centered_on_parent))
586 (meta . ((class . Item)
587 (interfaces . (self-alignment-interface
588 grid-line-interface))))))
592 (print-function . ,Hairpin::print)
593 (after-line-breaking-callback . ,Hairpin::after_line_breaking)
596 (spacing-procedure . ,Spanner::set_spacing_rods)
597 (minimum-length . 2.0)
598 (bound-padding . 1.0)
599 (self-alignment-Y . 0)
600 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
601 (meta . ((class . Spanner)
602 (interfaces . (hairpin-interface
604 self-alignment-interface
606 spanner-interface))))))
611 (print-function . ,Horizontal_bracket::print)
612 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
614 (staff-padding . 0.2)
616 (bracket-flare . (0.5 . 0.5))
617 (meta . ((class . Spanner)
618 (interfaces . (horizontal-bracket-interface
619 side-position-interface
621 spanner-interface))))))
625 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self
626 ,Side_position_interface::aligned_on_support_refpoints))
627 ;; This direction is for aligned_on_support_refpoints
631 (left-edge . (extra-space . 1.0))))
633 (self-alignment-Y . 0)
634 (print-function . ,Text_interface::print)
635 (break-align-symbol . instrument-name)
636 (break-visibility . ,begin-of-line-visible)
638 (meta . ((class . Item)
639 (interfaces . (font-interface
640 self-alignment-interface
641 side-position-interface
643 break-aligned-interface))))))
647 (print-function . ,Key_signature_interface::print)
649 (time-signature . (extra-space . 1.25))
650 (staff-bar . (extra-space . 0.6))
651 (key-signature . (extra-space . 0.5))
652 (right-edge . (extra-space . 0.5))
653 (first-note . (fixed-space . 2.5))))
654 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
655 (break-align-symbol . key-cancellation)
656 (break-visibility . ,begin-of-line-invisible)
659 (meta . ((class . Item)
660 (interfaces . (key-signature-interface
662 break-aligned-interface))))))
665 (print-function . ,Key_signature_interface::print)
667 (time-signature . (extra-space . 1.25))
668 (staff-bar . (extra-space . 1.1))
669 (right-edge . (extra-space . 0.5))
670 (first-note . (fixed-space . 2.5))))
671 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
672 (break-align-symbol . key-signature)
673 (break-visibility . ,begin-of-line-visible)
676 (meta . ((class . Item)
677 (interfaces . (key-signature-interface
679 break-aligned-interface))))))
682 (print-function . ,Ledger_line_spanner::print)
683 (X-extent-callback . #f)
684 (Y-extent-callback . #f)
685 (minimum-length-fraction . 0.25)
686 (length-fraction . 0.25)
687 (spacing-procedure . ,Ledger_line_spanner::set_spacing_rods)
688 (print-function . ,Ledger_line_spanner::print)
690 (meta . ((class . Spanner)
691 (interfaces . (ledger-line-interface))))))
695 (break-align-symbol . left-edge)
698 (break-visibility . ,center-invisible)
700 (custos . (extra-space . 0.0))
701 (ambitus . (extra-space . 2.0))
702 (time-signature . (extra-space . 1.0))
703 (staff-bar . (extra-space . 0.0))
704 (breathing-sign . (minimum-space . 0.0))
705 (clef . (extra-space . 0.8))
706 (first-note . (fixed-space . 2.0))
707 (right-edge . (extra-space . 0.0))
708 (key-signature . (extra-space . 0.0))
709 (key-cancellation . (extra-space . 0.0))
711 (meta . ((class . Item)
712 (interfaces . (break-aligned-interface))))))
716 (ligature-primitive-callback . ,Note_head::print)
721 (edge-height . (0.7 . 0.7))
722 (shorten-pair . (-0.2 . -0.2))
723 (before-line-breaking-callback . ,Tuplet_bracket::before_line_breaking)
724 (after-line-breaking-callback . ,Tuplet_bracket::after_line_breaking)
725 (print-function . ,Tuplet_bracket::print)
726 (meta . ((class . Spanner)
727 (interfaces . (tuplet-bracket-interface
736 (minimum-length . 0.3)
738 ; (spacing-procedure . ,Hyphen_spanner::set_spacing_rods)
739 (print-function . ,Hyphen_spanner::print)
741 (meta . ((class . Spanner)
742 (interfaces . (lyric-interface
743 lyric-hyphen-interface
744 spanner-interface))))))
748 (print-function . ,Lyric_extender::print)
749 (thickness . 0.8) ; linethickness
750 (minimum-length . 1.5)
752 (meta . ((class . Spanner)
753 (interfaces . (lyric-interface
754 lyric-extender-interface))))))
757 . ((print-function . ,Text_interface::print)
758 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_parent))
759 (self-alignment-X . 0)
761 (font-series . bold-narrow)
763 (meta . ((class . Item)
764 (interfaces . (rhythmic-grob-interface
765 lyric-syllable-interface
766 self-alignment-interface
774 (ligature-primitive-callback . ,Mensural_ligature::brew_ligature_primitive)
775 (print-function . ,Mensural_ligature::print)
776 (meta . ((class . Spanner)
777 (interfaces . (mensural-ligature-interface
782 (print-function . ,Text_interface::print)
783 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
786 (meta . ((class . Item)
787 (interfaces . (text-interface
788 side-position-interface
790 metronome-mark-interface))))))
793 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
794 (print-function . ,Measure_grouping::print)
800 (meta . ((class . Spanner)
801 (interfaces . (side-position-interface
802 measure-grouping-interface))))))
805 (print-function . ,Multi_measure_rest::print)
806 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
809 (thick-thickness . 6.6)
810 (hair-thickness . 2.0)
812 (meta . ((class . Spanner)
813 (interfaces . (multi-measure-rest-interface
814 multi-measure-interface
817 staff-symbol-referencer-interface))))))
819 (MultiMeasureRestNumber
821 (print-function . ,Text_interface::print)
822 (spacing-procedure . ,Multi_measure_rest::set_spacing_rods)
823 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
824 ,Self_alignment_interface::centered_on_other_axis_parent))
825 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
826 (self-alignment-X . 0)
829 (staff-padding . 0.4)
830 (font-encoding . fetaNumber)
831 (meta . ((class . Spanner)
832 (interfaces . (side-position-interface
833 multi-measure-interface
834 self-alignment-interface
838 (MultiMeasureRestText
840 (print-function . ,Text_interface::print)
841 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
842 ,Self_alignment_interface::centered_on_other_axis_parent))
843 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
844 (self-alignment-X . 0)
847 (staff-padding . 0.25)
848 (meta . ((class . Spanner)
849 (interfaces . (side-position-interface
850 multi-measure-interface
851 self-alignment-interface
858 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
859 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
860 (meta . ((class . Item)
861 (interfaces . (note-collision-interface
862 axis-group-interface))))))
867 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
868 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
869 (meta . ((class . Item)
870 (interfaces . (axis-group-interface
871 note-column-interface))))))
875 (print-function . ,Note_head::print)
876 (ligature-primitive-callback . ,Note_head::print)
877 (glyph-name-procedure . ,find-notehead-symbol)
878 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
879 (stem-attachment-function . ,note-head-style->attachment-coordinates)
880 (meta . ((class . Item)
881 (interfaces . (rhythmic-grob-interface
882 rhythmic-head-interface
886 staff-symbol-referencer-interface))))))
890 (stem-spacing-correction . 0.5)
891 (same-direction-correction . 0.25)
892 ;; Changed this from 0.75.
893 ;; If you ever change this back, please document! --hwn
894 (knee-spacing-correction . 1.0)
896 (meta . ((class . Item)
897 (interfaces . (spacing-interface
898 note-spacing-interface))))))
902 (print-function . ,Text_interface::print)
903 (meta . ((class . Item)
904 (interfaces . (note-name-interface
910 (self-alignment-X . 0)
911 (break-visibility . ,begin-of-line-visible)
912 (X-offset-callbacks . (,Self_alignment_interface::centered_on_parent
913 ,Self_alignment_interface::aligned_on_self))
914 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
915 (print-function . ,Text_interface::print)
917 ;; no Y dimensions, because of lyrics under tenor clef.
919 (font-shape . italic)
921 (staff-padding . 0.2)
923 (meta . ((class . Item)
924 (interfaces . (text-interface
925 self-alignment-interface
926 side-position-interface
931 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
932 (print-function . ,Ottava_bracket::print)
933 (font-shape . italic)
934 (shorten-pair . (0.0 . -0.6))
935 (staff-padding . 1.0)
937 (minimum-length . 1.0)
938 (dash-fraction . 0.3)
939 (edge-height . (0 . 1.2))
941 (meta . ((class . Spanner)
942 (interfaces . (ottava-bracket-interface
944 side-position-interface
951 (before-line-breaking-callback . ,Paper_column::before_line_breaking)
952 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
955 ;; (print-function . ,Paper_column::print) (font-size . -6) (font-name . "sans") (Y-extent-callback . #f)
956 (meta . ((class . Paper_column)
957 (interfaces . (paper-column-interface
959 spaceable-grob-interface))))))
962 . ((slur-details . ,default-slur-details)
963 (print-function . ,Slur::print)
965 (spacing-procedure . ,Spanner::set_spacing_rods)
966 (minimum-length . 1.5)
967 (after-line-breaking-callback . ,Slur::after_line_breaking)
968 (Y-extent-callback . ,Slur::height)
971 (meta . ((class . Spanner)
972 (interfaces . (slur-interface))))))
974 (NonMusicalPaperColumn
977 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
978 (before-line-breaking-callback . ,Paper_column::before_line_breaking)
981 ;; debugging stuff: print column number.
982 ;; (print-function . ,Paper_column::print) (font-size . -6) (font-name . "sans") (Y-extent-callback . #f)
984 (meta . ((class . Paper_column)
985 (interfaces . (paper-column-interface
987 spaceable-grob-interface))))))
991 (spacing-procedure . ,Multi_measure_rest::set_spacing_rods)
992 (print-function . ,Multi_measure_rest::percent)
995 (font-encoding . fetaMusic)
996 (meta . ((class . Spanner)
997 (interfaces . (multi-measure-rest-interface
999 percent-repeat-interface))))))
1000 (PercentRepeatCounter
1001 . ((print-function . ,Text_interface::print)
1002 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
1003 ,Self_alignment_interface::centered_on_other_axis_parent))
1004 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1005 (self-alignment-X . 0)
1008 (staff-padding . 0.25)
1010 (font-encoding . fetaNumber)
1011 (meta . ((class . Spanner)
1012 (interfaces . (side-position-interface
1013 self-alignment-interface
1014 percent-repeat-interface
1016 text-interface))))))
1018 ;; an example of a text spanner
1021 (print-function . ,Piano_pedal_bracket::print)
1023 (bound-padding . 1.0)
1025 (bracket-flare . (0.5 . 0.5))
1026 (edge-height . (1.0 . 1.0))
1027 (shorten-pair . (0.0 . 0.0))
1029 (meta . ((class . Spanner)
1030 (interfaces . (line-interface
1031 piano-pedal-interface
1032 piano-pedal-bracket-interface))))))
1036 (print-function . ,Text_interface::print)
1037 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1038 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1039 (after-line-breaking-callback . ,shift-right-at-line-begin)
1040 (self-alignment-X . 0)
1045 (break-visibility . ,end-of-line-invisible)
1047 (meta . ((class . Item)
1048 (interfaces . (text-interface
1049 side-position-interface
1052 self-alignment-interface))))))
1054 (RemoveEmptyVerticalGroup
1056 (Y-offset-callbacks . (,Hara_kiri_group_spanner::force_hara_kiri_callback))
1057 (Y-extent-callback . ,Hara_kiri_group_spanner::y_extent)
1059 (meta . ((class . Spanner)
1060 (interfaces . (axis-group-interface
1061 vertically-spaceable-interface
1062 hara-kiri-group-interface
1063 spanner-interface))))))
1067 (print-function . ,Percent_repeat_item_interface::beat_slash)
1070 (meta . ((class . Item)
1071 (interfaces . (percent-repeat-interface))))))
1074 (after-line-breaking-callback . ,Rest::after_line_breaking)
1075 (X-extent-callback . ,Rest::extent_callback)
1076 (Y-extent-callback . ,Rest::extent_callback)
1077 (print-function . ,Rest::print)
1078 (Y-offset-callbacks . (,Staff_symbol_referencer::callback
1079 ,Rest::polyphonic_offset_callback))
1080 (minimum-distance . 0.25)
1081 (meta . ((class . Item)
1082 (interfaces . (font-interface
1083 rhythmic-head-interface
1084 rhythmic-grob-interface
1085 staff-symbol-referencer-interface
1086 rest-interface))))))
1090 (minimum-distance . 0.75)
1091 (meta . ((class . Item)
1092 (interfaces . (rest-collision-interface))))))
1096 ;; don't set direction here: it breaks staccato.
1097 (print-function . ,Script_interface::print)
1099 ;; This value is sensitive: if too large, staccato dots will move a
1102 (staff-padding . 0.25)
1103 ;; (script-priority . 0) priorities for scripts, see script.scm
1104 (X-offset-callbacks . (,Self_alignment_interface::centered_on_parent))
1105 (before-line-breaking-callback . ,Script_interface::before_line_breaking)
1106 (font-encoding . fetaMusic)
1107 (meta . ((class . Item)
1108 (interfaces . (script-interface
1109 side-position-interface
1110 font-interface))))))
1114 (before-line-breaking-callback . ,Script_column::before_line_breaking)
1115 (meta . ((class . Item)
1116 (interfaces . (script-column-interface))))))
1120 (X-extent-callback . #f)
1121 (Y-extent-callback . #f)
1122 (meta . ((class . Item)
1123 (interfaces . (spacing-interface
1124 separation-item-interface))))))
1126 (SeparatingGroupSpanner
1128 (spacing-procedure . ,Separating_group_spanner::set_spacing_rods)
1129 (meta . ((class . Spanner)
1130 (interfaces . (only-prebreak-interface
1132 separation-spanner-interface))))))
1135 . ((slur-details . ,default-slur-details)
1136 (print-function . ,Slur::print)
1138 (spacing-procedure . ,Spanner::set_spacing_rods)
1139 (minimum-length . 1.5)
1140 (after-line-breaking-callback . ,Slur::after_line_breaking)
1141 (Y-extent-callback . ,Slur::height)
1143 (height-limit . 2.0)
1145 (meta . ((class . Spanner)
1146 (interfaces . (slur-interface))))))
1150 (spacing-procedure . ,Spacing_spanner::set_springs)
1151 (grace-space-factor . 0.6)
1152 (shortest-duration-space . 2.0)
1153 (spacing-increment . 1.2)
1154 (base-shortest-duration . ,(ly:make-moment 3 16))
1155 (meta . ((class . Spanner)
1156 (interfaces . (spacing-interface
1157 spacing-spanner-interface))))))
1161 (break-align-symbol . staff-bar)
1162 (bar-size-procedure . ,Span_bar::get_bar_size)
1163 (print-function . ,Span_bar::print)
1164 (X-extent-callback . ,Span_bar::width_callback)
1165 (Y-extent-callback . ())
1168 (before-line-breaking-callback . ,Span_bar::before_line_breaking)
1172 ;; Ross. page 151 lists other values, we opt for a leaner look
1176 (hair-thickness . 1.6)
1177 (thick-thickness . 6.0)
1178 (meta . ((class . Item)
1179 (interfaces . (span-bar-interface
1181 bar-line-interface))))))
1184 . ((print-function . ,Text_interface::print)
1185 (font-series . bold)
1187 (X-offset-callbacks . (,Side_position_interface::aligned_side))
1189 (meta . ((class . Item)
1190 (interfaces . (side-position-interface
1191 stanza-number-interface
1193 font-interface))))))
1197 (print-function . ,print-circled-text-callback)
1199 (staff-padding . 0.5)
1200 (self-alignment-X . 0)
1201 (self-alignment-Y . 0)
1202 (script-priority . 100)
1203 (font-encoding . fetaNumber)
1204 (font-size . -5) ; don't overlap when next to heads.
1205 (meta . ((class . Item)
1206 (interfaces . (string-number-interface
1208 text-script-interface
1210 side-position-interface
1211 self-alignment-interface
1212 item-interface))))))
1217 (stem-spacing-correction . 0.4)
1219 (meta . ((class . Item)
1220 (interfaces . (spacing-interface
1221 staff-spacing-interface))))))
1225 (print-function . ,Text_interface::print)
1227 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1228 (no-spacing-rods . #t)
1229 (padding . 0.0) ;; padding relative to SostenutoPedalLineSpanner
1230 (font-shape . italic)
1231 (self-alignment-X . 0)
1232 (meta . ((class . Item)
1233 (interfaces . (text-interface
1234 self-alignment-interface
1235 font-interface))))))
1237 (SostenutoPedalLineSpanner
1240 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1241 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1244 (minimum-space . 1.0)
1246 (meta . ((class . Spanner)
1247 (interfaces . (piano-pedal-interface
1248 axis-group-interface
1249 side-position-interface))))))
1253 (print-function . ,Staff_symbol::print)
1255 (ledger-line-thickness . (1.0 . 0.1))
1257 (meta . ((class . Spanner)
1258 (interfaces . (staff-symbol-interface))))))
1262 ;; this list is rather long. Trim --hwn
1263 (before-line-breaking-callback . ,Stem::before_line_breaking)
1264 (print-function . ,Stem::print)
1267 ;; 3.5 (or 3 measured from note head) is standard length
1268 ;; 32nd, 64th flagged stems should be longer
1269 (lengths . (3.5 3.5 3.5 4.5 5.0))
1271 ;; Stems in unnatural (forced) direction should be shortened by
1272 ;; one staff space, according to [Roush & Gourlay].
1273 ;; Flagged stems we shorten only half a staff space.
1274 (stem-shorten . (1.0 0.5))
1276 ;; default stem direction for note on middle line
1277 (neutral-direction . -1)
1279 ;; FIXME. 3.5 yields too long beams (according to Ross and
1280 ;; looking at Baerenreiter examples) for a number of common
1281 ;; boundary cases. Subtracting half a beam thickness fixes
1282 ;; this, but the bug may well be somewhere else.
1284 ;; FIXME this should come from 'lengths
1286 (beamed-lengths . (3.26 3.5 3.6))
1288 ;; We use the normal minima as minimum for the ideal lengths,
1289 ;; and the extreme minima as abolute minimum length.
1291 ;; The 'normal' minima
1292 (beamed-minimum-free-lengths . (1.83 1.5 1.25))
1293 ;(beamed-minimum-free-lengths . (2.0 1.83 1.25))
1295 ;; The 'extreme case' minima
1296 (beamed-extreme-minimum-free-lengths . (2.0 1.25))
1298 (X-offset-callbacks . (,Stem::offset_callback))
1299 (X-extent-callback . ,Stem::width_callback)
1300 (Y-extent-callback . ,Stem::height)
1301 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
1302 (meta . ((class . Item)
1303 (interfaces . (stem-interface
1304 font-interface))))))
1308 (print-function . ,Stem_tremolo::print)
1309 (Y-extent-callback . ,Stem_tremolo::height)
1310 (X-extent-callback . #f)
1312 (beam-width . 1.6) ; staff-space
1313 (beam-thickness . 0.48) ; staff-space
1314 (meta . ((class . Item)
1315 (interfaces . (stem-tremolo-interface))))))
1319 (no-spacing-rods . #t)
1320 (print-function . ,Sustain_pedal::print)
1321 (self-alignment-X . 0)
1323 (padding . 0.0) ;; padding relative to SustainPedalLineSpanner
1324 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1325 (meta . ((class . Item)
1326 (interfaces . (piano-pedal-interface
1327 text-spanner-interface
1329 self-alignment-interface
1330 font-interface))))))
1332 (SustainPedalLineSpanner
1335 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1336 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1339 (staff-padding . 1.2)
1340 (minimum-space . 1.0)
1342 (meta . ((class . Spanner)
1343 (interfaces . (piano-pedal-interface
1344 axis-group-interface
1345 side-position-interface))))))
1350 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
1351 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1352 (meta . ((class . System)
1353 (interfaces . (system-interface
1354 axis-group-interface))))))
1359 (print-function . ,System_start_delimiter::print)
1360 (collapse-height . 5.0)
1361 (font-encoding . fetaBraces)
1362 (Y-extent-callback . #f)
1363 (meta . ((class . Spanner)
1364 (interfaces . (system-start-delimiter-interface
1365 font-interface))))))
1369 (Y-extent-callback . #f)
1370 (X-offset-callbacks . (,(lambda (g a) -0.8)))
1371 (print-function . ,System_start_delimiter::print)
1373 (collapse-height . 1)
1375 (meta . ((class . Spanner)
1376 (interfaces . (font-interface
1377 system-start-delimiter-interface))))))
1381 (Y-extent-callback . #f)
1382 (print-function . ,System_start_delimiter::print)
1383 (glyph . "bar-line")
1385 (after-line-breaking-callback . ,System_start_delimiter::after_line_breaking)
1386 (meta . ((class . Spanner)
1387 (interfaces . (system-start-delimiter-interface))))))
1391 (print-function . ,Text_interface::print)
1392 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
1394 (stem-attachment-function . ,tablature-stem-attachment-function)
1395 (font-series . bold)
1396 (meta . ((class . Item)
1398 . (rhythmic-head-interface
1401 staff-symbol-referencer-interface
1402 text-interface))))))
1406 (print-function . ,Text_interface::print)
1407 (no-spacing-rods . #t)
1408 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1411 ;; sync with Fingering ?
1413 (staff-padding . 0.5)
1414 (before-line-breaking-callback . ,Script_interface::before_line_breaking)
1415 (avoid-slur . around)
1416 (slur-padding . 0.5)
1417 (script-priority . 200)
1418 ;; todo: add X self alignment?
1419 (meta . ((class . Item)
1420 (interfaces . (text-script-interface
1422 side-position-interface
1423 font-interface))))))
1427 (print-function . ,Text_spanner::print)
1428 (font-shape . italic)
1429 (style . dashed-line)
1430 (staff-padding . 0.8)
1431 (dash-fraction . 0.2)
1434 (meta . ((class . Spanner)
1435 (interfaces . (text-spanner-interface
1436 side-position-interface
1437 font-interface))))))
1441 (print-function . ,Tie::print)
1442 (details . ((ratio . 0.333) (height-limit . 1.0)))
1444 (meta . ((class . Spanner)
1445 (interfaces . (tie-interface))))))
1449 (after-line-breaking-callback . ,Tie_column::after_line_breaking)
1450 (before-line-breaking-callback . ,Tie_column::before_line_breaking)
1451 (X-extent-callback . #f)
1452 (Y-extent-callback . #f)
1453 (meta . ((class . Spanner)
1454 (interfaces . (tie-column-interface))))))
1458 (print-function . ,Time_signature::print)
1459 (break-align-symbol . time-signature)
1460 (break-visibility . ,all-visible)
1462 (first-note . (fixed-space . 2.0))
1463 (right-edge . (extra-space . 0.5))
1464 (staff-bar . (minimum-space . 2.0))))
1467 (meta . ((class . Item)
1468 (interfaces . (time-signature-interface
1469 break-aligned-interface
1470 font-interface))))))
1474 (print-function . ,Dynamic_text_spanner::print)
1475 (edge-text . ,(cons (make-musicglyph-markup "scripts.trill")
1478 (staff-padding . 1.0)
1481 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1482 (meta . ((class . Spanner)
1483 (interfaces . (text-spanner-interface
1484 side-position-interface
1485 font-interface))))))
1487 (TrillPitchAccidental
1488 . ((X-offset-callbacks . (,Side_position_interface::aligned_side))
1492 (print-function . ,Accidental_interface::print)
1493 (meta . ((class . Item)
1494 (interfaces . (item-interface
1495 accidental-interface
1496 side-position-interface
1497 font-interface))))))
1500 . ((X-offset-callbacks . (,Side_position_interface::aligned_side))
1503 (print-function . ,parenthesize-elements)
1504 (direction . ,RIGHT)
1506 (meta . ((class . Item)
1507 (interfaces . (side-position-interface
1509 rhythmic-head-interface
1511 accidental-interface
1512 axis-group-interface))))))
1515 . ((print-function . ,Note_head::print)
1517 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
1519 (meta . ((class . Item)
1520 (interfaces . (item-interface
1521 rhythmic-head-interface
1523 pitched-trill-interface
1525 staff-symbol-referencer-interface))))))
1531 (edge-height . (0.7 . 0.7))
1532 (shorten-pair . (-0.2 . -0.2))
1533 (before-line-breaking-callback . ,Tuplet_bracket::before_line_breaking)
1534 (after-line-breaking-callback . ,Tuplet_bracket::after_line_breaking)
1535 (print-function . ,Tuplet_bracket::print)
1536 (font-shape . italic)
1539 (meta . ((class . Spanner)
1540 (interfaces . (text-interface
1542 tuplet-bracket-interface
1543 font-interface))))))
1547 (print-function . ,Text_interface::print)
1548 (font-shape . italic)
1549 (no-spacing-rods . #t)
1550 (self-alignment-X . 0)
1552 (padding . 0.0) ;; padding relative to UnaCordaPedalLineSpanner
1553 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1554 (meta . ((class . Item)
1555 (interfaces . (text-interface
1556 self-alignment-interface
1557 font-interface))))))
1559 (UnaCordaPedalLineSpanner
1562 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1563 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1565 (staff-padding . 1.2)
1566 (minimum-space . 1.0)
1568 (meta . ((class . Spanner)
1569 (interfaces . (piano-pedal-interface
1570 axis-group-interface
1571 side-position-interface))))))
1577 (ligature-primitive-callback . ,Vaticana_ligature::brew_ligature_primitive)
1578 (print-function . ,Vaticana_ligature::print)
1579 (meta . ((class . Spanner)
1580 (interfaces . (vaticana-ligature-interface
1581 font-interface))))))
1586 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1587 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
1589 (meta . ((class . Spanner)
1590 (interfaces . (align-interface
1591 axis-group-interface))))))
1596 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1597 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
1599 (meta . ((class . Spanner)
1600 (interfaces . (axis-group-interface
1601 vertically-spaceable-interface))))))
1606 (Y-offset-callbacks . (,Side_position_interface::aligned_on_support_refpoints))
1608 (space-alist . ((left-edge . (extra-space . 1.0))))
1609 (break-align-symbol . instrument-name)
1610 (print-function . ,Text_interface::print)
1611 (break-align-symbol . clef)
1612 (break-visibility . ,begin-of-line-visible)
1614 (meta . ((class . Item)
1615 (interfaces . (font-interface
1616 self-alignment-interface
1617 side-position-interface
1619 break-aligned-interface))))))
1623 (print-function . ,Volta_bracket_interface::print)
1626 (font-encoding . fetaNumber)
1627 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1628 (thickness . 1.6) ;; linethickness
1629 (height . 2.0) ;; staffspace;
1632 (meta . ((class . Spanner)
1633 (interfaces . (volta-bracket-interface
1636 side-position-interface
1637 font-interface))))))
1644 (X-extent-callback . #f)
1645 (Y-extent-callback . #f)
1646 (print-function . ,Line_spanner::print)
1647 (after-line-breaking-callback . ,Line_spanner::after_line_breaking)
1648 (meta . ((class . Spanner)
1649 (interfaces . (line-spanner-interface
1650 line-interface))))))))
1652 (define (completize-grob-entry x)
1653 "Transplant assoc key into 'name entry of 'meta of X. Set interfaces for Item, Spanner etc.
1655 ;; (display (car x))
1657 (let* ((name-sym (car x))
1658 (grob-entry (cdr x))
1659 (meta-entry (cdr (assoc 'meta grob-entry)))
1660 (class (cdr (assoc 'class meta-entry)))
1662 (cdr (assoc 'interfaces meta-entry))))
1666 (set! ifaces-entry (cons 'item-interface ifaces-entry)))
1667 ((eq? 'Spanner class)
1668 (set! ifaces-entry (cons 'spanner-interface ifaces-entry)))
1669 ((eq? 'Paper_column class)
1670 (set! ifaces-entry (cons 'item-interface
1671 (cons 'paper-column-interface ifaces-entry))))
1672 ((eq? 'System class)
1673 (set! ifaces-entry (cons 'system-interface
1674 (cons 'spanner-interface ifaces-entry))))
1676 (ly:warning "Unknown class ~a" class)))
1677 (set! ifaces-entry (cons 'grob-interface ifaces-entry))
1679 (set! meta-entry (assoc-set! meta-entry 'name name-sym))
1680 (set! meta-entry (assoc-set! meta-entry 'interfaces
1682 (set! grob-entry (assoc-set! grob-entry 'meta meta-entry))
1683 (cons name-sym grob-entry)))
1685 (set! all-grob-descriptions (map completize-grob-entry all-grob-descriptions))
1687 ;; (display (map pair? all-grob-descriptions))
1689 ;; make sure that \property Foo.Bar =\turnOff doesn't complain
1692 ;; (display (car x)) (newline)
1694 (set-object-property! (car x) 'translation-type? list?)
1695 (set-object-property! (car x) 'is-grob? #t))
1696 all-grob-descriptions)
1698 (set! all-grob-descriptions (sort all-grob-descriptions alist<?))