scm/define-grobs.scm

   1 ;;;; This file is part of LilyPond, the GNU music typesetter.
   2 ;;;;
   3 ;;;; Copyright (C) 1998--2012 Han-Wen Nienhuys <hanwen@xs4all.nl>
   4 ;;;;                 Jan Nieuwenhuizen <janneke@gnu.org>
   5 ;;;;
   6 ;;;; LilyPond is free software: you can redistribute it and/or modify
   7 ;;;; it under the terms of the GNU General Public License as published by
   8 ;;;; the Free Software Foundation, either version 3 of the License, or
   9 ;;;; (at your option) any later version.
  10 ;;;;
  11 ;;;; LilyPond is distributed in the hope that it will be useful,
  12 ;;;; but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 ;;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14 ;;;; GNU General Public License for more details.
  15 ;;;;
  16 ;;;; You should have received a copy of the GNU General Public License
  17 ;;;; along with LilyPond.  If not, see <http://www.gnu.org/licenses/>.
  18
  19 ;;;; distances are given in line-thickness (thicknesses) and
  20 ;;;; staff-space (distances)
  21
  22 ;;;; WARNING: the meta field should be the last one.
  23 ;;;; WARNING: don't use anonymous functions for initialization.
  24
  25 ;; TODO: junk the meta field in favor of something more compact?
  26
  27 (define-public all-grob-descriptions
  28   `(
  29     (Accidental
  30      . (
  31         (alteration . ,accidental-interface::calc-alteration)
  32         (avoid-slur . inside)
  33         (glyph-name . ,accidental-interface::glyph-name)
  34         (glyph-name-alist . ,standard-alteration-glyph-name-alist)
  35         (stencil . ,ly:accidental-interface::print)
  36         (horizontal-skylines . ,ly:accidental-interface::horizontal-skylines)
  37         (vertical-skylines . ,ly:grob::vertical-skylines-from-stencil)
  38         (X-extent . ,ly:accidental-interface::width)
  39         (Y-extent . ,ly:accidental-interface::height)
  40         (meta . ((class . Item)
  41                  (interfaces . (accidental-interface
  42                                 inline-accidental-interface
  43                                 font-interface))))))
  44
  45     (AccidentalCautionary
  46      . (
  47         (alteration . ,accidental-interface::calc-alteration)
  48         (avoid-slur . inside)
  49         (glyph-name-alist . ,standard-alteration-glyph-name-alist)
  50         (parenthesized . #t)
  51         (stencil . ,ly:accidental-interface::print)
  52         (Y-extent . ,ly:accidental-interface::height)
  53         (meta . ((class . Item)
  54                  (interfaces . (accidental-interface
  55                                 inline-accidental-interface
  56                                 font-interface))))))
  57
  58     (AccidentalPlacement
  59      . (
  60         (direction .  ,LEFT)
  61         (positioning-done . ,ly:accidental-placement::calc-positioning-done)
  62
  63         ;; this is quite small, but it is very ugly to have
  64         ;; accs closer to the previous note than to the next one.
  65         (right-padding . 0.15)
  66
  67         ;; for horizontally stacked scripts.
  68         (script-priority .  -100)
  69
  70         (X-extent . ,ly:axis-group-interface::width)
  71         (meta . ((class . Item)
  72                  (interfaces . (accidental-placement-interface))))))
  73
  74     (AccidentalSuggestion
  75      . (
  76         (alteration . ,accidental-interface::calc-alteration)
  77         (direction . ,UP)
  78         (font-size . -2)
  79         (glyph-name-alist . ,standard-alteration-glyph-name-alist)
  80         (outside-staff-priority . 0)
  81         (script-priority . 0)
  82         (self-alignment-X . ,CENTER)
  83         (side-axis . ,Y)
  84         (staff-padding . 0.25)
  85         (stencil . ,ly:accidental-interface::print)
  86         (use-skylines . #t)
  87         (X-extent . ,ly:accidental-interface::width)
  88         (X-offset . ,(ly:make-simple-closure
  89                       `(,+
  90                         ,(ly:make-simple-closure
  91                           (list ly:self-alignment-interface::centered-on-x-parent))
  92                         ,(ly:make-simple-closure
  93                           (list ly:self-alignment-interface::x-aligned-on-self)))))
  94         (Y-extent . ,ly:accidental-interface::height)
  95         (Y-offset . ,ly:side-position-interface::y-aligned-side)
  96         (meta . ((class . Item)
  97                  (interfaces . (accidental-interface
  98                                 accidental-suggestion-interface
  99                                 font-interface
 100                                 script-interface
 101                                 self-alignment-interface
 102                                 side-position-interface))))))
 103
 104     (Ambitus
 105      . (
 106         (axes . (,X ,Y))
 107         (break-align-symbol . ambitus)
 108         (break-visibility . ,begin-of-line-visible)
 109         (non-musical . #t)
 110         (space-alist . (
 111                         (cue-end-clef . (extra-space . 0.5))
 112                         (clef . (extra-space . 0.5))
 113                         (cue-clef . (extra-space . 0.5))
 114                         (key-signature . (extra-space . 0.0))
 115                         (staff-bar . (extra-space . 0.0))
 116                         (time-signature . (extra-space . 0.0))
 117                         (first-note . (fixed-space . 0.0))))
 118         (X-extent . ,ly:axis-group-interface::width)
 119         (Y-extent . ,ly:axis-group-interface::height)
 120         (meta . ((class . Item)
 121                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
 122                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
 123                  (interfaces . (ambitus-interface
 124                                 axis-group-interface
 125                                 break-aligned-interface))))))
 126
 127     (AmbitusAccidental
 128      . (
 129         (direction . ,LEFT)
 130         (glyph-name-alist . ,standard-alteration-glyph-name-alist)
 131         (padding . 0.5)
 132         (side-axis . ,X)
 133         (stencil . ,ly:accidental-interface::print)
 134         (X-offset . ,ly:side-position-interface::x-aligned-side)
 135         (Y-extent . ,ly:accidental-interface::height)
 136         (meta . ((class . Item)
 137                  (interfaces . (accidental-interface
 138                                 break-aligned-interface
 139                                 font-interface
 140                                 side-position-interface))))))
 141
 142     (AmbitusLine
 143      . (
 144         (gap . 0.35)
 145         (stencil . ,ambitus::print)
 146         (thickness . 2)
 147         (X-offset . ,ly:self-alignment-interface::centered-on-x-parent)
 148         (meta . ((class . Item)
 149                  (interfaces . (ambitus-interface
 150                                 font-interface))))))
 151
 152     (AmbitusNoteHead
 153      . (
 154         (duration-log . 2)
 155         (glyph-name . ,note-head::calc-glyph-name)
 156         (stencil . ,ly:note-head::print)
 157         (Y-offset . ,ly:staff-symbol-referencer::callback)
 158         (meta . ((class . Item)
 159                  (interfaces . (ambitus-interface
 160                                 font-interface
 161                                 ledgered-interface
 162                                 note-head-interface
 163                                 rhythmic-head-interface
 164                                 staff-symbol-referencer-interface))))))
 165
 166     (Arpeggio
 167      . (
 168         (direction . ,LEFT)
 169         (padding . 0.5)
 170         (positions . ,ly:arpeggio::calc-positions)
 171         (script-priority . 0)
 172         (side-axis . ,X)
 173         (staff-position . 0.0)
 174         (stencil . ,ly:arpeggio::print)
 175         (X-extent . ,ly:arpeggio::width)
 176         (X-offset . ,ly:side-position-interface::x-aligned-side)
 177         (Y-offset . ,ly:staff-symbol-referencer::callback)
 178         (meta . ((class . Item)
 179                  (interfaces . (arpeggio-interface
 180                                 font-interface
 181                                 side-position-interface
 182                                 staff-symbol-referencer-interface))))))
 183
 184     (BalloonTextItem
 185      . (
 186         (annotation-balloon . #t)
 187         (annotation-line . #t)
 188         (stencil . ,ly:balloon-interface::print)
 189         (text . ,(grob::calc-property-by-copy 'text))
 190         (X-offset . ,(grob::calc-property-by-copy 'X-offset))
 191         (Y-offset . ,(grob::calc-property-by-copy 'Y-offset))
 192         (meta . ((class . Item)
 193                  (interfaces . (balloon-interface
 194                                 font-interface
 195                                 text-interface))))))
 196
 197     (BarLine
 198      . (
 199         (allow-span-bar . #t)
 200         (bar-extent . ,ly:bar-line::calc-bar-extent)
 201         (break-align-anchor . ,ly:bar-line::calc-anchor)
 202         (break-align-symbol . staff-bar)
 203         (break-visibility . ,bar-line::calc-break-visibility)
 204         (extra-spacing-height . ,pure-from-neighbor-interface::account-for-span-bar)
 205         (gap . 0.4)
 206         (glyph . "|")
 207         (glyph-name . ,bar-line::calc-glyph-name)
 208
 209         ;;
 210         ;; Ross. page 151 lists other values, we opt for a leaner look
 211         ;;
 212         ;; TODO:
 213         ;; kern should scale with line-thickness too.
 214         (kern . 3.0)
 215         (thin-kern . 3.0)
 216         (hair-thickness . 1.9)
 217         (thick-thickness . 6.0)
 218
 219         (layer . 0)
 220         (non-musical . #t)
 221         (rounded . #f)
 222         (space-alist . (
 223                         (time-signature . (extra-space . 0.75))
 224                         (custos . (minimum-space . 2.0))
 225                         (clef . (minimum-space . 1.0))
 226                         (key-signature . (extra-space . 1.0))
 227                         (key-cancellation . (extra-space . 1.0))
 228                         (first-note . (fixed-space . 1.3))
 229                         (next-note . (semi-fixed-space . 0.9))
 230                         (right-edge . (extra-space . 0.0))))
 231         (stencil . ,ly:bar-line::print)
 232         (meta . ((class . Item)
 233                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
 234                                       (pure-relevant-grobs . ,ly:pure-from-neighbor-interface::calc-pure-relevant-grobs)))
 235                  (interfaces . (bar-line-interface
 236                                 break-aligned-interface
 237                                 font-interface
 238                                 pure-from-neighbor-interface))))))
 239
 240     (BarNumber
 241      . (
 242         (after-line-breaking . ,ly:side-position-interface::move-to-extremal-staff)
 243         ;; want the bar number before the clef at line start.
 244         (break-align-symbols . (left-edge staff-bar))
 245
 246         (break-visibility . ,begin-of-line-visible)
 247         (direction . ,UP)
 248         (extra-spacing-width . (+inf.0 . -inf.0))
 249         (font-family . roman)
 250         (font-size . -2)
 251         (non-musical . #t)
 252         (outside-staff-priority . 100)
 253         (padding . 1.0)
 254         (self-alignment-X . ,RIGHT)
 255         (side-axis . ,Y)
 256         (stencil . ,ly:text-interface::print)
 257         (X-offset . ,(ly:make-simple-closure
 258                       `(,+
 259                         ,(ly:make-simple-closure
 260                           (list ly:break-alignable-interface::self-align-callback))
 261                         ,(ly:make-simple-closure
 262                           (list ly:self-alignment-interface::x-aligned-on-self)))))
 263         (Y-offset . ,ly:side-position-interface::y-aligned-side)
 264         (meta .
 265               ((class . Item)
 266                (interfaces . (break-alignable-interface
 267                               font-interface
 268                               self-alignment-interface
 269                               side-position-interface
 270                               text-interface))))))
 271
 272     (BassFigure
 273      . (
 274         (stencil . ,ly:text-interface::print)
 275         (meta . ((class . Item)
 276                  (interfaces . (bass-figure-interface
 277                                 font-interface
 278                                 rhythmic-grob-interface
 279                                 text-interface))))))
 280
 281     (BassFigureAlignment
 282      . (
 283         (axes . (,Y))
 284         (padding . 0.2)
 285         (positioning-done . ,ly:align-interface::align-to-minimum-distances)
 286         (stacking-dir . ,DOWN)
 287         (Y-extent . ,ly:axis-group-interface::height)
 288         (meta . ((class . Spanner)
 289                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
 290                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
 291                  (interfaces . (align-interface
 292                                 axis-group-interface
 293                                 bass-figure-alignment-interface))))))
 294
 295     (BassFigureAlignmentPositioning
 296      . (
 297         (axes . (,Y))
 298         (direction . ,UP)
 299         (padding . 0.5)
 300         (side-axis . ,Y)
 301         (staff-padding . 1.0)
 302         (Y-extent . ,ly:axis-group-interface::height)
 303         (Y-offset . ,ly:side-position-interface::y-aligned-side)
 304         (meta . ((class . Spanner)
 305                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
 306                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
 307                  (interfaces . (axis-group-interface
 308                                 side-position-interface))))))
 309
 310     (BassFigureBracket
 311      . (
 312         (edge-height . (0.2 . 0.2))
 313         (stencil . ,ly:enclosing-bracket::print)
 314         (X-extent . ,ly:enclosing-bracket::width)
 315         (meta . ((class . Item)
 316                  (interfaces . (enclosing-bracket-interface))))))
 317
 318     (BassFigureContinuation
 319      . (
 320         (stencil . ,ly:figured-bass-continuation::print)
 321         (Y-offset . ,ly:figured-bass-continuation::center-on-figures)
 322         (meta . ((class . Spanner)
 323                  (interfaces . (figured-bass-continuation-interface))))))
 324
 325     (BassFigureLine
 326      . (
 327         (adjacent-pure-heights . ,ly:axis-group-interface::adjacent-pure-heights)
 328         (axes . (,Y))
 329         (vertical-skylines . ,ly:axis-group-interface::calc-skylines)
 330         (Y-extent . ,ly:axis-group-interface::height)
 331         (meta . ((class . Spanner)
 332                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
 333                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
 334                  (interfaces . (axis-group-interface))))))
 335
 336
 337     (Beam
 338      . (
 339         ;; todo: clean this up a bit: the list is getting
 340         ;; rather long.
 341         (auto-knee-gap . 5.5)
 342         (beam-segments . ,ly:beam::calc-beam-segments)
 343         (beam-thickness . 0.48) ; in staff-space
 344
 345         ;; We have some unreferenced problems here.
 346         ;;
 347         ;; If we shorten beamed stems less than normal stems (1 staff-space),
 348         ;; or high order less than 8th beams, patterns like
 349         ;;     c''4 [c''8 c''] c''4 [c''16 c]
 350         ;; are ugly (different stem lengths).
 351         ;;
 352         ;; But if we shorten 16th beams as much as 8th beams, a single
 353         ;; forced 16th beam looks *very* short.
 354
 355         ;; We choose to shorten 8th beams the same as single stems,
 356         ;; and high order beams less than 8th beams, so that all
 357         ;; isolated shortened beams look nice and a bit shortened,
 358         ;; sadly possibly breaking patterns with high order beams.
 359         (beamed-stem-shorten . (1.0 0.5 0.25))
 360
 361         (beaming . ,ly:beam::calc-beaming)
 362         (clip-edges . #t)
 363         (collision-interfaces . (beam-interface
 364                                  clef-interface
 365                                  flag-interface
 366                                  inline-accidental-interface
 367                                  key-signature-interface
 368                                  note-head-interface
 369                                  octavate-eight-interface
 370                                  stem-interface
 371                                  time-signature-interface))
 372         (cross-staff . ,ly:beam::calc-cross-staff)
 373         (damping . 1)
 374         (details
 375          .(
 376            (secondary-beam-demerit . 10)
 377            (stem-length-demerit-factor . 5)
 378            (region-size . 2)
 379            (beam-eps . 0.001)
 380            (stem-length-limit-penalty . 5000)
 381            (damping-direction-penalty . 800)
 382            (hint-direction-penalty . 20)
 383            (musical-direction-factor . 400)
 384            (ideal-slope-factor . 10)
 385            (collision-penalty . 500)
 386            (collision-padding . 0.35)
 387            (round-to-zero-slope . 0.02)))
 388         (direction . ,ly:beam::calc-direction)
 389
 390         (normalized-endpoints . ,ly:spanner::calc-normalized-endpoints)
 391         ;; only for debugging.
 392         (font-family . roman)
 393
 394         (beam-gap . ,ly:beam::calc-beam-gap)
 395         (minimum-length . ,ly:beam::calc-minimum-length)
 396         (neutral-direction . ,DOWN)
 397         (positions . ,beam::get-positions)
 398         (springs-and-rods . ,ly:beam::calc-springs-and-rods)
 399         (X-positions . ,ly:beam::calc-x-positions)
 400
 401         ;; this is a hack to set stem lengths, if positions is set.
 402         (quantized-positions . ,beam::get-quantized-positions)
 403
 404         (shorten . ,ly:beam::calc-stem-shorten)
 405         (vertical-skylines . ,ly:grob::vertical-skylines-from-stencil)
 406         (stencil . ,ly:beam::print)
 407
 408         (meta . ((class . Spanner)
 409                  (object-callbacks . ((normal-stems . ,ly:beam::calc-normal-stems)))
 410                  (interfaces . (beam-interface
 411                                 font-interface
 412                                 staff-symbol-referencer-interface
 413                                 unbreakable-spanner-interface))))))
 414
 415     (BendAfter
 416      . (
 417         (minimum-length . 0.5)
 418         (stencil . ,bend::print)
 419         (thickness . 2.0)
 420         (meta . ((class . Spanner)
 421                  (interfaces . (bend-after-interface
 422                                 spanner-interface))))))
 423
 424     (BreakAlignGroup
 425      . (
 426         (axes . (,X))
 427         (break-align-anchor . ,ly:break-aligned-interface::calc-average-anchor)
 428         (break-visibility . ,ly:break-aligned-interface::calc-break-visibility)
 429         (X-extent . ,ly:axis-group-interface::width)
 430         (meta . ((class . Item)
 431                  (interfaces . (axis-group-interface
 432                                 break-aligned-interface))))))
 433
 434     (BreakAlignment
 435      . (
 436         (axes . (,X))
 437         (break-align-orders . ;; end of line
 438                             #((
 439                                left-edge
 440                                cue-end-clef
 441                                ambitus
 442                                breathing-sign
 443                                clef
 444                                cue-clef
 445                                staff-bar
 446                                key-cancellation
 447                                key-signature
 448                                time-signature
 449                                custos)
 450
 451                               ;; unbroken
 452                               (
 453                                left-edge
 454                                cue-end-clef
 455                                ambitus
 456                                breathing-sign
 457                                clef
 458                                cue-clef
 459                                staff-bar
 460                                key-cancellation
 461                                key-signature
 462                                time-signature
 463                                custos)
 464
 465                               ;; begin of line
 466                               (
 467                                left-edge
 468                                ambitus
 469                                breathing-sign
 470                                clef
 471                                key-cancellation
 472                                key-signature
 473                                staff-bar
 474                                time-signature
 475                                cue-clef
 476                                custos)))
 477         (non-musical . #t)
 478         (positioning-done . ,ly:break-alignment-interface::calc-positioning-done)
 479         (stacking-dir . 1)
 480         (X-extent . ,ly:axis-group-interface::width)
 481         (meta . ((class . Item)
 482                  (interfaces . (axis-group-interface
 483                                 break-alignment-interface))))))
 484
 485     (BreathingSign
 486      . (
 487         (break-align-symbol . breathing-sign)
 488         (break-visibility . ,begin-of-line-invisible)
 489         (non-musical . #t)
 490         (space-alist . (
 491                         (ambitus . (extra-space . 2.0))
 492                         (custos . (minimum-space . 1.0))
 493                         (key-signature . (minimum-space . 1.5))
 494                         (time-signature . (minimum-space . 1.5))
 495                         (staff-bar . (minimum-space . 1.5))
 496                         (clef . (minimum-space . 2.0))
 497                         (cue-clef . (minimum-space . 2.0))
 498                         (cue-end-clef . (minimum-space . 2.0))
 499                         (first-note . (fixed-space . 1.0)) ;huh?
 500                         (right-edge . (extra-space . 0.1))))
 501         (stencil . ,ly:text-interface::print)
 502         (text . ,(make-musicglyph-markup "scripts.rcomma"))
 503         (Y-offset . ,ly:breathing-sign::offset-callback)
 504         (meta . ((class . Item)
 505                  (interfaces . (break-aligned-interface
 506                                 breathing-sign-interface
 507                                 font-interface
 508                                 text-interface))))))
 509
 510     (ChordName
 511      . (
 512         (after-line-breaking . ,ly:chord-name::after-line-breaking)
 513         (font-family . sans)
 514         (font-size . 1.5)
 515         (stencil . ,ly:text-interface::print)
 516         (extra-spacing-height . (0.2 . -0.2))
 517         (extra-spacing-width . (-0.5 . 0.5))
 518         (word-space . 0.0)
 519         (meta . ((class . Item)
 520                  (interfaces . (chord-name-interface
 521                                 font-interface
 522                                 rhythmic-grob-interface
 523                                 text-interface))))))
 524
 525     (Clef
 526      . (
 527         (avoid-slur . inside)
 528         (break-align-anchor . ,ly:break-aligned-interface::calc-extent-aligned-anchor)
 529         (break-align-symbol . clef)
 530         (break-visibility . ,begin-of-line-visible)
 531         (extra-spacing-height . ,pure-from-neighbor-interface::extra-spacing-height-at-beginning-of-line)
 532         (glyph-name . ,ly:clef::calc-glyph-name)
 533         (non-musical . #t)
 534         (space-alist . ((cue-clef . (extra-space . 2.0))
 535                         (staff-bar . (extra-space . 0.7))
 536                         (key-cancellation . (minimum-space . 3.5))
 537                         (key-signature . (minimum-space . 3.5))
 538                         (time-signature . (minimum-space . 4.2))
 539                         (first-note . (minimum-fixed-space . 5.0))
 540                         (next-note . (extra-space . 1.0))
 541                         (right-edge . (extra-space . 0.5))))
 542         (stencil . ,ly:clef::print)
 543         (vertical-skylines . ,ly:grob::vertical-skylines-from-stencil)
 544         (Y-offset . ,ly:staff-symbol-referencer::callback)
 545         (meta . ((class . Item)
 546                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
 547                                       (pure-relevant-grobs . ,ly:pure-from-neighbor-interface::calc-pure-relevant-grobs)))
 548                  (interfaces . (break-aligned-interface
 549                                 clef-interface
 550                                 font-interface
 551                                 pure-from-neighbor-interface
 552                                 staff-symbol-referencer-interface))))))
 553
 554     (ClusterSpanner
 555      . (
 556         (cross-staff . ,ly:cluster::calc-cross-staff)
 557         (minimum-length . 0.0)
 558         (padding . 0.25)
 559         (springs-and-rods . ,ly:spanner::set-spacing-rods)
 560         (stencil . ,ly:cluster::print)
 561         (style . ramp)
 562         (meta . ((class . Spanner)
 563                  (interfaces . (cluster-interface))))))
 564
 565     (ClusterSpannerBeacon
 566      . (
 567         (Y-extent . ,ly:cluster-beacon::height)
 568         (meta . ((class . Item)
 569                  (interfaces . (cluster-beacon-interface
 570                                 rhythmic-grob-interface))))))
 571
 572     (CombineTextScript
 573      . (
 574         (avoid-slur . outside)
 575         (baseline-skip . 2)
 576         (direction . ,UP)
 577         (extra-spacing-width . (+inf.0 . -inf.0))
 578         (font-series . bold)
 579         (outside-staff-priority . 450)
 580         (padding . 0.5)
 581         (script-priority . 200)
 582         (side-axis . ,Y)
 583         (staff-padding . 0.5)
 584         ;; todo: add X self alignment?
 585         (stencil . ,ly:text-interface::print)
 586         (X-offset . ,ly:self-alignment-interface::x-aligned-on-self)
 587         (Y-offset . ,ly:side-position-interface::y-aligned-side)
 588         (meta . ((class . Item)
 589                  (interfaces . (font-interface
 590                                 side-position-interface
 591                                 text-interface
 592                                 text-script-interface))))))
 593
 594     (CueClef
 595      . (
 596         (avoid-slur . inside)
 597         (break-align-anchor . ,ly:break-aligned-interface::calc-extent-aligned-anchor)
 598         (break-align-symbol . cue-clef)
 599         (break-visibility . ,begin-of-line-visible)
 600         (extra-spacing-height . ,pure-from-neighbor-interface::extra-spacing-height-at-beginning-of-line)
 601         (font-size . -4)
 602         (glyph-name . ,ly:clef::calc-glyph-name)
 603         (non-musical . #t)
 604         (full-size-change . #t)
 605         (space-alist . ((staff-bar . (minimum-space . 2.7))
 606                         (key-cancellation . (minimum-space . 3.5))
 607                         (key-signature . (minimum-space . 3.5))
 608                         (time-signature . (minimum-space . 4.2))
 609                         (custos . (minimum-space . 0.0))
 610                         (first-note . (minimum-fixed-space . 3.0))
 611                         (next-note . (extra-space . 1.0))
 612                         (right-edge . (extra-space . 0.5))))
 613         (stencil . ,ly:clef::print)
 614         (Y-offset . ,ly:staff-symbol-referencer::callback)
 615         (meta . ((class . Item)
 616                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
 617                                       (pure-relevant-grobs . ,ly:pure-from-neighbor-interface::calc-pure-relevant-grobs)))
 618                  (interfaces . (break-aligned-interface
 619                                 clef-interface
 620                                 font-interface
 621                                 pure-from-neighbor-interface
 622                                 staff-symbol-referencer-interface))))))
 623
 624     (CueEndClef
 625      . (
 626         (avoid-slur . inside)
 627         (break-align-anchor . ,ly:break-aligned-interface::calc-extent-aligned-anchor)
 628         (break-align-symbol . cue-end-clef)
 629         (break-visibility . ,begin-of-line-invisible)
 630         (extra-spacing-height . ,pure-from-neighbor-interface::extra-spacing-height-at-beginning-of-line)
 631         (font-size . -4)
 632         (glyph-name . ,ly:clef::calc-glyph-name)
 633         (non-musical . #t)
 634         (full-size-change . #t)
 635         (space-alist . ((clef . (extra-space . 0.7))
 636                         (cue-clef . (extra-space . 0.7))
 637                         (staff-bar . (extra-space . 0.7))
 638                         (key-cancellation . (minimum-space . 3.5))
 639                         (key-signature . (minimum-space . 3.5))
 640                         (time-signature . (minimum-space . 4.2))
 641                         (first-note . (minimum-fixed-space . 5.0))
 642                         (next-note . (extra-space . 1.0))
 643                         (right-edge . (extra-space . 0.5))))
 644         (stencil . ,ly:clef::print)
 645         (Y-offset . ,ly:staff-symbol-referencer::callback)
 646         (meta . ((class . Item)
 647                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
 648                                       (pure-relevant-grobs . ,ly:pure-from-neighbor-interface::calc-pure-relevant-grobs)))
 649                  (interfaces . (break-aligned-interface
 650                                 clef-interface
 651                                 font-interface
 652                                 pure-from-neighbor-interface
 653                                 staff-symbol-referencer-interface))))))
 654
 655     (Custos
 656      . (
 657         (break-align-symbol . custos)
 658         (break-visibility . ,end-of-line-visible)
 659         (neutral-direction . ,DOWN)
 660         (non-musical . #t)
 661         (space-alist . (
 662                         (first-note . (minimum-fixed-space . 0.0))
 663                         (right-edge . (extra-space . 0.1))))
 664         (stencil . ,ly:custos::print)
 665         (style . vaticana)
 666         (Y-offset . ,ly:staff-symbol-referencer::callback)
 667         (meta . ((class . Item)
 668                  (interfaces  . (break-aligned-interface
 669                                  custos-interface
 670                                  font-interface
 671                                  staff-symbol-referencer-interface))))))
 672
 673     (DotColumn
 674      . (
 675         (axes . (,X))
 676         (direction . ,RIGHT)
 677         (positioning-done . ,ly:dot-column::calc-positioning-done)
 678         (X-extent . ,ly:axis-group-interface::width)
 679         (meta . ((class . Item)
 680                  (interfaces . (axis-group-interface
 681                                 dot-column-interface))))))
 682
 683     (Dots
 684      . (
 685         (avoid-slur . inside)
 686         (dot-count . ,dots::calc-dot-count)
 687         (staff-position . ,dots::calc-staff-position)
 688         (stencil . ,ly:dots::print)
 689         (extra-spacing-height . (-0.5 . 0.5))
 690         (meta . ((class . Item)
 691                  (interfaces . (dots-interface
 692                                 font-interface
 693                                 staff-symbol-referencer-interface))))))
 694
 695     (DoublePercentRepeat
 696      . (
 697         (break-align-symbol . staff-bar)
 698         (break-visibility . ,begin-of-line-invisible)
 699         (dot-negative-kern . 0.75)
 700         (font-encoding . fetaMusic)
 701         (non-musical . #t)
 702         (slash-negative-kern . 1.6)
 703         (slope . 1.0)
 704         (stencil . ,ly:percent-repeat-item-interface::double-percent)
 705         (thickness . 0.48)
 706         (meta . ((class . Item)
 707                  (interfaces . (break-aligned-interface
 708                                 font-interface
 709                                 percent-repeat-interface
 710                                 percent-repeat-item-interface))))))
 711
 712     (DoublePercentRepeatCounter
 713      . (
 714         (direction . ,UP)
 715         (font-encoding . fetaText)
 716         (font-size . -2)
 717         (padding . 0.2)
 718         (self-alignment-X . ,CENTER)
 719         (side-axis . ,Y)
 720         (staff-padding . 0.25)
 721         (stencil . ,ly:text-interface::print)
 722         (X-offset . ,(ly:make-simple-closure
 723                       `(,+
 724                         ,(ly:make-simple-closure
 725                           (list ly:self-alignment-interface::centered-on-y-parent))
 726                         ,(ly:make-simple-closure
 727                           (list ly:self-alignment-interface::x-aligned-on-self)))))
 728         (Y-offset . ,ly:side-position-interface::y-aligned-side)
 729         (meta . ((class . Item)
 730                  (interfaces . (font-interface
 731                                 percent-repeat-interface
 732                                 percent-repeat-item-interface
 733                                 self-alignment-interface
 734                                 side-position-interface
 735                                 text-interface))))))
 736
 737     (DoubleRepeatSlash
 738      . (
 739         (dot-negative-kern . 0.75)
 740         (font-encoding . fetaMusic)
 741         (slash-negative-kern . 1.6)
 742         (slope . 1.0)
 743         (stencil . ,ly:percent-repeat-item-interface::beat-slash)
 744         (thickness . 0.48)
 745         (meta . ((class . Item)
 746                  (interfaces . (font-interface
 747                                 percent-repeat-interface
 748                                 percent-repeat-item-interface
 749                                 rhythmic-grob-interface))))))
 750
 751     (DynamicLineSpanner
 752      . (
 753         (axes . (,Y))
 754         (cross-staff . ,ly:side-position-interface::calc-cross-staff)
 755         (direction . ,DOWN)
 756         (minimum-space . 1.2)
 757         (outside-staff-priority . 250)
 758         (padding . 0.6)
 759         (side-axis . ,Y)
 760         (slur-padding . 0.3)
 761         (staff-padding . 0.1)
 762         (vertical-skylines . ,ly:grob::vertical-skylines-from-element-stencils)
 763         (use-skylines . #t)
 764         (X-extent . ,ly:axis-group-interface::width)
 765         (Y-extent . ,ly:axis-group-interface::height)
 766         (Y-offset . ,ly:side-position-interface::y-aligned-side)
 767         (meta . ((class . Spanner)
 768                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
 769                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
 770                  (interfaces . (axis-group-interface
 771                                 dynamic-interface
 772                                 dynamic-line-spanner-interface
 773                                 side-position-interface))))))
 774
 775     (DynamicText
 776      . (
 777
 778         ;; todo.
 779
 780         (collision-bias . -2.0)
 781         (collision-padding . 0.5)
 782         (direction . ,ly:script-interface::calc-direction)
 783         (extra-spacing-width . (+inf.0 . -inf.0))
 784         (font-encoding . fetaText)
 785         (font-series . bold)
 786         (font-shape . italic)
 787         (positioning-done . ,ly:script-interface::calc-positioning-done)
 788         (right-padding . 0.5)
 789         (self-alignment-X . ,CENTER)
 790         (self-alignment-Y . ,CENTER)
 791         (stencil . ,ly:text-interface::print)
 792         (vertical-skylines . ,ly:grob::vertical-skylines-from-stencil)
 793         (X-offset . ,ly:self-alignment-interface::x-aligned-on-self)
 794         (Y-offset . ,ly:self-alignment-interface::y-aligned-on-self)
 795         (meta . ((class . Item)
 796                  (object-callbacks . ((X-colliding-grobs . ,ly:self-alignment-interface::x-colliding-grobs)))
 797                  (interfaces . (dynamic-interface
 798                                 dynamic-text-interface
 799                                 font-interface
 800                                 script-interface
 801                                 self-alignment-interface
 802                                 text-interface))))))
 803
 804     (DynamicTextSpanner
 805      . (
 806         (before-line-breaking . ,dynamic-text-spanner::before-line-breaking)
 807         (bound-details . ((right . ((attach-dir .  ,LEFT)
 808                                     (Y . 0)
 809                                     (padding . 0.75)
 810                                     ))
 811                           (right-broken . ((attach-dir .  ,RIGHT)
 812                                     (padding . 0.0)
 813                                     ))
 814
 815                           (left . ((attach-dir .  ,LEFT)
 816                                    (Y . 0)
 817                                    (stencil-offset . (-0.75 . -0.5))
 818                                    (padding . 0.75)
 819                                    ))
 820                           (left-broken . ((attach-dir .  ,RIGHT)
 821                                    ))
 822                           ))
 823         (dash-fraction . 0.2)
 824         (dash-period . 3.0)
 825
 826         ;; rather ugh with NCSB
 827         ;; (font-series . bold)
 828         (font-shape . italic)
 829
 830         ;; need to blend with dynamic texts.
 831         (font-size . 1)
 832
 833         (left-bound-info . ,ly:line-spanner::calc-left-bound-info-and-text)
 834
 835         (minimum-length . 2.0)
 836         ;; make sure the spanner doesn't get too close to notes
 837         (minimum-Y-extent . (-1 . 1))
 838
 839         (right-bound-info . ,ly:line-spanner::calc-right-bound-info)
 840         (springs-and-rods . ,ly:spanner::set-spacing-rods)
 841         (stencil . ,ly:line-spanner::print)
 842         (style . dashed-line)
 843         (vertical-skylines . ,ly:grob::vertical-skylines-from-stencil)
 844         (meta . ((class . Spanner)
 845                  (interfaces . (dynamic-interface
 846                                 dynamic-text-spanner-interface
 847                                 font-interface
 848                                 line-interface
 849                                 line-spanner-interface
 850                                 spanner-interface
 851                                 text-interface))))))
 852
 853
 854     (Episema
 855      . (
 856         (bound-details . ((left . ((Y . 0)
 857                                    (padding . 0)
 858                                    (attach-dir . ,LEFT)
 859                                    ))
 860                           (right . ((Y . 0)
 861                                     (padding . 0)
 862                                     (attach-dir . ,RIGHT)
 863                                     ))
 864                           ))
 865         (direction . ,UP)
 866         (left-bound-info . ,ly:line-spanner::calc-left-bound-info)
 867         (quantize-position . #t)
 868         (right-bound-info . ,ly:line-spanner::calc-right-bound-info)
 869         (side-axis . ,Y)
 870         (stencil . ,ly:line-spanner::print)
 871         (style . line)
 872         (Y-offset . ,ly:side-position-interface::y-aligned-side)
 873         (meta . ((class . Spanner)
 874                  (interfaces . (episema-interface
 875                                 font-interface
 876                                 line-interface
 877                                 line-spanner-interface
 878                                 side-position-interface))))))
 879
 880
 881     (Fingering
 882      . (
 883
 884         ;; sync with TextScript (?)
 885
 886         (avoid-slur . around)
 887         (cross-staff . ,script-or-side-position-cross-staff)
 888         (direction . ,ly:script-interface::calc-direction)
 889         (font-encoding . fetaText)
 890         (font-size . -5)                ; don't overlap when next to heads.
 891         (padding . 0.5)
 892         (positioning-done . ,ly:script-interface::calc-positioning-done)
 893         (script-priority . 100)
 894         (self-alignment-X . ,CENTER)
 895         (self-alignment-Y . ,CENTER)
 896         (slur-padding . 0.2)
 897         (staff-padding . 0.5)
 898         (stencil . ,ly:text-interface::print)
 899         (text . ,fingering::calc-text)
 900         (meta . ((class . Item)
 901                  (interfaces . (finger-interface
 902                                 font-interface
 903                                 self-alignment-interface
 904                                 side-position-interface
 905                                 text-interface
 906                                 text-script-interface))))))
 907
 908     (FingeringColumn
 909      . (
 910         (padding . 0.2)
 911         (positioning-done . ,ly:fingering-column::calc-positioning-done)
 912         (meta . ((class . Item)
 913                  (interfaces . (fingering-column-interface))))))
 914
 915     (Flag
 916      . (
 917         (glyph-name . ,ly:flag::glyph-name)
 918         (stencil . ,ly:flag::print)
 919         (X-extent . ,ly:flag::width)
 920         (X-offset . ,ly:flag::calc-x-offset)
 921         (Y-offset . ,ly:flag::calc-y-offset)
 922         (vertical-skylines . ,ly:grob::vertical-skylines-from-stencil)
 923         (meta . ((class . Item)
 924                  (interfaces . (flag-interface
 925                                 font-interface))))))
 926
 927     (FootnoteItem
 928      . (
 929         (annotation-balloon . #f)
 930         (annotation-line . #t)
 931         (automatically-numbered . ,(grob::calc-property-by-copy 'automatically-numbered))
 932         (break-visibility . ,inherit-y-parent-visibility)
 933         (footnote . #t)
 934         (footnote-text . ,(grob::calc-property-by-copy 'footnote-text))
 935         (stencil . ,ly:balloon-interface::print)
 936         (text . ,(grob::calc-property-by-copy 'text))
 937         (X-extent . #f)
 938         (Y-extent . #f)
 939         (X-offset . ,(grob::calc-property-by-copy 'X-offset))
 940         (Y-offset . ,(grob::calc-property-by-copy 'Y-offset))
 941         (meta . ((class . Item)
 942                  (interfaces . (balloon-interface
 943                                 footnote-interface
 944                                 font-interface
 945                                 text-interface))))))
 946
 947     (FootnoteSpanner
 948      . (
 949         (annotation-balloon . #f)
 950         (annotation-line . #t)
 951         (automatically-numbered . ,(grob::calc-property-by-copy 'automatically-numbered))
 952         (footnote . #t)
 953         (footnote-text . ,(grob::calc-property-by-copy 'footnote-text))
 954         (spanner-placement . ,LEFT)
 955         (stencil . ,ly:balloon-interface::print-spanner)
 956         (text . ,(grob::calc-property-by-copy 'text))
 957         (X-extent . #f)
 958         (Y-extent . #f)
 959         (X-offset . ,(grob::calc-property-by-copy 'X-offset))
 960         (Y-offset . ,(grob::calc-property-by-copy 'Y-offset))
 961         (meta . ((class . Spanner)
 962                  (interfaces . (balloon-interface
 963                                 footnote-interface
 964                                 footnote-spanner-interface
 965                                 font-interface
 966                                 text-interface))))))
 967
 968     (FretBoard
 969      . (
 970         (after-line-breaking . ,ly:chord-name::after-line-breaking)
 971         (fret-diagram-details . ((finger-code . below-string)))
 972         (stencil . ,fret-board::calc-stencil)
 973         (extra-spacing-height . (0.2 . -0.2))
 974         (extra-spacing-width . (-0.5 . 0.5))
 975         (meta . ((class . Item)
 976                  (interfaces . (chord-name-interface
 977                                 font-interface
 978                                 fret-diagram-interface
 979                                 rhythmic-grob-interface))))))
 980
 981
 982     (Glissando
 983      . (
 984         (after-line-breaking . ,ly:spanner::kill-zero-spanned-time)
 985         (bound-details . ((right . ((attach-dir .  ,LEFT)
 986                                     (end-on-accidental . #t)
 987                                     (padding . 0.5)
 988                                       ))
 989                           (left . ((attach-dir .  ,RIGHT)
 990                                    (padding . 0.5)
 991                                       ))
 992                           ))
 993         (cross-staff . ,ly:line-spanner::calc-cross-staff)
 994         (gap . 0.5)
 995         (left-bound-info . ,ly:line-spanner::calc-left-bound-info)
 996         (normalized-endpoints . ,ly:spanner::calc-normalized-endpoints)
 997         (right-bound-info . ,ly:line-spanner::calc-right-bound-info)
 998         (simple-Y . #t)
 999         (stencil . ,ly:line-spanner::print)
1000         (style . line)
1001         (vertical-skylines . ,ly:grob::vertical-skylines-from-stencil)
1002         (X-extent . #f)
1003         (Y-extent . #f)
1004         (zigzag-width . 0.75)
1005         (meta . ((class . Spanner)
1006                  (interfaces . (glissando-interface
1007                                 line-interface
1008                                 line-spanner-interface
1009                                 unbreakable-spanner-interface))))))
1010
1011     (GraceSpacing
1012      . (
1013         (common-shortest-duration . ,grace-spacing::calc-shortest-duration)
1014         (shortest-duration-space . 1.6)
1015         (spacing-increment . 0.8)
1016         (meta . ((class . Spanner)
1017                  (interfaces . (grace-spacing-interface
1018                                 spacing-options-interface
1019                                 spanner-interface))))))
1020
1021     (GridLine
1022      . (
1023         (layer . 0)
1024         (self-alignment-X . ,CENTER)
1025         (stencil . ,ly:grid-line-interface::print)
1026         (X-extent  . ,ly:grid-line-interface::width)
1027         (X-offset . ,(ly:make-simple-closure
1028                       `(,+
1029                         ,(ly:make-simple-closure
1030                           (list ly:self-alignment-interface::centered-on-x-parent))
1031                         ,(ly:make-simple-closure
1032                           (list ly:self-alignment-interface::x-aligned-on-self)))))
1033         (meta . ((class . Item)
1034                  (interfaces . (grid-line-interface
1035                                 self-alignment-interface))))))
1036
1037     (GridPoint
1038      . (
1039         (X-extent . (0 . 0))
1040         (Y-extent . (0 . 0))
1041         (meta . ((class . Item)
1042                  (interfaces . (grid-point-interface))))))
1043
1044
1045     (Hairpin
1046      . (
1047         (after-line-breaking . ,ly:spanner::kill-zero-spanned-time)
1048         (bound-padding . 1.0)
1049         (broken-bound-padding . ,ly:hairpin::broken-bound-padding)
1050         (circled-tip . #f)
1051         (grow-direction . ,hairpin::calc-grow-direction)
1052         (height . 0.6666)
1053         (minimum-length . 2.0)
1054         (self-alignment-Y . ,CENTER)
1055         (springs-and-rods . ,ly:spanner::set-spacing-rods)
1056         (stencil . ,ly:hairpin::print)
1057         (thickness . 1.0)
1058         (to-barline . #t)
1059         (vertical-skylines . ,ly:grob::vertical-skylines-from-stencil)
1060         (Y-offset . ,ly:self-alignment-interface::y-aligned-on-self)
1061         (meta . ((class . Spanner)
1062                  (interfaces . (dynamic-interface
1063                                 hairpin-interface
1064                                 line-interface
1065                                 self-alignment-interface
1066                                 spanner-interface))))))
1067
1068     (HorizontalBracket
1069      . (
1070         (bracket-flare . (0.5 . 0.5))
1071         (connect-to-neighbor . ,ly:tuplet-bracket::calc-connect-to-neighbors)
1072         (direction . ,DOWN)
1073         (padding . 0.2)
1074         (side-axis . ,Y)
1075         (staff-padding . 0.2)
1076         (stencil . ,ly:horizontal-bracket::print)
1077         (thickness . 1.0)
1078         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1079         (meta . ((class . Spanner)
1080                  (interfaces . (horizontal-bracket-interface
1081                                 line-interface
1082                                 side-position-interface
1083                                 spanner-interface))))))
1084
1085
1086     (InstrumentName
1087      . (
1088         (direction . ,LEFT)
1089         (padding . 0.3)
1090         (self-alignment-X . ,CENTER)
1091         (self-alignment-Y . ,CENTER)
1092         (stencil . ,system-start-text::print)
1093         (X-offset . ,system-start-text::calc-x-offset)
1094         (Y-offset . ,system-start-text::calc-y-offset)
1095         (meta . ((class . Spanner)
1096                  (interfaces . (font-interface
1097                                 self-alignment-interface
1098                                 side-position-interface
1099                                 system-start-text-interface))))))
1100
1101     (InstrumentSwitch
1102      . (
1103         (direction . ,UP)
1104         (extra-spacing-width . (+inf.0 . -inf.0))
1105         (outside-staff-priority . 500)
1106         (padding . 0.5)
1107         (self-alignment-X . ,LEFT)
1108         (side-axis . ,Y)
1109         (staff-padding . 0.5)
1110         (stencil . ,ly:text-interface::print)
1111         (X-offset . ,ly:self-alignment-interface::x-aligned-on-self)
1112         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1113         (meta . ((class . Item)
1114                  (interfaces . (font-interface
1115                                 self-alignment-interface
1116                                 side-position-interface
1117                                 text-interface))))))
1118
1119
1120     (KeyCancellation
1121      . (
1122         (break-align-symbol . key-cancellation)
1123         (break-visibility . ,begin-of-line-invisible)
1124         (glyph-name-alist . ,cancellation-glyph-name-alist)
1125         (non-musical . #t)
1126         (flat-positions . (2 3 4 2 1 2 1))
1127         (sharp-positions . (4 5 4 2 3 2 3))
1128         (space-alist . (
1129                         (time-signature . (extra-space . 1.25))
1130                         (staff-bar . (extra-space . 0.6))
1131                         (key-signature . (extra-space . 0.5))
1132                         (cue-clef . (extra-space . 0.5))
1133                         (right-edge . (extra-space . 0.5))
1134                         (first-note . (fixed-space . 2.5))))
1135         (stencil . ,ly:key-signature-interface::print)
1136         (vertical-skylines . ,ly:grob::vertical-skylines-from-stencil)
1137         (extra-spacing-width . (0.0 . 1.0))
1138         (extra-spacing-height . ,pure-from-neighbor-interface::extra-spacing-height-including-staff)
1139         (Y-offset . ,ly:staff-symbol-referencer::callback)
1140         (meta . ((class . Item)
1141                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
1142                                       (pure-relevant-grobs . ,ly:pure-from-neighbor-interface::calc-pure-relevant-grobs)))
1143                  (interfaces . (break-aligned-interface
1144                                 font-interface
1145                                 key-cancellation-interface
1146                                 key-signature-interface
1147                                 pure-from-neighbor-interface
1148                                 staff-symbol-referencer-interface))))))
1149
1150     (KeySignature
1151      . (
1152         (avoid-slur . inside)
1153         (break-align-anchor . ,ly:break-aligned-interface::calc-extent-aligned-anchor)
1154         (break-align-symbol . key-signature)
1155         (break-visibility . ,begin-of-line-visible)
1156         (glyph-name-alist . ,standard-alteration-glyph-name-alist)
1157         (non-musical . #t)
1158         (flat-positions . (2 3 4 2 1 2 1))
1159         (sharp-positions . (4 5 4 2 3 2 3))
1160         (space-alist . (
1161                         (time-signature . (extra-space . 1.15))
1162                         (staff-bar . (extra-space . 1.1))
1163                         (cue-clef . (extra-space . 0.5))
1164                         (right-edge . (extra-space . 0.5))
1165                         (first-note . (fixed-space . 2.5))))
1166         (stencil . ,ly:key-signature-interface::print)
1167         (extra-spacing-width . (0.0 . 1.0))
1168         (extra-spacing-height . ,pure-from-neighbor-interface::extra-spacing-height-including-staff)
1169         (vertical-skylines . ,ly:grob::vertical-skylines-from-stencil)
1170         (Y-offset . ,ly:staff-symbol-referencer::callback)
1171         (meta . ((class . Item)
1172                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
1173                                       (pure-relevant-grobs . ,ly:pure-from-neighbor-interface::calc-pure-relevant-grobs)))
1174                  (interfaces . (break-aligned-interface
1175                                 font-interface
1176                                 key-signature-interface
1177                                 pure-from-neighbor-interface
1178                                 staff-symbol-referencer-interface))))))
1179
1180
1181    (LaissezVibrerTie
1182      . (
1183         (control-points . ,ly:semi-tie::calc-control-points)
1184         (details . ((ratio . 0.333)
1185                     (height-limit . 1.0)))
1186         (direction . ,ly:tie::calc-direction)
1187         (head-direction . ,LEFT)
1188         (stencil  . ,laissez-vibrer::print)
1189         (thickness . 1.0)
1190         (extra-spacing-height . (-0.5 . 0.5))
1191         (vertical-skylines . ,ly:grob::vertical-skylines-from-stencil)
1192         (meta . ((class . Item)
1193                  (interfaces . (semi-tie-interface))))))
1194
1195     (LaissezVibrerTieColumn
1196      . (
1197         (head-direction . ,ly:semi-tie-column::calc-head-direction)
1198         (positioning-done . ,ly:semi-tie-column::calc-positioning-done)
1199         (X-extent . #f)
1200         (Y-extent . #f)
1201         (meta . ((class . Item)
1202                  (interfaces . (semi-tie-column-interface))))))
1203
1204     (LedgerLineSpanner
1205      . (
1206         (layer . 0)
1207         (length-fraction . 0.25)
1208         (minimum-length-fraction . 0.25)
1209         (springs-and-rods . ,ly:ledger-line-spanner::set-spacing-rods)
1210         (stencil . ,ly:ledger-line-spanner::print)
1211         (vertical-skylines . ,ly:grob::vertical-skylines-from-stencil)
1212         (X-extent . #f)
1213         (Y-extent . #f)
1214         (meta . ((class . Spanner)
1215                  (interfaces . (ledger-line-spanner-interface))))))
1216
1217     (LeftEdge
1218      . (
1219         (break-align-anchor . ,ly:break-aligned-interface::calc-extent-aligned-anchor)
1220         (break-align-symbol . left-edge)
1221         (break-visibility . ,center-invisible)
1222         (non-musical . #t)
1223         (extra-spacing-height . (+inf.0 . -inf.0))
1224         (space-alist . (
1225                         (ambitus . (extra-space . 2.0))
1226                         (breathing-sign . (minimum-space . 0.0))
1227                         (cue-end-clef . (extra-space . 0.8))
1228                         (clef . (extra-space . 0.8))
1229                         (cue-clef . (extra-space . 0.8))
1230                         (staff-bar . (extra-space . 0.0))
1231                         (key-cancellation . (extra-space . 0.0))
1232                         (key-signature . (extra-space . 0.8))
1233                         (time-signature . (extra-space . 1.0))
1234                         (custos . (extra-space . 0.0))
1235                         (first-note . (fixed-space . 2.0))
1236                         (right-edge . (extra-space . 0.0))
1237                         ))
1238         (X-extent . (0 . 0))
1239         (meta . ((class . Item)
1240                  (interfaces . (break-aligned-interface))))))
1241
1242     (LigatureBracket
1243      . (
1244         ;; ugh.  A ligature bracket is totally different from
1245         ;; a tuplet bracket.
1246
1247         (connect-to-neighbor . ,ly:tuplet-bracket::calc-connect-to-neighbors)
1248         (direction . ,UP)
1249         (edge-height . (0.7 . 0.7))
1250         (padding . 2.0)
1251         (positions . ,ly:tuplet-bracket::calc-positions)
1252         (shorten-pair . (-0.2 . -0.2))
1253         (staff-padding . 0.25)
1254         (stencil . ,ly:tuplet-bracket::print)
1255         (thickness . 1.6)
1256         (X-positions . ,ly:tuplet-bracket::calc-x-positions)
1257         (meta . ((class . Spanner)
1258                  (interfaces . (line-interface
1259                                 tuplet-bracket-interface))))))
1260
1261     (LyricExtender
1262      . (
1263         (minimum-length . 1.5)
1264         (stencil . ,ly:lyric-extender::print)
1265         (thickness . 0.8) ; line-thickness
1266         (Y-extent . (0 . 0))
1267         (meta . ((class . Spanner)
1268                  (interfaces . (lyric-extender-interface
1269                                 lyric-interface))))))
1270
1271     (LyricHyphen
1272      . (
1273         (after-line-breaking . ,ly:spanner::kill-zero-spanned-time)
1274         (dash-period . 10.0)
1275         (height . 0.42)
1276         (length . 0.66)
1277         (minimum-distance . 0.1)
1278         (minimum-length . 0.3)
1279         (padding . 0.07)
1280         (springs-and-rods . ,ly:lyric-hyphen::set-spacing-rods)
1281         (stencil . ,ly:lyric-hyphen::print)
1282         (vertical-skylines . ,ly:grob::vertical-skylines-from-stencil)
1283         (thickness . 1.3)
1284         (Y-extent . (0 . 0))
1285         (meta . ((class . Spanner)
1286                  (interfaces . (font-interface
1287                                 lyric-hyphen-interface
1288                                 lyric-interface
1289                                 spanner-interface))))))
1290
1291     (LyricSpace
1292      . (
1293         (minimum-distance . 0.45)
1294         (padding . 0.0)
1295         (springs-and-rods . ,ly:lyric-hyphen::set-spacing-rods)
1296         (X-extent . #f)
1297         (Y-extent . #f)
1298         (meta . ((class . Spanner)
1299                  (interfaces . (lyric-hyphen-interface
1300                                 spanner-interface))))))
1301
1302     (LyricText
1303      . (
1304         (extra-spacing-width . (0.0 . 0.0))
1305         ;; Recede in height for purposes of note spacing,
1306         ;; so notes in melismata can be freely spaced above lyrics
1307         (extra-spacing-height . (0.2 . -0.2))
1308         (font-series . medium)
1309         (font-size . 1.0)
1310         (self-alignment-X . ,CENTER)
1311         (stencil . ,lyric-text::print)
1312         (text . ,(grob::calc-property-by-copy 'text))
1313         (word-space . 0.6)
1314         (skyline-horizontal-padding . 0.1)
1315         (vertical-skylines . ,ly:grob::vertical-skylines-from-stencil)
1316         (X-offset . ,ly:self-alignment-interface::aligned-on-x-parent)
1317         (meta . ((class . Item)
1318                  (interfaces . (font-interface
1319                                 lyric-syllable-interface
1320                                 rhythmic-grob-interface
1321                                 self-alignment-interface
1322                                 text-interface))))))
1323
1324     (MeasureGrouping
1325      . (
1326         (direction . ,UP)
1327         (height . 2.0)
1328         (padding . 2)
1329         (side-axis . ,Y)
1330         (staff-padding . 3)
1331         (stencil . ,ly:measure-grouping::print)
1332         (thickness . 1)
1333         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1334         (meta . ((class . Spanner)
1335                  (interfaces . (measure-grouping-interface
1336                                 side-position-interface))))))
1337
1338     (MelodyItem
1339      . (
1340         (neutral-direction . ,DOWN)
1341         (meta . ((class . Item)
1342                  (interfaces . (melody-spanner-interface))))))
1343
1344     (MensuralLigature
1345      . (
1346         (stencil . ,ly:mensural-ligature::print)
1347         (thickness . 1.3)
1348         (meta . ((class . Spanner)
1349                  (interfaces . (font-interface
1350                                 mensural-ligature-interface))))))
1351
1352     (MetronomeMark
1353      . (
1354         (after-line-breaking . ,ly:side-position-interface::move-to-extremal-staff)
1355         (break-visibility . ,end-of-line-invisible)
1356         (direction . ,UP)
1357         (extra-spacing-width . (+inf.0 . -inf.0))
1358         (outside-staff-horizontal-padding . 0.12)
1359         (outside-staff-priority . 1000)
1360         (padding . 0.8)
1361         (side-axis . ,Y)
1362         (stencil . ,ly:text-interface::print)
1363         (vertical-skylines . ,ly:grob::vertical-skylines-from-stencil)
1364         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1365         (X-offset . ,(ly:make-simple-closure
1366                       `(,+
1367                         ,(ly:make-simple-closure
1368                           (list ly:break-alignable-interface::self-align-callback))
1369                         ,(ly:make-simple-closure
1370                           (list ly:self-alignment-interface::x-aligned-on-self)))))
1371         (self-alignment-X . ,LEFT)
1372         (break-align-symbols . (time-signature))
1373         (non-break-align-symbols . (multi-measure-rest-interface))
1374         (meta . ((class . Item)
1375                  (interfaces . (break-alignable-interface
1376                                 font-interface
1377                                 metronome-mark-interface
1378                                 self-alignment-interface
1379                                 side-position-interface
1380                                 text-interface))))))
1381
1382     (MultiMeasureRest
1383      . (
1384         (expand-limit . 10)
1385         (hair-thickness . 2.0)
1386         (round-up-exceptions . ())
1387         (padding . 1)
1388         (spacing-pair . (break-alignment . break-alignment))
1389         (springs-and-rods . ,ly:multi-measure-rest::set-spacing-rods)
1390         (stencil . ,ly:multi-measure-rest::print)
1391         (thick-thickness . 6.6)
1392         ;; See Wanske pp. 125
1393         (usable-duration-logs . ,(iota 4 -3))
1394         (Y-offset . ,ly:staff-symbol-referencer::callback)
1395         (meta . ((class . Spanner)
1396                  (interfaces . (font-interface
1397                                 multi-measure-interface
1398                                 multi-measure-rest-interface
1399                                 rest-interface
1400                                 staff-symbol-referencer-interface))))))
1401
1402     (MultiMeasureRestNumber
1403      . (
1404         (bound-padding  . 2.0)
1405         (direction . ,UP)
1406         (font-encoding . fetaText)
1407         (padding . 0.4)
1408         (self-alignment-X . ,CENTER)
1409         (side-axis . ,Y)
1410         (springs-and-rods . ,ly:multi-measure-rest::set-text-rods)
1411         (staff-padding . 0.4)
1412         (stencil . ,ly:text-interface::print)
1413         (X-offset . ,(ly:make-simple-closure
1414                       `(,+
1415                         ,(ly:make-simple-closure
1416                           (list ly:self-alignment-interface::x-aligned-on-self))
1417                         ,(ly:make-simple-closure
1418                           (list ly:self-alignment-interface::x-centered-on-y-parent)))))
1419         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1420         (meta . ((class . Spanner)
1421                  (interfaces . (font-interface
1422                                 multi-measure-interface
1423                                 self-alignment-interface
1424                                 side-position-interface
1425                                 text-interface))))))
1426
1427     (MultiMeasureRestText
1428      . (
1429         (direction . ,UP)
1430         (outside-staff-priority . 450)
1431         (padding . 0.2)
1432         (self-alignment-X . ,CENTER)
1433         (staff-padding . 0.25)
1434         (stencil . ,ly:text-interface::print)
1435         (X-offset . ,(ly:make-simple-closure
1436                       `(,+
1437                         ,(ly:make-simple-closure
1438                           (list ly:self-alignment-interface::x-centered-on-y-parent))
1439                         ,(ly:make-simple-closure
1440                           (list ly:self-alignment-interface::x-aligned-on-self)))))
1441         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1442         (meta . ((class . Spanner)
1443                  (interfaces . (font-interface
1444                                 multi-measure-interface
1445                                 self-alignment-interface
1446                                 side-position-interface
1447                                 text-interface))))))
1448
1449
1450     (NonMusicalPaperColumn
1451      . (
1452         (allow-loose-spacing . #t)
1453         (axes . (,X))
1454         (before-line-breaking . ,ly:paper-column::before-line-breaking)
1455         (bound-alignment-interfaces . (break-alignment-interface))
1456         (full-measure-extra-space . 1.0)
1457         (horizontal-skylines . ,ly:separation-item::calc-skylines)
1458         ;;                    (stencil . ,ly:paper-column::print)
1459
1460         (keep-inside-line . #t)
1461         (line-break-permission . allow)
1462         (non-musical . #t)
1463         (page-break-permission . allow)
1464
1465         ;; debugging stuff: print column number.
1466         ;;               (font-size . -6) (font-name . "sans")  (Y-extent . #f)
1467
1468         (X-extent . ,ly:axis-group-interface::width)
1469         (meta . ((class . Paper_column)
1470                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
1471                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
1472                  (interfaces . (axis-group-interface
1473                                 font-interface
1474                                 paper-column-interface
1475                                 separation-item-interface
1476                                 spaceable-grob-interface))))))
1477
1478     (NoteCollision
1479      . (
1480         (axes . (,X ,Y))
1481         (positioning-done . ,ly:note-collision-interface::calc-positioning-done)
1482         (prefer-dotted-right . #t)
1483         (X-extent . ,ly:axis-group-interface::width)
1484         (Y-extent . ,ly:axis-group-interface::height)
1485         (meta . ((class . Item)
1486                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
1487                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
1488                  (interfaces . (axis-group-interface
1489                                 note-collision-interface))))))
1490
1491     (NoteColumn
1492      . (
1493         (axes . (,X ,Y))
1494         (bound-alignment-interfaces . (rhythmic-head-interface stem-interface))
1495         (horizontal-skylines . ,ly:separation-item::calc-skylines)
1496         (skyline-vertical-padding . 0.15)
1497         (X-extent . ,ly:axis-group-interface::width)
1498         (Y-extent . ,ly:axis-group-interface::height)
1499         (meta . ((class . Item)
1500                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
1501                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
1502                  (interfaces . (axis-group-interface
1503                                 note-column-interface
1504                                 separation-item-interface))))))
1505
1506     (NoteHead
1507      . (
1508         (flexa-width . 2.0)
1509         (duration-log . ,note-head::calc-duration-log)
1510         (extra-spacing-height . ,ly:note-head::include-ledger-line-height)
1511         (glyph-name . ,note-head::calc-glyph-name)
1512         (ligature-flexa . #f)
1513         (stem-attachment . ,ly:note-head::calc-stem-attachment)
1514         (stencil . ,ly:note-head::print)
1515         (X-offset . ,ly:note-head::stem-x-shift)
1516         (Y-offset . ,ly:staff-symbol-referencer::callback)
1517         (meta . ((class . Item)
1518                  (interfaces . (font-interface
1519                                 gregorian-ligature-interface
1520                                 ledgered-interface
1521                                 ligature-head-interface
1522                                 mensural-ligature-interface
1523                                 note-head-interface
1524                                 rhythmic-grob-interface
1525                                 rhythmic-head-interface
1526                                 staff-symbol-referencer-interface
1527                                 vaticana-ligature-interface))))))
1528
1529     (NoteName
1530      . (
1531         (stencil . ,ly:text-interface::print)
1532         (meta . ((class . Item)
1533                  (interfaces . (font-interface
1534                                 note-name-interface
1535                                 text-interface))))))
1536
1537     (NoteSpacing
1538      . (
1539         ;; Changed this from 0.75.
1540         ;; If you ever change this back, please document! --hwn
1541         (knee-spacing-correction . 1.0)
1542         (same-direction-correction . 0.25)
1543         (space-to-barline . #t)
1544         (stem-spacing-correction . 0.5)
1545         (meta . ((class . Item)
1546                  (interfaces . (note-spacing-interface
1547                                 spacing-interface))))))
1548
1549
1550     (OctavateEight
1551      . (
1552         (break-visibility . ,inherit-x-parent-visibility)
1553         (font-shape . italic)
1554         (font-size . -4)
1555         (self-alignment-X . ,CENTER)
1556         (staff-padding . 0.2)
1557         (stencil . ,ly:text-interface::print)
1558         (X-offset . ,(ly:make-simple-closure
1559                       `(,+
1560                         ,(ly:make-simple-closure
1561                           (list ly:self-alignment-interface::x-aligned-on-self))
1562                         ,(ly:make-simple-closure
1563                           (list ly:self-alignment-interface::centered-on-x-parent)))))
1564         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1565         (meta . ((class . Item)
1566                  (interfaces . (font-interface
1567                                 octavate-eight-interface
1568                                 self-alignment-interface
1569                                 side-position-interface
1570                                 text-interface))))))
1571
1572     (OttavaBracket
1573      . (
1574         (dash-fraction . 0.3)
1575         (direction . ,UP)
1576         (edge-height . (0 . 1.2))
1577         (font-shape . italic)
1578         (minimum-length . 1.0)
1579         (outside-staff-priority . 400)
1580         (padding . 0.5)
1581         (shorten-pair . (0.0 . -0.6))
1582         (staff-padding . 1.0)
1583         (stencil . ,ly:ottava-bracket::print)
1584         (style . dashed-line)
1585         (vertical-skylines . ,ly:grob::vertical-skylines-from-stencil)
1586         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1587         (meta . ((class . Spanner)
1588                  (interfaces . (font-interface
1589                                 horizontal-bracket-interface
1590                                 line-interface
1591                                 ottava-bracket-interface
1592                                 side-position-interface
1593                                 text-interface))))))
1594
1595
1596     (PaperColumn
1597      . (
1598         (allow-loose-spacing . #t)
1599         (axes . (,X))
1600         (before-line-breaking . ,ly:paper-column::before-line-breaking)
1601         (bound-alignment-interfaces . (note-column-interface))
1602         (horizontal-skylines . ,ly:separation-item::calc-skylines)
1603         (keep-inside-line . #t)
1604         ; 0.08 comes from spacing-horizontal-skyline.ly
1605         ; allows double flat of F to be nestled over dots of C
1606         (skyline-vertical-padding . 0.08)
1607         ;; (stencil . ,ly:paper-column::print)
1608         (X-extent . ,ly:axis-group-interface::width)
1609
1610         ;; debugging
1611         ;;                       (font-size . -6) (font-name . "sans") (Y-extent . #f)
1612         (meta . ((class . Paper_column)
1613                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
1614                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
1615                  (interfaces . (axis-group-interface
1616                                 font-interface
1617                                 paper-column-interface
1618                                 separation-item-interface
1619                                 spaceable-grob-interface))))))
1620
1621     (ParenthesesItem
1622      . (
1623         (font-size . -6)
1624         (padding . 0.2)
1625         (stencil . ,parentheses-item::print)
1626         (stencils . ,parentheses-item::calc-parenthesis-stencils)
1627         (meta . ((class . Item)
1628                  (interfaces . (font-interface
1629                                 parentheses-interface))))))
1630
1631     (PercentRepeat
1632      . (
1633         (dot-negative-kern . 0.75)
1634         (font-encoding . fetaMusic)
1635         (slope . 1.0)
1636         (spacing-pair . (break-alignment . staff-bar))
1637         (springs-and-rods . ,ly:multi-measure-rest::set-spacing-rods)
1638         (stencil . ,ly:multi-measure-rest::percent)
1639         (thickness . 0.48)
1640         (meta . ((class . Spanner)
1641                  (interfaces . (font-interface
1642                                 multi-measure-rest-interface
1643                                 percent-repeat-interface))))))
1644
1645     (PercentRepeatCounter
1646      . (
1647         (direction . ,UP)
1648         (font-encoding . fetaText)
1649         (font-size . -2)
1650         (padding . 0.2)
1651         (self-alignment-X . ,CENTER)
1652         (staff-padding . 0.25)
1653         (stencil . ,ly:text-interface::print)
1654         (X-offset . ,(ly:make-simple-closure
1655                       `(,+
1656                         ,(ly:make-simple-closure
1657                           (list ly:self-alignment-interface::x-centered-on-y-parent))
1658                         ,(ly:make-simple-closure
1659                           (list ly:self-alignment-interface::x-aligned-on-self)))))
1660         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1661         (meta . ((class . Spanner)
1662                  (interfaces . (font-interface
1663                                 percent-repeat-interface
1664                                 self-alignment-interface
1665                                 side-position-interface
1666                                 text-interface))))))
1667
1668     (PhrasingSlur
1669      . (
1670         (control-points . ,ly:slur::calc-control-points)
1671         (cross-staff . ,ly:slur::calc-cross-staff)
1672         (details . ,default-slur-details)
1673         (direction . ,ly:slur::calc-direction)
1674         (height-limit . 2.0)
1675         (minimum-length . 1.5)
1676         (ratio . 0.333)
1677         (spanner-id . "")
1678         (springs-and-rods . ,ly:spanner::set-spacing-rods)
1679         (stencil . ,ly:slur::print)
1680         (thickness . 1.1)
1681         (vertical-skylines . ,ly:slur::vertical-skylines)
1682         (Y-extent . ,ly:slur::height)
1683         (meta . ((class . Spanner)
1684                  (interfaces . (slur-interface))))))
1685
1686     ;; an example of a text spanner
1687     (PianoPedalBracket
1688      . (
1689         (bound-padding . 1.0)
1690         (bracket-flare . (0.5 . 0.5))
1691         (direction . ,DOWN)
1692         (edge-height . (1.0 . 1.0))
1693         (shorten-pair . (0.0 . 0.0))
1694         (stencil . ,ly:piano-pedal-bracket::print)
1695         (style . line)
1696         (thickness .  1.0)
1697         (vertical-skylines . ,ly:grob::vertical-skylines-from-stencil)
1698         (meta . ((class . Spanner)
1699                  (interfaces . (line-interface
1700                                 piano-pedal-bracket-interface
1701                                 piano-pedal-interface))))))
1702
1703
1704     (RehearsalMark
1705      . (
1706         (after-line-breaking . ,ly:side-position-interface::move-to-extremal-staff)
1707         (baseline-skip . 2)
1708         (break-align-symbols . (staff-bar clef))
1709         (break-visibility . ,end-of-line-invisible)
1710         (direction . ,UP)
1711         (extra-spacing-width . (+inf.0 . -inf.0))
1712         (font-size . 2)
1713         (non-musical . #t)
1714         (outside-staff-horizontal-padding . 0.12)
1715         (outside-staff-priority . 1500)
1716         (padding . 0.8)
1717         (self-alignment-X . ,CENTER)
1718         (stencil . ,ly:text-interface::print)
1719         (vertical-skylines . ,ly:grob::vertical-skylines-from-stencil)
1720         (X-offset . ,(ly:make-simple-closure
1721                       `(,+
1722                         ,(ly:make-simple-closure
1723                           (list ly:break-alignable-interface::self-align-callback))
1724                         ,(ly:make-simple-closure
1725                           (list ly:self-alignment-interface::x-aligned-on-self)))))
1726         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1727         (meta . ((class . Item)
1728                  (interfaces . (break-alignable-interface
1729                                 font-interface
1730                                 mark-interface
1731                                 self-alignment-interface
1732                                 side-position-interface
1733                                 text-interface))))))
1734
1735     (RepeatSlash
1736      . (
1737         (slash-negative-kern . 0.85)
1738         (slope . 1.7)
1739         (stencil . ,ly:percent-repeat-item-interface::beat-slash)
1740         (thickness . 0.48)
1741         (meta . ((class . Item)
1742                  (interfaces . (percent-repeat-interface
1743                                 percent-repeat-item-interface
1744                                 rhythmic-grob-interface))))))
1745
1746     (RepeatTie
1747      . (
1748         (control-points . ,ly:semi-tie::calc-control-points)
1749         (details . ((ratio . 0.333)
1750                     (height-limit . 1.0)))
1751         (direction . ,ly:tie::calc-direction)
1752         (head-direction . ,RIGHT)
1753         (stencil  . ,ly:tie::print)
1754         (thickness . 1.0)
1755         (extra-spacing-height . (-0.5 . 0.5))
1756         (vertical-skylines . ,ly:grob::vertical-skylines-from-stencil)
1757         (meta . ((class . Item)
1758                  (interfaces . (semi-tie-interface))))))
1759
1760     (RepeatTieColumn
1761      . (
1762         (direction . ,ly:tie::calc-direction)
1763         (head-direction . ,ly:semi-tie-column::calc-head-direction)
1764         (positioning-done . ,ly:semi-tie-column::calc-positioning-done)
1765         (X-extent . #f)
1766         (Y-extent . #f)
1767         (meta . ((class . Item)
1768                  (interfaces . (semi-tie-column-interface))))))
1769
1770     (Rest
1771      . (
1772         (cross-staff . ,ly:rest::calc-cross-staff)
1773         (duration-log . ,stem::calc-duration-log)
1774         (minimum-distance . 0.25)
1775         (stencil . ,ly:rest::print)
1776         (X-extent . ,ly:rest::width)
1777         (Y-extent . ,ly:rest::height)
1778         (Y-offset . ,ly:rest::y-offset-callback)
1779         (meta . ((class . Item)
1780                  (interfaces . (font-interface
1781                                 rest-interface
1782                                 rhythmic-grob-interface
1783                                 rhythmic-head-interface
1784                                 staff-symbol-referencer-interface))))))
1785
1786     (RestCollision
1787      . (
1788         (minimum-distance . 0.75)
1789         (positioning-done . ,ly:rest-collision::calc-positioning-done)
1790         (meta . ((class . Item)
1791                  (interfaces . (rest-collision-interface))))))
1792
1793
1794     (Script
1795      . (
1796         (add-stem-support . #t)
1797         (cross-staff . ,ly:script-interface::calc-cross-staff)
1798         (direction . ,ly:script-interface::calc-direction)
1799         (font-encoding . fetaMusic)
1800         (positioning-done . ,ly:script-interface::calc-positioning-done)
1801         (side-axis . ,Y)
1802
1803         ;; padding set in script definitions.
1804         (slur-padding . 0.2)
1805         (staff-padding . 0.25)
1806
1807         (stencil . ,ly:script-interface::print)
1808         (use-skylines . #t)
1809         (vertical-skylines . ,ly:grob::vertical-skylines-from-stencil)
1810         (X-offset . ,script-interface::calc-x-offset)
1811         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1812         (meta . ((class . Item)
1813                  (interfaces . (font-interface
1814                                 script-interface
1815                                 side-position-interface))))))
1816
1817     (ScriptColumn
1818      . (
1819         (before-line-breaking . ,ly:script-column::before-line-breaking)
1820         (meta . ((class . Item)
1821                  (interfaces . (script-column-interface))))))
1822
1823     (ScriptRow
1824      . (
1825         (before-line-breaking . ,ly:script-column::row-before-line-breaking)
1826         (meta . ((class . Item)
1827                  (interfaces . (script-column-interface))))))
1828
1829     (Slur
1830      . (
1831         (avoid-slur . inside)
1832         (control-points . ,ly:slur::calc-control-points)
1833         (cross-staff . ,ly:slur::calc-cross-staff)
1834         (details . ,default-slur-details)
1835         (direction . ,ly:slur::calc-direction)
1836         (height-limit . 2.0)
1837         (line-thickness . 0.8)
1838         (minimum-length . 1.5)
1839         (ratio . 0.25)
1840         (spanner-id . "")
1841         (springs-and-rods . ,ly:spanner::set-spacing-rods)
1842         (stencil . ,ly:slur::print)
1843         (thickness . 1.2)
1844         (vertical-skylines . ,ly:slur::vertical-skylines)
1845         (Y-extent . ,ly:slur::height)
1846         (meta . ((class . Spanner)
1847                  (interfaces . (slur-interface))))))
1848
1849     (SostenutoPedal
1850      . (
1851         (direction . ,RIGHT)
1852         (extra-spacing-width . (+inf.0 . -inf.0))
1853         (font-shape . italic)
1854         (padding . 0.0) ;; padding relative to SostenutoPedalLineSpanner
1855         (self-alignment-X . ,CENTER)
1856         (stencil . ,ly:text-interface::print)
1857         (vertical-skylines . ,ly:grob::vertical-skylines-from-stencil)
1858         (X-offset . ,ly:self-alignment-interface::x-aligned-on-self)
1859         (meta . ((class . Item)
1860                  (interfaces . (font-interface
1861                                 piano-pedal-script-interface
1862                                 self-alignment-interface
1863                                 text-interface))))))
1864
1865     (SostenutoPedalLineSpanner
1866      . (
1867         (axes . (,Y))
1868         (direction . ,DOWN)
1869         (minimum-space . 1.0)
1870         (outside-staff-priority . 1000)
1871         (padding . 1.2)
1872         (side-axis . ,Y)
1873         (staff-padding . 1.0)
1874         (vertical-skylines . ,ly:grob::vertical-skylines-from-element-stencils)
1875         (X-extent . ,ly:axis-group-interface::width)
1876         (Y-extent . ,ly:axis-group-interface::height)
1877         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1878         (meta . ((class . Spanner)
1879                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
1880                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
1881                  (interfaces . (axis-group-interface
1882                                 piano-pedal-interface
1883                                 side-position-interface))))))
1884
1885     (SpacingSpanner
1886      . (
1887         (average-spacing-wishes . #t)
1888         (base-shortest-duration . ,(ly:make-moment 3 16))
1889         (common-shortest-duration . ,ly:spacing-spanner::calc-common-shortest-duration)
1890         (shortest-duration-space . 2.0)
1891         (spacing-increment . 1.2)
1892         (springs-and-rods . ,ly:spacing-spanner::set-springs)
1893         (meta . ((class . Spanner)
1894                  (interfaces . (spacing-options-interface
1895                                 spacing-spanner-interface))))))
1896
1897     (SpanBar
1898      . (
1899         (allow-span-bar . #t)
1900         (bar-extent . ,ly:axis-group-interface::height)
1901         (before-line-breaking . ,ly:span-bar::before-line-breaking)
1902         (break-align-symbol . staff-bar)
1903         (cross-staff . #t)
1904         (glyph-name . ,ly:span-bar::calc-glyph-name)
1905         (layer . 0)
1906         (non-musical . #t)
1907         (stencil . ,ly:span-bar::print)
1908         (X-extent . ,ly:span-bar::width)
1909         (Y-extent . (+inf.0 . -inf.0))
1910         (meta . ((class . Item)
1911                  (interfaces . (bar-line-interface
1912                                 font-interface
1913                                 span-bar-interface))))))
1914
1915     (SpanBarStub
1916      . (
1917         (X-extent . ,grob::x-parent-width)
1918         (extra-spacing-height . ,pure-from-neighbor-interface::extra-spacing-height)
1919         (Y-extent . #f)
1920         (meta . ((class . Item)
1921                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
1922                                       (pure-relevant-grobs . ,ly:pure-from-neighbor-interface::calc-pure-relevant-grobs)))
1923                  (interfaces . (pure-from-neighbor-interface))))))
1924
1925     (StaffGrouper
1926      . (
1927         (staff-staff-spacing . ((basic-distance . 9)
1928                                 (minimum-distance . 7)
1929                                 (padding . 1)
1930                                 (stretchability . 5)))
1931         (staffgroup-staff-spacing . ((basic-distance . 10.5)
1932                                      (minimum-distance . 8)
1933                                      (padding . 1)
1934                                      (stretchability . 9)))
1935         (meta . ((class . Spanner)
1936                  (interfaces . (staff-grouper-interface))))))
1937
1938     (StaffSpacing
1939      . (
1940         (non-musical . #t)
1941         (stem-spacing-correction . 0.4)
1942         (meta . ((class . Item)
1943                  (interfaces . (spacing-interface
1944                                 staff-spacing-interface))))))
1945
1946     (StaffSymbol
1947      . (
1948         (layer . 0)
1949         (ledger-line-thickness . (1.0 . 0.1))
1950         (line-count . 5)
1951         (stencil . ,ly:staff-symbol::print)
1952         (Y-extent . ,ly:staff-symbol::height)
1953         (meta . ((class . Spanner)
1954                  (interfaces . (staff-symbol-interface))))))
1955
1956     (StanzaNumber
1957      . (
1958         (direction . ,LEFT)
1959         (font-series . bold)
1960         (padding . 1.0)
1961         (side-axis . ,X)
1962         (stencil . ,ly:text-interface::print)
1963         (X-offset . ,ly:side-position-interface::x-aligned-side)
1964         (meta . ((class . Item)
1965                  (interfaces . (font-interface
1966                                 side-position-interface
1967                                 stanza-number-interface
1968                                 text-interface))))))
1969
1970     (Stem
1971      . (
1972         (beamlet-default-length . (1.1 . 1.1))
1973         (beamlet-max-length-proportion . (0.75 . 0.75))
1974         (cross-staff . ,ly:stem::calc-cross-staff)
1975         (default-direction . ,ly:stem::calc-default-direction)
1976         (details
1977          . (
1978             ;; 3.5 (or 3 measured from note head) is standard length
1979             ;; 32nd, 64th, 128th flagged stems should be longer
1980             (lengths . (3.5 3.5 3.5 4.25 5.0 6.0))
1981
1982             ;; FIXME.  3.5 yields too long beams (according to Ross and
1983             ;; looking at Baerenreiter examples) for a number of common
1984             ;; boundary cases.  Subtracting half a beam thickness fixes
1985             ;; this, but the bug may well be somewhere else.
1986
1987             ;; FIXME this should come from 'lengths
1988             (beamed-lengths . (3.26 3.5 3.6))
1989
1990             ;; The 'normal' minima
1991             (beamed-minimum-free-lengths . (1.83 1.5 1.25))
1992                                         ;(beamed-minimum-free-lengths . (2.0 1.83 1.25))
1993
1994             ;; The 'extreme case' minima
1995             (beamed-extreme-minimum-free-lengths . (2.0 1.25))
1996
1997             ;; Stems in unnatural (forced) direction should be shortened by
1998             ;; one staff space, according to [Roush & Gourlay].
1999             ;; Flagged stems we shorten only half a staff space.
2000             (stem-shorten . (1.0 0.5))
2001
2002             ))
2003
2004         ;; We use the normal minima as minimum for the ideal lengths,
2005         ;; and the extreme minima as abolute minimum length.
2006
2007         (direction . ,ly:stem::calc-direction)
2008         (duration-log . ,stem::calc-duration-log)
2009         (length . ,stem::length)
2010         (neutral-direction . ,DOWN)
2011         (positioning-done . ,ly:stem::calc-positioning-done)
2012         (stem-info . ,ly:stem::calc-stem-info)
2013         (stem-begin-position . ,ly:stem::calc-stem-begin-position)
2014         (stencil . ,ly:stem::print)
2015         (thickness . 1.3)
2016         (X-extent . ,ly:stem::width)
2017         (X-offset . ,ly:stem::offset-callback)
2018         (Y-extent . ,ly:stem::height)
2019         (Y-offset . ,ly:staff-symbol-referencer::callback)
2020         (meta . ((class . Item)
2021                  (interfaces . (stem-interface))))))
2022
2023     (StemStub
2024      . (
2025         (X-extent . ,stem-stub::width)
2026         (extra-spacing-height . ,stem-stub::extra-spacing-height)
2027         (Y-extent . ,(ly:make-unpure-pure-container #f stem-stub::pure-height))
2028         (meta . ((class . Item)
2029                  (interfaces . ())))))
2030
2031     (StemTremolo
2032      . (
2033         (beam-thickness . 0.48) ; staff-space
2034         (beam-width . ,ly:stem-tremolo::calc-width) ; staff-space
2035         (direction . ,ly:stem-tremolo::calc-direction)
2036         (slope . ,ly:stem-tremolo::calc-slope)
2037         (stencil . ,ly:stem-tremolo::print)
2038         (style . ,ly:stem-tremolo::calc-style)
2039         (X-extent . ,ly:stem-tremolo::width)
2040         (X-offset . ,(ly:make-simple-closure
2041                       `(,+
2042                         ,(ly:make-simple-closure
2043                           (list ly:self-alignment-interface::centered-on-x-parent))
2044                         ,(ly:make-simple-closure
2045                           (list ly:self-alignment-interface::x-aligned-on-self)))))
2046         (Y-offset . ,ly:stem-tremolo::calc-y-offset)
2047         (meta . ((class . Item)
2048                  (interfaces . (self-alignment-interface
2049                                 stem-tremolo-interface))))))
2050
2051     (StringNumber
2052      . (
2053         (avoid-slur . around)
2054         (cross-staff . ,script-or-side-position-cross-staff)
2055         (font-encoding . fetaText)
2056         (font-size . -5)                ; don't overlap when next to heads.
2057         (padding . 0.5)
2058         (script-priority . 100)
2059         (self-alignment-X . ,CENTER)
2060         (self-alignment-Y . ,CENTER)
2061         (staff-padding . 0.5)
2062         (stencil . ,print-circled-text-callback)
2063         (text . ,string-number::calc-text)
2064         (meta . ((class . Item)
2065                  (interfaces . (font-interface
2066                                 self-alignment-interface
2067                                 side-position-interface
2068                                 string-number-interface
2069                                 text-interface
2070                                 text-script-interface))))))
2071
2072     (StrokeFinger
2073      . (
2074         (digit-names . #("p" "i" "m" "a" "x"))
2075         (font-shape . italic)
2076         (font-size . -4)                ; don't overlap when next to heads.
2077         (padding . 0.5)
2078         (script-priority . 100)
2079         (self-alignment-X . ,CENTER)
2080         (self-alignment-Y . ,CENTER)
2081         (staff-padding . 0.5)
2082         (stencil . ,ly:text-interface::print)
2083         (text . ,stroke-finger::calc-text)
2084         (meta . ((class . Item)
2085                  (interfaces . (font-interface
2086                                 self-alignment-interface
2087                                 side-position-interface
2088                                 stroke-finger-interface
2089                                 text-interface
2090                                 text-script-interface))))))
2091
2092     (SustainPedal
2093      . (
2094         (direction . ,RIGHT)
2095         (extra-spacing-width . (+inf.0 . -inf.0))
2096         (padding . 0.0)  ;; padding relative to SustainPedalLineSpanner
2097         (self-alignment-X . ,CENTER)
2098         (stencil . ,ly:sustain-pedal::print)
2099         (vertical-skylines . ,ly:grob::vertical-skylines-from-stencil)
2100         (X-offset . ,ly:self-alignment-interface::x-aligned-on-self)
2101         (meta . ((class . Item)
2102                  (interfaces . (font-interface
2103                                 piano-pedal-interface
2104                                 piano-pedal-script-interface
2105                                 self-alignment-interface
2106                                 text-interface))))))
2107
2108     (SustainPedalLineSpanner
2109      . (
2110         (axes . (,Y))
2111         (direction . ,DOWN)
2112         (minimum-space . 1.0)
2113         (outside-staff-priority . 1000)
2114         (padding . 1.2)
2115         (side-axis . ,Y)
2116         (staff-padding . 1.2)
2117         (vertical-skylines . ,ly:grob::vertical-skylines-from-element-stencils)
2118         (X-extent . ,ly:axis-group-interface::width)
2119         (Y-extent . ,ly:axis-group-interface::height)
2120         (Y-offset . ,ly:side-position-interface::y-aligned-side)
2121         (meta . ((class . Spanner)
2122                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
2123                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
2124                  (interfaces . (axis-group-interface
2125                                 piano-pedal-interface
2126                                 side-position-interface))))))
2127
2128     (System
2129      . (
2130         (adjacent-pure-heights . ,ly:axis-group-interface::adjacent-pure-heights)
2131         (axes . (,X ,Y))
2132         (outside-staff-placement-directive . left-to-right-polite)
2133         (skyline-horizontal-padding . 1.0)
2134         (vertical-skylines . ,ly:axis-group-interface::calc-skylines)
2135         (X-extent . ,ly:axis-group-interface::width)
2136         (Y-extent . ,ly:system::height)
2137         (meta . ((class . System)
2138                  (object-callbacks . ((footnotes-before-line-breaking . ,ly:system::footnotes-before-line-breaking)
2139                                       (footnotes-after-line-breaking . ,ly:system::footnotes-after-line-breaking)
2140                                       (pure-relevant-grobs . ,ly:system::calc-pure-relevant-grobs)
2141                                       (pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
2142                                       (vertical-skyline-elements . ,ly:system::vertical-skyline-elements)
2143                                       (vertical-alignment . ,ly:system::get-vertical-alignment)))
2144                  (interfaces . (axis-group-interface
2145                                 system-interface))))))
2146
2147     (SystemStartBar
2148      . (
2149         (collapse-height . 5.0)
2150         (direction . ,LEFT)
2151
2152         ;; ugh--hardcoded.
2153         (padding . -0.1)  ;; bar must cover rounded ending of staff line.
2154         (stencil . ,ly:system-start-delimiter::print)
2155         (style . bar-line)
2156         (thickness . 1.6)
2157         (X-offset . ,ly:side-position-interface::x-aligned-side)
2158         (Y-extent . #f)
2159         (meta . ((class . Spanner)
2160                  (interfaces . (side-position-interface
2161                                 system-start-delimiter-interface))))))
2162
2163     (SystemStartBrace
2164      . (
2165         (collapse-height . 5.0)
2166         (direction . ,LEFT)
2167         (font-encoding . fetaBraces)
2168         (padding . 0.3)
2169         (stencil . ,ly:system-start-delimiter::print)
2170         (style . brace)
2171         (X-offset . ,ly:side-position-interface::x-aligned-side)
2172         (Y-extent . #f)
2173         (meta . ((class . Spanner)
2174                  (interfaces . (font-interface
2175                                 side-position-interface
2176                                 system-start-delimiter-interface))))))
2177
2178     (SystemStartBracket
2179      . (
2180         (collapse-height . 5.0)
2181         (direction . ,LEFT)
2182         (padding . 0.8)
2183         (stencil . ,ly:system-start-delimiter::print)
2184         (style . bracket)
2185         (thickness . 0.45)
2186         (X-offset . ,ly:side-position-interface::x-aligned-side)
2187         (Y-extent . #f)
2188         (meta . ((class . Spanner)
2189                  (interfaces . (font-interface
2190                                 side-position-interface
2191                                 system-start-delimiter-interface))))))
2192
2193     (SystemStartSquare
2194      . (
2195         (direction . ,LEFT)
2196         (stencil . ,ly:system-start-delimiter::print)
2197         (style . line-bracket)
2198         (thickness . 1.0)
2199         (X-offset . ,ly:side-position-interface::x-aligned-side)
2200         (Y-extent . #f)
2201         (meta . ((class . Spanner)
2202                  (interfaces . (font-interface
2203                                 side-position-interface
2204                                 system-start-delimiter-interface))))))
2205
2206
2207     (TabNoteHead
2208      . (
2209         (details . ((cautionary-properties . ((angularity . 0.4)
2210                                               (half-thickness . 0.075)
2211                                               (padding . 0)
2212                                               (procedure . ,parenthesize-stencil)
2213                                               (width . 0.25)))
2214                     (head-offset . 3/5)
2215                     (harmonic-properties . ((angularity . 2)
2216                                             (half-thickness . 0.075)
2217                                             (padding . 0)
2218                                             (procedure . ,parenthesize-stencil)
2219                                             (width . 0.25)))
2220                     (repeat-tied-properties . ((note-head-visible . #t)
2221                                                (parenthesize . #t)))
2222                     (tied-properties . ((break-visibility . ,begin-of-line-visible)
2223                                         (parenthesize . #t)))))
2224
2225         (direction . ,CENTER)
2226         (duration-log . ,note-head::calc-duration-log)
2227         (font-series . bold)
2228         (font-size . -2)
2229         (stem-attachment . (0.0 . 1.35))
2230         (stencil . ,tab-note-head::print)
2231         (whiteout . #t)
2232         (X-offset . ,ly:self-alignment-interface::x-aligned-on-self)
2233         (Y-offset . ,ly:staff-symbol-referencer::callback)
2234         (meta . ((class . Item)
2235                  (interfaces  . (font-interface
2236                                  note-head-interface
2237                                  rhythmic-grob-interface
2238                                  rhythmic-head-interface
2239                                  staff-symbol-referencer-interface
2240                                  tab-note-head-interface
2241                                  text-interface))))))
2242
2243     (TextScript
2244      . (
2245         (avoid-slur . around)
2246         (cross-staff . ,script-or-side-position-cross-staff)
2247         (direction . ,DOWN)
2248         (extra-spacing-width . (+inf.0 . -inf.0))
2249         (outside-staff-horizontal-padding . 0.12)
2250         (outside-staff-priority . 450)
2251
2252         ;; sync with Fingering ?
2253         (padding . 0.5)
2254
2255         (script-priority . 200)
2256         (side-axis . ,Y)
2257         (slur-padding . 0.5)
2258         (staff-padding . 0.5)
2259         (stencil . ,ly:text-interface::print)
2260         (vertical-skylines . ,ly:grob::vertical-skylines-from-stencil)
2261         ;; todo: add X self alignment?
2262         (X-offset . ,ly:self-alignment-interface::x-aligned-on-self)
2263         (Y-offset . ,ly:side-position-interface::y-aligned-side)
2264         (meta . ((class . Item)
2265                  (interfaces . (font-interface
2266                                 instrument-specific-markup-interface
2267                                 self-alignment-interface
2268                                 side-position-interface
2269                                 text-interface
2270                                 text-script-interface))))))
2271
2272     (TextSpanner
2273      . (
2274         (bound-details . ((left . ((Y . 0)
2275                                    (padding . 0.25)
2276                                    (attach-dir . ,LEFT)
2277                                    ))
2278                           (left-broken . ((attach-dir . ,RIGHT)))
2279                           (right . ((Y . 0)
2280                                     (padding . 0.25)
2281                                     ))
2282                           ))
2283         (dash-fraction . 0.2)
2284         (dash-period . 3.0)
2285         (direction . ,UP)
2286         (font-shape . italic)
2287         (left-bound-info . ,ly:line-spanner::calc-left-bound-info)
2288         (outside-staff-priority . 350)
2289         (right-bound-info . ,ly:line-spanner::calc-right-bound-info)
2290         (side-axis . ,Y)
2291         (staff-padding . 0.8)
2292         (stencil . ,ly:line-spanner::print)
2293         (style . dashed-line)
2294         (Y-offset . ,ly:side-position-interface::y-aligned-side)
2295
2296         (meta . ((class . Spanner)
2297                  (interfaces . (font-interface
2298                                 line-interface
2299                                 line-spanner-interface
2300                                 side-position-interface))))))
2301
2302     (Tie
2303      . (
2304         (avoid-slur . inside)
2305         (control-points . ,ly:tie::calc-control-points)
2306         (details . (
2307                     ;; for a full list, see tie-details.cc
2308                     (ratio . 0.333)
2309                     (center-staff-line-clearance . 0.6)
2310                     (tip-staff-line-clearance . 0.45)
2311                     (note-head-gap . 0.2)
2312                     (stem-gap . 0.35)
2313                     (height-limit . 1.0)
2314                     (horizontal-distance-penalty-factor . 10)
2315                     (same-dir-as-stem-penalty . 8)
2316                     (min-length-penalty-factor . 26)
2317                     (tie-tie-collision-distance . 0.45)
2318                     (tie-tie-collision-penalty . 25.0)
2319                     (intra-space-threshold . 1.25)
2320                     (outer-tie-vertical-distance-symmetry-penalty-factor . 10)
2321                     (outer-tie-length-symmetry-penalty-factor . 10)
2322                     (vertical-distance-penalty-factor . 7)
2323                     (outer-tie-vertical-gap . 0.25)
2324                     (multi-tie-region-size . 3)
2325                     (single-tie-region-size . 4)
2326                     (between-length-limit . 1.0)))
2327
2328         (direction . ,ly:tie::calc-direction)
2329         (font-size . -6)
2330         (line-thickness . 0.8)
2331         (neutral-direction . ,UP)
2332         (springs-and-rods . ,ly:spanner::set-spacing-rods)
2333         (stencil . ,ly:tie::print)
2334         (vertical-skylines . ,ly:grob::vertical-skylines-from-stencil)
2335         (thickness . 1.2)
2336         (meta . ((class . Spanner)
2337                  (interfaces . (tie-interface))))))
2338
2339     (TieColumn
2340      . (
2341         (before-line-breaking . ,ly:tie-column::before-line-breaking)
2342         (positioning-done . ,ly:tie-column::calc-positioning-done)
2343         (X-extent . #f)
2344         (Y-extent . #f)
2345         (meta . ((class . Spanner)
2346                  (interfaces . (tie-column-interface))))))
2347
2348     (TimeSignature
2349      . (
2350         (avoid-slur . inside)
2351         (break-align-anchor
2352          . ,ly:break-aligned-interface::calc-extent-aligned-anchor)
2353         (break-align-symbol . time-signature)
2354         (break-align-anchor-alignment . ,LEFT)
2355         (break-visibility . ,all-visible)
2356         (extra-spacing-height . ,pure-from-neighbor-interface::extra-spacing-height-including-staff)
2357         (extra-spacing-width . (0.0 . 0.8))
2358         (non-musical . #t)
2359         (space-alist . (
2360                         (cue-clef . (extra-space . 1.5))
2361                         (first-note . (fixed-space . 2.0))
2362                         (right-edge . (extra-space . 0.5))
2363                         (staff-bar . (minimum-space . 2.0))))
2364         (stencil . ,ly:time-signature::print)
2365         (style . C)
2366         (meta . ((class . Item)
2367                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
2368                                       (pure-relevant-grobs . ,ly:pure-from-neighbor-interface::calc-pure-relevant-grobs)))
2369                  (interfaces . (break-aligned-interface
2370                                 font-interface
2371                                 pure-from-neighbor-interface
2372                                 time-signature-interface))))))
2373
2374     (TrillPitchAccidental
2375      . (
2376         (direction . ,LEFT)
2377         (font-size . -4)
2378         (glyph-name-alist . ,standard-alteration-glyph-name-alist)
2379         (padding . 0.2)
2380         (side-axis . ,X)
2381         (stencil . ,ly:accidental-interface::print)
2382         (X-offset . ,ly:side-position-interface::x-aligned-side)
2383         (Y-extent . ,ly:accidental-interface::height)
2384         (meta . ((class . Item)
2385                  (interfaces . (accidental-interface
2386                                 font-interface
2387                                 inline-accidental-interface
2388                                 side-position-interface
2389                                 trill-pitch-accidental-interface))))))
2390
2391     (TrillPitchGroup
2392      . (
2393         (axes . (,X))
2394         (direction . ,RIGHT)
2395         (font-size . -4)
2396         (padding . 0.3)
2397         (side-axis . ,X)
2398         (stencil . ,parenthesize-elements)
2399         (stencils . ,parentheses-item::calc-parenthesis-stencils)
2400         (X-offset . ,ly:side-position-interface::x-aligned-side)
2401         (meta . ((class . Item)
2402                  (interfaces . (axis-group-interface
2403                                 font-interface
2404                                 note-head-interface
2405                                 parentheses-interface
2406                                 side-position-interface))))))
2407
2408     (TrillPitchHead
2409      . (
2410         (duration-log . 2)
2411         (font-size . -4)
2412         (stencil . ,ly:note-head::print)
2413         (Y-offset . ,ly:staff-symbol-referencer::callback)
2414         (meta . ((class . Item)
2415                  (interfaces . (font-interface
2416                                 ledgered-interface
2417                                 pitched-trill-interface
2418                                 rhythmic-head-interface
2419                                 staff-symbol-referencer-interface))))))
2420
2421     (TrillSpanner
2422      . (
2423         (after-line-breaking . ,ly:spanner::kill-zero-spanned-time)
2424         (bound-details . ((left . ((text . ,(make-musicglyph-markup "scripts.trill"))
2425                                    (Y . 0)
2426                                    (stencil-offset . (-0.5 . -1))
2427                                    (padding . 0.5)
2428                                    (attach-dir . ,CENTER)
2429                                    ))
2430                           (left-broken . ((end-on-note . #t)))
2431                           (right . ((Y . 0)))
2432                           ))
2433         (direction . ,UP)
2434         (left-bound-info . ,ly:line-spanner::calc-left-bound-info)
2435         (outside-staff-priority . 50)
2436         (padding . 0.5)
2437         (right-bound-info . ,ly:line-spanner::calc-right-bound-info)
2438         (side-axis . ,Y)
2439         (staff-padding . 1.0)
2440         (stencil . ,ly:line-spanner::print)
2441         (style . trill)
2442         (Y-offset . ,ly:side-position-interface::y-aligned-side)
2443         (meta . ((class . Spanner)
2444                  (interfaces . (font-interface
2445                                 line-interface
2446                                 line-spanner-interface
2447                                 side-position-interface
2448                                 trill-spanner-interface))))))
2449
2450     (TupletBracket
2451      . (
2452         (avoid-scripts . #t)
2453         (connect-to-neighbor . ,ly:tuplet-bracket::calc-connect-to-neighbors)
2454         (cross-staff . ,ly:tuplet-bracket::calc-cross-staff)
2455         (direction  . ,ly:tuplet-bracket::calc-direction)
2456         (edge-height . (0.7 . 0.7))
2457         (full-length-to-extent . #t)
2458         (padding . 1.1)
2459         (positions . ,ly:tuplet-bracket::calc-positions)
2460         (shorten-pair . (-0.2 . -0.2))
2461         (staff-padding . 0.25)
2462         (stencil . ,ly:tuplet-bracket::print)
2463         (thickness . 1.6)
2464         (vertical-skylines . ,ly:grob::vertical-skylines-from-stencil)
2465         (X-positions . ,ly:tuplet-bracket::calc-x-positions)
2466
2467         (meta . ((class . Spanner)
2468                  (interfaces . (line-interface
2469                                 tuplet-bracket-interface))))))
2470
2471     (TupletNumber
2472      . (
2473         (avoid-slur . inside)
2474         (cross-staff . ,ly:tuplet-number::calc-cross-staff)
2475         (direction . ,tuplet-number::calc-direction)
2476         (font-shape . italic)
2477         (font-size . -2)
2478         (stencil . ,ly:tuplet-number::print)
2479         (text . ,tuplet-number::calc-denominator-text)
2480         (X-offset . ,ly:tuplet-number::calc-x-offset)
2481         (Y-offset . ,ly:tuplet-number::calc-y-offset)
2482         (meta . ((class . Spanner)
2483                  (interfaces . (font-interface
2484                                 text-interface
2485                                 tuplet-number-interface))))))
2486
2487
2488     (UnaCordaPedal
2489      . (
2490         (direction . ,RIGHT)
2491         (extra-spacing-width . (+inf.0 . -inf.0))
2492         (font-shape . italic)
2493         (padding . 0.0)  ;; padding relative to UnaCordaPedalLineSpanner
2494         (self-alignment-X . ,CENTER)
2495         (stencil . ,ly:text-interface::print)
2496         (vertical-skylines . ,ly:grob::vertical-skylines-from-stencil)
2497         (X-offset . ,ly:self-alignment-interface::x-aligned-on-self)
2498         (meta . ((class . Item)
2499                  (interfaces . (font-interface
2500                                 piano-pedal-script-interface
2501                                 self-alignment-interface
2502                                 text-interface))))))
2503
2504     (UnaCordaPedalLineSpanner
2505      . (
2506         (axes . (,Y))
2507         (direction . ,DOWN)
2508         (minimum-space . 1.0)
2509         (outside-staff-priority . 1000)
2510         (padding . 1.2)
2511         (side-axis . ,Y)
2512         (staff-padding . 1.2)
2513         (vertical-skylines . ,ly:grob::vertical-skylines-from-element-stencils)
2514         (X-extent . ,ly:axis-group-interface::width)
2515         (Y-extent . ,ly:axis-group-interface::height)
2516         (Y-offset . ,ly:side-position-interface::y-aligned-side)
2517         (meta . ((class . Spanner)
2518                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
2519                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
2520                  (interfaces . (axis-group-interface
2521                                 piano-pedal-interface
2522                                 side-position-interface))))))
2523
2524
2525     (VaticanaLigature
2526      . (
2527         (flexa-width . 2.0)
2528         (stencil . ,ly:vaticana-ligature::print)
2529         (thickness . 0.6)
2530         (meta . ((class . Spanner)
2531                  (interfaces . (font-interface
2532                                 vaticana-ligature-interface))))))
2533
2534     (VerticalAlignment
2535      . (
2536         (axes . (,Y))
2537         (positioning-done . ,ly:align-interface::align-to-ideal-distances)
2538         (stacking-dir . -1)
2539         (vertical-skylines . ,ly:axis-group-interface::combine-skylines)
2540         (X-extent . ,ly:axis-group-interface::width)
2541         (Y-extent . ,ly:axis-group-interface::height)
2542         (meta . ((class . Spanner)
2543                  (object-callbacks . ((Y-common . ,ly:axis-group-interface::calc-y-common)
2544                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)
2545                                       (pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)))
2546                  (interfaces . (align-interface
2547                                 axis-group-interface))))))
2548
2549     (VerticalAxisGroup
2550      . (
2551         (adjacent-pure-heights . ,ly:axis-group-interface::adjacent-pure-heights)
2552         (axes . (,Y))
2553         (default-staff-staff-spacing . ((basic-distance . 9)
2554                                         (minimum-distance . 8)
2555                                         (padding . 1)))
2556         (nonstaff-unrelatedstaff-spacing . ((padding . 0.5)))
2557         (outside-staff-placement-directive . left-to-right-polite)
2558         (staff-staff-spacing . ,ly:axis-group-interface::calc-staff-staff-spacing)
2559         (stencil . ,ly:axis-group-interface::print)
2560         (skyline-horizontal-padding . 0.1)
2561         (vertical-skylines . ,ly:hara-kiri-group-spanner::calc-skylines)
2562         (X-extent . ,ly:axis-group-interface::width)
2563         (Y-extent . ,ly:hara-kiri-group-spanner::y-extent)
2564         (Y-offset . ,ly:hara-kiri-group-spanner::force-hara-kiri-callback)
2565         (meta . ((class . Spanner)
2566                  (object-callbacks . (
2567                                       (X-common . ,ly:axis-group-interface::calc-x-common)
2568                                       (pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
2569                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
2570
2571                  (interfaces . (axis-group-interface
2572                                 hara-kiri-group-spanner-interface))))))
2573
2574     (VoiceFollower
2575      . (
2576         (after-line-breaking . ,ly:spanner::kill-zero-spanned-time)
2577         (bound-details . ((right . ((attach-dir .  ,CENTER)
2578                                     (padding . 1.5)
2579                                       ))
2580                           (left . ((attach-dir .  ,CENTER)
2581                                    (padding . 1.5)
2582                                       ))
2583                           ))
2584         (cross-staff . #t)
2585         (gap . 0.5)
2586         (left-bound-info . ,ly:line-spanner::calc-left-bound-info)
2587         (non-musical . #t)
2588         (right-bound-info . ,ly:line-spanner::calc-right-bound-info)
2589         (stencil . ,ly:line-spanner::print)
2590         (style . line)
2591         (X-extent . #f)
2592         (Y-extent . #f)
2593         (meta . ((class . Spanner)
2594                  (interfaces . (line-interface
2595                                 line-spanner-interface))))))
2596
2597     (VoltaBracket
2598      . (
2599         (direction . ,UP)
2600         (edge-height . (2.0 . 2.0)) ;; staff-space;
2601         (font-encoding . fetaText)
2602         (font-size . -4)
2603         (shorten-pair . ,ly:volta-bracket::calc-shorten-pair)
2604         (stencil . ,ly:volta-bracket-interface::print)
2605         (thickness . 1.6) ;; line-thickness
2606         (word-space . 0.6)
2607         (vertical-skylines . ,ly:grob::vertical-skylines-from-stencil)
2608         (meta . ((class . Spanner)
2609                  (interfaces . (font-interface
2610                                 horizontal-bracket-interface
2611                                 line-interface
2612                                 side-position-interface
2613                                 text-interface
2614                                 volta-bracket-interface
2615                                 volta-interface))))))
2616
2617     (VoltaBracketSpanner
2618      . (
2619         (after-line-breaking . ,ly:side-position-interface::move-to-extremal-staff)
2620         (axes . (,Y))
2621         (direction . ,UP)
2622         (no-alignment . #t)
2623         (outside-staff-priority . 600)
2624         (padding . 1)
2625         (side-axis . ,Y)
2626         (vertical-skylines . ,ly:grob::vertical-skylines-from-element-stencils)
2627         (X-extent . ,ly:axis-group-interface::width)
2628         (Y-extent . ,ly:axis-group-interface::height)
2629         (Y-offset . ,ly:side-position-interface::y-aligned-side)
2630         (meta . ((class . Spanner)
2631                  (object-callbacks . ((pure-Y-common . ,ly:axis-group-interface::calc-pure-y-common)
2632                                       (pure-relevant-grobs . ,ly:axis-group-interface::calc-pure-relevant-grobs)))
2633                  (interfaces . (axis-group-interface
2634                                 side-position-interface
2635                                 volta-interface))))))
2636
2637 ))
2638
2639 (define (completize-grob-entry x)
2640   "Transplant assoc key into 'name entry of 'meta of X.  Set interfaces for Item, Spanner etc.
2641 "
2642   ;;  (display (car x))
2643   ;;  (newline)
2644   (let* ((name-sym  (car x))
2645          (grob-entry (cdr x))
2646          (meta-entry (assoc-get 'meta grob-entry))
2647          (class (assoc-get 'class meta-entry))
2648          (ifaces-entry
2649           (assoc-get 'interfaces meta-entry)))
2650
2651     (cond
2652      ((eq? 'Item class)
2653       (set! ifaces-entry (cons 'item-interface ifaces-entry)))
2654      ((eq? 'Spanner class)
2655       (set! ifaces-entry (cons 'spanner-interface ifaces-entry)))
2656      ((eq? 'Paper_column class)
2657       (set! ifaces-entry (cons 'item-interface
2658                                (cons 'paper-column-interface ifaces-entry))))
2659      ((eq? 'System class)
2660       (set! ifaces-entry (cons 'system-interface
2661                                (cons 'spanner-interface ifaces-entry))))
2662      (else
2663       (ly:warning "Unknown class ~a" class)))
2664
2665     (set! ifaces-entry (uniq-list (sort ifaces-entry symbol<?)))
2666     (set! ifaces-entry (cons 'grob-interface ifaces-entry))
2667
2668     (set! meta-entry (assoc-set! meta-entry 'name name-sym))
2669     (set! meta-entry (assoc-set! meta-entry 'interfaces
2670                                  ifaces-entry))
2671     (set! grob-entry (assoc-set! grob-entry 'meta meta-entry))
2672     (cons name-sym grob-entry)))
2673
2674 (set! all-grob-descriptions (map completize-grob-entry all-grob-descriptions))
2675
2676 ;;  (display (map pair? all-grob-descriptions))
2677
2678 ;; make sure that \property Foo.Bar =\turnOff doesn't complain
2679
2680 (map (lambda (x)
2681        ;; (display (car x)) (newline)
2682
2683        (set-object-property! (car x) 'translation-type? list?)
2684        (set-object-property! (car x) 'is-grob? #t))
2685      all-grob-descriptions)
2686
2687 (set! all-grob-descriptions (sort all-grob-descriptions alist<?))
2688
2689 (define (volta-bracket-interface::pure-height grob start end)
2690   (let ((edge-height (ly:grob-property grob 'edge-height)))
2691     (if (number-pair? edge-height)
2692         (let ((smaller (min (car edge-height) (cdr edge-height)))
2693               (larger (max (car edge-height) (cdr edge-height))))
2694           (interval-union '(0 . 0) (cons smaller larger)))
2695         '(0 . 0))))
2696
2697 (define pure-print-callbacks
2698   (list
2699    fret-board::calc-stencil
2700    note-head::brew-ez-stencil
2701    print-circled-text-callback
2702    laissez-vibrer::print
2703    lyric-text::print
2704    ly:bar-line::print
2705    ly:mensural-ligature::brew-ligature-primitive
2706    ly:note-head::print
2707    ly:dots::print
2708    ly:clef::print
2709    ly:flag::print
2710    ly:time-signature::print
2711    default-flag
2712    normal-flag
2713    mensural-flag
2714    no-flag
2715    modern-straight-flag
2716    old-straight-flag
2717    ly:key-signature-interface::print
2718    ly:percent-repeat-item-interface::beat-slash
2719    ly:text-interface::print
2720    ly:script-interface::print
2721    ly:sustain-pedal::print))
2722
2723 ;; Sometimes we have grobs with (Y-extent . ,ly:grob::stencil-height)
2724 ;; and the print function is not pure, but there is a easy way to
2725 ;; figure out the Y-extent from the print function.
2726 (define pure-print-to-height-conversions
2727   `(
2728     (,ly:arpeggio::print . ,ly:arpeggio::pure-height)
2729     (,ly:arpeggio::brew-chord-bracket . ,ly:arpeggio::pure-height)
2730     (,ly:arpeggio::brew-chord-slur . ,ly:arpeggio::pure-height)
2731     (,ly:hairpin::print . ,ly:hairpin::pure-height)
2732     (,ly:stem-tremolo::print . ,ly:stem-tremolo::pure-height)
2733     (,ly:volta-bracket-interface::print . ,volta-bracket-interface::pure-height)))
2734
2735 ;; ly:grob::stencil-extent is safe if the print callback is safe too
2736 (define (pure-stencil-height grob start stop)
2737   (let* ((sten (ly:grob-property-data grob 'stencil))
2738          (pure-height-callback (assoc-get sten pure-print-to-height-conversions)))
2739     (cond ((or
2740             (ly:stencil? sten)
2741             (memq sten pure-print-callbacks))
2742            (ly:grob::stencil-height grob))
2743           ((procedure? pure-height-callback)
2744            (pure-height-callback grob start stop))
2745           (else
2746            '(0 . 0)))))
2747
2748 ;; Sometimes, a pure callback will be chained to a non-pure callback via
2749 ;; chain_offset_callback, in which case this provides a default by simply
2750 ;; passing through the value from the pure callback.
2751 (define (pure-chain-offset-callback grob start end prev-offset) prev-offset)
2752
2753 (define pure-conversions-alist
2754   `(
2755     (,ly:accidental-interface::height . ,ly:accidental-interface::pure-height)
2756     (,ly:axis-group-interface::calc-staff-staff-spacing . ,ly:axis-group-interface::calc-pure-staff-staff-spacing)
2757     (,ly:axis-group-interface::height . ,ly:axis-group-interface::pure-height)
2758     (,ly:beam::rest-collision-callback . ,ly:beam::pure-rest-collision-callback)
2759     (,ly:flag::calc-y-offset . ,ly:flag::pure-calc-y-offset)
2760     (,ly:grob::stencil-height . ,pure-stencil-height)
2761     (,ly:hara-kiri-group-spanner::y-extent . ,ly:hara-kiri-group-spanner::pure-height)
2762     (,ly:rest-collision::force-shift-callback-rest . ,pure-chain-offset-callback)
2763     (,ly:rest::height . ,ly:rest::pure-height)
2764     (,ly:self-alignment-interface::y-aligned-on-self . ,ly:self-alignment-interface::pure-y-aligned-on-self)
2765     (,ly:side-position-interface::y-aligned-side . ,ly:side-position-interface::pure-y-aligned-side)
2766     (,ly:slur::height . ,ly:slur::pure-height)
2767     (,ly:slur::outside-slur-callback . ,ly:slur::pure-outside-slur-callback)
2768     (,ly:stem::calc-stem-begin-position . ,ly:stem::pure-calc-stem-begin-position)
2769     (,ly:stem::calc-stem-end-position . ,ly:stem::pure-calc-stem-end-position)
2770     (,stem::length . ,stem::pure-length)
2771     (,ly:stem::height . ,ly:stem::pure-height)
2772     (,ly:stem-tremolo::calc-y-offset . ,ly:stem-tremolo::pure-calc-y-offset)
2773     (,ly:system::height . ,ly:system::calc-pure-height)))
2774
2775 (define pure-functions
2776   (list
2777    parenthesize-elements
2778    laissez-vibrer::print
2779    ly:rest::y-offset-callback
2780    ly:staff-symbol-referencer::callback
2781    ly:staff-symbol::height))
2782
2783 (define-public (pure-relevant? grob)
2784   (let ((extent-callback (ly:grob-property-data grob 'Y-extent)))
2785     (not (eq? #f
2786               (or
2787                (ly:unpure-pure-container? extent-callback)
2788                (pair? extent-callback)
2789                (memq extent-callback pure-functions)
2790                (and
2791                 (pair? (assq extent-callback pure-conversions-alist))
2792                 (let ((stencil (ly:grob-property-data grob 'stencil)))
2793                   (or
2794                    (not (eq? extent-callback ly:grob::stencil-height))
2795                    (memq stencil pure-print-callbacks)
2796                    (assq stencil pure-print-to-height-conversions)
2797                    (ly:stencil? stencil)))))))))
2798
2799 ;; hideous code dup below - to be cleaned up when call pure functino
2800 ;; is eliminated and lilypond works entirely from unpure-pure-containers
2801
2802 (define-public (call-pure-function unpure args start end)
2803   (if (ly:unpure-pure-container? unpure)
2804       (let ((unpure (ly:unpure-pure-container-pure-part unpure)))
2805         (if (ly:simple-closure? unpure)
2806           (ly:eval-simple-closure (car args) unpure start end)
2807           (if (not (procedure? unpure))
2808               unpure
2809               (apply unpure
2810                      (append
2811                        (list (car args) start end)
2812                        (cdr args))))))
2813       (if (ly:simple-closure? unpure)
2814           (ly:eval-simple-closure (car args) unpure start end)
2815           (if (not (procedure? unpure))
2816               unpure
2817               (if (memq unpure pure-functions)
2818                   (apply unpure args)
2819                   (let ((pure (assq unpure pure-conversions-alist)))
2820                     (if pure
2821                         (apply (cdr pure)
2822                                (append
2823                                 (list (car args) start end)
2824                                 (cdr args))))))))))