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