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