scm/define-grobs.scm

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