scm/define-grobs.scm

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