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         (stencil . ,ly:dynamic-text-spanner::print)
 636
 637         ;; rather ugh with NCSB
 638         ;; (font-series . bold)
 639         (font-shape . italic)
 640         (style . dashed-line)
 641
 642         ;; need to blend with dynamic texts.
 643         (font-size . 1)
 644         (bound-padding . 0.75)
 645         (dash-fraction . 0.2)
 646         (dash-period . 3.0)
 647         (meta . ((class . Spanner)
 648                  (interfaces . (font-interface
 649                                 text-interface
 650                                 line-spanner-interface
 651                                 dynamic-interface
 652                                 dynamic-text-spanner-interface
 653                                 spanner-interface))))))
 654
 655
 656     (Fingering
 657      . (
 658
 659         ;; sync with TextScript (?)
 660
 661         (padding . 0.5)
 662         (avoid-slur . around)
 663         (slur-padding . 0.2)
 664         (staff-padding . 0.5)
 665         (self-alignment-X . 0)
 666         (self-alignment-Y . 0)
 667         (script-priority . 100)
 668         (stencil . ,ly:text-interface::print)
 669         (direction . ,ly:script-interface::calc-direction)
 670         (text . ,fingering::calc-text)
 671         (font-encoding . fetaNumber)
 672         (font-size . -5)                ; don't overlap when next to heads.
 673         (meta . ((class . Item)
 674                  (interfaces . (finger-interface
 675                                 font-interface
 676                                 text-script-interface
 677                                 text-interface
 678                                 side-position-interface
 679                                 self-alignment-interface
 680                                 ))))))
 681     (FretBoard
 682      . ((stencil . ,fret-board::calc-stencil)
 683         (finger-code . below-string)
 684         (meta . ((class . Item)
 685                  (interfaces . (fret-diagram-interface
 686                                 font-interface
 687                                 ))))
 688               ))
 689     (Glissando
 690      . (
 691         (style . line)
 692         (gap . 0.5)
 693         (zigzag-width . 0.75)
 694         (X-extent . #f)
 695         (Y-extent . #f)
 696         (bound-details . ((right . ((attach-dir .  ,CENTER)
 697                                     (padding . 1.5)
 698                                       ))
 699                           (left . ((attach-dir .  ,CENTER)
 700                                    (padding . 1.5)
 701                                       ))
 702                           ))
 703         (stencil . ,ly:new-line-spanner::print)
 704         (left-bound-info . ,ly:new-line-spanner::calc-left-bound-info)
 705         (right-bound-info . ,ly:new-line-spanner::calc-right-bound-info)
 706         (meta . ((class . Spanner)
 707                  (interfaces . (line-interface
 708                                 unbreakable-spanner-interface
 709                                 line-spanner-interface))))))
 710
 711     (GraceSpacing
 712      . (
 713         (common-shortest-duration . ,grace-spacing::calc-shortest-duration)
 714         (spacing-increment . 0.8)
 715         (shortest-duration-space . 1.6)
 716         (meta . ((class . Spanner)
 717                  (interfaces . (grace-spacing-interface
 718
 719                                 spacing-options-interface
 720                                 spanner-interface))))))
 721     (GridPoint
 722      . (
 723         (X-extent . (0 . 0))
 724         (Y-extent . (0 . 0))
 725         (meta . ((class . Item)
 726                  (interfaces . (grid-point-interface))))))
 727
 728     (GridLine
 729      . (
 730         (X-extent  . ,ly:grid-line-interface::width)
 731         (stencil . ,ly:grid-line-interface::print)
 732         (self-alignment-X . ,CENTER)
 733         (X-offset . ,(ly:make-simple-closure
 734                       `(,+  ,(ly:make-simple-closure
 735                               (list ly:self-alignment-interface::centered-on-x-parent))
 736                             ,(ly:make-simple-closure
 737                               (list ly:self-alignment-interface::x-aligned-on-self)))))
 738         (layer . 0)
 739         (meta . ((class . Item)
 740                  (interfaces . (self-alignment-interface
 741                                 grid-line-interface))))))
 742
 743     (Hairpin
 744      . (
 745         (stencil . ,ly:hairpin::print)
 746         (springs-and-rods . ,ly:spanner::set-spacing-rods)
 747         (after-line-breaking . ,ly:hairpin::after-line-breaking)
 748         (grow-direction . ,hairpin::calc-grow-direction)
 749         (circled-tip . #f)
 750         (thickness . 1.0)
 751         (height . 0.6666)
 752         (minimum-length . 2.0)
 753         (bound-padding . 1.0)
 754         (self-alignment-Y . 0)
 755         (Y-offset . ,ly:self-alignment-interface::y-aligned-on-self)
 756         (meta . ((class . Spanner)
 757                  (interfaces . (hairpin-interface
 758                                 line-interface
 759                                 self-alignment-interface
 760                                 dynamic-interface
 761                                 spanner-interface))))))
 762
 763     (HorizontalBracket
 764      . (
 765         (thickness . 1.0)
 766         (stencil . ,ly:horizontal-bracket::print)
 767         (Y-offset . ,ly:side-position-interface::y-aligned-side)
 768         (connect-to-neighbor . ,ly:tuplet-bracket::calc-connect-to-neighbors)
 769
 770         (padding . 0.2)
 771         (staff-padding . 0.2)
 772         (direction . ,DOWN)
 773         (side-axis . ,Y)
 774         (bracket-flare . (0.5 . 0.5))
 775         (meta . ((class . Spanner)
 776                  (interfaces . (horizontal-bracket-interface
 777                                 side-position-interface
 778                                 line-interface
 779                                 spanner-interface))))))
 780     (InstrumentName
 781      . (
 782         (padding . 0.3)
 783         (stencil . ,ly:system-start-text::print)
 784         (X-offset . ,ly:side-position-interface::x-aligned-side)
 785         (direction . ,LEFT)
 786         (self-alignment-Y . ,CENTER)
 787         (meta . ((class . Spanner)
 788                  (interfaces . (system-start-text-interface
 789                                 side-position-interface
 790                                 font-interface))))))
 791
 792     (InstrumentSwitch
 793      . (
 794         (padding . 0.3)
 795         (stencil . ,ly:text-interface::print)
 796         (Y-offset . ,ly:side-position-interface::y-aligned-side)
 797         (X-offset . ,ly:self-alignment-interface::x-aligned-on-self)
 798         (staff-padding . 2)
 799         (direction . ,UP)
 800         (self-alignment-X . ,CENTER)
 801         (meta . ((class . Item)
 802                  (interfaces . (system-start-text-interface
 803                                 side-position-interface
 804                                 font-interface))))))
 805
 806     (KeyCancellation
 807      . (
 808         (stencil . ,ly:key-signature-interface::print)
 809         (glyph-name-alist . ,cancellation-glyph-name-alist)
 810         (space-alist . (
 811                         (time-signature . (extra-space . 1.25))
 812                         (staff-bar . (extra-space . 0.6))
 813                         (key-signature . (extra-space . 0.5))
 814                         (right-edge . (extra-space . 0.5))
 815                         (first-note . (fixed-space . 2.5))))
 816         (Y-offset . ,ly:staff-symbol-referencer::callback)
 817         (break-align-symbol . key-cancellation)
 818         (break-visibility . ,begin-of-line-invisible)
 819         (non-musical . #t)
 820         (meta . ((class . Item)
 821                  (interfaces . (key-cancellation-interface
 822                                 key-signature-interface
 823                                 font-interface
 824                                 break-aligned-interface))))))
 825     (KeySignature
 826      . (
 827         (stencil . ,ly:key-signature-interface::print)
 828         (avoid-slur . inside)
 829         (glyph-name-alist . ,standard-alteration-glyph-name-alist)
 830         (space-alist . (
 831                         (time-signature . (extra-space . 1.15))
 832                         (staff-bar . (extra-space . 1.1))
 833                         (right-edge . (extra-space . 0.5))
 834                         (first-note . (fixed-space . 2.5))))
 835         (Y-offset . ,ly:staff-symbol-referencer::callback)
 836         (break-align-symbol . key-signature)
 837         (break-visibility . ,begin-of-line-visible)
 838         (non-musical . #t)
 839         (meta . ((class . Item)
 840                  (interfaces . (key-signature-interface
 841                                 font-interface
 842                                 break-aligned-interface))))))
 843
 844
 845    (LaissezVibrerTie
 846      . (
 847         (stencil  . ,ly:tie::print)
 848         (control-points . ,ly:semi-tie::calc-control-points)
 849         (direction . ,ly:tie::calc-direction)
 850         (details . ((ratio . 0.333)
 851                     (height-limit . 1.0)))
 852         (head-direction . ,LEFT)
 853         (thickness . 1.0)
 854         (meta . ((class . Item)
 855                  (interfaces . (semi-tie-interface))
 856                  ))
 857         ))
 858
 859     (LaissezVibrerTieColumn
 860      . (
 861         (X-extent . #f)
 862         (Y-extent . #f)
 863         (head-direction . ,LEFT)
 864         (positioning-done . ,ly:semi-tie-column::calc-positioning-done)
 865         (meta . ((class . Item)
 866                  (interfaces . (semi-tie-column-interface))
 867                  ))
 868         ))
 869
 870     (LedgerLineSpanner
 871      . (
 872         (springs-and-rods . ,ly:ledger-line-spanner::set-spacing-rods)
 873         (stencil . ,ly:ledger-line-spanner::print)
 874         (X-extent . #f)
 875         (Y-extent . #f)
 876         (minimum-length-fraction . 0.25)
 877         (length-fraction . 0.25)
 878         (layer . 0)
 879         (meta . ((class . Spanner)
 880                  (interfaces . (ledger-line-spanner-interface))))))
 881
 882     (LeftEdge
 883      . (
 884         (break-align-symbol . left-edge)
 885         (X-extent . (0 . 0))
 886         (non-musical . #t)
 887         (break-visibility . ,center-invisible)
 888         (space-alist . (
 889                         (custos . (extra-space . 0.0))
 890                         (ambitus . (extra-space . 2.0))
 891                         (time-signature . (extra-space . 1.0))
 892                         (staff-bar . (extra-space . 0.0))
 893                         (breathing-sign . (minimum-space . 0.0))
 894                         (clef . (extra-space . 0.8))
 895                         (first-note . (fixed-space . 2.0))
 896                         (right-edge . (extra-space . 0.0))
 897                         (key-signature . (extra-space . 0.0))
 898                         (key-cancellation . (extra-space . 0.0))
 899                         ))
 900         (meta . ((class . Item)
 901                  (interfaces . (break-aligned-interface))))))
 902
 903     (LigatureBracket
 904      . (
 905         ;; ugh.  A ligature bracket is totally different from
 906         ;; a tuplet bracket.
 907
 908         (padding . 2.0)
 909         (thickness . 1.6)
 910         (edge-height . (0.7 . 0.7))
 911         (shorten-pair . (-0.2 . -0.2))
 912         (direction . ,UP)
 913         (positions . ,ly:tuplet-bracket::calc-positions)
 914         (stencil . ,ly:tuplet-bracket::print)
 915         (staff-padding . 0.25)
 916         (connect-to-neighbor . ,ly:tuplet-bracket::calc-connect-to-neighbors)
 917         (control-points . ,ly:tuplet-bracket::calc-control-points)
 918         (meta . ((class . Spanner)
 919                  (interfaces . (line-interface
 920                                 tuplet-bracket-interface))))))
 921
 922
 923     (LyricExtender
 924      . (
 925         (stencil . ,ly:lyric-extender::print)
 926         (thickness . 0.8) ; line-thickness
 927         (minimum-length . 1.5)
 928         (Y-extent . (0 . 0))
 929         (meta . ((class . Spanner)
 930                  (interfaces . (lyric-interface
 931                                 lyric-extender-interface))))))
 932
 933     (LyricHyphen
 934      . (
 935         (thickness . 1.3)
 936         (height . 0.42)
 937         (dash-period . 10.0)
 938         (length . 0.66)
 939         (minimum-length . 0.3)
 940         (minimum-distance . 0.1)
 941         (padding . 0.07)
 942         (springs-and-rods . ,ly:lyric-hyphen::set-spacing-rods)
 943         (stencil . ,ly:lyric-hyphen::print)
 944         (Y-extent . (0 . 0))
 945         (meta . ((class . Spanner)
 946                  (interfaces . (lyric-interface
 947                                 font-interface
 948                                 lyric-hyphen-interface
 949                                 spanner-interface))))))
 950
 951     (LyricSpace
 952      . ((minimum-distance . 0.45)
 953         (springs-and-rods . ,ly:lyric-hyphen::set-spacing-rods)
 954         (padding . 0.0)
 955         (Y-extent . #f)
 956         (X-extent . #f)
 957         (meta . ((class . Spanner)
 958                  (interfaces . (spanner-interface
 959                                 lyric-hyphen-interface ))
 960                  ))
 961         ))
 962
 963     (LyricText
 964      . (
 965         (stencil . ,lyric-text::print)
 966         (text . ,(grob::calc-property-by-copy 'text))
 967         (X-offset . ,ly:self-alignment-interface::aligned-on-x-parent)
 968         (self-alignment-X . 0)
 969         (word-space . 0.6)
 970         (font-series . bold-narrow)
 971         (font-size . 1.0)
 972         (meta . ((class . Item)
 973                  (interfaces . (rhythmic-grob-interface
 974                                 lyric-syllable-interface
 975                                 self-alignment-interface
 976                                 text-interface
 977                                 font-interface))))))
 978
 979
 980     (MeasureGrouping
 981      . (
 982         (Y-offset . ,ly:side-position-interface::y-aligned-side)
 983         (side-axis . ,Y)
 984         (stencil . ,ly:measure-grouping::print)
 985         (padding . 2)
 986         (direction . ,UP)
 987         (thickness . 1)
 988         (height . 2.0)
 989         (staff-padding . 3)
 990         (meta . ((class . Spanner)
 991                  (interfaces . (side-position-interface
 992                                 measure-grouping-interface))))))
 993
 994     (MelodyItem
 995      . (
 996         (neutral-direction . ,DOWN)
 997         (meta . ((class . Item)
 998                  (interfaces . (melody-spanner-interface ))))))
 999     (MensuralLigature
1000      . (
1001         (thickness . 1.4)
1002         (flexa-width . 2.0)
1003         (stencil . ,ly:mensural-ligature::print)
1004         (meta . ((class . Spanner)
1005                  (interfaces . (mensural-ligature-interface
1006                                 font-interface))))))
1007
1008     (MetronomeMark
1009      . (
1010         (stencil . ,ly:text-interface::print)
1011         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1012         (direction . ,UP)
1013         (padding . 0.8)
1014         (side-axis . ,Y)
1015         (outside-staff-priority . 1000)
1016         (meta . ((class . Item)
1017                  (interfaces . (text-interface
1018                                 side-position-interface
1019                                 font-interface
1020                                 metronome-mark-interface))))))
1021
1022
1023     (MultiMeasureRest
1024      . (
1025         (stencil . ,ly:multi-measure-rest::print)
1026         (springs-and-rods . ,ly:multi-measure-rest::set-spacing-rods)
1027         (Y-offset . ,ly:staff-symbol-referencer::callback)
1028         (staff-position . 0)
1029         (expand-limit . 10)
1030         (thick-thickness . 6.6)
1031         (hair-thickness . 2.0)
1032         (padding . 1)
1033         (meta . ((class . Spanner)
1034                  (interfaces . (multi-measure-rest-interface
1035                                 multi-measure-interface
1036                                 rest-interface
1037                                 font-interface
1038                                 staff-symbol-referencer-interface))))))
1039
1040
1041     (MultiMeasureRestNumber
1042      . (
1043         (bound-padding  . 2.0)
1044         (springs-and-rods . ,ly:multi-measure-rest::set-text-rods)
1045         (stencil . ,ly:text-interface::print)
1046         (X-offset . ,(ly:make-simple-closure
1047                       `(,+ ,(ly:make-simple-closure (list ly:self-alignment-interface::x-aligned-on-self))
1048                            ,(ly:make-simple-closure (list ly:self-alignment-interface::x-centered-on-y-parent)))))
1049         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1050         (side-axis . ,Y)
1051         (self-alignment-X . 0)
1052         (direction . ,UP)
1053         (padding . 0.4)
1054         (staff-padding . 0.4)
1055         (font-encoding . fetaNumber)
1056         (meta . ((class . Spanner)
1057                  (interfaces . (side-position-interface
1058                                 multi-measure-interface
1059                                 self-alignment-interface
1060                                 font-interface
1061                                 text-interface))))
1062               ))
1063
1064     (MultiMeasureRestText
1065      . (
1066         (stencil . ,ly:text-interface::print)
1067         (X-offset . ,(ly:make-simple-closure
1068                       `(,+ ,(ly:make-simple-closure (list ly:self-alignment-interface::x-centered-on-y-parent))
1069                            ,(ly:make-simple-closure (list ly:self-alignment-interface::x-aligned-on-self)))))
1070
1071         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1072         (self-alignment-X . 0)
1073         (direction . ,UP)
1074         (padding . 0.2)
1075         (staff-padding . 0.25)
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     (NonMusicalPaperColumn
1084      . (
1085         (allow-loose-spacing . #t)
1086         (axes . (0))
1087         (before-line-breaking . ,ly:paper-column::before-line-breaking)
1088         (X-extent . ,ly:axis-group-interface::width)
1089         ;;                    (stencil . ,ly:paper-column::print)
1090
1091         (non-musical . #t)
1092         (line-break-permission . allow)
1093         (page-break-permission . allow)
1094
1095         ;; debugging stuff: print column number.
1096         ;;               (font-size . -6) (font-name . "sans")  (Y-extent . #f)
1097
1098         (meta . ((class . Paper_column)
1099                  (interfaces . (paper-column-interface
1100                                 axis-group-interface
1101                                 spaceable-grob-interface))))))
1102
1103     (NoteCollision
1104      . (
1105         (axes . (0 1))
1106         (X-extent . ,ly:axis-group-interface::width)
1107         (Y-extent . ,ly:axis-group-interface::height)
1108         (positioning-done . ,ly:note-collision-interface::calc-positioning-done)
1109         (meta . ((class . Item)
1110                  (interfaces . (note-collision-interface
1111                                 axis-group-interface))))))
1112
1113     (NoteColumn
1114      . (
1115         (axes . (0 1))
1116         (X-extent . ,ly:axis-group-interface::width)
1117         (Y-extent . ,ly:axis-group-interface::height)
1118         (meta . ((class . Item)
1119                  (interfaces . (axis-group-interface
1120                                 note-column-interface))))))
1121
1122     (NoteHead
1123      . (
1124         (stencil . ,ly:note-head::print)
1125         (duration-log . ,note-head::calc-duration-log)
1126         (stem-attachment . ,ly:note-head::calc-stem-attachment)
1127         (glyph-name . ,note-head::calc-glyph-name)
1128         (Y-offset . ,ly:staff-symbol-referencer::callback)
1129         (X-offset . ,ly:note-head::stem-x-shift)
1130         (meta . ((class . Item)
1131                  (interfaces . (rhythmic-grob-interface
1132                                 rhythmic-head-interface
1133                                 font-interface
1134                                 note-head-interface
1135                                 ledgered-interface
1136                                 staff-symbol-referencer-interface))))))
1137
1138     (NoteSpacing
1139      . (
1140         (stem-spacing-correction . 0.5)
1141         (same-direction-correction . 0.25)
1142         ;; Changed this from 0.75.
1143         ;; If you ever change this back, please document! --hwn
1144         (knee-spacing-correction . 1.0)
1145         (meta . ((class . Item)
1146                  (interfaces . (
1147                                 note-spacing-interface))))))
1148
1149     (NoteName
1150      . (
1151         (stencil . ,ly:text-interface::print)
1152         (meta . ((class . Item)
1153                  (interfaces . (note-name-interface
1154                                 text-interface
1155                                 font-interface))))))
1156
1157     (OctavateEight
1158      . (
1159         (self-alignment-X . 0)
1160         (break-visibility . ,begin-of-line-visible)
1161         (X-offset . ,(ly:make-simple-closure
1162                       `(,+ ,(ly:make-simple-closure (list ly:self-alignment-interface::x-aligned-on-self))
1163                            ,(ly:make-simple-closure (list ly:self-alignment-interface::centered-on-x-parent)))))
1164
1165         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1166         (stencil . ,ly:text-interface::print)
1167         (font-shape . italic)
1168         (staff-padding . 0.2)
1169         (font-size . -4)
1170         (meta . ((class . Item)
1171                  (interfaces . (text-interface
1172                                 self-alignment-interface
1173                                 side-position-interface
1174                                 font-interface))))))
1175
1176     (OttavaBracket
1177      . (
1178         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1179         (stencil . ,ly:ottava-bracket::print)
1180         (font-shape . italic)
1181         (shorten-pair . (0.0 . -0.6))
1182         (staff-padding . 1.0)
1183         (padding . 0.5)
1184         (minimum-length . 1.0)
1185         (dash-fraction . 0.3)
1186         (edge-height . (0 . 1.2))
1187         (direction . ,UP)
1188         (outside-staff-priority . 400)
1189         (meta . ((class . Spanner)
1190                  (interfaces . (ottava-bracket-interface
1191                                 horizontal-bracket-interface
1192                                 line-interface
1193                                 side-position-interface
1194                                 font-interface
1195                                 text-interface))))))
1196
1197     (PaperColumn
1198      . (
1199         (axes . (0))
1200         (allow-loose-spacing . #t)
1201         (before-line-breaking . ,ly:paper-column::before-line-breaking)
1202         ;; (stencil . ,ly:paper-column::print)
1203         (X-extent . ,ly:axis-group-interface::width)
1204
1205         ;; debugging
1206         ;;                       (font-size . -6) (font-name . "sans") (Y-extent . #f)
1207         (meta . ((class . Paper_column)
1208                  (interfaces . (paper-column-interface
1209                                 axis-group-interface
1210                                 spaceable-grob-interface))))))
1211
1212     (ParenthesesItem
1213      . ((stencil . ,parentheses-item::print)
1214         (stencils . ,parentheses-item::calc-parenthesis-stencils)
1215         (font-size . -6)
1216         (padding . 0.2)
1217         (meta . ((class . Item)
1218                  (interfaces . (parentheses-interface font-interface))))
1219         ))
1220
1221     (HarmonicParenthesesItem
1222      . ((stencil . ,parentheses-item::print)
1223         (padding . 0)
1224         (stencils . ,parentheses-item::calc-angled-bracket-stencils)
1225         (meta . ((class . Item)
1226                  (interfaces . (parentheses-interface font-interface))))
1227         ))
1228
1229     (PhrasingSlur
1230      . ((details . ,default-slur-details)
1231         (control-points . ,ly:slur::calc-control-points)
1232         (direction . ,ly:slur::calc-direction)
1233         (springs-and-rods . ,ly:spanner::set-spacing-rods)
1234         (Y-extent . ,ly:slur::height)
1235         (stencil . ,ly:slur::print)
1236         (thickness . 1.1)
1237         (minimum-length . 1.5)
1238         (height-limit . 2.0)
1239         (ratio . 0.333)
1240         (meta . ((class . Spanner)
1241                  (interfaces . (slur-interface))))))
1242
1243
1244
1245     (PercentRepeat
1246      . (
1247         (springs-and-rods . ,ly:multi-measure-rest::set-spacing-rods)
1248         (stencil . ,ly:multi-measure-rest::percent)
1249         (slope . 1.0)
1250         (thickness . 0.48)
1251         (font-encoding . fetaMusic)
1252         (meta . ((class . Spanner)
1253                  (interfaces . (multi-measure-rest-interface
1254                                 font-interface
1255                                 percent-repeat-item-interface))))))
1256     (PercentRepeatCounter
1257      . (
1258         (stencil . ,ly:text-interface::print)
1259         (X-offset . ,(ly:make-simple-closure
1260                       `(,+ ,(ly:make-simple-closure (list ly:self-alignment-interface::x-centered-on-y-parent))
1261                            ,(ly:make-simple-closure (list ly:self-alignment-interface::x-aligned-on-self)))))
1262         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1263         (self-alignment-X . 0)
1264         (direction . ,UP)
1265         (padding . 0.2)
1266         (staff-padding . 0.25)
1267         (font-size . -2)
1268         (font-encoding . fetaNumber)
1269         (meta . ((class . Spanner)
1270                  (interfaces . (side-position-interface
1271                                 self-alignment-interface
1272                                 percent-repeat-item-interface
1273                                 font-interface
1274                                 text-interface))))))
1275
1276     ;; an example of a text spanner
1277     (PianoPedalBracket
1278      . (
1279         (stencil . ,ly:piano-pedal-bracket::print)
1280         (style . line)
1281         (bound-padding . 1.0)
1282         (direction . ,DOWN)
1283         (bracket-flare . (0.5 . 0.5))
1284         (edge-height . (1.0 . 1.0))
1285         (shorten-pair . (0.0 . 0.0))
1286         (thickness .  1.0)
1287         (meta . ((class . Spanner)
1288                  (interfaces . (line-interface
1289                                 piano-pedal-interface
1290                                 piano-pedal-bracket-interface))))))
1291
1292     (RehearsalMark
1293      . (
1294         (stencil . ,ly:text-interface::print)
1295         (X-offset . ,(ly:make-simple-closure
1296                       `(,+
1297                         ,(ly:make-simple-closure
1298                           (list ly:break-alignable-interface::self-align-callback))
1299                         ,(ly:make-simple-closure
1300                           (list ly:self-alignment-interface::x-aligned-on-self)))))
1301
1302         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1303         (self-alignment-X . 0)
1304         (direction . ,UP)
1305         (non-musical . #t)
1306         (font-size . 2)
1307         (baseline-skip . 2)
1308         (break-visibility . ,end-of-line-invisible)
1309         (break-align-symbol . clef)
1310         (padding . 0.8)
1311         (outside-staff-priority . 1500)
1312         (meta . ((class . Item)
1313                  (interfaces . (text-interface
1314                                 side-position-interface
1315                                 break-alignable-interface
1316                                 font-interface
1317                                 mark-interface
1318                                 self-alignment-interface))))))
1319
1320     (RepeatSlash
1321      . (
1322         (stencil . ,ly:percent-repeat-item-interface::beat-slash)
1323         (thickness . 0.48)
1324         (slope . 1.7)
1325         (meta . ((class . Item)
1326                  (interfaces . (rhythmic-grob-interface
1327                                 percent-repeat-item-interface))))))
1328
1329     (RepeatTie
1330      . (
1331         (stencil  . ,ly:tie::print)
1332         (control-points . ,ly:semi-tie::calc-control-points)
1333         (direction . ,ly:tie::calc-direction)
1334         (details . ((ratio . 0.333)
1335                     (height-limit . 1.0)))
1336         (thickness . 1.0)
1337         (head-direction . ,RIGHT)
1338         (meta . ((class . Item)
1339                  (interfaces . (semi-tie-interface))
1340                  ))
1341         ))
1342
1343     (RepeatTieColumn
1344      . (
1345         (X-extent . #f)
1346         (Y-extent . #f)
1347         (direction . ,ly:tie::calc-direction)
1348         (head-direction . ,RIGHT)
1349
1350         (positioning-done . ,ly:semi-tie-column::calc-positioning-done)
1351         (meta . ((class . Item)
1352                  (interfaces . (semi-tie-column-interface))
1353                  ))
1354         ))
1355
1356     (Rest
1357      . (
1358         (stencil . ,ly:rest::print)
1359         (duration-log . ,stem::calc-duration-log)
1360         (X-extent . ,ly:rest::width)
1361         (Y-extent . ,ly:rest::height)
1362         (Y-offset . ,ly:rest::y-offset-callback)
1363         (minimum-distance . 0.25)
1364         (meta . ((class . Item)
1365                  (interfaces . (font-interface
1366                                 rhythmic-head-interface
1367                                 rhythmic-grob-interface
1368                                 staff-symbol-referencer-interface
1369                                 rest-interface))))))
1370
1371     (RestCollision
1372      . (
1373         (minimum-distance . 0.75)
1374         (positioning-done . ,ly:rest-collision::calc-positioning-done)
1375         (meta . ((class . Item)
1376                  (interfaces . (rest-collision-interface))))))
1377
1378     (Script
1379      . (
1380         ;; don't set direction here: it breaks staccato.
1381
1382         ;; padding set in script definitions.
1383         (staff-padding . 0.25)
1384         (X-offset . ,ly:self-alignment-interface::centered-on-x-parent)
1385         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1386         (side-axis . ,Y)
1387
1388         (stencil . ,ly:script-interface::print)
1389         (direction . ,ly:script-interface::calc-direction)
1390         (font-encoding . fetaMusic)
1391         (meta . ((class . Item)
1392                  (interfaces . (script-interface
1393                                 side-position-interface
1394                                 font-interface))))))
1395
1396     (ScriptColumn
1397      . (
1398         (before-line-breaking . ,ly:script-column::before-line-breaking)
1399         (meta . ((class . Item)
1400                  (interfaces . (script-column-interface))))))
1401     (ScriptRow
1402      . (
1403         (before-line-breaking . ,ly:script-column::row-before-line-breaking)
1404         (meta . ((class . Item)
1405                  (interfaces . (script-column-interface))))))
1406
1407     (SeparationItem
1408      . (
1409         (avoid-slur . inside)
1410         (X-extent . ,ly:axis-group-interface::width)
1411         (Y-extent . ,ly:axis-group-interface::height)
1412         (skylines . ,ly:separation-item::calc-skylines)
1413         (meta . ((class . Item)
1414                  (interfaces . (
1415                                 separation-item-interface))))))
1416
1417     (SeparatingGroupSpanner
1418      . (
1419         (springs-and-rods . ,ly:separating-group-spanner::set-spacing-rods)
1420         (meta . ((class . Spanner)
1421                  (interfaces . (only-prebreak-interface
1422
1423                                 separating-group-spanner-interface))))))
1424
1425     (Slur
1426      . ((details . ,default-slur-details)
1427         (control-points . ,ly:slur::calc-control-points)
1428         (direction . ,ly:slur::calc-direction)
1429         (springs-and-rods . ,ly:spanner::set-spacing-rods)
1430         (Y-extent . ,ly:slur::height)
1431         (stencil . ,ly:slur::print)
1432         (thickness . 1.2)
1433         (line-thickness . 0.8)
1434         (minimum-length . 1.5)
1435         (height-limit . 2.0)
1436         (ratio . 0.25)
1437         (avoid-slur . inside)
1438         (meta . ((class . Spanner)
1439                  (interfaces . (slur-interface))))))
1440
1441     (SostenutoPedal
1442      . (
1443         (stencil . ,ly:text-interface::print)
1444         (direction . ,RIGHT)
1445         (X-offset . ,ly:self-alignment-interface::x-aligned-on-self)
1446         (extra-spacing-width . (+inf.0 . -inf.0))
1447         (padding . 0.0) ;; padding relative to SostenutoPedalLineSpanner
1448         (font-shape . italic)
1449         (self-alignment-X . 0)
1450         (meta . ((class . Item)
1451                  (interfaces . (text-interface
1452                                 self-alignment-interface
1453                                 piano-pedal-script-interface
1454                                 font-interface))))))
1455
1456     (SostenutoPedalLineSpanner
1457      . (
1458         (axes . (1))
1459         (Y-extent . ,ly:axis-group-interface::height)
1460         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1461         (side-axis . ,Y)
1462         (staff-padding . 1.0)
1463         (padding . 1.2)
1464         (minimum-space . 1.0)
1465         (direction . ,DOWN)
1466         (meta . ((class . Spanner)
1467                  (interfaces . (piano-pedal-interface
1468                                 axis-group-interface
1469                                 side-position-interface))))))
1470     (SpacingSpanner
1471      . (
1472         (springs-and-rods . ,ly:spacing-spanner::set-springs)
1473         (common-shortest-duration . ,ly:spacing-spanner::calc-common-shortest-duration)
1474         (average-spacing-wishes . #t)
1475         (shortest-duration-space . 2.0)
1476         (spacing-increment . 1.2)
1477
1478         (base-shortest-duration . ,(ly:make-moment 3 16))
1479         (meta . ((class . Spanner)
1480                  (interfaces . (
1481                                 spacing-options-interface
1482                                 spacing-spanner-interface))))))
1483
1484     (SpanBar
1485      . (
1486         (break-align-symbol . staff-bar)
1487         (Y-extent . ())
1488         (layer . 0)
1489         (non-musical . #t)
1490         (stencil . ,ly:span-bar::print)
1491         (bar-size . ,ly:span-bar::calc-bar-size)
1492         (X-extent . ,ly:span-bar::width)
1493         (glyph-name . ,ly:span-bar::calc-glyph-name)
1494         (before-line-breaking . ,ly:span-bar::before-line-breaking)
1495
1496         ;; ugh duplication!
1497
1498         ;;
1499         ;; Ross. page 151 lists other values, we opt for a leaner look
1500         ;;
1501         (kern . 3.0)
1502         (thin-kern . 3.0)
1503         (hair-thickness . 1.6)
1504         (thick-thickness . 6.0)
1505         (meta . ((class . Item)
1506                  (interfaces . (span-bar-interface
1507                                 font-interface
1508                                 bar-line-interface))))))
1509
1510     (StanzaNumber
1511      . (
1512         (stencil . ,ly:text-interface::print)
1513         (font-series . bold)
1514         (padding . 1.0)
1515         (X-offset . ,ly:side-position-interface::x-aligned-side)
1516         (side-axis . ,X)
1517         (direction . ,LEFT)
1518         (meta . ((class . Item)
1519                  (interfaces . (side-position-interface
1520                                 stanza-number-interface
1521                                 text-interface
1522                                 font-interface))))))
1523
1524
1525     (StaffSpacing
1526      . (
1527         (non-musical . #t)
1528         (stem-spacing-correction . 0.4)
1529         (meta . ((class . Item)
1530                  (interfaces . (staff-spacing-interface))))))
1531
1532
1533     (StaffSymbol
1534      . (
1535         (Y-extent . ,ly:staff-symbol::height)
1536         (stencil . ,ly:staff-symbol::print)
1537         (line-count . 5)
1538         (ledger-line-thickness . (1.0 . 0.1))
1539         (layer . 0)
1540         (meta . ((class . Spanner)
1541                  (interfaces . (staff-symbol-interface))))))
1542
1543     (Stem
1544      . (
1545         (direction . ,ly:stem::calc-direction)
1546         (duration-log . ,stem::calc-duration-log)
1547         (default-direction . ,ly:stem::calc-default-direction)
1548         (stem-end-position . ,ly:stem::calc-stem-end-position)
1549
1550         (neutral-direction . ,DOWN)
1551         (stem-info . ,ly:stem::calc-stem-info)
1552         (positioning-done . ,ly:stem::calc-positioning-done)
1553         (stencil . ,ly:stem::print)
1554         (X-extent . ,ly:stem::width)
1555         (Y-extent . ,ly:stem::height)
1556         (length . ,ly:stem::calc-length)
1557         (thickness . 1.3)
1558         (details
1559          . (
1560             ;; 3.5 (or 3 measured from note head) is standard length
1561             ;; 32nd, 64th flagged stems should be longer
1562             (lengths . (3.5 3.5 3.5 4.5 5.0))
1563
1564             ;; FIXME.  3.5 yields too long beams (according to Ross and
1565             ;; looking at Baerenreiter examples) for a number of common
1566             ;; boundary cases.  Subtracting half a beam thickness fixes
1567             ;; this, but the bug may well be somewhere else.
1568
1569             ;; FIXME this should come from 'lengths
1570             (beamed-lengths . (3.26 3.5 3.6))
1571
1572             ;; The 'normal' minima
1573             (beamed-minimum-free-lengths . (1.83 1.5 1.25))
1574                                         ;(beamed-minimum-free-lengths . (2.0 1.83 1.25))
1575
1576             ;; The 'extreme case' minima
1577             (beamed-extreme-minimum-free-lengths . (2.0 1.25))
1578
1579             ;; Stems in unnatural (forced) direction should be shortened by
1580             ;; one staff space, according to [Roush & Gourlay].
1581             ;; Flagged stems we shorten only half a staff space.
1582             (stem-shorten . (1.0 0.5))
1583
1584             ))
1585
1586         ;; We use the normal minima as minimum for the ideal lengths,
1587         ;; and the extreme minima as abolute minimum length.
1588
1589         (X-offset . ,ly:stem::offset-callback)
1590         (Y-offset . ,ly:staff-symbol-referencer::callback)
1591         (meta . ((class . Item)
1592                  (interfaces . (stem-interface
1593                                 font-interface))))))
1594
1595     (StemTremolo
1596      . (
1597         (Y-extent . ,ly:stem-tremolo::height)
1598         (stencil . ,ly:stem-tremolo::print)
1599         (X-extent . #f)
1600         (slope . ,ly:stem-tremolo::calc-slope)
1601         (beam-width . ,ly:stem-tremolo::calc-width) ; staff-space
1602         (style . ,ly:stem-tremolo::calc-style)
1603         (beam-thickness . 0.48) ; staff-space
1604         (meta . ((class . Item)
1605                  (interfaces . (stem-tremolo-interface))))))
1606
1607     (StringNumber
1608      . (
1609         (stencil . ,print-circled-text-callback)
1610         (text . ,string-number::calc-text)
1611         (padding . 0.5)
1612         (staff-padding . 0.5)
1613         (self-alignment-X . 0)
1614         (self-alignment-Y . 0)
1615         (script-priority . 100)
1616         (font-encoding . fetaNumber)
1617         (font-size . -5)                ; don't overlap when next to heads.
1618         (meta . ((class . Item)
1619                  (interfaces . (string-number-interface
1620                                 font-interface
1621                                 text-script-interface
1622                                 text-interface
1623                                 side-position-interface
1624                                 self-alignment-interface
1625                                 ))))))
1626
1627     (StrokeFinger
1628      . (
1629         (stencil . ,ly:text-interface::print)
1630         (text . ,stroke-finger::calc-text)
1631         (digit-names . #("p" "i" "m" "a" "x"))
1632         (padding . 0.5)
1633         (staff-padding . 0.5)
1634         (self-alignment-X . 0)
1635         (self-alignment-Y . 0)
1636         (script-priority . 100)
1637         (font-shape . italic)
1638         (font-size . -4)                ; don't overlap when next to heads.
1639         (meta . ((class . Item)
1640                  (interfaces . (stroke-finger-interface
1641                                 font-interface
1642                                 text-script-interface
1643                                 text-interface
1644                                 side-position-interface
1645                                 self-alignment-interface
1646                                 ))))))
1647
1648
1649     (SustainPedal
1650      . (
1651         (extra-spacing-width . (+inf.0 . -inf.0))
1652         (stencil . ,ly:sustain-pedal::print)
1653         (self-alignment-X . 0)
1654         (direction . ,RIGHT)
1655         (padding . 0.0)  ;; padding relative to SustainPedalLineSpanner
1656         (X-offset . ,ly:self-alignment-interface::x-aligned-on-self)
1657         (meta . ((class . Item)
1658                  (interfaces . (piano-pedal-interface
1659                                 text-spanner-interface
1660                                 line-spanner-interface
1661                                 text-interface
1662                                 self-alignment-interface
1663                                 piano-pedal-script-interface
1664                                 font-interface))))))
1665
1666     (SustainPedalLineSpanner
1667      . (
1668         (axes . (1))
1669         (Y-extent . ,ly:axis-group-interface::height)
1670         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1671         (side-axis . ,Y)
1672         (padding . 1.2)
1673         (staff-padding . 1.2)
1674         (minimum-space . 1.0)
1675         (direction . ,DOWN)
1676         (meta . ((class . Spanner)
1677                  (interfaces . (piano-pedal-interface
1678                                 axis-group-interface
1679                                 side-position-interface))))))
1680
1681     (System
1682      . (
1683         (axes . (0 1))
1684         (X-extent . ,ly:axis-group-interface::width)
1685         (Y-extent . ,ly:axis-group-interface::height)
1686         (skylines . ,ly:axis-group-interface::calc-skylines)
1687         (skyline-horizontal-padding . 1.0)
1688         (meta . ((class . System)
1689                  (interfaces . (system-interface
1690                                 axis-group-interface))))))
1691
1692     (SystemStartBrace
1693      . (
1694         (style . brace)
1695         (padding . 0.3)
1696         (stencil . ,ly:system-start-delimiter::print)
1697         (collapse-height . 5.0)
1698         (X-offset . ,ly:side-position-interface::x-aligned-side)
1699         (direction . ,LEFT)
1700         (font-encoding . fetaBraces)
1701         (Y-extent . #f)
1702         (meta . ((class . Spanner)
1703                  (interfaces . (system-start-delimiter-interface
1704                                 side-position-interface
1705                                 font-interface))))))
1706
1707
1708     (SystemStartSquare
1709      . (
1710         (Y-extent . #f)
1711         (X-offset . ,ly:side-position-interface::x-aligned-side)
1712         (direction . ,LEFT)
1713         (stencil . ,ly:system-start-delimiter::print)
1714         (style . line-bracket)
1715         (thickness . 1.0)
1716         (meta . ((class . Spanner)
1717                  (interfaces . (font-interface
1718                                 side-position-interface
1719                                 system-start-delimiter-interface))))))
1720     (SystemStartBracket
1721      . (
1722         (Y-extent . #f)
1723         (padding . 0.8)
1724         (X-offset . ,ly:side-position-interface::x-aligned-side)
1725         (direction . ,LEFT)
1726         (stencil . ,ly:system-start-delimiter::print)
1727         (style . bracket)
1728         (collapse-height . 5.0)
1729         (thickness . 0.45)
1730         (meta . ((class . Spanner)
1731                  (interfaces . (font-interface
1732                                 side-position-interface
1733                                 system-start-delimiter-interface))))))
1734
1735     (SystemStartBar
1736      . (
1737         (Y-extent . #f)
1738
1739         ;; ugh--hardcoded.
1740         (padding . -0.1)  ;; bar must cover rounded ending of staff line.
1741         (X-offset . ,ly:side-position-interface::x-aligned-side)
1742         (direction . ,LEFT)
1743         (style . bar-line)
1744         (thickness . 1.6)
1745         (stencil . ,ly:system-start-delimiter::print)
1746         (meta . ((class . Spanner)
1747                  (interfaces . (side-position-interface
1748                                 system-start-delimiter-interface))))))
1749
1750     (TabNoteHead
1751      . (
1752         (stencil . ,ly:text-interface::print)
1753         (Y-offset . ,ly:staff-symbol-referencer::callback)
1754         (X-offset . ,ly:self-alignment-interface::x-aligned-on-self)
1755         (direction . 0)
1756         (font-size . -2)
1757         (stem-attachment . (0.0 . 1.35))
1758         (font-series . bold)
1759         (meta . ((class . Item)
1760                  (interfaces
1761                   . (rhythmic-head-interface
1762                      font-interface rhythmic-grob-interface
1763                      note-head-interface
1764                      staff-symbol-referencer-interface
1765                      text-interface))))))
1766
1767     (TextScript
1768      . (
1769         (extra-spacing-width . (+inf.0 . -inf.0))
1770         (X-offset . ,ly:self-alignment-interface::x-aligned-on-self)
1771         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1772         (side-axis . ,Y)
1773         (direction . ,DOWN)
1774
1775         ;; sync with Fingering ?
1776         (padding . 0.5)
1777         (staff-padding . 0.5)
1778
1779         (stencil . ,ly:text-interface::print)
1780         (direction . ,ly:script-interface::calc-direction)
1781
1782         (outside-staff-priority . 450)
1783         (avoid-slur . around)
1784         (slur-padding . 0.5)
1785         (script-priority . 200)
1786         ;; todo: add X self alignment?
1787         (meta . ((class . Item)
1788                  (interfaces . (text-script-interface
1789                                 text-interface
1790                                 side-position-interface
1791                                 font-interface))))))
1792
1793     (TextSpanner
1794      . (
1795         (stencil . ,ly:text-spanner::print)
1796         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1797         (font-shape . italic)
1798         (style . dashed-line)
1799         (staff-padding . 0.8)
1800         (dash-fraction . 0.2)
1801         (dash-period . 3.0)
1802         (side-axis . ,Y)
1803         (direction . ,UP)
1804         (outside-staff-priority . 350)
1805         (meta . ((class . Spanner)
1806                  (interfaces . (text-spanner-interface
1807                                 line-spanner-interface
1808                                 side-position-interface
1809                                 font-interface))))))
1810
1811     (Tie
1812      . (
1813         (control-points . ,ly:tie::calc-control-points)
1814         (springs-and-rods . ,ly:spanner::set-spacing-rods)
1815         (avoid-slur . inside)
1816         (direction . ,ly:tie::calc-direction)
1817         (stencil . ,ly:tie::print)
1818         (font-size . -6)
1819         (details . (
1820                     ;; for a full list, see tie-details.cc
1821                     (ratio . 0.333)
1822                     (center-staff-line-clearance . 0.6)
1823                     (tip-staff-line-clearance . 0.45)
1824                     (note-head-gap . 0.2)
1825                     (stem-gap . 0.35)
1826                     (height-limit . 1.0)
1827                     (horizontal-distance-penalty-factor . 10)
1828                     (same-dir-as-stem-penalty . 8)
1829                     (min-length-penalty-factor . 26)
1830                     (tie-tie-collision-distance . 0.45)
1831                     (tie-tie-collision-penalty . 25.0)
1832                     (intra-space-threshold . 1.25)
1833                     (outer-tie-vertical-distance-symmetry-penalty-factor . 10)
1834                     (outer-tie-length-symmetry-penalty-factor . 10)
1835                     (vertical-distance-penalty-factor . 7)
1836                     (outer-tie-vertical-gap . 0.25)
1837                     (multi-tie-region-size . 1)
1838                     (single-tie-region-size . 4)
1839                     (between-length-limit . 1.0)))
1840
1841         (thickness . 1.2)
1842         (line-thickness . 0.8)
1843         (meta . ((class . Spanner)
1844                  (interfaces . (tie-interface))))
1845         ))
1846
1847     (TieColumn
1848      . (
1849         (positioning-done . ,ly:tie-column::calc-positioning-done)
1850         (before-line-breaking . ,ly:tie-column::before-line-breaking)
1851         (X-extent . #f)
1852         (Y-extent . #f)
1853         (meta . ((class . Spanner)
1854                  (interfaces . (tie-column-interface))))))
1855
1856     (TimeSignature
1857      . (
1858         (stencil . ,ly:time-signature::print)
1859         (break-align-symbol . time-signature)
1860         (break-visibility . ,all-visible)
1861         (avoid-slur . inside)
1862         (space-alist . (
1863                         (first-note . (fixed-space . 2.0))
1864                         (right-edge . (extra-space . 0.5))
1865                         (staff-bar . (minimum-space . 2.0))))
1866         (non-musical . #t)
1867         (style . C)
1868         (meta . ((class . Item)
1869                  (interfaces . (time-signature-interface
1870                                 break-aligned-interface
1871                                 font-interface))))))
1872
1873     (TrillSpanner
1874      . (
1875         (left-bound-info . ,ly:new-line-spanner::calc-left-bound-info)
1876         (right-bound-info . ,ly:new-line-spanner::calc-right-bound-info)
1877         (bound-details . ((left . ((text . ,(make-translate-scaled-markup
1878                                              '(0 . -0.6)
1879                                              (make-musicglyph-markup "scripts.trill")))
1880                                    (Y . 0)
1881                                    (padding . 0.25)
1882                                    ))
1883                           (right . ((Y . 0)))
1884                           ))
1885         (stencil . ,ly:new-line-spanner::print)
1886
1887         (style . trill)
1888         (staff-padding . 1.0)
1889         (padding . 0.5)
1890         (direction . ,UP)
1891         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1892         (side-axis . ,Y)
1893         (outside-staff-priority . 50)
1894         (meta . ((class . Spanner)
1895                  (interfaces . (text-spanner-interface
1896                                 line-spanner-interface
1897                                 side-position-interface
1898                                 font-interface))))))
1899
1900     (TrillPitchAccidental
1901      . ((X-offset . ,ly:side-position-interface::x-aligned-side)
1902         (padding . 0.2)
1903         (direction . ,LEFT)
1904         (font-size . -4)
1905         (side-axis . ,X)
1906         (stencil . ,ly:accidental-interface::print)
1907         (Y-extent . ,ly:accidental-interface::height)
1908         (glyph-name-alist . ,standard-alteration-glyph-name-alist)
1909         (meta . ((class . Item)
1910                  (interfaces . (trill-pitch-accidental-interface
1911                                 accidental-interface
1912                                 side-position-interface
1913                                 font-interface))))))
1914
1915     (TrillPitchGroup
1916      . ((X-offset . ,ly:side-position-interface::x-aligned-side)
1917         (axes . (,X))
1918         (font-size . -4)
1919         (stencil . ,parenthesize-elements)
1920         (stencils . ,parentheses-item::calc-parenthesis-stencils)
1921         (direction . ,RIGHT)
1922         (side-axis . ,X)
1923         (padding . 0.3)
1924         (meta . ((class . Item)
1925                  (interfaces . (side-position-interface
1926                                 parentheses-interface
1927                                 note-head-interface
1928                                 rhythmic-head-interface
1929                                 font-interface
1930                                 axis-group-interface))))))
1931
1932     (TrillPitchHead
1933      . (
1934         (stencil . ,ly:note-head::print)
1935         (duration-log . 2)
1936         (Y-offset . ,ly:staff-symbol-referencer::callback)
1937         (font-size . -4)
1938         (meta . ((class . Item)
1939                  (interfaces . (rhythmic-head-interface
1940                                 font-interface
1941                                 pitched-trill-interface
1942                                 ledgered-interface
1943                                 staff-symbol-referencer-interface))))))
1944
1945     (TupletBracket
1946      . (
1947         (padding . 1.1)
1948         (thickness . 1.6)
1949         (edge-height . (0.7 . 0.7))
1950         (shorten-pair . (-0.2 . -0.2))
1951         (staff-padding . 0.25)
1952         (direction  . ,ly:tuplet-bracket::calc-direction)
1953         (positions . ,ly:tuplet-bracket::calc-positions)
1954         (connect-to-neighbor . ,ly:tuplet-bracket::calc-connect-to-neighbors)
1955         (control-points . ,ly:tuplet-bracket::calc-control-points)
1956         (stencil . ,ly:tuplet-bracket::print)
1957
1958         (meta . ((class . Spanner)
1959                  (interfaces . (line-interface
1960                                 tuplet-bracket-interface))))))
1961
1962     (TupletNumber
1963      . (
1964         (stencil . ,ly:tuplet-number::print)
1965         (text . ,tuplet-number::calc-denominator-text)
1966         (font-shape . italic)
1967         (font-size . -2)
1968         (avoid-slur . inside)
1969         (meta . ((class . Spanner)
1970                  (interfaces . (text-interface tuplet-number-interface
1971                                 font-interface))))))
1972
1973     (UnaCordaPedal
1974      . (
1975         (stencil . ,ly:text-interface::print)
1976         (font-shape . italic)
1977         (extra-spacing-width . (+inf.0 . -inf.0))
1978         (self-alignment-X . 0)
1979         (direction . ,RIGHT)
1980         (padding . 0.0)  ;; padding relative to UnaCordaPedalLineSpanner
1981         (X-offset . ,ly:self-alignment-interface::x-aligned-on-self)
1982         (meta . ((class . Item)
1983                  (interfaces . (text-interface
1984                                 piano-pedal-script-interface
1985                                 self-alignment-interface
1986                                 font-interface))))))
1987
1988     (UnaCordaPedalLineSpanner
1989      . (
1990         (axes . (1))
1991         (Y-extent . ,ly:axis-group-interface::height)
1992         (Y-offset . ,ly:side-position-interface::y-aligned-side)
1993         (side-axis . ,Y)
1994         (padding . 1.2)
1995         (staff-padding . 1.2)
1996         (minimum-space . 1.0)
1997         (direction . ,DOWN)
1998         (meta . ((class . Spanner)
1999                  (interfaces . (piano-pedal-interface
2000                                 axis-group-interface
2001                                 side-position-interface))))))
2002
2003     (VaticanaLigature
2004      . (
2005         (thickness . 0.6)
2006         (flexa-width . 2.0)
2007         (stencil . ,ly:vaticana-ligature::print)
2008         (meta . ((class . Spanner)
2009                  (interfaces . (vaticana-ligature-interface
2010                                 font-interface))))))
2011
2012     (VerticalAlignment
2013      . (
2014         (axes . (1))
2015         (positioning-done . ,ly:align-interface::calc-positioning-done)
2016         (after-line-breaking . ,ly:align-interface::stretch-after-break)
2017         (Y-extent . ,ly:axis-group-interface::height)
2018         (X-extent . ,ly:axis-group-interface::width)
2019         (stacking-dir . -1)
2020         (padding . 0.5)
2021         (skylines . ,ly:axis-group-interface::combine-skylines)
2022         (meta . ((class . Spanner)
2023                  (object-callbacks . ((Y-common . ,ly:axis-group-interface::calc-y-common)))
2024                  (interfaces . (align-interface
2025                                 axis-group-interface))))))
2026     (VerticalAxisGroup
2027      . (
2028         (axes . (1))
2029         (Y-offset . ,ly:hara-kiri-group-spanner::force-hara-kiri-callback)
2030         (Y-extent . ,ly:hara-kiri-group-spanner::y-extent)
2031         (X-extent . ,ly:axis-group-interface::width)
2032         (skylines . ,ly:axis-group-interface::calc-skylines);
2033         (meta . ((class . Spanner)
2034                  (object-callbacks . ((X-common . ,ly:axis-group-interface::calc-x-common)))
2035                  (interfaces . (axis-group-interface
2036                                 hara-kiri-group-spanner-interface
2037                                 vertically-spaceable-interface))))))
2038
2039
2040     (VoltaBracket
2041      . (
2042         (stencil . ,ly:volta-bracket-interface::print)
2043         (direction . ,UP)
2044         (padding . 1)
2045         (font-encoding . fetaNumber)
2046         (Y-offset . ,ly:side-position-interface::y-aligned-side)
2047         (side-axis . ,Y)
2048         (thickness . 1.6)  ;;  line-thickness
2049         (edge-height . (2.0 . 2.0)) ;; staff-space;
2050         (minimum-space . 5)
2051         (font-size . -4)
2052         (outside-staff-priority . 100)
2053         (meta . ((class . Spanner)
2054                  (interfaces . (volta-bracket-interface
2055                                 horizontal-bracket-interface
2056                                 line-interface
2057                                 text-interface
2058                                 side-position-interface
2059                                 font-interface)))
2060               )))
2061
2062
2063     (VoiceFollower
2064      . (
2065         (style . line)
2066         (gap . 0.5)
2067         (non-musical . #t)
2068         (X-extent . #f)
2069         (Y-extent . #f)
2070         (stencil . ,ly:line-spanner::print)
2071         (after-line-breaking . ,ly:line-spanner::after-line-breaking)
2072         (meta . ((class . Spanner)
2073                  (interfaces . (line-spanner-interface
2074                                 line-interface))))
2075         ))
2076
2077 ))
2078
2079 (define (completize-grob-entry x)
2080   "Transplant assoc key into 'name entry of 'meta of X.  Set interfaces for Item, Spanner etc.
2081 "
2082   ;;  (display (car x))
2083   ;;  (newline)
2084   (let* ((name-sym  (car x))
2085          (grob-entry (cdr x))
2086          (meta-entry (cdr (assoc 'meta grob-entry)))
2087          (class (cdr (assoc 'class meta-entry)))
2088          (ifaces-entry
2089           (cdr (assoc 'interfaces meta-entry))))
2090
2091     (cond
2092      ((eq? 'Item class)
2093       (set! ifaces-entry (cons 'item-interface ifaces-entry)))
2094      ((eq? 'Spanner class)
2095       (set! ifaces-entry (cons 'spanner-interface ifaces-entry)))
2096      ((eq? 'Paper_column class)
2097       (set! ifaces-entry (cons 'item-interface
2098                                (cons 'paper-column-interface ifaces-entry))))
2099      ((eq? 'System class)
2100       (set! ifaces-entry (cons 'system-interface
2101                                (cons 'spanner-interface ifaces-entry))))
2102      (else
2103       (ly:warning "Unknown class ~a" class)))
2104
2105     (set! ifaces-entry (uniq-list (sort ifaces-entry symbol<?)))
2106     (set! ifaces-entry (cons 'grob-interface ifaces-entry))
2107
2108     (set! meta-entry (assoc-set! meta-entry 'name name-sym))
2109     (set! meta-entry (assoc-set! meta-entry 'interfaces
2110                                  ifaces-entry))
2111     (set! grob-entry (assoc-set! grob-entry 'meta meta-entry))
2112     (cons name-sym grob-entry)))
2113
2114 (set! all-grob-descriptions (map completize-grob-entry all-grob-descriptions))
2115
2116 ;;  (display (map pair? all-grob-descriptions))
2117
2118 ;; make sure that \property Foo.Bar =\turnOff doesn't complain
2119
2120 (map (lambda (x)
2121        ;; (display (car x)) (newline)
2122
2123        (set-object-property! (car x) 'translation-type? list?)
2124        (set-object-property! (car x) 'is-grob? #t))
2125      all-grob-descriptions)
2126
2127 (set! all-grob-descriptions (sort all-grob-descriptions alist<?))
2128
2129 (define pure-print-callbacks
2130   (list
2131    ly:bar-line::print
2132    ly:note-head::print
2133    ly:dots::print
2134    ly:clef::print
2135    ly:text-interface::print
2136    ly:script-interface::print))
2137
2138 ;; ly:grob::stencil-extent is safe iff the print callback is safe too
2139 (define (pure-stencil-height grob start stop)
2140   (let ((sten (ly:grob-property-data grob 'stencil)))
2141     (if (or
2142          (ly:stencil? sten)
2143          (memq sten pure-print-callbacks))
2144         (ly:grob::stencil-height grob)
2145         '(0 . 0))))
2146
2147 (define pure-conversions-alist
2148   `(
2149     (,ly:accidental-interface::height . ,ly:accidental-interface::pure-height)
2150     (,ly:slur::outside-slur-callback . ,ly:slur::pure-outside-slur-callback)
2151     (,ly:stem::height . ,ly:stem::pure-height)
2152     (,ly:rest::height . ,ly:rest::pure-height)
2153     (,ly:grob::stencil-height . ,pure-stencil-height)
2154     (,ly:side-position-interface::y-aligned-side . ,ly:side-position-interface::pure-y-aligned-side)
2155     (,ly:axis-group-interface::height . ,ly:axis-group-interface::pure-height)
2156     (,ly:hara-kiri-group-spanner::y-extent . ,ly:hara-kiri-group-spanner::pure-height)
2157     (,ly:slur::height . ,ly:slur::pure-height)
2158     (,ly:side-position-interface::y-aligned-side . ,ly:side-position-interface::pure-y-aligned-side)))
2159
2160 (define pure-functions
2161   (list
2162    ly:staff-symbol-referencer::callback
2163    ly:staff-symbol::height))
2164
2165 (define-public (pure-relevant? grob)
2166   (let ((extent-callback (ly:grob-property-data grob 'Y-extent)))
2167     (not (eq? #f
2168               (or
2169                (pair? extent-callback)
2170                (memq extent-callback pure-functions)
2171                (and
2172                 (pair? (assq extent-callback pure-conversions-alist))
2173                 (begin
2174                   (or
2175                    (not (eq? extent-callback ly:grob::stencil-height))
2176                    (memq (ly:grob-property-data grob 'stencil) pure-print-callbacks)
2177                    (ly:stencil? (ly:grob-property-data grob 'stencil))
2178
2179                    ))))))))
2180
2181 (define-public (call-pure-function unpure args start end)
2182   (if (ly:simple-closure? unpure)
2183       (ly:eval-simple-closure (car args) unpure start end)
2184       (if (not (procedure? unpure))
2185           unpure
2186           (if (memq unpure pure-functions)
2187               (apply unpure args)
2188               (let ((pure (assq unpure pure-conversions-alist)))
2189                 (if pure
2190                     (apply (cdr pure)
2191                            (append
2192                             (list (car args) start end)
2193                             (cdr args)))))))))