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 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
479 (staff-padding . 0.1)
481 (avoid-slur . outside)
483 (minimum-space . 1.2)
486 (meta . ((class . Spanner)
487 (interfaces . (axis-group-interface
489 dynamic-line-spanner-interface
490 side-position-interface))))))
494 (print-function . ,Text_interface::print)
495 (before-line-breaking-callback . ,Script_interface::before_line_breaking)
496 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
497 (self-alignment-X . 0)
498 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
499 (self-alignment-Y . 0)
501 (font-encoding . fetaDynamic)
502 (font-shape . italic)
503 (no-spacing-rods . #t)
504 (script-priority . 100)
505 (meta . ((class . Item)
506 (interfaces . (font-interface
508 self-alignment-interface
510 script-interface))))))
513 . ((print-function . ,Dynamic_text_spanner::print)
515 ;; rather ugh with NCSB
516 ;; (font-series . bold)
517 (font-shape . italic)
518 (style . dashed-line)
520 ;; need to blend with dynamic texts.
522 (bound-padding . 0.75)
523 (dash-fraction . 0.2)
525 (meta . ((class . Spanner)
526 (interfaces . (font-interface
529 dynamic-text-spanner-interface
530 spanner-interface))))))
534 (print-function . ,Text_interface::print)
536 ;; sync with TextScript (?)
539 (avoid-slur . around)
541 (staff-padding . 0.5)
542 (self-alignment-X . 0)
543 (self-alignment-Y . 0)
544 (script-priority . 100)
545 (before-line-breaking-callback . ,Script_interface::before_line_breaking)
546 (font-encoding . fetaNumber)
547 (font-size . -5) ; don't overlap when next to heads.
548 (meta . ((class . Item)
549 (interfaces . (finger-interface
551 text-script-interface
553 side-position-interface
554 self-alignment-interface
560 (zigzag-width . 0.75)
562 (X-extent-callback . #f)
563 (Y-extent-callback . #f)
564 (after-line-breaking-callback . ,Line_spanner::after_line_breaking)
565 (print-function . ,Line_spanner::print)
566 (meta . ((class . Spanner)
567 (interfaces . (line-interface
568 line-spanner-interface))))))
574 (meta . ((class . Item)
575 (interfaces . (grid-point-interface))))))
579 (print-function . ,Grid_line_interface::print)
580 (X-extent-callback . ,Grid_line_interface::width_callback)
581 (self-alignment-X . ,CENTER)
582 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
583 ,Self_alignment_interface::centered_on_parent))
585 (meta . ((class . Item)
586 (interfaces . (self-alignment-interface
587 grid-line-interface))))))
591 (print-function . ,Hairpin::print)
592 (after-line-breaking-callback . ,Hairpin::after_line_breaking)
595 (spacing-procedure . ,Spanner::set_spacing_rods)
596 (minimum-length . 2.0)
597 (bound-padding . 1.0)
598 (self-alignment-Y . 0)
599 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
600 (meta . ((class . Spanner)
601 (interfaces . (hairpin-interface
603 self-alignment-interface
605 spanner-interface))))))
610 (print-function . ,Horizontal_bracket::print)
611 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
613 (staff-padding . 0.2)
615 (bracket-flare . (0.5 . 0.5))
616 (meta . ((class . Spanner)
617 (interfaces . (horizontal-bracket-interface
618 side-position-interface
620 spanner-interface))))))
624 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self
625 ,Side_position_interface::aligned_on_support_refpoints))
626 ;; This direction is for aligned_on_support_refpoints
630 (left-edge . (extra-space . 1.0))))
632 (self-alignment-Y . 0)
633 (print-function . ,Text_interface::print)
634 (break-align-symbol . instrument-name)
635 (break-visibility . ,begin-of-line-visible)
637 (meta . ((class . Item)
638 (interfaces . (font-interface
639 self-alignment-interface
640 side-position-interface
642 break-aligned-interface))))))
646 (print-function . ,Key_signature_interface::print)
648 (time-signature . (extra-space . 1.25))
649 (staff-bar . (extra-space . 0.6))
650 (key-signature . (extra-space . 0.5))
651 (right-edge . (extra-space . 0.5))
652 (first-note . (fixed-space . 2.5))))
653 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
654 (break-align-symbol . key-cancellation)
655 (break-visibility . ,begin-of-line-invisible)
658 (meta . ((class . Item)
659 (interfaces . (key-signature-interface
661 break-aligned-interface))))))
664 (print-function . ,Key_signature_interface::print)
666 (time-signature . (extra-space . 1.25))
667 (staff-bar . (extra-space . 1.1))
668 (right-edge . (extra-space . 0.5))
669 (first-note . (fixed-space . 2.5))))
670 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
671 (break-align-symbol . key-signature)
672 (break-visibility . ,begin-of-line-visible)
675 (meta . ((class . Item)
676 (interfaces . (key-signature-interface
678 break-aligned-interface))))))
681 (print-function . ,Ledger_line_spanner::print)
682 (X-extent-callback . #f)
683 (Y-extent-callback . #f)
684 (minimum-length-fraction . 0.25)
685 (length-fraction . 0.25)
686 (spacing-procedure . ,Ledger_line_spanner::set_spacing_rods)
687 (print-function . ,Ledger_line_spanner::print)
689 (meta . ((class . Spanner)
690 (interfaces . (ledger-line-interface))))))
694 (break-align-symbol . left-edge)
697 (break-visibility . ,center-invisible)
699 (custos . (extra-space . 0.0))
700 (ambitus . (extra-space . 2.0))
701 (time-signature . (extra-space . 1.0))
702 (staff-bar . (extra-space . 0.0))
703 (breathing-sign . (minimum-space . 0.0))
704 (clef . (extra-space . 0.8))
705 (first-note . (fixed-space . 2.0))
706 (right-edge . (extra-space . 0.0))
707 (key-signature . (extra-space . 0.0))
708 (key-cancellation . (extra-space . 0.0))
710 (meta . ((class . Item)
711 (interfaces . (break-aligned-interface))))))
715 (ligature-primitive-callback . ,Note_head::print)
720 (edge-height . (0.7 . 0.7))
721 (shorten-pair . (-0.2 . -0.2))
722 (before-line-breaking-callback . ,Tuplet_bracket::before_line_breaking)
723 (after-line-breaking-callback . ,Tuplet_bracket::after_line_breaking)
724 (print-function . ,Tuplet_bracket::print)
725 (meta . ((class . Spanner)
726 (interfaces . (tuplet-bracket-interface
735 (minimum-length . 0.3)
737 ; (spacing-procedure . ,Hyphen_spanner::set_spacing_rods)
738 (print-function . ,Hyphen_spanner::print)
740 (meta . ((class . Spanner)
741 (interfaces . (lyric-interface
742 lyric-hyphen-interface
743 spanner-interface))))))
747 (print-function . ,Lyric_extender::print)
748 (thickness . 0.8) ; linethickness
749 (minimum-length . 1.5)
751 (meta . ((class . Spanner)
752 (interfaces . (lyric-interface
753 lyric-extender-interface))))))
756 . ((print-function . ,Text_interface::print)
757 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_parent))
758 (self-alignment-X . 0)
760 (font-series . bold-narrow)
762 (meta . ((class . Item)
763 (interfaces . (rhythmic-grob-interface
764 lyric-syllable-interface
765 self-alignment-interface
773 (ligature-primitive-callback . ,Mensural_ligature::brew_ligature_primitive)
774 (print-function . ,Mensural_ligature::print)
775 (meta . ((class . Spanner)
776 (interfaces . (mensural-ligature-interface
781 (print-function . ,Text_interface::print)
782 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
785 (meta . ((class . Item)
786 (interfaces . (text-interface
787 side-position-interface
789 metronome-mark-interface))))))
792 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
793 (print-function . ,Measure_grouping::print)
799 (meta . ((class . Spanner)
800 (interfaces . (side-position-interface
801 measure-grouping-interface))))))
804 (spacing-procedure . ,Multi_measure_rest::set_spacing_rods)
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 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
823 ,Self_alignment_interface::centered_on_other_axis_parent))
824 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
825 (self-alignment-X . 0)
828 (staff-padding . 0.4)
829 (font-encoding . fetaNumber)
830 (meta . ((class . Spanner)
831 (interfaces . (side-position-interface
832 multi-measure-interface
833 self-alignment-interface
837 (MultiMeasureRestText
839 (print-function . ,Text_interface::print)
840 (spacing-procedure . ,Multi_measure_rest::set_text_rods)
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 ,Self_alignment_interface::aligned_on_self))
913 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
914 (print-function . ,Text_interface::print)
916 ;; no Y dimensions, because of lyrics under tenor clef.
918 (font-shape . italic)
920 (staff-padding . 0.2)
922 (meta . ((class . Item)
923 (interfaces . (text-interface
924 self-alignment-interface
925 side-position-interface
930 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
931 (print-function . ,Ottava_bracket::print)
932 (font-shape . italic)
933 (shorten-pair . (0.0 . -0.6))
934 (staff-padding . 1.0)
936 (minimum-length . 1.0)
937 (dash-fraction . 0.3)
938 (edge-height . (0 . 1.2))
940 (meta . ((class . Spanner)
941 (interfaces . (ottava-bracket-interface
943 side-position-interface
950 (before-line-breaking-callback . ,Paper_column::before_line_breaking)
951 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
954 ;; (print-function . ,Paper_column::print) (font-size . -6) (font-name . "sans") (Y-extent-callback . #f)
955 (meta . ((class . Paper_column)
956 (interfaces . (paper-column-interface
958 spaceable-grob-interface))))))
961 . ((slur-details . ,default-slur-details)
962 (print-function . ,Slur::print)
964 (spacing-procedure . ,Spanner::set_spacing_rods)
965 (minimum-length . 1.5)
966 (after-line-breaking-callback . ,Slur::after_line_breaking)
967 (Y-extent-callback . ,Slur::height)
970 (meta . ((class . Spanner)
971 (interfaces . (slur-interface))))))
973 (NonMusicalPaperColumn
976 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
977 (before-line-breaking-callback . ,Paper_column::before_line_breaking)
980 ;; debugging stuff: print column number.
981 ;; (print-function . ,Paper_column::print) (font-size . -6) (font-name . "sans") (Y-extent-callback . #f)
983 (meta . ((class . Paper_column)
984 (interfaces . (paper-column-interface
986 spaceable-grob-interface))))))
990 (spacing-procedure . ,Multi_measure_rest::set_spacing_rods)
991 (print-function . ,Multi_measure_rest::percent)
994 (font-encoding . fetaMusic)
995 (meta . ((class . Spanner)
996 (interfaces . (multi-measure-rest-interface
998 percent-repeat-interface))))))
999 (PercentRepeatCounter
1000 . ((print-function . ,Text_interface::print)
1001 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
1002 ,Self_alignment_interface::centered_on_other_axis_parent))
1003 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1004 (self-alignment-X . 0)
1007 (staff-padding . 0.25)
1009 (font-encoding . fetaNumber)
1010 (meta . ((class . Spanner)
1011 (interfaces . (side-position-interface
1012 self-alignment-interface
1013 percent-repeat-interface
1015 text-interface))))))
1017 ;; an example of a text spanner
1020 (print-function . ,Piano_pedal_bracket::print)
1022 (bound-padding . 1.0)
1024 (bracket-flare . (0.5 . 0.5))
1025 (edge-height . (1.0 . 1.0))
1026 (shorten-pair . (0.0 . 0.0))
1028 (meta . ((class . Spanner)
1029 (interfaces . (line-interface
1030 piano-pedal-interface
1031 piano-pedal-bracket-interface))))))
1035 (print-function . ,Text_interface::print)
1036 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1037 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1038 (after-line-breaking-callback . ,shift-right-at-line-begin)
1039 (self-alignment-X . 0)
1044 (break-visibility . ,end-of-line-invisible)
1046 (meta . ((class . Item)
1047 (interfaces . (text-interface
1048 side-position-interface
1051 self-alignment-interface))))))
1053 (RemoveEmptyVerticalGroup
1055 (Y-offset-callbacks . (,Hara_kiri_group_spanner::force_hara_kiri_callback))
1056 (Y-extent-callback . ,Hara_kiri_group_spanner::y_extent)
1058 (meta . ((class . Spanner)
1059 (interfaces . (axis-group-interface
1060 vertically-spaceable-interface
1061 hara-kiri-group-interface
1062 spanner-interface))))))
1066 (print-function . ,Percent_repeat_item_interface::beat_slash)
1069 (meta . ((class . Item)
1070 (interfaces . (percent-repeat-interface))))))
1073 (after-line-breaking-callback . ,Rest::after_line_breaking)
1074 (X-extent-callback . ,Rest::extent_callback)
1075 (Y-extent-callback . ,Rest::extent_callback)
1076 (print-function . ,Rest::print)
1077 (Y-offset-callbacks . (,Staff_symbol_referencer::callback
1078 ,Rest::polyphonic_offset_callback))
1079 (minimum-distance . 0.25)
1080 (meta . ((class . Item)
1081 (interfaces . (font-interface
1082 rhythmic-head-interface
1083 rhythmic-grob-interface
1084 staff-symbol-referencer-interface
1085 rest-interface))))))
1089 (minimum-distance . 0.75)
1090 (meta . ((class . Item)
1091 (interfaces . (rest-collision-interface))))))
1095 ;; don't set direction here: it breaks staccato.
1096 (print-function . ,Script_interface::print)
1098 ;; This value is sensitive: if too large, staccato dots will move a
1101 (staff-padding . 0.25)
1102 ;; (script-priority . 0) priorities for scripts, see script.scm
1103 (X-offset-callbacks . (,Self_alignment_interface::centered_on_parent))
1104 (before-line-breaking-callback . ,Script_interface::before_line_breaking)
1105 (font-encoding . fetaMusic)
1106 (meta . ((class . Item)
1107 (interfaces . (script-interface
1108 side-position-interface
1109 font-interface))))))
1113 (before-line-breaking-callback . ,Script_column::before_line_breaking)
1114 (meta . ((class . Item)
1115 (interfaces . (script-column-interface))))))
1119 (X-extent-callback . #f)
1120 (Y-extent-callback . #f)
1121 (meta . ((class . Item)
1122 (interfaces . (spacing-interface
1123 separation-item-interface))))))
1125 (SeparatingGroupSpanner
1127 (spacing-procedure . ,Separating_group_spanner::set_spacing_rods)
1128 (meta . ((class . Spanner)
1129 (interfaces . (only-prebreak-interface
1131 separation-spanner-interface))))))
1134 . ((slur-details . ,default-slur-details)
1135 (print-function . ,Slur::print)
1137 (spacing-procedure . ,Spanner::set_spacing_rods)
1138 (minimum-length . 1.5)
1139 (after-line-breaking-callback . ,Slur::after_line_breaking)
1140 (Y-extent-callback . ,Slur::height)
1142 (height-limit . 2.0)
1144 (meta . ((class . Spanner)
1145 (interfaces . (slur-interface))))))
1149 (spacing-procedure . ,Spacing_spanner::set_springs)
1150 (grace-space-factor . 0.6)
1151 (shortest-duration-space . 2.0)
1152 (spacing-increment . 1.2)
1153 (base-shortest-duration . ,(ly:make-moment 3 16))
1154 (meta . ((class . Spanner)
1155 (interfaces . (spacing-interface
1156 spacing-spanner-interface))))))
1160 (break-align-symbol . staff-bar)
1161 (bar-size-procedure . ,Span_bar::get_bar_size)
1162 (print-function . ,Span_bar::print)
1163 (X-extent-callback . ,Span_bar::width_callback)
1164 (Y-extent-callback . ())
1167 (before-line-breaking-callback . ,Span_bar::before_line_breaking)
1171 ;; Ross. page 151 lists other values, we opt for a leaner look
1175 (hair-thickness . 1.6)
1176 (thick-thickness . 6.0)
1177 (meta . ((class . Item)
1178 (interfaces . (span-bar-interface
1180 bar-line-interface))))))
1183 . ((print-function . ,Text_interface::print)
1184 (font-series . bold)
1186 (X-offset-callbacks . (,Side_position_interface::aligned_side))
1188 (meta . ((class . Item)
1189 (interfaces . (side-position-interface
1190 stanza-number-interface
1192 font-interface))))))
1196 (print-function . ,print-circled-text-callback)
1198 (staff-padding . 0.5)
1199 (self-alignment-X . 0)
1200 (self-alignment-Y . 0)
1201 (script-priority . 100)
1202 (font-encoding . fetaNumber)
1203 (font-size . -5) ; don't overlap when next to heads.
1204 (meta . ((class . Item)
1205 (interfaces . (string-number-interface
1207 text-script-interface
1209 side-position-interface
1210 self-alignment-interface
1211 item-interface))))))
1216 (stem-spacing-correction . 0.4)
1218 (meta . ((class . Item)
1219 (interfaces . (spacing-interface
1220 staff-spacing-interface))))))
1224 (print-function . ,Text_interface::print)
1226 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1227 (no-spacing-rods . #t)
1228 (padding . 0.0) ;; padding relative to SostenutoPedalLineSpanner
1229 (font-shape . italic)
1230 (self-alignment-X . 0)
1231 (meta . ((class . Item)
1232 (interfaces . (text-interface
1233 self-alignment-interface
1234 font-interface))))))
1236 (SostenutoPedalLineSpanner
1239 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1240 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1243 (minimum-space . 1.0)
1245 (meta . ((class . Spanner)
1246 (interfaces . (piano-pedal-interface
1247 axis-group-interface
1248 side-position-interface))))))
1252 (print-function . ,Staff_symbol::print)
1254 (ledger-line-thickness . (1.0 . 0.1))
1256 (meta . ((class . Spanner)
1257 (interfaces . (staff-symbol-interface))))))
1261 ;; this list is rather long. Trim --hwn
1262 (before-line-breaking-callback . ,Stem::before_line_breaking)
1263 (print-function . ,Stem::print)
1266 ;; 3.5 (or 3 measured from note head) is standard length
1267 ;; 32nd, 64th flagged stems should be longer
1268 (lengths . (3.5 3.5 3.5 4.5 5.0))
1270 ;; Stems in unnatural (forced) direction should be shortened by
1271 ;; one staff space, according to [Roush & Gourlay].
1272 ;; Flagged stems we shorten only half a staff space.
1273 (stem-shorten . (1.0 0.5))
1275 ;; default stem direction for note on middle line
1276 (neutral-direction . -1)
1278 ;; FIXME. 3.5 yields too long beams (according to Ross and
1279 ;; looking at Baerenreiter examples) for a number of common
1280 ;; boundary cases. Subtracting half a beam thickness fixes
1281 ;; this, but the bug may well be somewhere else.
1283 ;; FIXME this should come from 'lengths
1285 (beamed-lengths . (3.26 3.5 3.6))
1287 ;; We use the normal minima as minimum for the ideal lengths,
1288 ;; and the extreme minima as abolute minimum length.
1290 ;; The 'normal' minima
1291 (beamed-minimum-free-lengths . (1.83 1.5 1.25))
1292 ;(beamed-minimum-free-lengths . (2.0 1.83 1.25))
1294 ;; The 'extreme case' minima
1295 (beamed-extreme-minimum-free-lengths . (2.0 1.25))
1297 (X-offset-callbacks . (,Stem::offset_callback))
1298 (X-extent-callback . ,Stem::width_callback)
1299 (Y-extent-callback . ,Stem::height)
1300 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
1301 (meta . ((class . Item)
1302 (interfaces . (stem-interface
1303 font-interface))))))
1307 (print-function . ,Stem_tremolo::print)
1308 (Y-extent-callback . ,Stem_tremolo::height)
1309 (X-extent-callback . #f)
1311 (beam-width . 1.6) ; staff-space
1312 (beam-thickness . 0.48) ; staff-space
1313 (meta . ((class . Item)
1314 (interfaces . (stem-tremolo-interface))))))
1318 (no-spacing-rods . #t)
1319 (print-function . ,Sustain_pedal::print)
1320 (self-alignment-X . 0)
1322 (padding . 0.0) ;; padding relative to SustainPedalLineSpanner
1323 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1324 (meta . ((class . Item)
1325 (interfaces . (piano-pedal-interface
1326 text-spanner-interface
1328 self-alignment-interface
1329 font-interface))))))
1331 (SustainPedalLineSpanner
1334 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1335 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1338 (staff-padding . 1.2)
1339 (minimum-space . 1.0)
1341 (meta . ((class . Spanner)
1342 (interfaces . (piano-pedal-interface
1343 axis-group-interface
1344 side-position-interface))))))
1349 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
1350 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1351 (meta . ((class . System)
1352 (interfaces . (system-interface
1353 axis-group-interface))))))
1358 (print-function . ,System_start_delimiter::print)
1359 (collapse-height . 5.0)
1360 (font-encoding . fetaBraces)
1361 (Y-extent-callback . #f)
1362 (meta . ((class . Spanner)
1363 (interfaces . (system-start-delimiter-interface
1364 font-interface))))))
1368 (Y-extent-callback . #f)
1369 (X-offset-callbacks . (,(lambda (g a) -0.8)))
1370 (print-function . ,System_start_delimiter::print)
1372 (collapse-height . 1)
1374 (meta . ((class . Spanner)
1375 (interfaces . (font-interface
1376 system-start-delimiter-interface))))))
1380 (Y-extent-callback . #f)
1381 (print-function . ,System_start_delimiter::print)
1382 (glyph . "bar-line")
1384 (after-line-breaking-callback . ,System_start_delimiter::after_line_breaking)
1385 (meta . ((class . Spanner)
1386 (interfaces . (system-start-delimiter-interface))))))
1390 (print-function . ,Text_interface::print)
1391 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
1393 (stem-attachment-function . ,tablature-stem-attachment-function)
1394 (font-series . bold)
1395 (meta . ((class . Item)
1397 . (rhythmic-head-interface
1400 staff-symbol-referencer-interface
1401 text-interface))))))
1405 (print-function . ,Text_interface::print)
1406 (no-spacing-rods . #t)
1407 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1410 ;; sync with Fingering ?
1412 (staff-padding . 0.5)
1413 (before-line-breaking-callback . ,Script_interface::before_line_breaking)
1414 (avoid-slur . around)
1415 (slur-padding . 0.5)
1416 (script-priority . 200)
1417 ;; todo: add X self alignment?
1418 (meta . ((class . Item)
1419 (interfaces . (text-script-interface
1421 side-position-interface
1422 font-interface))))))
1426 (print-function . ,Text_spanner::print)
1427 (font-shape . italic)
1428 (style . dashed-line)
1429 (staff-padding . 0.8)
1430 (dash-fraction . 0.2)
1433 (meta . ((class . Spanner)
1434 (interfaces . (text-spanner-interface
1435 side-position-interface
1436 font-interface))))))
1440 (print-function . ,Tie::print)
1441 (details . ((ratio . 0.333) (height-limit . 1.0)))
1443 (meta . ((class . Spanner)
1444 (interfaces . (tie-interface))))))
1448 (after-line-breaking-callback . ,Tie_column::after_line_breaking)
1449 (before-line-breaking-callback . ,Tie_column::before_line_breaking)
1450 (X-extent-callback . #f)
1451 (Y-extent-callback . #f)
1452 (meta . ((class . Spanner)
1453 (interfaces . (tie-column-interface))))))
1457 (print-function . ,Time_signature::print)
1458 (break-align-symbol . time-signature)
1459 (break-visibility . ,all-visible)
1461 (first-note . (fixed-space . 2.0))
1462 (right-edge . (extra-space . 0.5))
1463 (staff-bar . (minimum-space . 2.0))))
1466 (meta . ((class . Item)
1467 (interfaces . (time-signature-interface
1468 break-aligned-interface
1469 font-interface))))))
1473 (print-function . ,Dynamic_text_spanner::print)
1474 (edge-text . ,(cons (make-musicglyph-markup "scripts.trill")
1477 (staff-padding . 1.0)
1480 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1481 (meta . ((class . Spanner)
1482 (interfaces . (text-spanner-interface
1483 side-position-interface
1484 font-interface))))))
1486 (TrillPitchAccidental
1487 . ((X-offset-callbacks . (,Side_position_interface::aligned_side))
1491 (print-function . ,Accidental_interface::print)
1492 (meta . ((class . Item)
1493 (interfaces . (item-interface
1494 accidental-interface
1495 side-position-interface
1496 font-interface))))))
1499 . ((X-offset-callbacks . (,Side_position_interface::aligned_side))
1502 (print-function . ,parenthesize-elements)
1503 (direction . ,RIGHT)
1505 (meta . ((class . Item)
1506 (interfaces . (side-position-interface
1508 rhythmic-head-interface
1510 accidental-interface
1511 axis-group-interface))))))
1514 . ((print-function . ,Note_head::print)
1516 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
1518 (meta . ((class . Item)
1519 (interfaces . (item-interface
1520 rhythmic-head-interface
1522 pitched-trill-interface
1524 staff-symbol-referencer-interface))))))
1530 (edge-height . (0.7 . 0.7))
1531 (shorten-pair . (-0.2 . -0.2))
1532 (before-line-breaking-callback . ,Tuplet_bracket::before_line_breaking)
1533 (after-line-breaking-callback . ,Tuplet_bracket::after_line_breaking)
1534 (print-function . ,Tuplet_bracket::print)
1535 (font-shape . italic)
1538 (meta . ((class . Spanner)
1539 (interfaces . (text-interface
1541 tuplet-bracket-interface
1542 font-interface))))))
1546 (print-function . ,Text_interface::print)
1547 (font-shape . italic)
1548 (no-spacing-rods . #t)
1549 (self-alignment-X . 0)
1551 (padding . 0.0) ;; padding relative to UnaCordaPedalLineSpanner
1552 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1553 (meta . ((class . Item)
1554 (interfaces . (text-interface
1555 self-alignment-interface
1556 font-interface))))))
1558 (UnaCordaPedalLineSpanner
1561 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1562 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1564 (staff-padding . 1.2)
1565 (minimum-space . 1.0)
1567 (meta . ((class . Spanner)
1568 (interfaces . (piano-pedal-interface
1569 axis-group-interface
1570 side-position-interface))))))
1576 (ligature-primitive-callback . ,Vaticana_ligature::brew_ligature_primitive)
1577 (print-function . ,Vaticana_ligature::print)
1578 (meta . ((class . Spanner)
1579 (interfaces . (vaticana-ligature-interface
1580 font-interface))))))
1585 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1586 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
1588 (meta . ((class . Spanner)
1589 (interfaces . (align-interface
1590 axis-group-interface))))))
1595 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1596 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
1598 (meta . ((class . Spanner)
1599 (interfaces . (axis-group-interface
1600 vertically-spaceable-interface))))))
1605 (Y-offset-callbacks . (,Side_position_interface::aligned_on_support_refpoints))
1607 (space-alist . ((left-edge . (extra-space . 1.0))))
1608 (break-align-symbol . instrument-name)
1609 (print-function . ,Text_interface::print)
1610 (break-align-symbol . clef)
1611 (break-visibility . ,begin-of-line-visible)
1613 (meta . ((class . Item)
1614 (interfaces . (font-interface
1615 self-alignment-interface
1616 side-position-interface
1618 break-aligned-interface))))))
1622 (print-function . ,Volta_bracket_interface::print)
1625 (font-encoding . fetaNumber)
1626 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1627 (thickness . 1.6) ;; linethickness
1628 (height . 2.0) ;; staffspace;
1631 (meta . ((class . Spanner)
1632 (interfaces . (volta-bracket-interface
1635 side-position-interface
1636 font-interface))))))
1643 (X-extent-callback . #f)
1644 (Y-extent-callback . #f)
1645 (print-function . ,Line_spanner::print)
1646 (after-line-breaking-callback . ,Line_spanner::after_line_breaking)
1647 (meta . ((class . Spanner)
1648 (interfaces . (line-spanner-interface
1649 line-interface))))))))
1651 (define (completize-grob-entry x)
1652 "Transplant assoc key into 'name entry of 'meta of X. Set interfaces for Item, Spanner etc.
1654 ;; (display (car x))
1656 (let* ((name-sym (car x))
1657 (grob-entry (cdr x))
1658 (meta-entry (cdr (assoc 'meta grob-entry)))
1659 (class (cdr (assoc 'class meta-entry)))
1661 (cdr (assoc 'interfaces meta-entry))))
1665 (set! ifaces-entry (cons 'item-interface ifaces-entry)))
1666 ((eq? 'Spanner class)
1667 (set! ifaces-entry (cons 'spanner-interface ifaces-entry)))
1668 ((eq? 'Paper_column class)
1669 (set! ifaces-entry (cons 'item-interface
1670 (cons 'paper-column-interface ifaces-entry))))
1671 ((eq? 'System class)
1672 (set! ifaces-entry (cons 'system-interface
1673 (cons 'spanner-interface ifaces-entry))))
1675 (ly:warning "Unknown class ~a" class)))
1676 (set! ifaces-entry (cons 'grob-interface ifaces-entry))
1678 (set! meta-entry (assoc-set! meta-entry 'name name-sym))
1679 (set! meta-entry (assoc-set! meta-entry 'interfaces
1681 (set! grob-entry (assoc-set! grob-entry 'meta meta-entry))
1682 (cons name-sym grob-entry)))
1684 (set! all-grob-descriptions (map completize-grob-entry all-grob-descriptions))
1686 ;; (display (map pair? all-grob-descriptions))
1688 ;; make sure that \property Foo.Bar =\turnOff doesn't complain
1691 ;; (display (car x)) (newline)
1693 (set-object-property! (car x) 'translation-type? list?)
1694 (set-object-property! (car x) 'is-grob? #t))
1695 all-grob-descriptions)
1697 (set! all-grob-descriptions (sort all-grob-descriptions alist<?))