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
836 (MultiMeasureRestText
838 (print-function . ,Text_interface::print)
839 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
840 ,Self_alignment_interface::centered_on_other_axis_parent))
841 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
842 (self-alignment-X . 0)
845 (staff-padding . 0.25)
846 (meta . ((class . Spanner)
847 (interfaces . (side-position-interface
848 multi-measure-interface
849 self-alignment-interface
856 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
857 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
858 (meta . ((class . Item)
859 (interfaces . (note-collision-interface
860 axis-group-interface))))))
865 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
866 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
867 (meta . ((class . Item)
868 (interfaces . (axis-group-interface
869 note-column-interface))))))
873 (print-function . ,Note_head::print)
874 (ligature-primitive-callback . ,Note_head::print)
875 (glyph-name-procedure . ,find-notehead-symbol)
876 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
877 (stem-attachment-function . ,note-head-style->attachment-coordinates)
878 (meta . ((class . Item)
879 (interfaces . (rhythmic-grob-interface
880 rhythmic-head-interface
884 staff-symbol-referencer-interface))))))
888 (stem-spacing-correction . 0.5)
889 (same-direction-correction . 0.25)
890 ;; Changed this from 0.75.
891 ;; If you ever change this back, please document! --hwn
892 (knee-spacing-correction . 1.0)
894 (meta . ((class . Item)
895 (interfaces . (spacing-interface
896 note-spacing-interface))))))
900 (print-function . ,Text_interface::print)
901 (meta . ((class . Item)
902 (interfaces . (note-name-interface
908 (self-alignment-X . 0)
909 (break-visibility . ,begin-of-line-visible)
910 (X-offset-callbacks . (,Self_alignment_interface::centered_on_parent ,Self_alignment_interface::aligned_on_self))
911 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
912 (print-function . ,Text_interface::print)
914 ;; no Y dimensions, because of lyrics under tenor clef.
916 (font-shape . italic)
918 (staff-padding . 0.2)
920 (meta . ((class . Item)
921 (interfaces . (text-interface
922 self-alignment-interface
923 side-position-interface
928 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
929 (print-function . ,Ottava_bracket::print)
930 (font-shape . italic)
931 (shorten-pair . (0.0 . -0.6))
932 (staff-padding . 1.0)
934 (minimum-length . 1.0)
935 (dash-fraction . 0.3)
936 (edge-height . (0 . 1.2))
938 (meta . ((class . Spanner)
939 (interfaces . (ottava-bracket-interface
941 side-position-interface
948 (before-line-breaking-callback . ,Paper_column::before_line_breaking)
949 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
952 ;; (print-function . ,Paper_column::print) (font-size . -6) (font-name . "sans") (Y-extent-callback . #f)
953 (meta . ((class . Paper_column)
954 (interfaces . (paper-column-interface
956 spaceable-grob-interface))))))
959 . ((slur-details . ,default-slur-details)
960 (print-function . ,Slur::print)
962 (spacing-procedure . ,Spanner::set_spacing_rods)
963 (minimum-length . 1.5)
964 (after-line-breaking-callback . ,Slur::after_line_breaking)
965 (Y-extent-callback . ,Slur::height)
968 (meta . ((class . Spanner)
969 (interfaces . (slur-interface))))))
971 (NonMusicalPaperColumn
974 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
975 (before-line-breaking-callback . ,Paper_column::before_line_breaking)
978 ;; debugging stuff: print column number.
979 ;; (print-function . ,Paper_column::print) (font-size . -6) (font-name . "sans") (Y-extent-callback . #f)
981 (meta . ((class . Paper_column)
982 (interfaces . (paper-column-interface
984 spaceable-grob-interface))))))
988 (spacing-procedure . ,Multi_measure_rest::set_spacing_rods)
989 (print-function . ,Multi_measure_rest::percent)
992 (font-encoding . fetaMusic)
993 (meta . ((class . Spanner)
994 (interfaces . (multi-measure-rest-interface
996 percent-repeat-interface))))))
997 (PercentRepeatCounter
998 . ((print-function . ,Text_interface::print)
999 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
1000 ,Self_alignment_interface::centered_on_other_axis_parent))
1001 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1002 (self-alignment-X . 0)
1005 (staff-padding . 0.25)
1007 (font-encoding . fetaNumber)
1008 (meta . ((class . Spanner)
1009 (interfaces . (side-position-interface
1010 self-alignment-interface
1011 percent-repeat-interface
1013 text-interface))))))
1015 ;; an example of a text spanner
1018 (print-function . ,Piano_pedal_bracket::print)
1020 (bound-padding . 1.0)
1022 (bracket-flare . (0.5 . 0.5))
1023 (edge-height . (1.0 . 1.0))
1024 (shorten-pair . (0.0 . 0.0))
1026 (meta . ((class . Spanner)
1027 (interfaces . (line-interface
1028 piano-pedal-interface
1029 piano-pedal-bracket-interface))))))
1033 (print-function . ,Text_interface::print)
1034 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1035 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1036 (after-line-breaking-callback . ,shift-right-at-line-begin)
1037 (self-alignment-X . 0)
1042 (break-visibility . ,end-of-line-invisible)
1044 (meta . ((class . Item)
1045 (interfaces . (text-interface
1046 side-position-interface
1049 self-alignment-interface))))))
1051 (RemoveEmptyVerticalGroup
1053 (Y-offset-callbacks . (,Hara_kiri_group_spanner::force_hara_kiri_callback))
1054 (Y-extent-callback . ,Hara_kiri_group_spanner::y_extent)
1056 (meta . ((class . Spanner)
1057 (interfaces . (axis-group-interface
1058 vertically-spaceable-interface
1059 hara-kiri-group-interface
1060 spanner-interface))))))
1064 (print-function . ,Percent_repeat_item_interface::beat_slash)
1067 (meta . ((class . Item)
1068 (interfaces . (percent-repeat-interface))))))
1071 (after-line-breaking-callback . ,Rest::after_line_breaking)
1072 (X-extent-callback . ,Rest::extent_callback)
1073 (Y-extent-callback . ,Rest::extent_callback)
1074 (print-function . ,Rest::print)
1075 (Y-offset-callbacks . (,Staff_symbol_referencer::callback
1076 ,Rest::polyphonic_offset_callback))
1077 (minimum-distance . 0.25)
1078 (meta . ((class . Item)
1079 (interfaces . (font-interface
1080 rhythmic-head-interface
1081 rhythmic-grob-interface
1082 staff-symbol-referencer-interface
1083 rest-interface))))))
1087 (minimum-distance . 0.75)
1088 (meta . ((class . Item)
1089 (interfaces . (rest-collision-interface))))))
1093 ;; don't set direction here: it breaks staccato.
1094 (print-function . ,Script_interface::print)
1096 ;; This value is sensitive: if too large, staccato dots will move a
1099 (staff-padding . 0.25)
1100 ;; (script-priority . 0) priorities for scripts, see script.scm
1101 (X-offset-callbacks . (,Self_alignment_interface::centered_on_parent))
1102 (before-line-breaking-callback . ,Script_interface::before_line_breaking)
1103 (font-encoding . fetaMusic)
1104 (meta . ((class . Item)
1105 (interfaces . (script-interface
1106 side-position-interface
1107 font-interface))))))
1111 (before-line-breaking-callback . ,Script_column::before_line_breaking)
1112 (meta . ((class . Item)
1113 (interfaces . (script-column-interface))))))
1117 (X-extent-callback . #f)
1118 (Y-extent-callback . #f)
1119 (meta . ((class . Item)
1120 (interfaces . (spacing-interface
1121 separation-item-interface))))))
1123 (SeparatingGroupSpanner
1125 (spacing-procedure . ,Separating_group_spanner::set_spacing_rods)
1126 (meta . ((class . Spanner)
1127 (interfaces . (only-prebreak-interface
1129 separation-spanner-interface))))))
1132 . ((slur-details . ,default-slur-details)
1133 (print-function . ,Slur::print)
1135 (spacing-procedure . ,Spanner::set_spacing_rods)
1136 (minimum-length . 1.5)
1137 (after-line-breaking-callback . ,Slur::after_line_breaking)
1138 (Y-extent-callback . ,Slur::height)
1140 (height-limit . 2.0)
1142 (meta . ((class . Spanner)
1143 (interfaces . (slur-interface))))))
1147 (spacing-procedure . ,Spacing_spanner::set_springs)
1148 (grace-space-factor . 0.6)
1149 (shortest-duration-space . 2.0)
1150 (spacing-increment . 1.2)
1151 (base-shortest-duration . ,(ly:make-moment 3 16))
1152 (meta . ((class . Spanner)
1153 (interfaces . (spacing-interface
1154 spacing-spanner-interface))))))
1158 (break-align-symbol . staff-bar)
1159 (bar-size-procedure . ,Span_bar::get_bar_size)
1160 (print-function . ,Span_bar::print)
1161 (X-extent-callback . ,Span_bar::width_callback)
1162 (Y-extent-callback . ())
1165 (before-line-breaking-callback . ,Span_bar::before_line_breaking)
1169 ;; Ross. page 151 lists other values, we opt for a leaner look
1173 (hair-thickness . 1.6)
1174 (thick-thickness . 6.0)
1175 (meta . ((class . Item)
1176 (interfaces . (span-bar-interface
1178 bar-line-interface))))))
1181 . ((print-function . ,Text_interface::print)
1182 (font-series . bold)
1184 (X-offset-callbacks . (,Side_position_interface::aligned_side))
1186 (meta . ((class . Item)
1187 (interfaces . (side-position-interface
1188 stanza-number-interface
1190 font-interface))))))
1194 (print-function . ,print-circled-text-callback)
1196 (staff-padding . 0.5)
1197 (self-alignment-X . 0)
1198 (self-alignment-Y . 0)
1199 (script-priority . 100)
1200 (font-encoding . fetaNumber)
1201 (font-size . -5) ; don't overlap when next to heads.
1202 (meta . ((class . Item)
1203 (interfaces . (string-number-interface
1205 text-script-interface
1207 side-position-interface
1208 self-alignment-interface
1209 item-interface))))))
1214 (stem-spacing-correction . 0.4)
1216 (meta . ((class . Item)
1217 (interfaces . (spacing-interface
1218 staff-spacing-interface))))))
1222 (print-function . ,Text_interface::print)
1224 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1225 (no-spacing-rods . #t)
1226 (padding . 0.0) ;; padding relative to SostenutoPedalLineSpanner
1227 (font-shape . italic)
1228 (self-alignment-X . 0)
1229 (meta . ((class . Item)
1230 (interfaces . (text-interface
1231 self-alignment-interface
1232 font-interface))))))
1234 (SostenutoPedalLineSpanner
1237 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1238 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1241 (minimum-space . 1.0)
1243 (meta . ((class . Spanner)
1244 (interfaces . (piano-pedal-interface
1245 axis-group-interface
1246 side-position-interface))))))
1250 (print-function . ,Staff_symbol::print)
1252 (ledger-line-thickness . (1.0 . 0.1))
1254 (meta . ((class . Spanner)
1255 (interfaces . (staff-symbol-interface))))))
1259 ;; this list is rather long. Trim --hwn
1260 (before-line-breaking-callback . ,Stem::before_line_breaking)
1261 (print-function . ,Stem::print)
1264 ;; 3.5 (or 3 measured from note head) is standard length
1265 ;; 32nd, 64th flagged stems should be longer
1266 (lengths . (3.5 3.5 3.5 4.5 5.0))
1268 ;; Stems in unnatural (forced) direction should be shortened by
1269 ;; one staff space, according to [Roush & Gourlay].
1270 ;; Flagged stems we shorten only half a staff space.
1271 (stem-shorten . (1.0 0.5))
1273 ;; default stem direction for note on middle line
1274 (neutral-direction . -1)
1276 ;; FIXME. 3.5 yields too long beams (according to Ross and
1277 ;; looking at Baerenreiter examples) for a number of common
1278 ;; boundary cases. Subtracting half a beam thickness fixes
1279 ;; this, but the bug may well be somewhere else.
1281 ;; FIXME this should come from 'lengths
1283 (beamed-lengths . (3.26 3.5 3.6))
1285 ;; We use the normal minima as minimum for the ideal lengths,
1286 ;; and the extreme minima as abolute minimum length.
1288 ;; The 'normal' minima
1289 (beamed-minimum-free-lengths . (1.83 1.5 1.25))
1290 ;(beamed-minimum-free-lengths . (2.0 1.83 1.25))
1292 ;; The 'extreme case' minima
1293 (beamed-extreme-minimum-free-lengths . (2.0 1.25))
1295 (X-offset-callbacks . (,Stem::offset_callback))
1296 (X-extent-callback . ,Stem::width_callback)
1297 (Y-extent-callback . ,Stem::height)
1298 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
1299 (meta . ((class . Item)
1300 (interfaces . (stem-interface
1301 font-interface))))))
1305 (print-function . ,Stem_tremolo::print)
1306 (Y-extent-callback . ,Stem_tremolo::height)
1307 (X-extent-callback . #f)
1309 (beam-width . 1.6) ; staff-space
1310 (beam-thickness . 0.48) ; staff-space
1311 (meta . ((class . Item)
1312 (interfaces . (stem-tremolo-interface))))))
1316 (no-spacing-rods . #t)
1317 (print-function . ,Sustain_pedal::print)
1318 (self-alignment-X . 0)
1320 (padding . 0.0) ;; padding relative to SustainPedalLineSpanner
1321 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1322 (meta . ((class . Item)
1323 (interfaces . (piano-pedal-interface
1324 text-spanner-interface
1326 self-alignment-interface
1327 font-interface))))))
1329 (SustainPedalLineSpanner
1332 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1333 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1336 (staff-padding . 1.2)
1337 (minimum-space . 1.0)
1339 (meta . ((class . Spanner)
1340 (interfaces . (piano-pedal-interface
1341 axis-group-interface
1342 side-position-interface))))))
1347 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
1348 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1349 (meta . ((class . System)
1350 (interfaces . (system-interface
1351 axis-group-interface))))))
1356 (print-function . ,System_start_delimiter::print)
1357 (collapse-height . 5.0)
1358 (font-encoding . fetaBraces)
1359 (Y-extent-callback . #f)
1360 (meta . ((class . Spanner)
1361 (interfaces . (system-start-delimiter-interface
1362 font-interface))))))
1366 (Y-extent-callback . #f)
1367 (X-offset-callbacks . (,(lambda (g a) -0.8)))
1368 (print-function . ,System_start_delimiter::print)
1370 (collapse-height . 1)
1372 (meta . ((class . Spanner)
1373 (interfaces . (font-interface
1374 system-start-delimiter-interface))))))
1378 (Y-extent-callback . #f)
1379 (print-function . ,System_start_delimiter::print)
1380 (glyph . "bar-line")
1382 (after-line-breaking-callback . ,System_start_delimiter::after_line_breaking)
1383 (meta . ((class . Spanner)
1384 (interfaces . (system-start-delimiter-interface))))))
1388 (print-function . ,Text_interface::print)
1389 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
1391 (stem-attachment-function . ,tablature-stem-attachment-function)
1392 (font-series . bold)
1393 (meta . ((class . Item)
1395 . (rhythmic-head-interface
1398 staff-symbol-referencer-interface
1399 text-interface))))))
1403 (print-function . ,Text_interface::print)
1404 (no-spacing-rods . #t)
1405 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1408 ;; sync with Fingering ?
1410 (staff-padding . 0.5)
1411 (before-line-breaking-callback . ,Script_interface::before_line_breaking)
1412 (avoid-slur . around)
1413 (slur-padding . 0.5)
1414 (script-priority . 200)
1415 ;; todo: add X self alignment?
1416 (meta . ((class . Item)
1417 (interfaces . (text-script-interface
1419 side-position-interface
1420 font-interface))))))
1424 (print-function . ,Text_spanner::print)
1425 (font-shape . italic)
1426 (style . dashed-line)
1427 (staff-padding . 0.8)
1428 (dash-fraction . 0.2)
1431 (meta . ((class . Spanner)
1432 (interfaces . (text-spanner-interface
1433 side-position-interface
1434 font-interface))))))
1438 (print-function . ,Tie::print)
1439 (spacing-procedure . ,Spanner::set_spacing_rods)
1440 (staffline-clearance . 0.35)
1441 (details . ((ratio . 0.333) (height-limit . 1.0)))
1445 (minimum-length . 2.5)
1446 (meta . ((class . Spanner)
1447 (interfaces . (tie-interface))))))
1451 (after-line-breaking-callback . ,Tie_column::after_line_breaking)
1452 (before-line-breaking-callback . ,Tie_column::before_line_breaking)
1453 (X-extent-callback . #f)
1454 (Y-extent-callback . #f)
1455 (meta . ((class . Spanner)
1456 (interfaces . (tie-column-interface))))))
1460 (print-function . ,Time_signature::print)
1461 (break-align-symbol . time-signature)
1462 (break-visibility . ,all-visible)
1464 (first-note . (fixed-space . 2.0))
1465 (right-edge . (extra-space . 0.5))
1466 (staff-bar . (minimum-space . 2.0))))
1469 (meta . ((class . Item)
1470 (interfaces . (time-signature-interface
1471 break-aligned-interface
1472 font-interface))))))
1476 (print-function . ,Dynamic_text_spanner::print)
1477 (edge-text . ,(cons (make-musicglyph-markup "scripts.trill")
1480 (staff-padding . 1.0)
1483 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1484 (meta . ((class . Spanner)
1485 (interfaces . (text-spanner-interface
1486 side-position-interface
1487 font-interface))))))
1489 (TrillPitchAccidental
1490 . ((X-offset-callbacks . (,Side_position_interface::aligned_side))
1494 (print-function . ,Accidental_interface::print)
1495 (meta . ((class . Item)
1496 (interfaces . (item-interface
1497 accidental-interface
1498 side-position-interface
1499 font-interface))))))
1502 . ((X-offset-callbacks . (,Side_position_interface::aligned_side))
1505 (print-function . ,parenthesize-elements)
1506 (direction . ,RIGHT)
1508 (meta . ((class . Item)
1509 (interfaces . (side-position-interface
1511 rhythmic-head-interface
1513 accidental-interface
1514 axis-group-interface))))))
1517 . ((print-function . ,Note_head::print)
1519 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
1521 (meta . ((class . Item)
1522 (interfaces . (item-interface
1523 rhythmic-head-interface
1525 pitched-trill-interface
1527 staff-symbol-referencer-interface))))))
1533 (edge-height . (0.7 . 0.7))
1534 (shorten-pair . (-0.2 . -0.2))
1535 (before-line-breaking-callback . ,Tuplet_bracket::before_line_breaking)
1536 (after-line-breaking-callback . ,Tuplet_bracket::after_line_breaking)
1537 (print-function . ,Tuplet_bracket::print)
1538 (font-shape . italic)
1541 (meta . ((class . Spanner)
1542 (interfaces . (text-interface
1544 tuplet-bracket-interface
1545 font-interface))))))
1549 (print-function . ,Text_interface::print)
1550 (font-shape . italic)
1551 (no-spacing-rods . #t)
1552 (self-alignment-X . 0)
1554 (padding . 0.0) ;; padding relative to UnaCordaPedalLineSpanner
1555 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1556 (meta . ((class . Item)
1557 (interfaces . (text-interface
1558 self-alignment-interface
1559 font-interface))))))
1561 (UnaCordaPedalLineSpanner
1564 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1565 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1567 (staff-padding . 1.2)
1568 (minimum-space . 1.0)
1570 (meta . ((class . Spanner)
1571 (interfaces . (piano-pedal-interface
1572 axis-group-interface
1573 side-position-interface))))))
1579 (ligature-primitive-callback . ,Vaticana_ligature::brew_ligature_primitive)
1580 (print-function . ,Vaticana_ligature::print)
1581 (meta . ((class . Spanner)
1582 (interfaces . (vaticana-ligature-interface
1583 font-interface))))))
1588 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1589 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
1591 (meta . ((class . Spanner)
1592 (interfaces . (align-interface
1593 axis-group-interface))))))
1598 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1599 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
1601 (meta . ((class . Spanner)
1602 (interfaces . (axis-group-interface
1603 vertically-spaceable-interface))))))
1608 (Y-offset-callbacks . (,Side_position_interface::aligned_on_support_refpoints))
1610 (space-alist . ((left-edge . (extra-space . 1.0))))
1611 (break-align-symbol . instrument-name)
1612 (print-function . ,Text_interface::print)
1613 (break-align-symbol . clef)
1614 (break-visibility . ,begin-of-line-visible)
1616 (meta . ((class . Item)
1617 (interfaces . (font-interface
1618 self-alignment-interface
1619 side-position-interface
1621 break-aligned-interface))))))
1625 (print-function . ,Volta_bracket_interface::print)
1628 (font-encoding . fetaNumber)
1629 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1630 (thickness . 1.6) ;; linethickness
1631 (height . 2.0) ;; staffspace;
1634 (meta . ((class . Spanner)
1635 (interfaces . (volta-bracket-interface
1638 side-position-interface
1639 font-interface))))))
1646 (X-extent-callback . #f)
1647 (Y-extent-callback . #f)
1648 (print-function . ,Line_spanner::print)
1649 (after-line-breaking-callback . ,Line_spanner::after_line_breaking)
1650 (meta . ((class . Spanner)
1651 (interfaces . (line-spanner-interface
1652 line-interface))))))))
1654 (define (completize-grob-entry x)
1655 "Transplant assoc key into 'name entry of 'meta of X. Set interfaces for Item, Spanner etc.
1657 ;; (display (car x))
1659 (let* ((name-sym (car x))
1660 (grob-entry (cdr x))
1661 (meta-entry (cdr (assoc 'meta grob-entry)))
1662 (class (cdr (assoc 'class meta-entry)))
1664 (cdr (assoc 'interfaces meta-entry))))
1668 (set! ifaces-entry (cons 'item-interface ifaces-entry)))
1669 ((eq? 'Spanner class)
1670 (set! ifaces-entry (cons 'spanner-interface ifaces-entry)))
1671 ((eq? 'Paper_column class)
1672 (set! ifaces-entry (cons 'item-interface
1673 (cons 'paper-column-interface ifaces-entry))))
1674 ((eq? 'System class)
1675 (set! ifaces-entry (cons 'system-interface
1676 (cons 'spanner-interface ifaces-entry))))
1678 (ly:warning "Unknown class ~a" class)))
1679 (set! ifaces-entry (cons 'grob-interface ifaces-entry))
1681 (set! meta-entry (assoc-set! meta-entry 'name name-sym))
1682 (set! meta-entry (assoc-set! meta-entry 'interfaces
1684 (set! grob-entry (assoc-set! grob-entry 'meta meta-entry))
1685 (cons name-sym grob-entry)))
1687 (set! all-grob-descriptions (map completize-grob-entry all-grob-descriptions))
1689 ;; (display (map pair? all-grob-descriptions))
1691 ;; make sure that \property Foo.Bar =\turnOff doesn't complain
1694 ;; (display (car x)) (newline)
1696 (set-object-property! (car x) 'translation-type? list?)
1697 (set-object-property! (car x) 'is-grob? #t))
1698 all-grob-descriptions)
1700 (set! all-grob-descriptions (sort all-grob-descriptions alist<?))