scm/define-grobs.scm

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