scm/define-grobs.scm

   1 ;;;; define-grobs.scm --
   2 ;;;;
   3 ;;;;  source file of the GNU LilyPond music typesetter
   4 ;;;;
   5 ;;;; (c) 1998--2006 Han-Wen Nienhuys <hanwen@cs.uu.nl>
   6 ;;;;                 Jan Nieuwenhuizen <janneke@gnu.org>
   7
   8 ;;;; distances are given in line-thickness (thicknesses) and
   9 ;;;; staff-space (distances)
  10
  11 ;;;; WARNING: the meta field should be the last one.
  12 ;;;; WARNING: don't use anonymous functions for initialization.
  13
  14 ;; TODO: junk the meta field in favor of something more compact?
  15
  16 ;;; todo:: reorder sensibly.
  17
  18 (define-public all-grob-descriptions
  19   `(
  20     (Accidental
  21      . (
  22         (avoid-slur . inside)
  23         (cautionary-style . parentheses)
  24         (stencil . ,ly:accidental-interface::print)
  25         (after-line-breaking
  26          . ,ly:accidental-interface::after-line-breaking)
  27         (meta . ((class . Item)
  28                  (interfaces . (accidental-interface
  29                                 font-interface))))))
  30
  31     (AccidentalSuggestion
  32      . (
  33         (stencil . ,ly:accidental-interface::print)
  34         (X-offset . ,(ly:make-simple-closure
  35                       `(,+
  36                         ,(ly:make-simple-closure (list ly:self-alignment-interface::centered-on-x-parent))
  37                         ,(ly:make-simple-closure (list ly:self-alignment-interface::x-aligned-on-self)))))
  38         (self-alignment-X . ,CENTER)
  39         (cautionary . #t)
  40         (cautionary-style . smaller)
  41         (Y-offset . ,ly:side-position-interface::y-aligned-side)
  42         (cautionary-style . parentheses)
  43         (direction . ,UP)
  44         (staff-padding . 0.25)
  45         (script-priority . 0)
  46         (side-axis . ,X)
  47         (meta . ((class . Item)
  48                  (interfaces . (side-position-interface
  49                                 script-interface
  50                                 accidental-interface
  51                                 accidental-suggestion-interface
  52                                 self-alignment-interface
  53                                 font-interface))))))
  54     (AccidentalPlacement
  55      . (
  56         (left-padding . 0.2)
  57
  58         (positioning-done . ,ly:accidental-placement::calc-positioning-done)
  59         (X-extent . ,ly:axis-group-interface::width)
  60
  61         ;; this is quite small, but it is very ugly to have
  62         ;; accs closer to the previous note than to the next one.
  63         (right-padding . 0.15)
  64         (meta . ((class . Item)
  65                  (interfaces . (accidental-placement-interface))))))
  66     (Ambitus
  67      . (
  68         (axes . (0 1))
  69         (X-extent . ,ly:axis-group-interface::width)
  70         (Y-extent . ,ly:axis-group-interface::height)
  71         (space-alist . (
  72                         (clef . (extra-space . 0.5))
  73                         (key-signature . (extra-space . 0.0))
  74                         (staff-bar . (extra-space . 0.0))
  75                         (time-signature . (extra-space . 0.0))
  76                         (first-note . (fixed-space . 0.0))))
  77         (non-musical . #t)
  78         (break-align-symbol . ambitus)
  79         (break-visibility . ,begin-of-line-visible)
  80         (meta . ((class . Item)
  81                  (interfaces . (axis-group-interface
  82                                 break-aligned-interface
  83                                 ambitus-interface))))))
  84
  85     (AmbitusLine
  86      . (
  87         (stencil . ,ly:ambitus::print)
  88         (join-heads . #t)
  89         (thickness . 2)
  90         (X-offset . ,ly:self-alignment-interface::centered-on-x-parent)
  91         (meta . ((class . Item)
  92                  (interfaces . (ambitus-interface
  93                                 staff-symbol-referencer-interface
  94                                 font-interface))))))
  95     (AmbitusAccidental
  96      . (
  97         (font-family . music)
  98         (padding . 0.5)
  99         (X-offset . ,ly:side-position-interface::x-aligned-side)
 100         (direction . ,LEFT)
 101         (cautionary-style . parentheses)
 102         (stencil . ,ly:accidental-interface::print)
 103         (after-line-breaking . ,ly:accidental-interface::after-line-breaking)
 104         (side-axis . ,X)
 105         (meta . ((class . Item)
 106                  (interfaces . (item-interface
 107                                 accidental-interface
 108                                 break-aligned-interface
 109                                 side-position-interface
 110                                 font-interface))))))
 111
 112     (AmbitusNoteHead
 113      . (
 114         (duration-log . 2)
 115         (stencil . ,ly:note-head::print)
 116         (glyph-name . ,note-head::calc-glyph-name)
 117         (Y-offset . ,ly:staff-symbol-referencer::callback)
 118         (meta . ((class . Item)
 119                  (interfaces . (font-interface
 120                                 note-head-interface
 121                                 ambitus-interface
 122                                 staff-symbol-referencer-interface
 123                                 rhythmic-head-interface
 124                                 ledgered-interface))))))
 125
 126     (Arpeggio
 127      . ((X-extent . ,ly:arpeggio::width)
 128         (stencil . ,ly:arpeggio::print)
 129         (Y-offset . ,ly:staff-symbol-referencer::callback)
 130         (X-offset . ,ly:side-position-interface::x-aligned-side)
 131         (direction . ,LEFT)
 132         (padding . 0.5)
 133         (side-axis . ,X)
 134         (staff-position . 0.0)
 135         (meta . ((class . Item)
 136                  (interfaces . (arpeggio-interface
 137                                 staff-symbol-referencer-interface
 138                                 side-position-interface
 139                                 font-interface))))))
 140
 141     (BarLine
 142      . (
 143         (break-align-symbol . staff-bar)
 144         (glyph . "|")
 145         (layer . 0)
 146         (break-visibility . ,all-visible)
 147         (non-musical . #t)
 148
 149         (stencil . ,ly:bar-line::print)
 150         (glyph-name . ,bar-line::calc-glyph-name)
 151         (bar-size .  ,ly:bar-line::calc-bar-size)
 152
 153         (space-alist . (
 154                         (time-signature . (extra-space . 0.75))
 155                         (custos . (minimum-space . 2.0))
 156                         (clef . (minimum-space . 1.0))
 157                         (key-signature . (extra-space . 1.0))
 158                         (key-cancellation . (extra-space . 1.0))
 159                         (first-note . (fixed-space . 1.3))
 160                         (next-note . (semi-fixed-space . 1.3))
 161                         (right-edge . (extra-space . 0.0))))
 162
 163         ;;
 164         ;; Ross. page 151 lists other values, we opt for a leaner look
 165         ;;
 166         ;; TODO:
 167         ;; kern should scale with line-thickness too.
 168         (kern . 3.0)
 169         (thin-kern . 3.0)
 170         (hair-thickness . 1.9)
 171         (thick-thickness . 6.0)
 172         (meta . ((class . Item)
 173                  (interfaces . (bar-line-interface
 174                                 break-aligned-interface
 175                                 font-interface))))))
 176
 177     (BarNumber
 178      . (
 179         (stencil . ,ly:text-interface::print)
 180         (non-musical . #t)
 181         (break-visibility . ,begin-of-line-visible)
 182         (padding . 1.0)
 183         (direction . ,UP)
 184         (font-family . roman)
 185         (font-size . -2)
 186         (Y-offset . ,ly:side-position-interface::y-aligned-side)
 187         (side-axis . ,Y)
 188         (X-offset . ,(ly:make-simple-closure
 189                       `(,+
 190                         ,(ly:make-simple-closure
 191                           (list ly:break-alignment-align-interface::self-align-callback))
 192                         ,(ly:make-simple-closure
 193                           (list ly:self-alignment-interface::x-aligned-on-self)))))
 194
 195         (self-alignment-X . 1)
 196         (break-align-symbol . left-edge)
 197         (meta .
 198               ((class . Item)
 199                (interfaces . (side-position-interface
 200                               text-interface
 201                               break-alignment-align-interface
 202                               self-alignment-interface
 203                               font-interface
 204                               ))))
 205         ))
 206
 207     (BassFigure
 208      . (
 209         (stencil . ,ly:text-interface::print)
 210         (meta . ((class . Item)
 211                  (interfaces . (text-interface
 212                                 rhythmic-grob-interface
 213                                 bass-figure-interface
 214                                 font-interface))))))
 215
 216     (BassFigureAlignment
 217      . (
 218         (axes . (,Y))
 219         (threshold . (2 . 1000))
 220         (positioning-done . ,ly:align-interface::calc-positioning-done)
 221         (Y-extent . ,ly:axis-group-interface::height)
 222         (stacking-dir . -1)
 223         (meta . ((class . Spanner)
 224                  (interfaces . (align-interface
 225                                 bass-figure-alignment-interface
 226                                 axis-group-interface))))))
 227
 228     (BassFigureAlignmentPositioning
 229      . ((Y-offset . ,ly:side-position-interface::y-aligned-side)
 230         (side-axis . ,Y)
 231         (direction . ,UP)
 232         (Y-extent . ,ly:axis-group-interface::height)
 233         (axes . (,Y))
 234         (staff-padding . 1.0)
 235         (padding . 0.5)
 236         (meta . ((class . Spanner)
 237                  (interfaces . (side-position-interface
 238                                 axis-group-interface
 239                              ))))))
 240
 241     (BassFigureBracket
 242      . (
 243         (stencil . ,ly:enclosing-bracket::print)
 244         (X-extent . ,ly:enclosing-bracket::width)
 245         (edge-height . (0.2 . 0.2))
 246         (meta . ((class . Item)
 247                  (interfaces . (enclosing-bracket-interface)) ))
 248         ))
 249     (BassFigureContinuation
 250      . (
 251         (stencil . ,ly:figured-bass-continuation::print)
 252         (Y-offset . ,ly:figured-bass-continuation::center-on-figures)
 253         (meta . ((class . Spanner)
 254                  (interfaces . (figured-bass-continuation-interface))
 255                  ))))
 256     (BassFigureLine
 257      . (
 258         (axes . (,Y))
 259         (Y-extent . ,ly:axis-group-interface::height)
 260         (meta . ((class . Spanner)
 261                  (interfaces . (axis-group-interface
 262                                 ))))))
 263
 264
 265     (Beam
 266      . (
 267         ;; todo: clean this up a bit: the list is getting
 268         ;; rather long.
 269         (gap . 0.8)
 270         (positions .  ,(ly:make-simple-closure
 271                         (ly:make-simple-closure
 272                          (list chain-grob-member-functions
 273                            `(,cons 0 0)
 274                            ly:beam::calc-least-squares-positions
 275                            ly:beam::slope-damping
 276                            ly:beam::shift-region-to-valid
 277                            ly:beam::quanting
 278                            ))))
 279
 280         ;; this is a hack to set stem lengths, if positions is set.
 281         (quantized-positions . ,ly:beam::set-stem-lengths)
 282         (concaveness . ,ly:beam::calc-concaveness)
 283         (direction . ,ly:beam::calc-direction)
 284         (shorten . ,ly:beam::calc-stem-shorten)
 285         (beaming . ,ly:beam::calc-beaming)
 286         (stencil . ,ly:beam::print)
 287         (clip-edges . #t)
 288
 289         ;; TODO: should be in SLT.
 290         (thickness . 0.48) ; in staff-space
 291         (neutral-direction . ,DOWN)
 292
 293         ;; Whe have some unreferenced problems here.
 294         ;;
 295         ;; If we shorten beamed stems less than normal stems (1 staff-space),
 296         ;; or high order less than 8th beams, patterns like
 297         ;;     c''4 [c''8 c''] c''4 [c''16 c]
 298         ;; are ugly (different stem lengths).
 299         ;;
 300         ;; But if we shorten 16th beams as much as 8th beams, a single
 301         ;; forced 16th beam looks *very* short.
 302
 303         ;; We choose to shorten 8th beams the same as single stems,
 304         ;; and high order beams less than 8th beams, so that all
 305         ;; isolated shortened beams look nice and a bit shortened,
 306         ;; sadly possibly breaking patterns with high order beams.
 307         (beamed-stem-shorten . (1.0 0.5 0.25))
 308         (damping . 1)
 309         (auto-knee-gap . 5.5)
 310
 311         ;; only for debugging.
 312         (font-family . roman)
 313         (meta . ((class . Spanner)
 314                  (interfaces . (staff-symbol-referencer-interface
 315                                 beam-interface))))))
 316
 317     (BreakAlignment
 318      . (
 319         (non-musical . #t)
 320         (stacking-dir . 1)
 321         (positioning-done . ,ly:break-align-interface::calc-positioning-done)
 322         (X-extent . ,ly:axis-group-interface::width)
 323         (break-align-orders . ;; end of line
 324                             #((
 325                                left-edge
 326                                ambitus
 327                                breathing-sign
 328                                clef
 329                                staff-bar
 330                                key-cancellation
 331                                key-signature
 332                                time-signature
 333                                custos)
 334
 335                               ;; unbroken
 336                               (
 337                                left-edge
 338                                ambitus
 339                                breathing-sign
 340                                clef
 341                                staff-bar
 342                                key-cancellation
 343                                key-signature
 344                                staff
 345                                time-signature custos)
 346
 347                               ;; begin of line
 348                               (
 349                                left-edge
 350                                ambitus
 351                                breathing-sign
 352                                clef
 353                                key-cancellation
 354                                key-signature
 355                                staff-bar
 356                                time-signature
 357                                custos)))
 358         (axes . (0))
 359         (meta . ((class . Item)
 360                  (interfaces . (break-alignment-interface
 361                                 axis-group-interface))))))
 362
 363     (BreakAlignGroup
 364      . (
 365         (axes . (0))
 366         (X-extent . ,ly:axis-group-interface::width)
 367         (meta . ((class . Item)
 368                  (interfaces . (break-aligned-interface
 369                                 axis-group-interface))))))
 370
 371     (BreathingSign
 372      . (
 373         (break-align-symbol . breathing-sign)
 374         (non-musical . #t)
 375         (space-alist . (
 376                         (ambitus . (extra-space . 2.0))
 377                         (custos . (minimum-space . 1.0))
 378                         (key-signature . (minimum-space . 1.5))
 379                         (time-signature . (minimum-space . 1.5))
 380                         (staff-bar . (minimum-space . 1.5))
 381                         (clef . (minimum-space . 2.0))
 382                         (first-note . (fixed-space . 1.0)) ;huh?
 383                         (right-edge . (extra-space . 0.1))))
 384         (stencil . ,ly:text-interface::print)
 385         (text . ,(make-musicglyph-markup "scripts.rcomma"))
 386         (Y-offset . ,ly:breathing-sign::offset-callback)
 387         (break-visibility . ,begin-of-line-invisible)
 388         (meta . ((class . Item)
 389                  (interfaces . (break-aligned-interface
 390                                 breathing-sign-interface
 391                                 text-interface
 392                                 font-interface))))))
 393
 394     (Clef
 395      . (
 396         (stencil . ,ly:clef::print)
 397         (glyph-name . ,ly:clef::calc-glyph-name)
 398         (non-musical . #t)
 399         (font-family . music)
 400         (break-align-symbol . clef)
 401         (break-visibility . ,begin-of-line-visible)
 402         (space-alist . ((ambitus . (extra-space . 2.0))
 403                         (staff-bar . (extra-space . 0.7))
 404                         (key-cancellation . (minimum-space . 3.5))
 405                         (key-signature . (minimum-space . 3.5))
 406                         (time-signature . (minimum-space . 4.2))
 407                         (first-note . (minimum-fixed-space . 5.0))
 408                         (next-note . (extra-space . 0.5))
 409                         (right-edge . (extra-space . 0.5))))
 410         (Y-offset . ,ly:staff-symbol-referencer::callback)
 411         (meta . ((class . Item)
 412                  (interfaces . (clef-interface
 413                                 staff-symbol-referencer-interface
 414                                 font-interface
 415                                 break-aligned-interface))))))
 416
 417     (ClusterSpannerBeacon
 418      . (
 419         (Y-extent . ,ly:cluster-beacon::height)
 420         (meta . ((class . Item)
 421                  (interfaces . (cluster-beacon-interface))))))
 422
 423     (ClusterSpanner
 424      . (
 425         (springs-and-rods . ,ly:spanner::set-spacing-rods)
 426         (stencil . ,ly:cluster::print)
 427         (minimum-length . 0.0)
 428         (padding . 0.25)
 429         (style . ramp)
 430         (meta . ((class . Spanner)
 431                  (interfaces . (cluster-interface))))))
 432
 433     (ChordName
 434      . (
 435         (stencil . ,ly:text-interface::print)
 436         (after-line-breaking . ,ly:chord-name::after-line-breaking)
 437         (word-space . 0.0)
 438         (font-family . sans)
 439         (font-size . 1.5)
 440         (meta . ((class . Item)
 441                  (interfaces . (font-interface
 442                                 rhythmic-grob-interface
 443                                 text-interface
 444                                 chord-name-interface
 445                                 item-interface))))))
 446
 447     (CombineTextScript
 448      . (
 449         (stencil . ,ly:text-interface::print)
 450         (no-spacing-rods . #t)
 451         (Y-offset . ,ly:side-position-interface::y-aligned-side)
 452         (X-offset . ,ly:self-alignment-interface::x-aligned-on-self)
 453         (direction . ,UP)
 454         (padding . 0.5)
 455         (staff-padding . 0.5)
 456         (script-priority . 200)
 457         ;; todo: add X self alignment?
 458         (baseline-skip . 2)
 459         (side-axis . ,Y)
 460         (font-series . bold)
 461         (meta . ((class . Item)
 462                  (interfaces . (text-script-interface
 463                                 text-interface
 464                                 side-position-interface
 465                                 font-interface))))))
 466
 467     (Custos
 468      . (
 469         (break-align-symbol . custos)
 470         (non-musical . #t)
 471         (stencil . ,ly:custos::print)
 472         (break-visibility . ,end-of-line-visible)
 473         (style . vaticana)
 474         (neutral-direction . ,DOWN)
 475         (Y-offset . ,ly:staff-symbol-referencer::callback)
 476         (space-alist . (
 477                         (first-note . (minimum-fixed-space . 0.0))
 478                         (right-edge . (extra-space . 0.1))))
 479         (meta . ((class . Item)
 480                  (interfaces
 481                   . (custos-interface
 482                      staff-symbol-referencer-interface
 483                      font-interface
 484                      break-aligned-interface))))))
 485
 486     (DotColumn
 487      . (
 488         (axes . (0))
 489         (direction . ,RIGHT)
 490         (positioning-done . ,ly:dot-column::calc-positioning-done)
 491         (X-extent . ,ly:axis-group-interface::width)
 492         (X-offset . ,ly:dot-column::side-position)
 493         (meta . ((class . Item)
 494                  (interfaces . (dot-column-interface
 495                                 axis-group-interface))))))
 496
 497     (Dots
 498      . (
 499         (stencil . ,ly:dots::print)
 500         (dot-count . 1)
 501         (meta . ((class . Item)
 502                  (interfaces . (font-interface
 503                                 staff-symbol-referencer-interface
 504                                 dots-interface))))))
 505
 506     (DoublePercentRepeat
 507      . (
 508         (stencil . ,ly:percent-repeat-item-interface::double-percent)
 509         (non-musical . #t)
 510         (slope . 1.0)
 511         (font-encoding . fetaMusic)
 512         (width . 2.0)
 513         (thickness . 0.48)
 514         (break-align-symbol . staff-bar)
 515         (break-visibility . ,begin-of-line-invisible)
 516         (meta . ((class . Item)
 517                  (interfaces . (font-interface
 518                                 break-aligned-interface
 519                                 percent-repeat-interface))))))
 520
 521     (DoublePercentRepeatCounter
 522      . (
 523         (stencil . ,ly:text-interface::print)
 524         (X-offset . ,(ly:make-simple-closure `(,+ ,(ly:make-simple-closure (list ly:self-alignment-interface::centered-on-y-parent))
 525                                                   ,(ly:make-simple-closure (list ly:self-alignment-interface::x-aligned-on-self)))))
 526         (Y-offset . ,ly:side-position-interface::y-aligned-side)
 527         (font-encoding . fetaNumber)
 528         (self-alignment-X . 0)
 529         (font-size . -2)
 530         (direction . ,UP)
 531         (padding . 0.2)
 532         (staff-padding . 0.25)
 533         (side-axis . ,Y)
 534         (meta . ((class . Item)
 535                  (interfaces . (side-position-interface
 536                                 self-alignment-interface
 537                                 percent-repeat-interface
 538                                 font-interface
 539                                 text-interface))))))
 540     (DynamicLineSpanner
 541      . (
 542         (axes . (1))
 543         (Y-offset . ,ly:side-position-interface::y-aligned-side)
 544         (staff-padding . 0.1)
 545         (padding . 0.6)
 546         (avoid-slur . outside)
 547         (slur-padding . 0.3)
 548         (minimum-space . 1.2)
 549         (direction . ,DOWN)
 550         (side-axis . ,Y)
 551         (Y-extent . ,ly:axis-group-interface::height)
 552         (X-extent . ,ly:axis-group-interface::width)
 553         (meta . ((class . Spanner)
 554                  (interfaces . (axis-group-interface
 555                                 dynamic-interface
 556                                 dynamic-line-spanner-interface
 557                                 side-position-interface))))))
 558
 559     (DynamicText
 560      . (
 561
 562         ;; todo.
 563
 564         (stencil . ,ly:text-interface::print)
 565         (direction . ,ly:script-interface::calc-direction)
 566
 567         (X-offset . ,ly:self-alignment-interface::x-aligned-on-self)
 568         (self-alignment-X . 0)
 569         (Y-offset . ,ly:self-alignment-interface::y-aligned-on-self)
 570         (self-alignment-Y . 0)
 571         (font-series . bold)
 572         (font-encoding . fetaDynamic)
 573         (font-shape . italic)
 574         (avoid-slur . around)
 575         (no-spacing-rods . #t)
 576         (script-priority . 100)
 577         (meta . ((class . Item)
 578                  (interfaces . (font-interface
 579                                 text-interface
 580                                 self-alignment-interface
 581                                 dynamic-interface
 582                                 script-interface))))))
 583
 584     (DynamicTextSpanner
 585      . (
 586         (stencil . ,ly:dynamic-text-spanner::print)
 587
 588         ;; rather ugh with NCSB
 589         ;; (font-series . bold)
 590         (font-shape . italic)
 591         (style . dashed-line)
 592
 593         ;; need to blend with dynamic texts.
 594         (font-size . 1)
 595         (bound-padding . 0.75)
 596         (dash-fraction . 0.2)
 597         (dash-period . 3.0)
 598         (meta . ((class . Spanner)
 599                  (interfaces . (font-interface
 600                                 text-interface
 601                                 line-spanner-interface
 602                                 dynamic-interface
 603                                 dynamic-text-spanner-interface
 604                                 spanner-interface))))))
 605
 606     (Fingering
 607      . (
 608
 609         ;; sync with TextScript (?)
 610
 611         (padding . 0.5)
 612         (avoid-slur . around)
 613         (slur-padding . 0.2)
 614         (staff-padding . 0.5)
 615         (self-alignment-X . 0)
 616         (self-alignment-Y . 0)
 617         (script-priority . 100)
 618
 619         (stencil . ,ly:text-interface::print)
 620         (direction . ,ly:script-interface::calc-direction)
 621
 622         (font-encoding . fetaNumber)
 623         (font-size . -5)                ; don't overlap when next to heads.
 624         (meta . ((class . Item)
 625                  (interfaces . (finger-interface
 626                                 font-interface
 627                                 text-script-interface
 628                                 text-interface
 629                                 side-position-interface
 630                                 self-alignment-interface
 631                                 item-interface))))))
 632     (Glissando
 633      . (
 634         (style . line)
 635         (gap . 0.5)
 636         (zigzag-width . 0.75)
 637         (non-musical . #t)
 638         (X-extent . #f)
 639         (Y-extent . #f)
 640         (stencil . ,ly:line-spanner::print)
 641         (after-line-breaking . ,ly:line-spanner::after-line-breaking)
 642         (meta . ((class . Spanner)
 643                  (interfaces . (line-interface
 644                                 line-spanner-interface))))))
 645
 646     (GridPoint
 647      . (
 648         (X-extent . (0 . 0))
 649         (Y-extent . (0 . 0))
 650         (meta . ((class . Item)
 651                  (interfaces . (grid-point-interface))))))
 652
 653     (GridLine
 654      . (
 655         (X-extent  . ,ly:grid-line-interface::width)
 656         (stencil . ,ly:grid-line-interface::print)
 657         (self-alignment-X . ,CENTER)
 658         (X-offset . ,(ly:make-simple-closure
 659                       `(,+  ,(ly:make-simple-closure
 660                               (list ly:self-alignment-interface::centered-on-x-parent))
 661                             ,(ly:make-simple-closure
 662                               (list ly:self-alignment-interface::x-aligned-on-self)))))
 663         (layer . 0)
 664         (meta . ((class . Item)
 665                  (interfaces . (self-alignment-interface
 666                                 grid-line-interface))))))
 667
 668     (Hairpin
 669      . (
 670         (stencil . ,ly:hairpin::print)
 671         (springs-and-rods . ,ly:spanner::set-spacing-rods)
 672         (after-line-breaking . ,ly:hairpin::after-line-breaking)
 673         (circled-tip . #f)
 674         (thickness . 1.0)
 675         (height . 0.6666)
 676         (minimum-length . 2.0)
 677         (bound-padding . 1.0)
 678         (self-alignment-Y . 0)
 679         (Y-offset . ,ly:self-alignment-interface::y-aligned-on-self)
 680         (meta . ((class . Spanner)
 681                  (interfaces . (hairpin-interface
 682                                 line-interface
 683                                 self-alignment-interface
 684                                 dynamic-interface
 685                                 spanner-interface))))))
 686
 687     (HorizontalBracket
 688      . (
 689         (thickness . 1.0)
 690         (stencil . ,ly:horizontal-bracket::print)
 691         (Y-offset . ,ly:side-position-interface::y-aligned-side)
 692         (padding . 0.2)
 693         (staff-padding . 0.2)
 694         (direction . ,DOWN)
 695         (side-axis . ,Y)
 696         (bracket-flare . (0.5 . 0.5))
 697         (meta . ((class . Spanner)
 698                  (interfaces . (horizontal-bracket-interface
 699                                 side-position-interface
 700                                 line-interface
 701                                 spanner-interface))))))
 702     (InstrumentName
 703      . (
 704         (padding . 0.3)
 705         (stencil . ,ly:system-start-text::print)
 706         (X-offset . ,ly:side-position-interface::x-aligned-side)
 707         (direction . ,LEFT)
 708         (self-alignment-Y . ,CENTER)
 709         (meta . ((class . Spanner)
 710                  (interfaces . (system-start-text-interface
 711                                 side-position-interface
 712                                 font-interface))))))
 713
 714     (KeyCancellation
 715      . (
 716         (stencil . ,ly:key-signature-interface::print)
 717         (space-alist . (
 718                         (time-signature . (extra-space . 1.25))
 719                         (staff-bar . (extra-space . 0.6))
 720                         (key-signature . (extra-space . 0.5))
 721                         (right-edge . (extra-space . 0.5))
 722                         (first-note . (fixed-space . 2.5))))
 723         (Y-offset . ,ly:staff-symbol-referencer::callback)
 724         (break-align-symbol . key-cancellation)
 725         (break-visibility . ,begin-of-line-invisible)
 726         (non-musical . #t)
 727         (meta . ((class . Item)
 728                  (interfaces . (key-signature-interface
 729                                 font-interface
 730                                 break-aligned-interface))))))
 731     (KeySignature
 732      . (
 733         (stencil . ,ly:key-signature-interface::print)
 734         (space-alist . (
 735                         (time-signature . (extra-space . 1.15))
 736                         (staff-bar . (extra-space . 1.1))
 737                         (right-edge . (extra-space . 0.5))
 738                         (first-note . (fixed-space . 2.5))))
 739         (Y-offset . ,ly:staff-symbol-referencer::callback)
 740         (break-align-symbol . key-signature)
 741         (break-visibility . ,begin-of-line-visible)
 742         (non-musical . #t)
 743         (meta . ((class . Item)
 744                  (interfaces . (key-signature-interface
 745                                 font-interface
 746                                 break-aligned-interface))))))
 747
 748
 749    (LaissezVibrerTie
 750      . (
 751         (stencil  . ,ly:tie::print)
 752         (control-points . ,ly:semi-tie::calc-control-points)
 753         (direction . ,ly:semi-tie::calc-direction)
 754         (details . ((ratio . 0.333)
 755                     (height-limit . 1.0)))
 756         (thickness . 1.0)
 757         (meta . ((class . Item)
 758                  (interfaces . (semi-tie-interface))
 759                  ))
 760         ))
 761
 762     (LaissezVibrerTieColumn
 763      . (
 764         (X-extent . #f)
 765         (Y-extent . #f)
 766         (head-direction . ,LEFT)
 767         (positioning-done . ,ly:semi-tie-column::calc-positioning-done)
 768         (meta . ((class . Item)
 769                  (interfaces . (semi-tie-column-interface))
 770                  ))
 771         ))
 772
 773     (LedgerLineSpanner
 774      . (
 775         (springs-and-rods . ,ly:ledger-line-spanner::set-spacing-rods)
 776         (stencil . ,ly:ledger-line-spanner::print)
 777         (X-extent . #f)
 778         (Y-extent . #f)
 779         (minimum-length-fraction . 0.25)
 780         (length-fraction . 0.25)
 781         (layer . 0)
 782         (meta . ((class . Spanner)
 783                  (interfaces . (ledger-line-interface))))))
 784
 785     (LeftEdge
 786      . (
 787         (break-align-symbol . left-edge)
 788         (X-extent . (0 . 0))
 789         (non-musical . #t)
 790         (break-visibility . ,center-invisible)
 791         (space-alist . (
 792                         (custos . (extra-space . 0.0))
 793                         (ambitus . (extra-space . 2.0))
 794                         (time-signature . (extra-space . 1.0))
 795                         (staff-bar . (extra-space . 0.0))
 796                         (breathing-sign . (minimum-space . 0.0))
 797                         (clef . (extra-space . 0.8))
 798                         (first-note . (fixed-space . 2.0))
 799                         (right-edge . (extra-space . 0.0))
 800                         (key-signature . (extra-space . 0.0))
 801                         (key-cancellation . (extra-space . 0.0))
 802                         ))
 803         (meta . ((class . Item)
 804                  (interfaces . (break-aligned-interface))))))
 805
 806     (LigatureBracket
 807      . (
 808         ;; ugh.  A ligature bracket is totally different from
 809         ;; a tuplet bracket.
 810
 811         (padding . 2.0)
 812         (thickness . 1.6)
 813         (edge-height . (0.7 . 0.7))
 814         (shorten-pair . (-0.2 . -0.2))
 815         (direction . ,UP)
 816         (positions . ,ly:tuplet-bracket::calc-positions)
 817         (stencil . ,ly:tuplet-bracket::print)
 818         (staff-padding . 0.25)
 819         (connect-to-neighbor . ,ly:tuplet-bracket::calc-connect-to-neighbors)
 820         (control-points . ,ly:tuplet-bracket::calc-control-points)
 821         (meta . ((class . Spanner)
 822                  (interfaces . (line-interface
 823                                 tuplet-bracket-interface))))))
 824
 825
 826     (LyricExtender
 827      . (
 828         (stencil . ,ly:lyric-extender::print)
 829         (thickness . 0.8) ; line-thickness
 830         (minimum-length . 1.5)
 831         (Y-extent . (0 . 0))
 832         (meta . ((class . Spanner)
 833                  (interfaces . (lyric-interface
 834                                 lyric-extender-interface))))))
 835
 836     (LyricHyphen
 837      . (
 838         (thickness . 1.3)
 839         (height . 0.42)
 840         (dash-period . 10.0)
 841         (length . 0.66)
 842         (minimum-length . 0.3)
 843         (minimum-distance . 0.1)
 844         (padding . 0.07)
 845         (springs-and-rods . ,ly:hyphen-spanner::set-spacing-rods)
 846         (stencil . ,ly:hyphen-spanner::print)
 847         (Y-extent . (0 . 0))
 848         (meta . ((class . Spanner)
 849                  (interfaces . (lyric-interface
 850                                 font-interface
 851                                 lyric-hyphen-interface
 852                                 spanner-interface))))))
 853
 854     (LyricSpace
 855      . ((minimum-distance . 0.45)
 856         (springs-and-rods . ,ly:hyphen-spanner::set-spacing-rods)
 857         (padding . 0.0)
 858         (Y-extent . #f)
 859         (X-extent . #f)
 860         (meta . ((class . Spanner)
 861                  (interfaces . (spanner-interface
 862                                 lyric-hyphen-interface spacing-interface))
 863                  ))
 864         ))
 865     (LyricText
 866      . (
 867         (stencil . ,ly:text-interface::print)
 868         (X-offset . ,ly:self-alignment-interface::aligned-on-x-parent)
 869         (self-alignment-X . 0)
 870         (word-space . 0.6)
 871         (font-series . bold-narrow)
 872         (font-size . 1.0)
 873         (meta . ((class . Item)
 874                  (interfaces . (rhythmic-grob-interface
 875                                 lyric-syllable-interface
 876                                 self-alignment-interface
 877                                 text-interface
 878                                 font-interface))))))
 879
 880
 881     (MeasureGrouping
 882      . (
 883         (Y-offset . ,ly:side-position-interface::y-aligned-side)
 884         (side-axis . ,Y)
 885         (stencil . ,ly:measure-grouping::print)
 886         (padding . 2)
 887         (direction . ,UP)
 888         (thickness . 1)
 889         (height . 2.0)
 890         (staff-padding . 3)
 891         (meta . ((class . Spanner)
 892                  (interfaces . (side-position-interface
 893                                 measure-grouping-interface))))))
 894
 895     (MelodyItem
 896      . (
 897         (neutral-direction . ,DOWN)
 898         (meta . ((class . Item)
 899                  (interfaces . (melody-spanner-interface spacing-interface))))))
 900     (MensuralLigature
 901      . (
 902         (thickness . 1.4)
 903         (flexa-width . 2.0)
 904         (stencil . ,ly:mensural-ligature::print)
 905         (meta . ((class . Spanner)
 906                  (interfaces . (mensural-ligature-interface
 907                                 font-interface))))))
 908
 909     (MetronomeMark
 910      . (
 911         (stencil . ,ly:text-interface::print)
 912         (Y-offset . ,ly:side-position-interface::y-aligned-side)
 913         (direction . ,UP)
 914         (padding . 0.8)
 915         (side-axis . ,Y)
 916         (meta . ((class . Item)
 917                  (interfaces . (text-interface
 918                                 side-position-interface
 919                                 font-interface
 920                                 metronome-mark-interface))))))
 921
 922
 923     (MultiMeasureRest
 924      . (
 925         (stencil . ,ly:multi-measure-rest::print)
 926         (springs-and-rods . ,ly:multi-measure-rest::set-spacing-rods)
 927         (Y-offset . ,ly:staff-symbol-referencer::callback)
 928         (staff-position . 0)
 929         (expand-limit . 10)
 930         (thick-thickness . 6.6)
 931         (hair-thickness . 2.0)
 932         (padding . 1)
 933         (meta . ((class . Spanner)
 934                  (interfaces . (multi-measure-rest-interface
 935                                 multi-measure-interface
 936                                 rest-interface
 937                                 font-interface
 938                                 staff-symbol-referencer-interface))))))
 939
 940
 941     (MultiMeasureRestNumber
 942      . (
 943         (bound-padding  . 2.0)
 944         (springs-and-rods . ,ly:multi-measure-rest::set-text-rods)
 945         (stencil . ,ly:text-interface::print)
 946         (X-offset . ,(ly:make-simple-closure
 947                       `(,+ ,(ly:make-simple-closure (list ly:self-alignment-interface::x-aligned-on-self))
 948                            ,(ly:make-simple-closure (list ly:self-alignment-interface::x-centered-on-y-parent)))))
 949         (Y-offset . ,ly:side-position-interface::y-aligned-side)
 950         (side-axis . ,Y)
 951         (self-alignment-X . 0)
 952         (direction . ,UP)
 953         (padding . 0.4)
 954         (staff-padding . 0.4)
 955         (font-encoding . fetaNumber)
 956         (meta . ((class . Spanner)
 957                  (interfaces . (side-position-interface
 958                                 multi-measure-interface
 959                                 self-alignment-interface
 960                                 font-interface
 961                                 text-interface))))
 962               ))
 963
 964     (MultiMeasureRestText
 965      . (
 966         (stencil . ,ly:text-interface::print)
 967         (X-offset . ,(ly:make-simple-closure
 968                       `(,+ ,(ly:make-simple-closure (list ly:self-alignment-interface::x-centered-on-y-parent))
 969                            ,(ly:make-simple-closure (list ly:self-alignment-interface::x-aligned-on-self)))))
 970
 971         (Y-offset . ,ly:side-position-interface::y-aligned-side)
 972         (self-alignment-X . 0)
 973         (direction . ,UP)
 974         (padding . 0.2)
 975         (staff-padding . 0.25)
 976         (meta . ((class . Spanner)
 977                  (interfaces . (side-position-interface
 978                                 multi-measure-interface
 979                                 self-alignment-interface
 980                                 font-interface
 981                                 text-interface))))))
 982
 983     (NoteCollision
 984      . (
 985         (axes . (0 1))
 986         (X-extent . ,ly:axis-group-interface::width)
 987         (Y-extent . ,ly:axis-group-interface::height)
 988         (positioning-done . ,ly:note-collision-interface::calc-positioning-done)
 989         (meta . ((class . Item)
 990                  (interfaces . (note-collision-interface
 991                                 axis-group-interface))))))
 992
 993     (NoteColumn
 994      . (
 995         (axes . (0 1))
 996         (X-extent . ,ly:axis-group-interface::width)
 997         (Y-extent . ,ly:axis-group-interface::height)
 998         (meta . ((class . Item)
 999                  (interfaces . (axis-group-interface
1000                                 note-column-interface))))))
1001
1002     (NoteHead
1003      . (
1004         (stencil . ,ly:note-head::print)
1005         (stem-attachment . ,ly:note-head::calc-stem-attachment)
1006         (glyph-name . ,note-head::calc-glyph-name)
1007         (Y-offset . ,ly:staff-symbol-referencer::callback)
1008         (X-offset . ,ly:note-head::stem-x-shift)
1009         (meta . ((class . Item)
1010                  (interfaces . (rhythmic-grob-interface
1011                                 rhythmic-head-interface
1012                                 font-interface
1013                                 note-head-interface
1014                                 ledgered-interface
1015                                 staff-symbol-referencer-interface))))))
1016
1017     (NoteSpacing
1018      . (
1019         (stem-spacing-correction . 0.5)
1020         (same-direction-correction . 0.25)
1021         ;; Changed this from 0.75.
1022         ;; If you ever change this back, please document! --hwn
1023         (knee-spacing-correction . 1.0)
1024         (meta . ((class . Item)
1025                  (interfaces . (spacing-interface
1026                                 note-spacing-interface))))))
1027
1028     (NoteName
1029      . (
1030         (stencil . ,ly:text-interface::print)
1031         (meta . ((class . Item)
1032                  (interfaces . (note-name-interface
1033                                 text-interface
1034                                 font-interface))))))
1035
1036     (OctavateEight
1037      . (
1038         (self-alignment-X . 0)
1039         (break-visibility . ,begin-of-line-visible)
1040         (X-offset . ,(ly:make-simple-closure
1041                       `(,+ ,(ly:make-simple-closure (list ly:self-alignment-interface::x-aligned-on-self))
1042                            ,(ly:make-simple-closure (list ly:self-alignment-interface::centered-on-x-parent)))))
1043
1044         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1045         (stencil . ,ly:text-interface::print)
1046
1047         ;; no Y dimensions, because of lyrics under tenor clef.
1048         (Y-extent . (0 . 0))
1049         (font-shape . italic)
1050         (padding . 0.6)
1051         (staff-padding . 0.2)
1052         (font-size . -4)
1053         (meta . ((class . Item)
1054                  (interfaces . (text-interface
1055                                 self-alignment-interface
1056                                 side-position-interface
1057                                 font-interface))))))
1058
1059     (OttavaBracket
1060      . (
1061         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1062         (stencil . ,ly:ottava-bracket::print)
1063         (font-shape . italic)
1064         (shorten-pair . (0.0 . -0.6))
1065         (staff-padding . 1.0)
1066         (padding . 0.5)
1067         (minimum-length . 1.0)
1068         (dash-fraction . 0.3)
1069         (edge-height . (0 . 1.2))
1070         (direction . ,UP)
1071         (meta . ((class . Spanner)
1072                  (interfaces . (ottava-bracket-interface
1073                                 horizontal-bracket-interface
1074                                 line-interface
1075                                 side-position-interface
1076                                 font-interface
1077                                 text-interface))))))
1078
1079     (PaperColumn
1080      . (
1081         (axes . (0))
1082         (before-line-breaking . ,ly:paper-column::before-line-breaking)
1083         ;; (stencil . ,ly:paper-column::print)
1084         (X-extent . ,ly:axis-group-interface::width)
1085
1086         ;; debugging
1087         ;;                       (font-size . -6) (font-name . "sans") (Y-extent . #f)
1088         (meta . ((class . Paper_column)
1089                  (interfaces . (paper-column-interface
1090                                 axis-group-interface
1091                                 spaceable-grob-interface))))))
1092
1093     (ParenthesesItem
1094      . ((stencil . ,parentheses-item::print)
1095         (font-size . -6)
1096         (padding . 0.2)
1097         (meta . ((class . Item)
1098                  (interfaces . (parentheses-interface font-interface))))
1099         ))
1100
1101     (PhrasingSlur
1102      . ((details . ,default-slur-details)
1103         (control-points . ,ly:slur::calc-control-points)
1104         (direction . ,ly:slur::calc-direction)
1105         (springs-and-rods . ,ly:spanner::set-spacing-rods)
1106         (Y-extent . ,ly:slur::height)
1107         (stencil . ,ly:slur::print)
1108         (thickness . 1.1)
1109         (minimum-length . 1.5)
1110         (height-limit . 2.0)
1111         (ratio . 0.333)
1112         (meta . ((class . Spanner)
1113                  (interfaces . (slur-interface))))))
1114
1115     (NonMusicalPaperColumn
1116      . (
1117         (axes . (0))
1118         (before-line-breaking . ,ly:paper-column::before-line-breaking)
1119         (X-extent . ,ly:axis-group-interface::width)
1120         ;;                    (stencil . ,ly:paper-column::print)
1121
1122         (non-musical . #t)
1123         (line-break-permission . allow)
1124
1125         ;; debugging stuff: print column number.
1126         ;;               (font-size . -6) (font-name . "sans")  (Y-extent . #f)
1127
1128         (meta . ((class . Paper_column)
1129                  (interfaces . (paper-column-interface
1130                                 axis-group-interface
1131                                 spaceable-grob-interface))))))
1132
1133     (PercentRepeat
1134      . (
1135         (springs-and-rods . ,ly:multi-measure-rest::set-spacing-rods)
1136         (stencil . ,ly:multi-measure-rest::percent)
1137         (slope . 1.0)
1138         (thickness . 0.48)
1139         (font-encoding . fetaMusic)
1140         (meta . ((class . Spanner)
1141                  (interfaces . (multi-measure-rest-interface
1142                                 font-interface
1143                                 percent-repeat-interface))))))
1144     (PercentRepeatCounter
1145      . (
1146         (stencil . ,ly:text-interface::print)
1147         (X-offset . ,(ly:make-simple-closure
1148                       `(,+ ,(ly:make-simple-closure (list ly:self-alignment-interface::x-centered-on-y-parent))
1149                            ,(ly:make-simple-closure (list ly:self-alignment-interface::x-aligned-on-self)))))
1150         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1151         (self-alignment-X . 0)
1152         (direction . ,UP)
1153         (padding . 0.2)
1154         (staff-padding . 0.25)
1155         (font-size . -2)
1156         (font-encoding . fetaNumber)
1157         (meta . ((class . Spanner)
1158                  (interfaces . (side-position-interface
1159                                 self-alignment-interface
1160                                 percent-repeat-interface
1161                                 font-interface
1162                                 text-interface))))))
1163
1164     ;; an example of a text spanner
1165     (PianoPedalBracket
1166      . (
1167         (stencil . ,ly:piano-pedal-bracket::print)
1168         (style . line)
1169         (bound-padding . 1.0)
1170         (direction . ,DOWN)
1171         (bracket-flare . (0.5 . 0.5))
1172         (edge-height . (1.0 . 1.0))
1173         (shorten-pair . (0.0 . 0.0))
1174         (thickness .  1.0)
1175         (meta . ((class . Spanner)
1176                  (interfaces . (line-interface
1177                                 piano-pedal-interface
1178                                 piano-pedal-bracket-interface))))))
1179
1180     (RehearsalMark
1181      . (
1182         (stencil . ,ly:text-interface::print)
1183         (X-offset . ,(ly:make-simple-closure
1184                       `(,+
1185                         ,(ly:make-simple-closure
1186                           (list ly:break-alignment-align-interface::self-align-callback))
1187                         ,(ly:make-simple-closure
1188                           (list ly:self-alignment-interface::x-aligned-on-self)))))
1189
1190         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1191         (self-alignment-X . 0)
1192         (direction . ,UP)
1193         (non-musical . #t)
1194         (font-size . 2)
1195         (baseline-skip . 2)
1196         (break-visibility . ,end-of-line-invisible)
1197         (break-align-symbol . staff-bar)
1198         (padding . 0.8)
1199         (meta . ((class . Item)
1200                  (interfaces . (text-interface
1201                                 side-position-interface
1202                                 break-alignment-align-interface
1203                                 font-interface
1204                                 mark-interface
1205                                 self-alignment-interface))))))
1206
1207
1208     (RepeatSlash
1209      . (
1210         (stencil . ,ly:percent-repeat-item-interface::beat-slash)
1211         (thickness . 0.48)
1212         (slope . 1.7)
1213         (meta . ((class . Item)
1214                  (interfaces . (percent-repeat-interface))))))
1215     (RepeatTie
1216      . (
1217         (stencil  . ,ly:tie::print)
1218         (control-points . ,ly:semi-tie::calc-control-points)
1219         (direction . ,ly:semi-tie::calc-direction)
1220         (details . ((ratio . 0.333)
1221                     (height-limit . 1.0)))
1222         (thickness . 1.0)
1223         (meta . ((class . Item)
1224                  (interfaces . (semi-tie-interface))
1225                  ))
1226         ))
1227
1228     (RepeatTieColumn
1229      . (
1230         (X-extent . #f)
1231         (Y-extent . #f)
1232         (head-direction . ,RIGHT)
1233         (positioning-done . ,ly:semi-tie-column::calc-positioning-done)
1234         (meta . ((class . Item)
1235                  (interfaces . (semi-tie-column-interface))
1236                  ))
1237         ))
1238
1239     (Rest
1240      . (
1241         (stencil . ,ly:rest::print)
1242         (X-extent . ,ly:rest::width)
1243         (Y-extent . ,ly:rest::height)
1244         (Y-offset . ,ly:rest::y-offset-callback)
1245         (minimum-distance . 0.25)
1246         (meta . ((class . Item)
1247                  (interfaces . (font-interface
1248                                 rhythmic-head-interface
1249                                 rhythmic-grob-interface
1250                                 staff-symbol-referencer-interface
1251                                 rest-interface))))))
1252
1253     (RestCollision
1254      . (
1255         (minimum-distance . 0.75)
1256         (positioning-done . ,ly:rest-collision::calc-positioning-done)
1257         (meta . ((class . Item)
1258                  (interfaces . (rest-collision-interface))))))
1259
1260     (Script
1261      . (
1262         ;; don't set direction here: it breaks staccato.
1263
1264         ;; This value is sensitive: if too large, staccato dots will move a
1265         ;; space a away.
1266         (padding . 0.20)
1267         (staff-padding . 0.25)
1268         ;; (script-priority . 0) priorities for scripts, see script.scm
1269         (X-offset . , ly:self-alignment-interface::centered-on-x-parent)
1270
1271
1272         (stencil . ,ly:script-interface::print)
1273         (direction . ,ly:script-interface::calc-direction)
1274         (font-encoding . fetaMusic)
1275         (meta . ((class . Item)
1276                  (interfaces . (script-interface
1277                                 side-position-interface
1278                                 font-interface))))))
1279
1280     (ScriptColumn
1281      . (
1282         (before-line-breaking . ,ly:script-column::before-line-breaking)
1283         (meta . ((class . Item)
1284                  (interfaces . (script-column-interface))))))
1285
1286     (SeparationItem
1287      . (
1288         (X-extent . #f)
1289         (Y-extent . #f)
1290         (meta . ((class . Item)
1291                  (interfaces . (spacing-interface
1292                                 separation-item-interface))))))
1293
1294     (SeparatingGroupSpanner
1295      . (
1296         (springs-and-rods . ,ly:separating-group-spanner::set-spacing-rods)
1297         (meta . ((class . Spanner)
1298                  (interfaces . (only-prebreak-interface
1299                                 spacing-interface
1300                                 separation-spanner-interface))))))
1301
1302     (Slur
1303      . ((details . ,default-slur-details)
1304         (control-points . ,ly:slur::calc-control-points)
1305         (direction . ,ly:slur::calc-direction)
1306         (springs-and-rods . ,ly:spanner::set-spacing-rods)
1307         (Y-extent . ,ly:slur::height)
1308         (stencil . ,ly:slur::print)
1309         (thickness . 1.2)
1310         (line-thickness . 0.8)
1311         (minimum-length . 1.5)
1312         (height-limit . 2.0)
1313         (ratio . 0.25)
1314         (avoid-slur . inside)
1315         (meta . ((class . Spanner)
1316                  (interfaces . (slur-interface))))))
1317
1318     (SostenutoPedal
1319      . (
1320         (stencil . ,ly:text-interface::print)
1321         (direction . ,RIGHT)
1322         (X-offset . ,ly:self-alignment-interface::x-aligned-on-self)
1323         (no-spacing-rods . #t)
1324         (padding . 0.0) ;; padding relative to SostenutoPedalLineSpanner
1325         (font-shape . italic)
1326         (self-alignment-X . 0)
1327         (meta . ((class . Item)
1328                  (interfaces . (text-interface
1329                                 self-alignment-interface
1330                                 font-interface))))))
1331
1332     (SostenutoPedalLineSpanner
1333      . (
1334         (axes . (1))
1335         (Y-extent . ,ly:axis-group-interface::height)
1336         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1337         (side-axis . ,Y)
1338         (staff-padding . 1.0)
1339         (padding . 1.2)
1340         (minimum-space . 1.0)
1341         (direction . ,DOWN)
1342         (meta . ((class . Spanner)
1343                  (interfaces . (piano-pedal-interface
1344                                 axis-group-interface
1345                                 side-position-interface))))))
1346     (SpacingSpanner
1347      . (
1348         (springs-and-rods . ,ly:spacing-spanner::set-springs)
1349         (average-spacing-wishes . #t)
1350         (grace-space-factor . 0.6)
1351         (shortest-duration-space . 2.0)
1352         (spacing-increment . 1.2)
1353         (base-shortest-duration . ,(ly:make-moment 3 16))
1354         (meta . ((class . Spanner)
1355                  (interfaces . (spacing-interface
1356                                 spacing-spanner-interface))))))
1357
1358     (SpanBar
1359      . (
1360         (break-align-symbol . staff-bar)
1361         (Y-extent . ())
1362         (layer . 0)
1363         (non-musical . #t)
1364         (stencil . ,ly:span-bar::print)
1365         (bar-size . ,ly:span-bar::calc-bar-size)
1366         (X-extent . ,ly:span-bar::width)
1367         (glyph-name . ,ly:span-bar::calc-glyph-name)
1368         (before-line-breaking . ,ly:span-bar::before-line-breaking)
1369
1370         ;; ugh duplication!
1371
1372         ;;
1373         ;; Ross. page 151 lists other values, we opt for a leaner look
1374         ;;
1375         (kern . 3.0)
1376         (thin-kern . 3.0)
1377         (hair-thickness . 1.6)
1378         (thick-thickness . 6.0)
1379         (meta . ((class . Item)
1380                  (interfaces . (span-bar-interface
1381                                 font-interface
1382                                 bar-line-interface))))))
1383
1384     (StanzaNumber
1385      . (
1386         (stencil . ,ly:text-interface::print)
1387         (font-series . bold)
1388         (padding . 1.0)
1389         (X-offset . ,ly:side-position-interface::x-aligned-side)
1390         (side-axis . ,X)
1391         (direction . ,LEFT)
1392         (meta . ((class . Item)
1393                  (interfaces . (side-position-interface
1394                                 stanza-number-interface
1395                                 text-interface
1396                                 font-interface))))))
1397
1398
1399     (StaffSpacing
1400      . (
1401         (non-musical . #t)
1402         (stem-spacing-correction . 0.4)
1403         (meta . ((class . Item)
1404                  (interfaces . (spacing-interface
1405                                 staff-spacing-interface))))))
1406
1407
1408     (StaffSymbol
1409      . (
1410         (Y-extent . ,ly:staff-symbol::height)
1411         (stencil . ,ly:staff-symbol::print)
1412         (line-count . 5)
1413         (ledger-line-thickness . (1.0 . 0.1))
1414         (layer . 0)
1415         (meta . ((class . Spanner)
1416                  (interfaces . (staff-symbol-interface))))))
1417
1418     (Stem
1419      . (
1420         (direction . ,ly:stem::calc-direction)
1421         (default-direction . ,ly:stem::calc-default-direction)
1422         (stem-end-position . ,ly:stem::calc-stem-end-position)
1423         (neutral-direction . ,DOWN)
1424         (stem-info . ,ly:stem::calc-stem-info)
1425         (positioning-done . ,ly:stem::calc-positioning-done)
1426         (stencil . ,ly:stem::print)
1427         (X-extent . ,ly:stem::width)
1428         (Y-extent . ,ly:stem::height)
1429         (length . ,ly:stem::calc-length)
1430         (thickness . 1.3)
1431         (details
1432          . (
1433             ;; 3.5 (or 3 measured from note head) is standard length
1434             ;; 32nd, 64th flagged stems should be longer
1435             (lengths . (3.5 3.5 3.5 4.5 5.0))
1436
1437             ;; FIXME.  3.5 yields too long beams (according to Ross and
1438             ;; looking at Baerenreiter examples) for a number of common
1439             ;; boundary cases.  Subtracting half a beam thickness fixes
1440             ;; this, but the bug may well be somewhere else.
1441
1442             ;; FIXME this should come from 'lengths
1443             (beamed-lengths . (3.26 3.5 3.6))
1444
1445             ;; The 'normal' minima
1446             (beamed-minimum-free-lengths . (1.83 1.5 1.25))
1447                                         ;(beamed-minimum-free-lengths . (2.0 1.83 1.25))
1448
1449             ;; The 'extreme case' minima
1450             (beamed-extreme-minimum-free-lengths . (2.0 1.25))
1451
1452             ;; Stems in unnatural (forced) direction should be shortened by
1453             ;; one staff space, according to [Roush & Gourlay].
1454             ;; Flagged stems we shorten only half a staff space.
1455             (stem-shorten . (1.0 0.5))
1456
1457             ))
1458
1459         ;; We use the normal minima as minimum for the ideal lengths,
1460         ;; and the extreme minima as abolute minimum length.
1461
1462         (X-offset . ,ly:stem::offset-callback)
1463         (Y-offset . ,ly:staff-symbol-referencer::callback)
1464         (meta . ((class . Item)
1465                  (interfaces . (stem-interface
1466                                 font-interface))))))
1467
1468     (StemTremolo
1469      . (
1470         (Y-extent . ,ly:stem-tremolo::height)
1471         (stencil . ,ly:stem-tremolo::print)
1472         (X-extent . #f)
1473         (slope . ,ly:stem-tremolo::calc-slope)
1474         (beam-width . ,ly:stem-tremolo::calc-width) ; staff-space
1475         (style . ,ly:stem-tremolo::calc-style)
1476         (beam-thickness . 0.48) ; staff-space
1477         (meta . ((class . Item)
1478                  (interfaces . (stem-tremolo-interface))))))
1479
1480     (StringNumber
1481      . (
1482         (stencil . ,print-circled-text-callback)
1483         (padding . 0.5)
1484         (staff-padding . 0.5)
1485         (self-alignment-X . 0)
1486         (self-alignment-Y . 0)
1487         (script-priority . 100)
1488         (font-encoding . fetaNumber)
1489         (font-size . -5)                ; don't overlap when next to heads.
1490         (meta . ((class . Item)
1491                  (interfaces . (string-number-interface
1492                                 font-interface
1493                                 text-script-interface
1494                                 text-interface
1495                                 side-position-interface
1496                                 self-alignment-interface
1497                                 item-interface))))))
1498
1499     (SustainPedal
1500      . (
1501         (no-spacing-rods . #t)
1502         (stencil . ,ly:sustain-pedal::print)
1503         (self-alignment-X . 0)
1504         (direction . ,RIGHT)
1505         (padding . 0.0)  ;; padding relative to SustainPedalLineSpanner
1506         (X-offset . ,ly:self-alignment-interface::x-aligned-on-self)
1507         (meta . ((class . Item)
1508                  (interfaces . (piano-pedal-interface
1509                                 text-spanner-interface
1510                                 line-spanner-interface
1511                                 text-interface
1512                                 self-alignment-interface
1513                                 font-interface))))))
1514
1515     (SustainPedalLineSpanner
1516      . (
1517         (axes . (1))
1518         (Y-extent . ,ly:axis-group-interface::height)
1519         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1520         (side-axis . ,Y)
1521         (padding . 1.2)
1522         (staff-padding . 1.2)
1523         (minimum-space . 1.0)
1524         (direction . ,DOWN)
1525         (meta . ((class . Spanner)
1526                  (interfaces . (piano-pedal-interface
1527                                 axis-group-interface
1528                                 side-position-interface))))))
1529
1530     (System
1531      . (
1532         (axes . (0 1))
1533         (X-extent . ,ly:axis-group-interface::width)
1534         (Y-extent . ,ly:axis-group-interface::height)
1535         (meta . ((class . System)
1536                  (interfaces . (system-interface
1537                                 axis-group-interface))))))
1538
1539     (SystemStartBrace
1540      . (
1541         (style . brace)
1542         (padding . 0.3)
1543         (stencil . ,ly:system-start-delimiter::print)
1544         (collapse-height . 5.0)
1545         (X-offset . ,ly:side-position-interface::x-aligned-side)
1546         (direction . ,LEFT)
1547         (font-encoding . fetaBraces)
1548         (Y-extent . #f)
1549         (meta . ((class . Spanner)
1550                  (interfaces . (system-start-delimiter-interface
1551                                 side-position-interface
1552                                 font-interface))))))
1553
1554
1555     (SystemStartSquare
1556      . (
1557         (Y-extent . #f)
1558         (X-offset . ,ly:side-position-interface::x-aligned-side)
1559         (direction . ,LEFT)
1560         (stencil . ,ly:system-start-delimiter::print)
1561         (style . line-bracket)
1562         (thickness . 1.0)
1563         (meta . ((class . Spanner)
1564                  (interfaces . (font-interface
1565                                 side-position-interface
1566                                 system-start-delimiter-interface))))))
1567     (SystemStartBracket
1568      . (
1569         (Y-extent . #f)
1570         (padding . 0.8)
1571         (X-offset . ,ly:side-position-interface::x-aligned-side)
1572         (direction . ,LEFT)
1573         (stencil . ,ly:system-start-delimiter::print)
1574         (style . bracket)
1575         (collapse-height . 5.0)
1576         (thickness . 0.45)
1577         (meta . ((class . Spanner)
1578                  (interfaces . (font-interface
1579                                 side-position-interface
1580                                 system-start-delimiter-interface))))))
1581
1582     (SystemStartBar
1583      . (
1584         (Y-extent . #f)
1585
1586         ;; ugh--hardcoded.
1587         (padding . -0.1)  ;; bar must cover rounded ending of staff line.
1588         (X-offset . ,ly:side-position-interface::x-aligned-side)
1589         (direction . ,LEFT)
1590         (style . bar-line)
1591         (thickness . 1.6)
1592         (stencil . ,ly:system-start-delimiter::print)
1593         (meta . ((class . Spanner)
1594                  (interfaces . (side-position-interface
1595                                 system-start-delimiter-interface))))))
1596
1597
1598     (TabNoteHead
1599      . (
1600         (stencil . ,ly:text-interface::print)
1601         (Y-offset . ,ly:staff-symbol-referencer::callback)
1602         (font-size . -2)
1603         (stem-attachment . (0.0 . 1.35))
1604         (font-series . bold)
1605         (meta . ((class . Item)
1606                  (interfaces
1607                   . (rhythmic-head-interface
1608                      font-interface rhythmic-grob-interface
1609                      note-head-interface
1610                      staff-symbol-referencer-interface
1611                      text-interface))))))
1612
1613     (TextScript
1614      . (
1615         (no-spacing-rods . #t)
1616         (X-offset . ,ly:self-alignment-interface::x-aligned-on-self)
1617         (direction . ,DOWN)
1618
1619         ;; sync with Fingering ?
1620         (padding . 0.5)
1621         (staff-padding . 0.5)
1622
1623         (stencil . ,ly:text-interface::print)
1624         (direction . ,ly:script-interface::calc-direction)
1625
1626         (avoid-slur . around)
1627         (slur-padding . 0.5)
1628         (script-priority . 200)
1629         ;; todo: add X self alignment?
1630         (meta . ((class . Item)
1631                  (interfaces . (text-script-interface
1632                                 text-interface
1633                                 side-position-interface
1634                                 font-interface))))))
1635
1636     (TextSpanner
1637      . (
1638         (stencil . ,ly:text-spanner::print)
1639         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1640         (font-shape . italic)
1641         (style . dashed-line)
1642         (staff-padding . 0.8)
1643         (dash-fraction . 0.2)
1644         (dash-period . 3.0)
1645         (side-axis . ,Y)
1646         (direction . ,UP)
1647         (meta . ((class . Spanner)
1648                  (interfaces . (text-spanner-interface
1649                                 line-spanner-interface
1650                                 side-position-interface
1651                                 font-interface))))))
1652
1653     (Tie
1654      . (
1655         (control-points . ,ly:tie::calc-control-points)
1656         (avoid-slur . inside)
1657         (direction . ,ly:tie::calc-direction)
1658         (stencil . ,ly:tie::print)
1659         (font-size . -6)
1660         (details . (
1661                     ;; for a full list, see tie-helper.cc
1662                     (ratio . 0.333)
1663                     (center-staff-line-clearance . 0.6)
1664                     (tip-staff-line-clearance . 0.45)
1665                     (note-head-gap . 0.2)
1666                     (stem-gap . 0.35)
1667                     (height-limit . 1.0)
1668                     (horizontal-distance-penalty-factor . 10)
1669                     (min-length-penalty-factor . 20)
1670                     (tie-tie-collision-distance . 0.45)
1671                     (tie-tie-collision-penalty . 25.0)
1672                     (intra-space-threshold . 1.25)
1673                     (outer-tie-vertical-distance-symmetry-penalty-factor . 10)
1674                     (outer-tie-length-symmetry-penalty-factor . 10)
1675                     (outer-tie-vertical-gap . 0.25)
1676                     (multi-tie-region-size . 1)
1677                     (between-length-limit . 1.0)))
1678         (thickness . 1.2)
1679         (line-thickness . 0.8)
1680         (meta . ((class . Spanner)
1681                  (interfaces . (tie-interface))))
1682         ))
1683
1684     (TieColumn
1685      . (
1686         (positioning-done . ,ly:tie-column::calc-positioning-done)
1687         (before-line-breaking . ,ly:tie-column::before-line-breaking)
1688         (X-extent . #f)
1689         (Y-extent . #f)
1690         (meta . ((class . Spanner)
1691                  (interfaces . (tie-column-interface))))))
1692
1693     (TimeSignature
1694      . (
1695         (stencil . ,ly:time-signature::print)
1696         (break-align-symbol . time-signature)
1697         (break-visibility . ,all-visible)
1698         (space-alist . (
1699                         (first-note . (fixed-space . 2.0))
1700                         (right-edge . (extra-space . 0.5))
1701                         (staff-bar . (minimum-space . 2.0))))
1702         (non-musical . #t)
1703         (style . C)
1704         (meta . ((class . Item)
1705                  (interfaces . (time-signature-interface
1706                                 break-aligned-interface
1707                                 font-interface))))))
1708
1709     (TrillSpanner
1710      . (
1711         (stencil . ,ly:dynamic-text-spanner::print)
1712         (edge-text . ,(cons (make-musicglyph-markup "scripts.trill")
1713                             ""))
1714         (style . trill)
1715         (staff-padding . 1.0)
1716         (padding . 0.5)
1717         (direction . ,UP)
1718         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1719         (side-axis . ,Y)
1720         (meta . ((class . Spanner)
1721                  (interfaces . (text-spanner-interface
1722                                 line-spanner-interface
1723                                 side-position-interface
1724                                 font-interface))))))
1725
1726     (TrillPitchAccidental
1727      . ((X-offset . ,ly:side-position-interface::x-aligned-side)
1728         (padding . 0.2)
1729         (direction . ,LEFT)
1730         (font-size . -4)
1731         (side-axis . ,X)
1732         (stencil . ,ly:accidental-interface::print)
1733         (meta . ((class . Item)
1734                  (interfaces . (item-interface
1735                                 accidental-interface
1736                                 side-position-interface
1737                                 font-interface))))))
1738
1739     (TrillPitchGroup
1740      . ((X-offset . ,ly:side-position-interface::x-aligned-side)
1741         (axes . (,X))
1742         (font-size . -4)
1743         (stencil . ,parenthesize-elements)
1744         (direction . ,RIGHT)
1745         (side-axis . ,X)
1746         (padding . 0.3)
1747         (meta . ((class . Item)
1748                  (interfaces . (side-position-interface
1749                                 note-head-interface
1750                                 rhythmic-head-interface
1751                                 font-interface
1752                                 accidental-interface
1753                                 axis-group-interface))))))
1754
1755     (TrillPitchHead
1756      . (
1757         (stencil . ,ly:note-head::print)
1758         (duration-log . 2)
1759         (Y-offset . ,ly:staff-symbol-referencer::callback)
1760         (font-size . -4)
1761         (meta . ((class . Item)
1762                  (interfaces . (item-interface
1763                                 rhythmic-head-interface
1764                                 font-interface
1765                                 pitched-trill-interface
1766                                 ledgered-interface
1767                                 staff-symbol-referencer-interface))))))
1768
1769     (TupletBracket
1770      . (
1771         (padding . 1.1)
1772         (thickness . 1.6)
1773         (edge-height . (0.7 . 0.7))
1774         (shorten-pair . (-0.2 . -0.2))
1775         (staff-padding . 0.25)
1776         (direction  . ,ly:tuplet-bracket::calc-direction)
1777         (positions . ,ly:tuplet-bracket::calc-positions)
1778         (connect-to-neighbor . ,ly:tuplet-bracket::calc-connect-to-neighbors)
1779         (control-points . ,ly:tuplet-bracket::calc-control-points)
1780         (stencil . ,ly:tuplet-bracket::print)
1781
1782         (meta . ((class . Spanner)
1783                  (interfaces . (line-interface
1784                                 tuplet-bracket-interface))))))
1785
1786     (TupletNumber
1787      . (
1788         (stencil . ,ly:tuplet-number::print)
1789         (text . ,tuplet-number::calc-denominator-text)
1790         (font-shape . italic)
1791         (font-size . -2)
1792         (avoid-slur . inside)
1793         (meta . ((class . Spanner)
1794                  (interfaces . (text-interface tuplet-number-interface
1795                                 font-interface))))))
1796
1797     (UnaCordaPedal
1798      . (
1799         (stencil . ,ly:text-interface::print)
1800         (font-shape . italic)
1801         (no-spacing-rods . #t)
1802         (self-alignment-X . 0)
1803         (direction . ,RIGHT)
1804         (padding . 0.0)  ;; padding relative to UnaCordaPedalLineSpanner
1805         (X-offset . ,ly:self-alignment-interface::x-aligned-on-self)
1806         (meta . ((class . Item)
1807                  (interfaces . (text-interface
1808                                 self-alignment-interface
1809                                 font-interface))))))
1810
1811     (UnaCordaPedalLineSpanner
1812      . (
1813         (axes . (1))
1814         (Y-extent . ,ly:axis-group-interface::height)
1815         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1816         (side-axis . ,Y)
1817         (padding . 1.2)
1818         (staff-padding . 1.2)
1819         (minimum-space . 1.0)
1820         (direction . ,DOWN)
1821         (meta . ((class . Spanner)
1822                  (interfaces . (piano-pedal-interface
1823                                 axis-group-interface
1824                                 side-position-interface))))))
1825
1826     (VaticanaLigature
1827      . (
1828         (thickness . 0.6)
1829         (flexa-width . 2.0)
1830         (stencil . ,ly:vaticana-ligature::print)
1831         (meta . ((class . Spanner)
1832                  (interfaces . (vaticana-ligature-interface
1833                                 font-interface))))))
1834
1835     (VerticalAlignment
1836      . (
1837         (axes . (1))
1838         (positioning-done . ,ly:align-interface::calc-positioning-done)
1839         (after-line-breaking . ,ly:align-interface::stretch-after-break)
1840         (Y-extent . ,ly:axis-group-interface::height)
1841         (X-extent . ,ly:axis-group-interface::width)
1842         (stacking-dir . -1)
1843         (meta . ((class . Spanner)
1844                  (interfaces . (align-interface
1845                                 axis-group-interface))))))
1846     (VerticalAxisGroup
1847      . (
1848         (axes . (1))
1849         (Y-offset . ,ly:hara-kiri-group-spanner::force-hara-kiri-callback)
1850
1851         (Y-extent . ,ly:hara-kiri-group-spanner::y-extent)
1852         (X-extent . ,ly:axis-group-interface::width)
1853         (meta . ((class . Spanner)
1854                  (interfaces . (axis-group-interface
1855                                 hara-kiri-group-interface
1856                                 vertically-spaceable-interface))))))
1857
1858
1859     (VoltaBracket
1860      . (
1861         (stencil . ,ly:volta-bracket-interface::print)
1862         (direction . ,UP)
1863         (padding . 1)
1864         (font-encoding . fetaNumber)
1865         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1866         (side-axis . ,Y)
1867         (thickness . 1.6)  ;;  line-thickness
1868         (edge-height . (2.0 . 2.0)) ;; staff-space;
1869         (minimum-space . 5)
1870         (font-size . -4)
1871         (meta . ((class . Spanner)
1872                  (interfaces . (volta-bracket-interface
1873                                 horizontal-bracket-interface
1874                                 line-interface
1875                                 text-interface
1876                                 side-position-interface
1877                                 font-interface)))
1878               )))
1879
1880
1881     (VoiceFollower
1882      . (
1883         (style . line)
1884         (gap . 0.5)
1885         (non-musical . #t)
1886         (X-extent . #f)
1887         (Y-extent . #f)
1888         (stencil . ,ly:line-spanner::print)
1889         (after-line-breaking . ,ly:line-spanner::after-line-breaking)
1890         (meta . ((class . Spanner)
1891                  (interfaces . (line-spanner-interface
1892                                 line-interface))))
1893         ))
1894
1895 ))
1896
1897 (define (completize-grob-entry x)
1898   "Transplant assoc key into 'name entry of 'meta of X.  Set interfaces for Item, Spanner etc.
1899 "
1900   ;;  (display (car x))
1901   ;;  (newline)
1902   (let* ((name-sym  (car x))
1903          (grob-entry (cdr x))
1904          (meta-entry (cdr (assoc 'meta grob-entry)))
1905          (class (cdr (assoc 'class meta-entry)))
1906          (ifaces-entry
1907           (cdr (assoc 'interfaces meta-entry))))
1908
1909     (cond
1910      ((eq? 'Item class)
1911       (set! ifaces-entry (cons 'item-interface ifaces-entry)))
1912      ((eq? 'Spanner class)
1913       (set! ifaces-entry (cons 'spanner-interface ifaces-entry)))
1914      ((eq? 'Paper_column class)
1915       (set! ifaces-entry (cons 'item-interface
1916                                (cons 'paper-column-interface ifaces-entry))))
1917      ((eq? 'System class)
1918       (set! ifaces-entry (cons 'system-interface
1919                                (cons 'spanner-interface ifaces-entry))))
1920      (else
1921       (ly:warning "Unknown class ~a" class)))
1922     (set! ifaces-entry (cons 'grob-interface ifaces-entry))
1923
1924     (set! meta-entry (assoc-set! meta-entry 'name name-sym))
1925     (set! meta-entry (assoc-set! meta-entry 'interfaces
1926                                  ifaces-entry))
1927     (set! grob-entry (assoc-set! grob-entry 'meta meta-entry))
1928     (cons name-sym grob-entry)))
1929
1930 (set! all-grob-descriptions (map completize-grob-entry all-grob-descriptions))
1931
1932 ;;  (display (map pair? all-grob-descriptions))
1933
1934 ;; make sure that \property Foo.Bar =\turnOff doesn't complain
1935
1936 (map (lambda (x)
1937        ;; (display (car x)) (newline)
1938
1939        (set-object-property! (car x) 'translation-type? list?)
1940        (set-object-property! (car x) 'is-grob? #t))
1941      all-grob-descriptions)
1942
1943 (set! all-grob-descriptions (sort all-grob-descriptions alist<?))
1944
1945
1946 (define pure-print-callbacks
1947   (list
1948    `(,ly:note-head::print . '())
1949    `(,ly:clef::print . '())
1950    `(,ly:text-interface::print . '())))
1951
1952 ;; ly:grob::stencil-extent is safe iff the print callback is safe too
1953 (define (pure-stencil-height grob start stop)
1954   (let ((sten (ly:grob-property-data grob 'stencil)))
1955     (if (or
1956          (ly:stencil? sten)
1957          (pair? (assq sten pure-print-callbacks)))
1958         (ly:grob::stencil-height grob)
1959         '(0 . 0))))
1960
1961 (define pure-Y-extents
1962   (list
1963    `(,ly:staff-symbol::height . ())))
1964
1965 (define Y-extent-conversions
1966   (list
1967    `(,ly:stem::height . ,ly:stem::pure-height)
1968    `(,ly:grob::stencil-height . ,pure-stencil-height)
1969    `(,ly:side-position-interface::y-aligned-side . ,ly:side-position-interface::pure-y-aligned-side)
1970    `(,ly:axis-group-interface::height . ,ly:axis-group-interface::pure-height)
1971    `(,ly:hara-kiri-group-spanner::y-extent . ,ly:hara-kiri-group-spanner::pure-height)))
1972
1973 (define pure-Y-offsets
1974   (list
1975    `(,ly:staff-symbol-referencer::callback . ())))
1976
1977 (define Y-offset-conversions
1978   (list
1979    `(,ly:side-position-interface::y-aligned-side . ,ly:side-position-interface::pure-y-aligned-side)))
1980
1981 (define-public (pure-relevant grob)
1982   (let ((extent-callback (ly:grob-property-data grob 'Y-extent)))
1983     (or
1984      (pair? (assq extent-callback pure-Y-extents))
1985      (and
1986       (pair? (assq extent-callback Y-extent-conversions))
1987       (or
1988        (not (eq? extent-callback ly:grob::stencil-height))
1989        (pair? (assq (ly:grob-property-data grob 'stencil) pure-print-callbacks))
1990        (ly:stencil? (ly:grob-property-data grob 'stencil)))))))
1991
1992 (define (pure-conversion pures conversions defsymbol defreturn rettype? grob start stop)
1993   (let* ((normal-callback (ly:grob-property-data grob defsymbol))
1994          (pure-callback (assq normal-callback conversions)))
1995     (if (rettype? normal-callback)
1996         normal-callback
1997         (if (pair? (assq normal-callback pures))
1998             (normal-callback grob)
1999             (if (pair? pure-callback)
2000                 ((cdr pure-callback) grob start stop)
2001                 defreturn)))))
2002
2003 (define-public (pure-Y-extent grob start stop)
2004   (pure-conversion pure-Y-extents Y-extent-conversions
2005                    'Y-extent '(0 . 0) pair? grob start stop))
2006
2007 (define-public (pure-Y-offset grob start stop)
2008   (pure-conversion pure-Y-offsets Y-offset-conversions
2009                    'Y-offset 0 number? grob start stop))