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
32 . ((X-extent-callback . ,Axis_group_interface::group_extent_callback)
35 ;; this is quite small, but it is very ugly to have
36 ;; accs closer to the previous note than to the next one.
37 (right-padding . 0.15)
38 (meta . ((class . Item)
39 (interfaces . (accidental-placement-interface))))
44 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
45 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
47 (clef . (extra-space . 0.5))
48 (key-signature . (extra-space . 0.0))
49 (staff-bar . (extra-space . 0.0))
50 (time-signature . (extra-space . 0.0))
51 (first-note . (fixed-space . 0.0))
54 (break-align-symbol . ambitus)
55 (break-visibility . ,begin-of-line-visible)
56 (meta . ((class . Item)
57 (interfaces . (axis-group-interface
58 break-aligned-interface ambitus-interface))))
63 (print-function . ,Ambitus::print)
66 (X-offset-callbacks . (,Self_alignment_interface::centered_on_parent))
68 (meta . ((class . Item)
69 (interfaces . (ambitus-interface staff-symbol-referencer-interface font-interface))))
73 (print-function . ,Accidental_interface::print)
76 (X-offset-callbacks . (,Side_position_interface::aligned_side))
78 (cautionary-style . parentheses)
79 (after-line-breaking-callback . ,Accidental_interface::after_line_breaking)
80 (meta . ((class . Item)
81 (interfaces . (item-interface
82 accidental-interface break-aligned-interface
83 side-position-interface font-interface))))
89 (print-function . ,Note_head::print)
90 (glyph-name-procedure . ,find-notehead-symbol)
91 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
92 (meta . ((class . Item)
93 (interfaces . (font-interface note-head-interface
95 staff-symbol-referencer-interface
96 rhythmic-head-interface
103 (X-extent-callback . ,Arpeggio::width_callback)
104 (print-function . ,Arpeggio::print)
105 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
106 (X-offset-callbacks . (,Side_position_interface::aligned_side))
109 (staff-position . 0.0)
110 (meta . ((class . Item)
111 (interfaces . (arpeggio-interface
112 staff-symbol-referencer-interface side-position-interface
118 (break-align-symbol . staff-bar)
120 (break-glyph-function . ,default-break-barline)
122 (bar-size-procedure . ,Bar_line::get_staff_bar_size)
123 (print-function . ,Bar_line::print)
124 (break-visibility . ,all-visible)
126 (before-line-breaking-callback . ,Bar_line::before_line_breaking)
128 (time-signature . (extra-space . 0.75))
129 (custos . (minimum-space . 2.0))
130 (clef . (minimum-space . 1.0))
131 (key-signature . (extra-space . 1.0))
132 (key-cancellation . (extra-space . 1.0))
133 (first-note . (fixed-space . 1.3))
134 (next-note . (semi-fixed-space . 1.3))
135 (right-edge . (extra-space . 0.0))
139 ;; Ross. page 151 lists other values, we opt for a leaner look
142 ;; kern should scale with linethickness too.
145 (hair-thickness . 1.9)
146 (thick-thickness . 6.0)
147 (meta . ((class . Item)
148 (interfaces . (bar-line-interface
149 break-aligned-interface font-interface))))
155 (print-function . ,Text_interface::print)
157 (break-visibility . ,begin-of-line-visible)
160 (font-family . roman)
162 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
163 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
164 (self-alignment-X . 1)
168 (interfaces . (side-position-interface
170 self-alignment-interface
171 font-interface break-aligned-interface))))
177 (print-function . ,Text_interface::print)
178 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
180 (font-family . number)
182 ;; We must do this, other BFs in
183 ;; layout16 become too small.
186 (meta . ((class . Item)
187 (interfaces . (text-interface
188 rhythmic-grob-interface bass-figure-interface
189 self-alignment-interface font-interface))))
193 ;; todo: clean this up a bit: the list is getting
195 (print-function . ,Beam::print)
197 (positions . (#f . #f))
198 (position-callbacks . (,Beam::least_squares
201 ,Beam::shift_region_to_valid
205 ;; TODO: should be in SLT.
206 (thickness . 0.48) ; in staff-space
207 (before-line-breaking-callback . ,Beam::before_line_breaking)
208 (after-line-breaking-callback . ,Beam::after_line_breaking)
209 (neutral-direction . -1)
210 (dir-function . ,beam-dir-majority-median)
212 ;; Whe have some unreferenced problems here.
214 ;; If we shorten beamed stems less than normal stems (1 staffspace),
215 ;; or high order less than 8th beams, patterns like
216 ;; c''4 [c''8 c''] c''4 [c''16 c]
217 ;; are ugly (different stem lengths).
219 ;; But if we shorten 16th beams as much as 8th beams, a single
220 ;; forced 16th beam looks *very* short.
222 ;; We choose to shorten 8th beams the same as single stems,
223 ;; and high order beams less than 8th beams, so that all
224 ;; isolated shortened beams look nice and a bit shortened,
225 ;; sadly possibly breaking patterns with high order beams.
226 (beamed-stem-shorten . (1.0 0.5 0.25))
228 (flag-width-function . ,beam-flag-width-function)
230 (auto-knee-gap . 5.5)
232 ;; only for debugging.
233 (font-family . roman)
235 (space-function . ,Beam::space_function)
236 (meta . ((class . Spanner)
237 (interfaces . (staff-symbol-referencer-interface beam-interface))))
244 (break-align-orders . #(; end-of-line:
246 left-edge ambitus breathing-sign
247 clef staff-bar key-cancellation key-signature
248 time-signature custos)
251 (instrument-name left-edge ambitus breathing-sign
252 clef staff-bar key-cancellation key-signature
254 time-signature custos)
256 (instrument-name left-edge ambitus breathing-sign
257 clef key-cancellation key-signature staff-bar
258 time-signature custos)
262 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
263 (meta . ((class . Item)
264 (interfaces . (break-alignment-interface axis-group-interface)))))
270 (X-offset-callbacks . (,Break_align_interface::alignment_callback))
271 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
272 (meta . ((class . Item)
273 (interfaces . (break-aligned-interface axis-group-interface ))))
278 (break-align-symbol . breathing-sign)
281 (ambitus . (extra-space . 2.0))
282 (custos . (minimum-space . 1.0))
283 (key-signature . (minimum-space . 1.5))
284 (staff-bar . (minimum-space . 1.5))
285 (clef . (minimum-space . 2.0))
286 (first-note . (fixed-space . 1.0)) ;huh?
287 (right-edge . (extra-space . 0.1))
289 (print-function . ,Text_interface::print)
290 (text . ,(make-musicglyph-markup "scripts.rcomma"))
291 (Y-offset-callbacks . (,Breathing_sign::offset_callback))
292 (break-visibility . ,begin-of-line-invisible)
293 (meta . ((class . Item)
294 (interfaces . (break-aligned-interface
295 breathing-sign-interface text-interface font-interface ))))
300 (print-function . ,Clef::print)
301 (before-line-breaking-callback . ,Clef::before_line_breaking)
303 (font-family . music)
304 (break-align-symbol . clef)
305 (break-visibility . ,begin-of-line-visible)
306 (space-alist . ((ambitus . (extra-space . 2.0))
307 (staff-bar . (extra-space . 0.7))
308 (key-cancellation . (minimum-space . 4.0))
309 (key-signature . (minimum-space . 4.0))
310 (time-signature . (minimum-space . 4.2))
311 (first-note . (minimum-fixed-space . 5.0))
312 (next-note . (extra-space . 0.5))
313 (right-edge . (extra-space . 0.5))
315 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
316 (meta . ((class . Item)
317 (interfaces . (clef-interface
318 staff-symbol-referencer-interface font-interface
319 break-aligned-interface ))))
322 (ClusterSpannerBeacon
324 (print-function . #f)
325 (Y-extent-callback . ,Cluster_beacon::height)
326 (meta . ((class . Item)
327 (interfaces . (cluster-beacon-interface))))
332 (print-function . ,Cluster::print)
333 (spacing-procedure . ,Spanner::set_spacing_rods)
334 (minimum-length . 0.0)
337 (meta . ((class . Spanner)
338 (interfaces . (cluster-interface))))
344 (print-function . ,Text_interface::print)
345 (after-line-breaking-callback . ,Chord_name::after_line_breaking)
349 (meta . ((class . Item)
350 (interfaces . (font-interface
351 rhythmic-grob-interface text-interface chord-name-interface
357 (print-function . ,Text_interface::print)
358 (no-spacing-rods . #t)
359 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
360 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
363 (staff-padding . 0.5)
364 (script-priority . 200)
365 ;; todo: add X self alignment?
368 (meta . ((class . Item)
369 (interfaces . (text-script-interface
370 text-interface side-position-interface
376 (break-align-symbol . custos)
378 (print-function . ,Custos::print)
379 (break-visibility . ,end-of-line-visible)
381 (neutral-direction . -1)
382 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
384 (first-note . (minimum-fixed-space . 0.0))
385 (right-edge . (extra-space . 0.1))
387 (meta . ((class . Item)
389 . (custos-interface staff-symbol-referencer-interface
391 break-aligned-interface ))))
398 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
399 (X-offset-callbacks . (,Dot_column::side_position))
400 (meta . ((class . Item)
401 (interfaces . (dot-column-interface axis-group-interface ))))
406 (print-function . ,Dots::print)
408 (meta . ((class . Item)
409 (interfaces . (font-interface
410 staff-symbol-referencer-interface dots-interface ))))
415 (print-function . ,Percent_repeat_item_interface::double_percent)
418 (font-encoding . fetaMusic)
421 (break-align-symbol . staff-bar)
422 (break-visibility . ,begin-of-line-invisible)
423 (meta . ((class . Item)
424 (interfaces . (font-interface
425 break-aligned-interface
426 percent-repeat-interface ))))
431 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
432 (print-function . ,Text_interface::print)
433 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
434 (self-alignment-X . 0)
435 (no-spacing-rods . #t)
436 (script-priority . 100)
438 (font-encoding . fetaDynamic)
439 (font-shape . italic)
440 (self-alignment-Y . 0)
441 (meta . ((class . Item)
442 (interfaces . (font-interface text-interface self-alignment-interface
443 dynamic-interface script-interface))))
447 . ((print-function . ,Dynamic_text_spanner::print)
449 ;; rather ugh with NCSB
450 ; (font-series . bold)
451 (font-shape . italic)
452 (style . dashed-line)
454 ; need to blend with dynamic texts.
456 (bound-padding . 0.75)
457 (dash-fraction . 0.2)
459 (meta . ((class . Spanner)
460 (interfaces . (font-interface
462 dynamic-interface dynamic-text-spanner-interface
463 spanner-interface))))
469 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
470 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
471 (staff-padding . 0.1)
473 (minimum-space . 1.2)
476 (meta . ((class . Spanner)
477 (interfaces . (dynamic-interface axis-group-interface
478 side-position-interface))))))
482 (print-function . ,Text_interface::print)
484 ; sync with TextScript (?)
486 (staff-padding . 0.5)
487 (self-alignment-X . 0)
488 (self-alignment-Y . 0)
489 (script-priority . 100)
490 (font-encoding . fetaNumber)
491 (font-size . -5) ; don't overlap when next to heads.
492 (meta . ((class . Item)
493 (interfaces . (finger-interface
494 font-interface text-script-interface text-interface
495 side-position-interface self-alignment-interface
502 (zigzag-width . 0.75)
504 (X-extent-callback . #f)
505 (Y-extent-callback . #f)
506 (after-line-breaking-callback . ,Line_spanner::after_line_breaking)
507 (print-function . ,Line_spanner::print)
508 (meta . ((class . Spanner)
509 (interfaces . (line-interface line-spanner-interface))))
516 (meta . ((class . Item)
517 (interfaces . (grid-point-interface))))
522 (print-function . ,Grid_line_interface::print)
523 (X-extent-callback . ,Grid_line_interface::width_callback)
524 (self-alignment-X . ,CENTER)
525 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
526 ,Self_alignment_interface::centered_on_parent))
528 (meta . ((class . Spanner)
529 (interfaces . (self-alignment-interface grid-line-interface)))
534 (print-function . ,Hairpin::print)
535 (after-line-breaking-callback . ,Hairpin::after_line_breaking)
538 (spacing-procedure . ,Spanner::set_spacing_rods)
539 (minimum-length . 2.0)
540 (bound-padding . 1.0)
541 (self-alignment-Y . 0)
542 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
543 (meta . ((class . Spanner)
544 (interfaces . (hairpin-interface
545 line-interface self-alignment-interface dynamic-interface
546 spanner-interface))))
552 (print-function . ,Horizontal_bracket::print)
553 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
555 (staff-padding . 0.2)
557 (bracket-flare . (0.5 . 0.5))
558 (meta . ((class . Spanner)
559 (interfaces . (horizontal-bracket-interface
560 side-position-interface
562 spanner-interface))))
567 (Y-offset-callbacks . (,Self_alignment_interface::aligned_on_self
568 ,Side_position_interface::aligned_on_support_refpoints))
569 ;; This direction is for aligned_on_support_refpoints
573 (left-edge . (extra-space . 1.0))
576 (self-alignment-Y . 0)
577 (print-function . ,Text_interface::print)
578 (break-align-symbol . instrument-name)
579 (break-visibility . ,begin-of-line-visible)
581 (meta . ((class . Item)
582 (interfaces . (font-interface
583 self-alignment-interface side-position-interface text-interface
584 break-aligned-interface ))))
589 (print-function . ,Key_signature_interface::print)
591 (time-signature . (extra-space . 1.25))
592 (staff-bar . (extra-space . 0.6))
593 (key-signature . (extra-space . 0.5))
594 (right-edge . (extra-space . 0.5))
595 (first-note . (fixed-space . 2.5))
597 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
598 (break-align-symbol . key-cancellation)
599 (break-visibility . ,begin-of-line-invisible)
602 (meta . ((class . Item)
603 (interfaces . (key-signature-interface font-interface
604 break-aligned-interface ))))
608 (print-function . ,Key_signature_interface::print)
610 (time-signature . (extra-space . 1.25))
611 (staff-bar . (extra-space . 1.1))
612 (right-edge . (extra-space . 0.5))
613 (first-note . (fixed-space . 2.5))
615 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
616 (break-align-symbol . key-signature)
617 (break-visibility . ,begin-of-line-visible)
620 (meta . ((class . Item)
621 (interfaces . (key-signature-interface font-interface
622 break-aligned-interface ))))
626 (print-function . ,Ledger_line_spanner::print)
627 (X-extent-callback . #f)
628 (Y-extent-callback . #f)
629 (minimum-length-fraction . 0.25)
630 (length-fraction . 0.25)
631 (spacing-procedure . ,Ledger_line_spanner::set_spacing_rods)
632 (print-function . ,Ledger_line_spanner::print)
634 (meta . ((class . Spanner)
635 (interfaces . (ledger-line-interface))))
640 (break-align-symbol . left-edge)
643 (break-visibility . ,center-invisible)
645 (custos . (extra-space . 0.0))
646 (ambitus . (extra-space . 2.0))
647 (time-signature . (extra-space . 0.0))
648 (staff-bar . (extra-space . 0.0))
649 (breathing-sign . (minimum-space . 0.0))
650 (clef . (extra-space . 0.8))
651 (first-note . (fixed-space . 1.0))
652 (right-edge . (extra-space . 0.0))
653 (key-signature . (extra-space . 0.0))
654 (key-cancellation . (extra-space . 0.0))
657 (meta . ((class . Item)
658 (interfaces . (break-aligned-interface ))))
663 (ligature-primitive-callback . ,Note_head::print)
668 (edge-height . (0.7 . 0.7))
669 (shorten-pair . (-0.2 . -0.2))
670 (before-line-breaking-callback . ,Tuplet_bracket::before_line_breaking)
671 (after-line-breaking-callback . ,Tuplet_bracket::after_line_breaking)
672 (print-function . ,Tuplet_bracket::print)
673 (meta . ((class . Spanner)
674 (interfaces . (tuplet-bracket-interface line-interface))))
683 (minimum-length . 0.3)
685 ; (spacing-procedure . ,Hyphen_spanner::set_spacing_rods)
686 (print-function . ,Hyphen_spanner::print)
688 (meta . ((class . Spanner)
689 (interfaces . (lyric-interface lyric-hyphen-interface
690 spanner-interface))))
695 (print-function . ,Lyric_extender::print)
696 (thickness . 0.8) ; linethickness
697 (minimum-length . 1.5)
699 (meta . ((class . Spanner)
700 (interfaces . (lyric-interface
701 lyric-extender-interface))))
705 . ((print-function . ,Text_interface::print)
706 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_parent))
707 (self-alignment-X . 0)
709 (font-series . bold-narrow)
711 (meta . ((class . Item)
712 (interfaces . (rhythmic-grob-interface
713 lyric-syllable-interface
714 self-alignment-interface text-interface
722 (ligature-primitive-callback . ,Mensural_ligature::brew_ligature_primitive)
723 (print-function . ,Mensural_ligature::print)
724 (meta . ((class . Spanner)
725 (interfaces . (mensural-ligature-interface font-interface))))
730 (print-function . ,Text_interface::print)
731 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
734 (meta . ((class . Item)
735 (interfaces . (text-interface
736 side-position-interface font-interface
737 metronome-mark-interface))))
741 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
742 (print-function . ,Measure_grouping::print)
748 (meta . ((class . Spanner)
749 (interfaces . (side-position-interface
750 measure-grouping-interface))))
754 (spacing-procedure . ,Multi_measure_rest::set_spacing_rods)
755 (print-function . ,Multi_measure_rest::print)
756 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
759 (thick-thickness . 6.6)
760 (hair-thickness . 2.0)
762 (meta . ((class . Spanner)
763 (interfaces . (multi-measure-rest-interface
764 multi-measure-interface rest-interface
765 font-interface staff-symbol-referencer-interface))))
768 (MultiMeasureRestNumber
770 (print-function . ,Text_interface::print)
771 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
772 ,Self_alignment_interface::centered_on_other_axis_parent))
773 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
774 (self-alignment-X . 0)
777 (staff-padding . 0.4)
778 (font-encoding . fetaNumber)
779 (meta . ((class . Spanner)
780 (interfaces . (side-position-interface
781 multi-measure-interface self-alignment-interface
782 font-interface text-interface))))
784 (MultiMeasureRestText
786 (print-function . ,Text_interface::print)
787 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self
788 ,Self_alignment_interface::centered_on_other_axis_parent))
789 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
790 (self-alignment-X . 0)
793 (staff-padding . 0.25)
794 (meta . ((class . Spanner)
795 (interfaces . (side-position-interface
796 multi-measure-interface self-alignment-interface font-interface
803 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
804 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
805 (meta . ((class . Item)
806 (interfaces . (note-collision-interface axis-group-interface ))))
812 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
813 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
814 (meta . ((class . Item)
815 (interfaces . (axis-group-interface note-column-interface ))))
820 (print-function . ,Note_head::print)
821 (ligature-primitive-callback . ,Note_head::print)
822 (glyph-name-procedure . ,find-notehead-symbol)
823 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
824 (stem-attachment-function . ,note-head-style->attachment-coordinates)
825 (meta . ((class . Item)
826 (interfaces . (rhythmic-grob-interface
827 rhythmic-head-interface font-interface note-head-interface
829 staff-symbol-referencer-interface ))))
834 (stem-spacing-correction . 0.5)
835 (same-direction-correction . 0.25)
836 ;; Changed this from 0.75.
837 ;; If you ever change this back, please document! --hwn
838 (knee-spacing-correction . 1.0)
840 (meta . ((class . Item)
841 (interfaces . (spacing-interface note-spacing-interface ))))
847 (print-function . ,Text_interface::print)
848 (meta . ((class . Item)
849 (interfaces . (note-name-interface
850 text-interface font-interface ))))
855 (self-alignment-X . 0)
856 (break-visibility . ,begin-of-line-visible)
857 (X-offset-callbacks . (,Self_alignment_interface::centered_on_parent ,Self_alignment_interface::aligned_on_self))
858 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
859 (print-function . ,Text_interface::print)
861 ;; no Y dimensions, because of lyrics under tenor clef.
863 (font-shape . italic)
865 (staff-padding . 0.2)
867 (meta . ((class . Item)
868 (interfaces . (text-interface self-alignment-interface side-position-interface font-interface ))))
873 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
874 (print-function . ,Ottava_bracket::print)
875 (font-shape . italic)
876 (shorten-pair . (0.0 . -0.6))
877 (staff-padding . 1.0)
879 (minimum-length . 1.0)
880 (dash-fraction . 0.3)
881 (edge-height . (0 . 1.2))
883 (meta . ((class . Spanner)
884 (interfaces . (ottava-bracket-interface
885 line-interface side-position-interface
886 font-interface text-interface))))
892 (before-line-breaking-callback . ,Paper_column::before_line_breaking)
893 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
896 ;; (print-function . ,Paper_column::print) (font-size . -6) (font-name . "sans") (Y-extent-callback . #f)
897 (meta . ((class . Paper_column)
898 (interfaces . (paper-column-interface axis-group-interface spaceable-grob-interface ))))
902 . ((slur-details . ,default-slur-details)
903 (print-function . ,Slur::print)
905 (spacing-procedure . ,Spanner::set_spacing_rods)
906 (minimum-length . 1.5)
907 (after-line-breaking-callback . ,Slur::after_line_breaking)
908 (Y-extent-callback . ,Slur::height)
911 (meta . ((class . Spanner)
912 (interfaces . (slur-interface))))
915 (NonMusicalPaperColumn
918 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
919 (before-line-breaking-callback . ,Paper_column::before_line_breaking)
922 ;; debugging stuff: print column number.
923 ;; (print-function . ,Paper_column::print) (font-size . -6) (font-name . "sans") (Y-extent-callback . #f)
926 (meta . ((class . Paper_column)
927 (interfaces . (paper-column-interface axis-group-interface spaceable-grob-interface ))))
932 (spacing-procedure . ,Multi_measure_rest::set_spacing_rods)
933 (print-function . ,Multi_measure_rest::percent)
936 (font-encoding . fetaMusic)
937 (meta . ((class . Spanner)
938 (interfaces . (multi-measure-rest-interface
939 font-interface percent-repeat-interface))))
942 ;; an example of a text spanner
945 (print-function . ,Piano_pedal_bracket::print)
947 (bound-padding . 1.0)
949 (bracket-flare . (0.5 . 0.5))
950 (edge-height . (1.0 . 1.0))
951 (shorten-pair . (0.0 . 0.0))
953 (meta . ((class . Spanner)
954 (interfaces . (line-interface
955 piano-pedal-interface piano-pedal-bracket-interface))))
960 (print-function . ,Text_interface::print)
961 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
962 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
963 (after-line-breaking-callback . ,shift-right-at-line-begin)
964 (self-alignment-X . 0)
969 (break-visibility . ,end-of-line-invisible)
971 (meta . ((class . Item)
972 (interfaces . (text-interface
973 side-position-interface font-interface mark-interface
974 self-alignment-interface ))))
978 (RemoveEmptyVerticalGroup
980 (Y-offset-callbacks . (,Hara_kiri_group_spanner::force_hara_kiri_callback))
981 (Y-extent-callback . ,Hara_kiri_group_spanner::y_extent)
983 (meta . ((class . Spanner)
984 (interfaces . (axis-group-interface
985 vertically-spaceable-interface hara-kiri-group-interface
986 spanner-interface))))
991 (print-function . ,Percent_repeat_item_interface::beat_slash)
994 (meta . ((class . Item)
995 (interfaces . (percent-repeat-interface ))))
999 (after-line-breaking-callback . ,Rest::after_line_breaking)
1000 (X-extent-callback . ,Rest::extent_callback)
1001 (Y-extent-callback . ,Rest::extent_callback)
1002 (print-function . ,Rest::print)
1003 (Y-offset-callbacks . (,Staff_symbol_referencer::callback
1004 ,Rest::polyphonic_offset_callback
1006 (minimum-distance . 0.25)
1007 (meta . ((class . Item)
1008 (interfaces . (font-interface
1009 rhythmic-head-interface
1010 rhythmic-grob-interface
1011 staff-symbol-referencer-interface
1017 (minimum-distance . 0.75)
1018 (meta . ((class . Item)
1019 (interfaces . (rest-collision-interface ))))
1024 ;; don't set direction here: it breaks staccato.
1025 (print-function . ,Script_interface::print)
1027 ;; This value is sensitive: if too large, staccato dots will move a
1030 (staff-padding . 0.25)
1031 ;; (script-priority . 0) priorities for scripts, see script.scm
1032 (X-offset-callbacks . (,Self_alignment_interface::centered_on_parent))
1033 (before-line-breaking-callback . ,Script_interface::before_line_breaking)
1034 (font-encoding . fetaMusic)
1035 (meta . ((class . Item)
1036 (interfaces . (script-interface
1037 side-position-interface font-interface ))))
1042 (before-line-breaking-callback . ,Script_column::before_line_breaking)
1043 (meta . ((class . Item)
1044 (interfaces . (script-column-interface ))))
1050 (X-extent-callback . #f)
1051 (Y-extent-callback . #f)
1052 (meta . ((class . Item)
1053 (interfaces . (spacing-interface separation-item-interface ))))
1056 (SeparatingGroupSpanner
1058 (spacing-procedure . ,Separating_group_spanner::set_spacing_rods)
1059 (meta . ((class . Spanner)
1060 (interfaces . (only-prebreak-interface spacing-interface separation-spanner-interface))))
1064 . ((slur-details . ,default-slur-details)
1065 (print-function . ,Slur::print)
1067 (spacing-procedure . ,Spanner::set_spacing_rods)
1068 (minimum-length . 1.5)
1069 (after-line-breaking-callback . ,Slur::after_line_breaking)
1070 (Y-extent-callback . ,Slur::height)
1072 (height-limit . 2.0)
1074 (meta . ((class . Spanner)
1075 (interfaces . (slur-interface))))
1080 (spacing-procedure . ,Spacing_spanner::set_springs)
1081 (grace-space-factor . 0.6)
1082 (shortest-duration-space . 2.0)
1083 (spacing-increment . 1.2)
1084 (base-shortest-duration . ,(ly:make-moment 3 16))
1085 (meta . ((class . Spanner)
1086 (interfaces . (spacing-interface spacing-spanner-interface))))
1091 (break-align-symbol . staff-bar)
1092 (bar-size-procedure . ,Span_bar::get_bar_size)
1093 (print-function . ,Span_bar::print)
1094 (X-extent-callback . ,Span_bar::width_callback)
1095 (Y-extent-callback . ())
1098 (before-line-breaking-callback . ,Span_bar::before_line_breaking)
1102 ;; Ross. page 151 lists other values, we opt for a leaner look
1106 (hair-thickness . 1.6)
1107 (thick-thickness . 6.0)
1108 (meta . ((class . Item)
1109 (interfaces . (span-bar-interface font-interface
1110 bar-line-interface ))))
1114 . ((print-function . ,Text_interface::print)
1115 (font-series . bold)
1117 (X-offset-callbacks . (,Side_position_interface::aligned_side))
1119 (meta . ((class . Item)
1120 (interfaces . (side-position-interface
1121 stanza-number-interface text-interface font-interface ))))
1126 (print-function . ,print-circled-text-callback)
1128 (staff-padding . 0.5)
1129 (self-alignment-X . 0)
1130 (self-alignment-Y . 0)
1131 (script-priority . 100)
1132 (font-encoding . fetaNumber)
1133 (font-size . -5) ; don't overlap when next to heads.
1134 (meta . ((class . Item)
1135 (interfaces . (string-number-interface
1136 font-interface text-script-interface text-interface
1137 side-position-interface self-alignment-interface
1144 (stem-spacing-correction . 0.4)
1146 (meta . ((class . Item)
1147 (interfaces . (spacing-interface staff-spacing-interface ))))
1152 (print-function . ,Text_interface::print)
1154 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1155 (no-spacing-rods . #t)
1156 (padding . 0.0) ;; padding relative to SostenutoPedalLineSpanner
1157 (font-shape . italic)
1158 (self-alignment-X . 0)
1159 (meta . ((class . Item)
1160 (interfaces . (text-interface
1161 self-alignment-interface font-interface))))
1164 (SostenutoPedalLineSpanner
1167 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1168 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1172 (minimum-space . 1.0)
1174 (meta . ((class . Spanner)
1175 (interfaces . (piano-pedal-interface
1176 axis-group-interface side-position-interface))))
1181 (print-function . ,Staff_symbol::print)
1183 (ledger-line-thickness . (1.0 . 0.1))
1185 (meta . ((class . Spanner)
1186 (interfaces . (staff-symbol-interface))))
1191 ;; this list is rather long. Trim --hwn
1192 (before-line-breaking-callback . ,Stem::before_line_breaking)
1193 (print-function . ,Stem::print)
1196 ;; 3.5 (or 3 measured from note head) is standard length
1197 ;; 32nd, 64th flagged stems should be longer
1198 (lengths . (3.5 3.5 3.5 4.5 5.0))
1200 ;; Stems in unnatural (forced) direction should be shortened by
1201 ;; one staff space, according to [Roush & Gourlay].
1202 ;; Flagged stems we shorten only half a staff space.
1203 (stem-shorten . (1.0 0.5))
1205 ;; default stem direction for note on middle line
1206 (neutral-direction . -1)
1210 ;; FIXME. 3.5 yields too long beams (according to Ross and
1211 ;; looking at Baerenreiter examples) for a number of common
1212 ;; boundary cases. Subtracting half a beam thickness fixes
1213 ;; this, but the bug may well be somewhere else.
1215 ;; FIXME this should come from 'lengths
1217 (beamed-lengths . (3.26 3.5 3.6))
1219 ;; We use the normal minima as minimum for the ideal lengths,
1220 ;; and the extreme minima as abolute minimum length.
1222 ;; The 'normal' minima
1223 (beamed-minimum-free-lengths . (1.83 1.5 1.25))
1224 ;(beamed-minimum-free-lengths . (2.0 1.83 1.25))
1226 ;; The 'extreme case' minima
1227 (beamed-extreme-minimum-free-lengths . (2.0 1.25))
1229 (X-offset-callbacks . (,Stem::offset_callback))
1230 (X-extent-callback . ,Stem::width_callback)
1231 (Y-extent-callback . ,Stem::height)
1232 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
1233 (meta . ((class . Item)
1234 (interfaces . (stem-interface font-interface ))))
1239 (print-function . ,Stem_tremolo::print)
1240 (Y-extent-callback . ,Stem_tremolo::height)
1241 (X-extent-callback . #f)
1243 (beam-width . 1.6) ; staff-space
1244 (beam-thickness . 0.48) ; staff-space
1245 (meta . ((class . Item)
1246 (interfaces . (stem-tremolo-interface ))))
1251 (no-spacing-rods . #t)
1252 (print-function . ,Sustain_pedal::print)
1253 (self-alignment-X . 0)
1255 (padding . 0.0) ;; padding relative to SustainPedalLineSpanner
1256 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1257 (meta . ((class . Item)
1258 (interfaces . (piano-pedal-interface
1259 text-spanner-interface text-interface self-alignment-interface
1263 (SustainPedalLineSpanner
1266 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1267 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1270 (staff-padding . 1.2)
1271 (minimum-space . 1.0)
1273 (meta . ((class . Spanner)
1274 (interfaces . (piano-pedal-interface
1275 axis-group-interface side-position-interface))))
1281 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
1282 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1283 (meta . ((class . System)
1284 (interfaces . (system-interface axis-group-interface))))
1290 (print-function . ,System_start_delimiter::print)
1291 (collapse-height . 5.0)
1292 (font-encoding . fetaBraces)
1293 (Y-extent-callback . #f)
1294 (meta . ((class . Spanner)
1295 (interfaces . (system-start-delimiter-interface font-interface))))
1300 (Y-extent-callback . #f)
1301 (X-offset-callbacks . (,(lambda (g a) -0.8)))
1302 (print-function . ,System_start_delimiter::print)
1304 (collapse-height . 1)
1306 (meta . ((class . Spanner)
1307 (interfaces . (font-interface system-start-delimiter-interface
1313 (Y-extent-callback . #f)
1314 (print-function . ,System_start_delimiter::print)
1315 (glyph . "bar-line")
1317 (after-line-breaking-callback . ,System_start_delimiter::after_line_breaking)
1318 (meta . ((class . Spanner)
1319 (interfaces . (system-start-delimiter-interface))))
1325 (print-function . ,Text_interface::print)
1326 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
1328 (stem-attachment-function . ,tablature-stem-attachment-function)
1329 (font-series . bold)
1330 (meta . ((class . Item)
1332 . (rhythmic-head-interface
1334 note-head-interface staff-symbol-referencer-interface
1341 (print-function . ,Text_interface::print)
1342 (no-spacing-rods . #t)
1343 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1346 ; sync with Fingering ?
1348 (staff-padding . 0.5)
1349 (script-priority . 200)
1350 ;; todo: add X self alignment?
1351 (meta . ((class . Item)
1352 (interfaces . (text-script-interface
1353 text-interface side-position-interface font-interface
1359 (print-function . ,Text_spanner::print)
1360 (font-shape . italic)
1361 (style . dashed-line)
1362 (staff-padding . 0.8)
1363 (dash-fraction . 0.2)
1366 (meta . ((class . Spanner)
1367 (interfaces . (text-spanner-interface
1368 side-position-interface font-interface))))
1374 (print-function . ,Tie::print)
1375 (spacing-procedure . ,Spanner::set_spacing_rods)
1376 (staffline-clearance . 0.35)
1377 (details . ((ratio . 0.333) (height-limit . 1.0)))
1381 (minimum-length . 2.5)
1382 (meta . ((class . Spanner)
1383 (interfaces . (tie-interface))))
1388 (after-line-breaking-callback . ,Tie_column::after_line_breaking)
1389 (before-line-breaking-callback . ,Tie_column::before_line_breaking)
1390 (X-extent-callback . #f)
1391 (Y-extent-callback . #f)
1392 (meta . ((class . Spanner)
1393 (interfaces . (tie-column-interface))))
1398 (print-function . ,Time_signature::print)
1399 (break-align-symbol . time-signature)
1400 (break-visibility . ,all-visible)
1402 (first-note . (fixed-space . 2.0))
1403 (right-edge . (extra-space . 0.5))
1404 (staff-bar . (minimum-space . 2.0))
1408 (meta . ((class . Item)
1409 (interfaces . (time-signature-interface break-aligned-interface font-interface ))))
1415 (print-function . ,Dynamic_text_spanner::print)
1416 (edge-text . ,(cons (make-musicglyph-markup "scripts.trill")
1419 (staff-padding . 1.0)
1422 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1423 (meta . ((class . Spanner)
1424 (interfaces . (text-spanner-interface side-position-interface font-interface))))
1427 (TrillPitchAccidental
1428 . ((X-offset-callbacks . (,Side_position_interface::aligned_side))
1432 (print-function . ,Accidental_interface::print)
1433 (meta . ((class . Item)
1434 (interfaces . (item-interface
1435 accidental-interface
1436 side-position-interface font-interface))))
1440 . ((X-offset-callbacks . (,Side_position_interface::aligned_side))
1443 (print-function . ,parenthesize-elements)
1444 (direction . ,RIGHT)
1446 (meta . ((class . Item)
1447 (interfaces . (side-position-interface
1448 note-head-interface rhythmic-head-interface
1449 font-interface accidental-interface
1450 axis-group-interface))))
1454 . ((print-function . ,Note_head::print)
1456 (Y-offset-callbacks . (,Staff_symbol_referencer::callback))
1458 (meta . ((class . Item)
1459 (interfaces . (item-interface
1460 rhythmic-head-interface
1461 font-interface pitched-trill-interface
1462 ledgered-interface staff-symbol-referencer-interface))))
1469 (edge-height . (0.7 . 0.7))
1470 (shorten-pair . (-0.2 . -0.2))
1471 (before-line-breaking-callback . ,Tuplet_bracket::before_line_breaking)
1472 (after-line-breaking-callback . ,Tuplet_bracket::after_line_breaking)
1473 (print-function . ,Tuplet_bracket::print)
1474 (font-shape . italic)
1477 (meta . ((class . Spanner)
1478 (interfaces . (text-interface line-interface
1479 tuplet-bracket-interface
1485 (print-function . ,Text_interface::print)
1486 (font-shape . italic)
1487 (no-spacing-rods . #t)
1488 (self-alignment-X . 0)
1490 (padding . 0.0) ;; padding relative to UnaCordaPedalLineSpanner
1491 (X-offset-callbacks . (,Self_alignment_interface::aligned_on_self))
1492 (meta . ((class . Item)
1493 (interfaces . (text-interface self-alignment-interface font-interface ))))
1496 (UnaCordaPedalLineSpanner
1499 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1500 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1502 (staff-padding . 1.2)
1503 (minimum-space . 1.0)
1505 (meta . ((class . Spanner)
1506 (interfaces . (piano-pedal-interface axis-group-interface side-position-interface))))
1513 (ligature-primitive-callback . ,Vaticana_ligature::brew_ligature_primitive)
1514 (print-function . ,Vaticana_ligature::print)
1515 (meta . ((class . Spanner)
1516 (interfaces . (vaticana-ligature-interface font-interface))))
1523 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1524 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
1526 (meta . ((class . Spanner)
1527 (interfaces . (align-interface axis-group-interface))))
1533 (Y-extent-callback . ,Axis_group_interface::group_extent_callback)
1534 (X-extent-callback . ,Axis_group_interface::group_extent_callback)
1536 (meta . ((class . Spanner)
1537 (interfaces . (axis-group-interface
1538 vertically-spaceable-interface))))
1544 (Y-offset-callbacks . (,Side_position_interface::aligned_on_support_refpoints))
1546 (space-alist . ((left-edge . (extra-space . 1.0))
1548 (break-align-symbol . instrument-name)
1549 (print-function . ,Text_interface::print)
1550 (break-align-symbol . clef)
1551 (break-visibility . ,begin-of-line-visible)
1553 (meta . ((class . Item)
1554 (interfaces . (font-interface
1555 self-alignment-interface
1556 side-position-interface text-interface
1557 break-aligned-interface))))
1562 (print-function . ,Volta_bracket_interface::print)
1565 (font-encoding . fetaNumber)
1566 (Y-offset-callbacks . (,Side_position_interface::aligned_side))
1567 (thickness . 1.6) ;; linethickness
1568 (height . 2.0) ;; staffspace;
1571 (meta . ((class . Spanner)
1572 (interfaces . (volta-bracket-interface
1573 line-interface text-interface
1574 side-position-interface font-interface))))
1583 (X-extent-callback . #f)
1584 (Y-extent-callback . #f)
1585 (print-function . ,Line_spanner::print)
1586 (after-line-breaking-callback . ,Line_spanner::after_line_breaking)
1587 (meta . ((class . Spanner)
1588 (interfaces . (line-spanner-interface line-interface))))
1592 (define (completize-grob-entry x)
1593 "transplant assoc key into 'name entry of 'meta of X. Set interfaces for Item, Spanner etc.
1595 ;; (display (car x))
1597 (let* ((name-sym (car x))
1598 (grob-entry (cdr x))
1599 (meta-entry (cdr (assoc 'meta grob-entry)))
1600 (class (cdr (assoc 'class meta-entry)))
1602 (cdr (assoc 'interfaces meta-entry)))
1607 (set! ifaces-entry (cons 'item-interface ifaces-entry)))
1608 ((eq? 'Spanner class)
1609 (set! ifaces-entry (cons 'spanner-interface ifaces-entry)))
1610 ((eq? 'Paper_column class)
1611 (set! ifaces-entry (cons 'item-interface
1612 (cons 'paper-column-interface ifaces-entry))))
1613 ((eq? 'System class)
1614 (set! ifaces-entry (cons 'system-interface
1615 (cons 'spanner-interface ifaces-entry))))
1617 (ly:warning "Unknown class ~a" class)))
1620 (set! ifaces-entry (cons 'grob-interface ifaces-entry))
1622 (set! meta-entry (assoc-set! meta-entry 'name name-sym))
1623 (set! meta-entry (assoc-set! meta-entry 'interfaces
1625 (set! grob-entry (assoc-set! grob-entry 'meta meta-entry))
1626 (cons name-sym grob-entry)))
1628 (set! all-grob-descriptions (map completize-grob-entry all-grob-descriptions))
1631 ;; (display (map pair? all-grob-descriptions))
1633 ;; make sure that \property Foo.Bar =\turnOff doesn't complain
1636 ;; (display (car x)) (newline)
1638 (set-object-property! (car x) 'translation-type? list?)
1639 (set-object-property! (car x) 'is-grob? #t))
1640 all-grob-descriptions)
1642 (set! all-grob-descriptions (sort all-grob-descriptions alist<?))