ly/engraver-init.ly

   1 %%%% This file is part of LilyPond, the GNU music typesetter.
   2 %%%%
   3 %%%% Copyright (C) 1996--2014 Han-Wen Nienhuys <hanwen@xs4all.nl>
   4 %%%%                          Jan Nieuwenhuizen <janneke@gnu.org>
   5 %%%%
   6 %%%% LilyPond is free software: you can redistribute it and/or modify
   7 %%%% it under the terms of the GNU General Public License as published by
   8 %%%% the Free Software Foundation, either version 3 of the License, or
   9 %%%% (at your option) any later version.
  10 %%%%
  11 %%%% LilyPond is distributed in the hope that it will be useful,
  12 %%%% but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 %%%% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14 %%%% GNU General Public License for more details.
  15 %%%%
  16 %%%% You should have received a copy of the GNU General Public License
  17 %%%% along with LilyPond.  If not, see <http://www.gnu.org/licenses/>.
  18
  19 \version "2.17.29"
  20
  21 \context {
  22   \name "Global"
  23
  24   \accepts "Score"
  25
  26   \defaultchild "Score"
  27   \description "Hard coded entry point for LilyPond.  Cannot be tuned."
  28   \grobdescriptions #all-grob-descriptions
  29 }
  30
  31 \context {
  32   \type "Engraver_group"
  33   \name "FretBoards"
  34   \alias "Staff"
  35   \description "A context for displaying fret diagrams."
  36
  37   \consists "Fretboard_engraver"
  38   \consists "Output_property_engraver"
  39   \consists "Axis_group_engraver"
  40   \consists "Separating_line_group_engraver"
  41   \consists "Font_size_engraver"
  42   \consists "Instrument_name_engraver"
  43
  44   %% explicitly set instrument, so it is not inherited from the parent
  45   instrumentName = #'()
  46   shortInstrumentName = #'()
  47
  48   predefinedDiagramTable = #default-fret-table
  49   handleNegativeFrets = #'recalculate
  50   restrainOpenStrings = ##f
  51 }
  52
  53 \context {
  54   \type "Engraver_group"
  55   \name "Staff"
  56
  57   \consists "Output_property_engraver"
  58   \consists "Bar_engraver"
  59   \consists "Pure_from_neighbor_engraver"
  60   %% Bar_engraver must be first so default bars aren't overwritten
  61   %% with empty ones.
  62
  63   \consists "Font_size_engraver"
  64   \consists "Separating_line_group_engraver"
  65   \consists "Dot_column_engraver"
  66   \consists "Staff_collecting_engraver"
  67
  68  %% perhaps move to Voice context?
  69   \consists "Ottava_spanner_engraver"
  70   \consists "Clef_engraver"
  71   \consists "Key_engraver"
  72   \consists "Time_signature_engraver"
  73   \consists "Ledger_line_engraver"
  74   \consists "Staff_symbol_engraver"
  75   \consists "Collision_engraver"
  76   \consists "Grob_pq_engraver"
  77   \consists "Rest_collision_engraver"
  78   \consists "Accidental_engraver"
  79   \consists "Piano_pedal_engraver"
  80   \consists "Piano_pedal_align_engraver"
  81   \consists "Instrument_name_engraver"
  82   \consists "Axis_group_engraver"
  83   \consists "Figured_bass_engraver"
  84   \consists "Figured_bass_position_engraver"
  85   \consists "Script_row_engraver"
  86   \consists "Cue_clef_engraver"
  87   \consists "Fingering_column_engraver"
  88
  89   localAlterations = #'()
  90   createSpacing = ##t
  91   ignoreFiguredBassRest = ##f
  92
  93   %% explicitly set instrument, so we don't get
  94   %% weird effects when doing instrument names for
  95   %% piano staves
  96   instrumentName = #'()
  97   shortInstrumentName = #'()
  98
  99   \defaultchild "Voice"
 100   \accepts "Voice"
 101   \accepts "CueVoice"
 102   \accepts "NullVoice"
 103
 104   \description "Handles clefs, bar lines, keys, accidentals.  It can contain
 105 @code{Voice} contexts."
 106
 107 }
 108
 109 \context {
 110   \Staff
 111   \type "Engraver_group"
 112   \name "DrumStaff"
 113   \alias "Staff"
 114
 115   \remove "Accidental_engraver"
 116   \remove "Ottava_spanner_engraver"
 117   \remove "Key_engraver"
 118   \remove "Piano_pedal_engraver"
 119
 120   \description "Handles typesetting for percussion."
 121
 122   \denies "Voice"
 123   \accepts "DrumVoice"
 124   \defaultchild "DrumVoice"
 125
 126   clefGlyph = #"clefs.percussion"
 127   clefPosition = #0
 128   \override Script.staff-padding = #0.75
 129 }
 130
 131
 132 \context {
 133   \type "Engraver_group"
 134   \name "ChoirStaff"
 135   \consists "Vertical_align_engraver"
 136   topLevelAlignment = ##f
 137
 138   \consists "Instrument_name_engraver"
 139   \consists "System_start_delimiter_engraver"
 140   systemStartDelimiter = #'SystemStartBracket
 141   %% explicitly set instrument, so it is not inherited from the parent
 142   instrumentName = #'()
 143   shortInstrumentName = #'()
 144   vocalName = #'()
 145   shortVocalName = #'()
 146
 147   \accepts "Staff"
 148   \accepts "DrumStaff"
 149   \accepts "RhythmicStaff"
 150   \accepts "GrandStaff"
 151   \accepts "PianoStaff"
 152   \accepts "Lyrics"
 153   \accepts "ChordNames"
 154   \accepts "FiguredBass"
 155   \accepts "ChoirStaff"
 156   \accepts "StaffGroup"
 157   \defaultchild "Staff"
 158   \description "Identical to @code{StaffGroup} except that the
 159 contained staves are not connected vertically."
 160 }
 161
 162 \context{
 163   \type "Engraver_group"
 164
 165   localAlterations = #'()
 166   createSpacing = ##t
 167
 168   squashedPosition = #0
 169   \name RhythmicStaff
 170   \alias "Staff"
 171
 172   \override VoltaBracket.staff-padding = #3
 173   \override StaffSymbol.line-count = #1
 174
 175   \override Stem.neutral-direction = #UP
 176   \override Beam.neutral-direction = #UP
 177
 178   \consists "Output_property_engraver"
 179   \consists "Font_size_engraver"
 180   \consists "Separating_line_group_engraver"
 181   \consists "Dot_column_engraver"
 182   \consists "Bar_engraver"
 183   \consists "Staff_symbol_engraver"
 184   \consists "Pitch_squash_engraver"
 185   \consists "Time_signature_engraver"
 186   \consists "Instrument_name_engraver"
 187   \consists "Axis_group_engraver"
 188   \consists "Ledger_line_engraver"
 189
 190   %% explicitly set instrument, so it is not inherited from the parent
 191   instrumentName = #'()
 192   shortInstrumentName = #'()
 193
 194   \accepts "Voice"
 195   \accepts "CueVoice"
 196   \defaultchild "Voice"
 197
 198   \description "A context like @code{Staff} but for printing rhythms.
 199 Pitches are ignored; the notes are printed on one line."
 200 }
 201
 202
 203 \context {
 204   \type "Engraver_group"
 205   \name "Voice"
 206
 207   \description "Corresponds to a voice on a staff.  This context
 208 handles the conversion of dynamic signs, stems, beams, super- and
 209 subscripts, slurs, ties, and rests.
 210
 211 You have to instantiate this explicitly if you want to have
 212 multiple voices on the same staff."
 213
 214   \consists "Font_size_engraver"
 215
 216   \consists "Pitched_trill_engraver"
 217   \consists "Output_property_engraver"
 218   \consists "Arpeggio_engraver"
 219   \consists "Multi_measure_rest_engraver"
 220   \consists "Text_spanner_engraver"
 221   \consists "Trill_spanner_engraver"
 222   \consists "Grob_pq_engraver"
 223   \consists "Forbid_line_break_engraver"
 224   \consists "Laissez_vibrer_engraver"
 225   \consists "Repeat_tie_engraver"
 226   \consists "Note_head_line_engraver"
 227   \consists "Glissando_engraver"
 228   \consists "Ligature_bracket_engraver"
 229   \consists "Breathing_sign_engraver"
 230   \consists "Note_heads_engraver"
 231   \consists "Dots_engraver"
 232   \consists "Rest_engraver"
 233
 234   %% switch on to make stem directions interpolate for the
 235   %% center line.
 236   %  \consists "Melody_engraver"
 237
 238   \consists "Stem_engraver"
 239   \consists "Beam_engraver"
 240   \consists "Grace_beam_engraver"
 241   \consists "Auto_beam_engraver"
 242   \consists "Grace_auto_beam_engraver"
 243
 244   %% must come before Script_column_engraver.
 245   \consists "New_fingering_engraver"
 246
 247   \consists "Chord_tremolo_engraver"
 248   \consists "Double_percent_repeat_engraver"
 249   \consists "Percent_repeat_engraver"
 250   \consists "Slash_repeat_engraver"
 251   \consists "Part_combine_engraver"
 252
 253   \consists "Text_engraver"
 254   \consists "Dynamic_engraver"
 255   \consists "Dynamic_align_engraver"
 256   \consists "Fingering_engraver"
 257   \consists "Bend_engraver"
 258
 259   \consists "Script_engraver"
 260   \consists "Script_column_engraver"
 261   \consists "Rhythmic_column_engraver"
 262   \consists "Note_spacing_engraver"
 263   \consists "Spanner_break_forbid_engraver"
 264   \consists "Phrasing_slur_engraver"
 265   \consists "Cluster_spanner_engraver"
 266   \consists "Slur_engraver"
 267   \consists "Tie_engraver"
 268   \consists "Tuplet_engraver"
 269   \consists "Grace_engraver"
 270   \consists "Instrument_switch_engraver"
 271 }
 272
 273 \context{
 274   \Voice
 275
 276   \name CueVoice
 277   \alias Voice
 278   fontSize = #-4
 279   \override Stem.length-fraction = #(magstep -4)
 280   \override Beam.length-fraction = #(magstep -4)
 281   \override Beam.beam-thickness = #0.35
 282 }
 283
 284 \context {
 285   \Voice
 286   \name DrumVoice
 287   \alias Voice
 288
 289   \description "A voice on a percussion staff."
 290   \remove "Arpeggio_engraver"
 291   \consists "Grob_pq_engraver"
 292
 293   \remove "Note_head_line_engraver"
 294   \remove "Glissando_engraver"
 295   \remove "Ligature_bracket_engraver"
 296   \remove "Note_heads_engraver"
 297   \consists "Drum_notes_engraver"
 298   \remove "New_fingering_engraver"
 299
 300   \remove "Fingering_engraver"
 301
 302   \remove "Cluster_spanner_engraver"
 303 }
 304
 305 \context{
 306   \type "Engraver_group"
 307   \name GrandStaff
 308   localAlterations = #'()
 309
 310   \description "A group of staves, with a brace on the left
 311 side, grouping the staves together.  The bar lines of the
 312 contained staves are connected vertically."
 313
 314   \consists "Instrument_name_engraver"
 315   \consists "Span_bar_engraver"
 316 % The default for DynamicText.extra-spacing-width causes dynamics to
 317 % be placed across span bars, so switch it off:
 318   \override DynamicText.extra-spacing-width = ##f
 319   \consists "Span_bar_stub_engraver"
 320   \consists "Span_arpeggio_engraver"
 321   \consists "System_start_delimiter_engraver"
 322   \consists "Vertical_align_engraver"
 323   systemStartDelimiter = #'SystemStartBrace
 324   topLevelAlignment = ##f
 325   %% explicitly set instrument, so it is not inherited from the parent
 326   instrumentName = #'()
 327   shortInstrumentName = #'()
 328
 329   \defaultchild "Staff"
 330   \accepts "Staff"
 331   \accepts "RhythmicStaff"
 332   \accepts "DrumStaff"
 333   \accepts "TabStaff"
 334   \accepts "Lyrics"
 335   \accepts "FiguredBass"
 336   \accepts "Dynamics"
 337   \accepts "ChordNames"
 338 }
 339
 340 \context{
 341   \GrandStaff
 342   \name "PianoStaff"
 343   \alias "GrandStaff"
 344
 345   \description "Just like @code{GrandStaff}, but the staves are only removed
 346 together, never separately."
 347
 348   \consists "Vertical_align_engraver"
 349   \consists "Keep_alive_together_engraver"
 350   topLevelAlignment = ##f
 351
 352   instrumentName = #'()
 353   shortInstrumentName = #'()
 354 }
 355
 356 \context {
 357   \type "Engraver_group"
 358   \name "StaffGroup"
 359
 360   \consists "Vertical_align_engraver"
 361   topLevelAlignment = ##f
 362
 363   \consists "Instrument_name_engraver"
 364   \consists "Span_bar_engraver"
 365 % The default for DynamicText.extra-spacing-width causes dynamics to
 366 % be placed across span bars, so switch it off:
 367   \override DynamicText.extra-spacing-width = ##f
 368   \consists "Span_bar_stub_engraver"
 369   \consists "Span_arpeggio_engraver"
 370   \consists "Output_property_engraver"
 371   systemStartDelimiter = #'SystemStartBracket
 372   %% explicitly set instrument, so it is not inherited from the parent
 373   instrumentName = #'()
 374   shortInstrumentName = #'()
 375
 376   \consists "System_start_delimiter_engraver"
 377
 378   \defaultchild "Staff"
 379   \accepts "Staff"
 380   \accepts "RhythmicStaff"
 381   \accepts "DrumStaff"
 382   \accepts "GrandStaff"
 383   \accepts "PianoStaff"
 384   \accepts "TabStaff"
 385   \accepts "Lyrics"
 386   \accepts "ChordNames"
 387   \accepts "FiguredBass"
 388   \accepts "ChoirStaff"
 389   \accepts "StaffGroup"
 390
 391   \description "Groups staves while adding a bracket on the left
 392 side, grouping the staves together.  The bar lines of the contained
 393 staves are connected vertically.  @code{StaffGroup} only consists of
 394 a collection of staves, with a bracket in front and spanning bar lines."
 395 }
 396
 397 \context {
 398   \type "Engraver_group"
 399   \name Dynamics
 400   \alias Voice
 401   \consists "Output_property_engraver"
 402   \consists "Bar_engraver"
 403   \consists "Piano_pedal_engraver"
 404   \consists "Script_engraver"
 405   \consists "Dynamic_engraver"
 406   \consists "Dynamic_align_engraver"
 407   \consists "Text_engraver"
 408   \consists "Text_spanner_engraver"
 409   \consists "Font_size_engraver"
 410   \consists "Axis_group_engraver"
 411
 412   pedalSustainStrings = #'("Ped." "*Ped." "*")
 413   pedalUnaCordaStrings = #'("una corda" "" "tre corde")
 414   \override VerticalAxisGroup.staff-affinity = #CENTER
 415   \override VerticalAxisGroup.nonstaff-relatedstaff-spacing =
 416     #'((basic-distance . 5)
 417        (padding . 0.5))
 418   \override TextScript.font-shape = #'italic
 419   \override DynamicLineSpanner.Y-offset = #0
 420   \override DynamicLineSpanner.outside-staff-priority = ##f
 421   \override DynamicText.outside-staff-priority = ##f
 422   \override Hairpin.outside-staff-priority = ##f
 423
 424   \description "Holds a single line of dynamics, which will be
 425 centered between the staves surrounding this context."
 426 }
 427
 428
 429 \context{
 430   \type "Engraver_group"
 431
 432   \description "Corresponds to a voice with lyrics.  Handles the
 433 printing of a single line of lyrics."
 434
 435   \name "Lyrics"
 436   \consists "Lyric_engraver"
 437   \consists "Extender_engraver"
 438   \consists "Hyphen_engraver"
 439   \consists "Stanza_number_engraver"
 440   \consists "Instrument_name_engraver"
 441   \consists "Font_size_engraver"
 442   \consists "Axis_group_engraver"
 443   \consists "Pure_from_neighbor_engraver"
 444   searchForVoice = ##f
 445   %% explicitly set instrument, so it is not inherited from the parent
 446   instrumentName = #'()
 447   shortInstrumentName = #'()
 448
 449   \override VerticalAxisGroup.remove-first = ##t
 450   \override VerticalAxisGroup.remove-empty = ##t
 451   \override VerticalAxisGroup.staff-affinity = #UP
 452   \override VerticalAxisGroup.nonstaff-relatedstaff-spacing =
 453     #'((basic-distance . 5.5)
 454        (padding . 0.5)
 455        (stretchability . 1))
 456   \override VerticalAxisGroup.nonstaff-nonstaff-spacing =
 457      #'((basic-distance . 0)
 458         (minimum-distance . 2.8)
 459         (padding . 0.2)
 460         (stretchability . 0))
 461   \override VerticalAxisGroup.nonstaff-unrelatedstaff-spacing.padding = #1.5
 462   \override InstrumentName.self-alignment-Y = ##f
 463
 464   %% sync with define-grobs.scm ;
 465   \override InstrumentName.font-size = #1.0
 466
 467   %% make sure that barlines aren't collapsed, when
 468   %% Bar_engraver is there.
 469   \override BarLine.bar-extent = #'(-0.05 . 0.05)
 470
 471 }
 472
 473 \context {
 474   \type "Engraver_group"
 475   \name NoteNames
 476   \description "A context for printing the names of notes."
 477   \consists "Axis_group_engraver"
 478
 479   \override VerticalAxisGroup.staff-affinity = #UP
 480   \override VerticalAxisGroup.nonstaff-nonstaff-spacing =
 481     #'((basic-distance . 0)
 482        (minimum-distance . 2.8)
 483        (padding . 0.2)
 484        (stretchability . 0))
 485   \override VerticalAxisGroup.nonstaff-relatedstaff-spacing =
 486     #'((basic-distance . 5.5)
 487        (padding . 0.5)
 488        (stretchability . 1))
 489   \override VerticalAxisGroup.nonstaff-unrelatedstaff-spacing.padding = 1.5
 490
 491   \consists "Tie_engraver"
 492   \consists "Note_name_engraver"
 493   \consists "Separating_line_group_engraver"
 494 }
 495
 496 \context {
 497   \type "Engraver_group"
 498   \name ChordNames
 499   \description "Typesets chord names."
 500
 501   \consists "Output_property_engraver"
 502   \consists "Separating_line_group_engraver"
 503   \consists "Chord_name_engraver"
 504   \consists "Axis_group_engraver"
 505 %  \consists "Note_spacing_engraver"
 506
 507   \override VerticalAxisGroup.remove-first = ##t
 508   \override VerticalAxisGroup.remove-empty = ##t
 509   \override VerticalAxisGroup.staff-affinity = #DOWN
 510   \override VerticalAxisGroup.nonstaff-relatedstaff-spacing.padding = #0.5
 511   \override VerticalAxisGroup.nonstaff-nonstaff-spacing.padding = #0.5
 512 }
 513
 514 \context {
 515   \type "Score_engraver"
 516   \name "Score"
 517
 518   \description "This is the top level notation context.  No
 519 other context can contain a @code{Score} context.  This context
 520 handles the administration of time signatures.  It also makes sure
 521 that items such as clefs, time signatures, and key-signatures are
 522 aligned across staves.
 523
 524 You cannot explicitly instantiate a @code{Score} context (since it
 525 is not contained in any other context).  It is instantiated
 526 automatically when an output definition (a @code{\\score} or
 527 @code{\\layout} block) is processed."
 528
 529   \consists "Paper_column_engraver"
 530   \consists "Repeat_acknowledge_engraver"
 531   \consists "Staff_collecting_engraver"
 532
 533   \alias "Timing"
 534
 535   %% An alias for Timing is established by the Timing_translator in
 536   %% whatever context it is initialized, and the timing variables are
 537   %% then copied from wherever Timing had been previously established.
 538   %% The alias at Score level provides a target for initializing
 539   %% Timing variables in layout definitions before any
 540   %% Timing_translator has been run.
 541
 542   % timing translator must come BEFORE bar number engraver
 543   \consists "Timing_translator"
 544   \consists "Default_bar_line_engraver"
 545   \consists "Output_property_engraver"
 546   \consists "Tweak_engraver"
 547   \consists "System_start_delimiter_engraver"
 548   \consists "Mark_engraver"
 549   \consists "Volta_engraver"
 550   \consists "Metronome_mark_engraver"
 551   \consists "Break_align_engraver"
 552   \consists "Spacing_engraver"
 553   \consists "Grace_spacing_engraver"
 554   \consists "Vertical_align_engraver"
 555   \consists "Stanza_number_align_engraver"
 556   \consists "Bar_number_engraver"
 557   \consists "Parenthesis_engraver"
 558   \consists "Concurrent_hairpin_engraver"
 559   \consists "Beam_collision_engraver"
 560   \consists "Footnote_engraver"
 561
 562   \defaultchild "Staff"
 563
 564   \accepts "FretBoards"
 565   \accepts "Staff"
 566   \accepts "RhythmicStaff"
 567   \accepts "TabStaff"
 568   \accepts "VaticanaStaff"
 569   \accepts "GregorianTranscriptionStaff"
 570   \accepts "MensuralStaff"
 571   \accepts "PetrucciStaff"
 572   \accepts "StaffGroup"
 573   \accepts "DrumStaff"
 574   \accepts "KievanStaff"
 575   \accepts "Lyrics"
 576   \accepts "ChordNames"
 577   \accepts "GrandStaff"
 578   \accepts "ChoirStaff"
 579   \accepts "PianoStaff"
 580   \accepts "Devnull"
 581   \accepts "NoteNames"
 582   \accepts "FiguredBass"
 583
 584   noteToFretFunction = #determine-frets
 585   predefinedDiagramTable = ##f
 586   soloText = #"Solo"
 587   soloIIText = #"Solo II"
 588   aDueText = #"a2"
 589   printPartCombineTexts = ##t
 590   partCombineTextsOnNote = ##t
 591   systemStartDelimiter =#'SystemStartBar
 592
 593   drumStyleTable = #drums-style
 594
 595   melismaBusyProperties = #default-melisma-properties
 596   tieWaitForNote = ##f
 597   clefGlyph = #"clefs.G"
 598   clefPosition = #-2
 599   middleCClefPosition = #-6
 600   middleCPosition = #-6
 601   firstClef = ##t
 602
 603   crescendoSpanner = #'hairpin
 604   decrescendoSpanner = #'hairpin
 605
 606   defaultBarType = #"|"
 607   doubleRepeatType = #":..:"
 608   startRepeatType = #".|:"
 609   endRepeatType = #":|."
 610   alternativeRestores = #'(measurePosition measureLength lastChord)
 611   barNumberVisibility = #first-bar-number-invisible-and-no-parenthesized-bar-numbers
 612   barNumberFormatter = #robust-bar-number-function
 613   clefTranspositionFormatter = #clef-transposition-markup
 614   cueClefTranspositionFormatter = #clef-transposition-markup
 615   automaticBars = ##t
 616
 617   explicitClefVisibility = #all-visible
 618   explicitCueClefVisibility = #end-of-line-invisible
 619   explicitKeySignatureVisibility = #all-visible
 620   implicitTimeSignatureVisibility = #end-of-line-invisible
 621
 622   repeatCountVisibility = #all-repeat-counts-visible
 623
 624 %% Other Timing variables are derived and set by the Timing_translator
 625 %% at initialization time by calling the functions in
 626 %% scm/time-signature-settings.scm
 627
 628   timeSignatureSettings = #default-time-signature-settings
 629   timeSignatureFraction = 4/4
 630
 631   beamHalfMeasure = ##t
 632
 633   autoBeaming = ##t
 634   autoBeamCheck = #default-auto-beam-check
 635
 636   completionFactor = #unity-if-multimeasure
 637
 638   scriptDefinitions = #default-script-alist
 639
 640   pedalSustainStrings = #'("Ped." "*Ped." "*")
 641   pedalSustainStyle = #'text
 642   pedalUnaCordaStrings = #'("una corda" "" "tre corde")
 643   pedalUnaCordaStyle = #'text
 644
 645 %% These are in ordinary italic font, including the *,
 646 %% but they are unlikely to be used,
 647 %% as the default pedal-style for SostenutoPedal is 'mixed':
 648 %% i.e.  Sost. Ped_____________________
 649   pedalSostenutoStrings = #'("Sost. Ped." "*Sost. Ped." "*")
 650   pedalSostenutoStyle = #'mixed
 651
 652   harmonicAccidentals = ##t
 653   fingeringOrientations = #'(up down)
 654   stringNumberOrientations = #'(up down)
 655   strokeFingerOrientations = #'(right)
 656
 657   lyricMelismaAlignment = #LEFT
 658   markFormatter = #format-mark-letters
 659   rehearsalMark = #1
 660   subdivideBeams = ##f
 661   extraNatural = ##t
 662   autoAccidentals = #`(Staff ,(make-accidental-rule 'same-octave 0))
 663   autoCautionaries = #'()
 664
 665   printKeyCancellation = ##t
 666   keyAlterationOrder = #`(
 667     (6 . ,FLAT) (2  . ,FLAT) (5 . ,FLAT ) (1  . ,FLAT) (4  . ,FLAT) (0  . ,FLAT) (3  . ,FLAT)
 668     (3 . ,SHARP) (0 . ,SHARP) (4 . ,SHARP) (1 . ,SHARP) (5 . ,SHARP) (2 . ,SHARP) (6 . ,SHARP)
 669     (6 . ,DOUBLE-FLAT) (2 . ,DOUBLE-FLAT) (5 . ,DOUBLE-FLAT ) (1 . ,DOUBLE-FLAT) (4 . ,DOUBLE-FLAT) (0 . ,DOUBLE-FLAT) (3 . ,DOUBLE-FLAT)
 670     (3  . ,DOUBLE-SHARP) (0 . ,DOUBLE-SHARP) (4 . ,DOUBLE-SHARP) (1 . ,DOUBLE-SHARP) (5 . ,DOUBLE-SHARP) (2 . ,DOUBLE-SHARP) (6 . ,DOUBLE-SHARP)
 671   )
 672
 673   barCheckSynchronize = ##f
 674
 675 %% chord names:
 676   chordNameFunction = #ignatzek-chord-names
 677   minorChordModifier = #(make-simple-markup "m")
 678   additionalPitchPrefix = #"" % was "add"
 679   majorSevenSymbol = #whiteTriangleMarkup
 680   chordNameLowercaseMinor = ##f
 681   chordNameSeparator = #(make-hspace-markup 0.5)
 682   slashChordSeparator = #(make-simple-markup "/")
 683   chordNameExceptions = #ignatzekExceptions
 684   chordNoteNamer = #'()
 685   chordRootNamer = #note-name->markup
 686   chordPrefixSpacer = #0
 687   chordNameExceptionsFull = #fullJazzExceptions
 688   chordNameExceptionsPartial = #partialJazzExceptions
 689   noChordSymbol = #(make-simple-markup "N.C.")
 690
 691   bassStaffProperties = #'((assign clefGlyph "clefs.F")
 692   (assign clefPosition 2)
 693   (assign middleCPosition 6)
 694   (assign middleCClefPosition 6))
 695 %% tablature:
 696   stringOneTopmost = ##t
 697   highStringOne = ##t
 698
 699 %% One may change the string tunings as follows :
 700 %% The length of the list must be equal to the number of strings
 701   stringTunings = #guitar-tuning
 702   tablatureFormat = #fret-number-tablature-format
 703   tabStaffLineLayoutFunction = #tablature-position-on-lines
 704
 705 %%
 706   figuredBassFormatter = #format-bass-figure
 707   metronomeMarkFormatter = #format-metronome-markup
 708
 709   %% See also make-voice-props-set
 710   graceSettings = #score-grace-settings
 711
 712   keepAliveInterfaces = #'(
 713     bass-figure-interface
 714     chord-name-interface
 715     cluster-beacon-interface
 716     fret-diagram-interface
 717     lyric-syllable-interface
 718     note-head-interface
 719     tab-note-head-interface
 720     lyric-interface
 721     percent-repeat-item-interface
 722     percent-repeat-interface
 723
 724     ;; need this, as stanza numbers are items, and appear only once.
 725     stanza-number-interface
 726   )
 727   % \quoteDuring is supposed to quote everything, cueDuring only the essentials
 728   quotedEventTypes = #'(StreamEvent)
 729   quotedCueEventTypes = #'(
 730     note-event
 731     rest-event
 732     tie-event
 733     beam-event
 734     tuplet-span-event)
 735   instrumentTransposition = #(ly:make-pitch 0 0 0)
 736
 737   topLevelAlignment = ##t
 738
 739   timing = ##t
 740 }
 741
 742
 743
 744
 745 \context {
 746   \type "Engraver_group"
 747   \name "FiguredBass"
 748   \description "A context for printing a figured bass line."
 749
 750   \consists "Figured_bass_engraver"
 751   \consists "Separating_line_group_engraver"
 752   \consists "Axis_group_engraver"
 753
 754   \override VerticalAxisGroup.remove-empty = ##t
 755   \override VerticalAxisGroup.remove-first = ##t
 756   \override VerticalAxisGroup.staff-affinity = #UP
 757   \override VerticalAxisGroup.nonstaff-relatedstaff-spacing.padding = #0.5
 758   \override VerticalAxisGroup.nonstaff-nonstaff-spacing.padding = #0.5
 759 }
 760
 761 \context {
 762   \name "Devnull"
 763   \type "Engraver_group"
 764
 765 %% don't want to route anything out of here:
 766   \alias "Staff"
 767   \alias "Voice"
 768   \description "Silently discards all musical information given to this
 769 context."
 770 }
 771
 772 \context {
 773   \name "NullVoice"
 774   \type "Engraver_group"
 775
 776   \description "Non-printing context, typically used for aligning
 777 lyrics in polyphonic situations, or with @code{\partcombine}."
 778
 779   %% don't route anything out of here
 780   \alias "Staff"
 781   \alias "Voice"
 782
 783   %% all three are needed for ties to work with lyrics
 784   \consists "Note_heads_engraver"
 785   \consists "Rhythmic_column_engraver"
 786   \consists "Tie_engraver"
 787
 788   %% both are needed for melismas to work with \autoBeamOff
 789   \consists "Beam_engraver"
 790   \consists "Stem_engraver"
 791
 792   %% needed for slurs to work with lyrics
 793   \consists "Slur_engraver"
 794
 795   %% keep noteheads inside the staff
 796   \consists "Pitch_squash_engraver"
 797   squashedPosition = 0
 798
 799   %% `\omit NoteHead' would give slur attachment errors
 800   \omit Accidental
 801   \omit Beam
 802   \omit Dots
 803   \omit Flag
 804   \omit Rest
 805   \omit Slur
 806   \omit Stem
 807   \omit Tie
 808
 809   %% let these take up space (for lyric extenders, etc.)
 810   \override NoteHead.transparent = ##t
 811   \override TabNoteHead.transparent = ##t
 812
 813   %% don't let notes shift
 814   \override NoteHead.X-offset = 0
 815   \override NoteColumn.ignore-collision = ##t
 816
 817   %% keep beams and stems inside the staff
 818   \override Beam.positions = #'(1 . 1)
 819   \override Stem.length = 0
 820
 821   %% prevent "weird stem size" warnings
 822   \override Stem.direction = #UP
 823 }
 824
 825 \context {
 826   \Voice
 827   \name "TabVoice"
 828   \alias "Voice"
 829   \consists "Tab_note_heads_engraver"
 830   \consists "Tab_tie_follow_engraver"
 831
 832   \remove "Note_heads_engraver"
 833   \remove "Fingering_engraver"
 834   \remove "New_fingering_engraver"
 835   \remove "Pitched_trill_engraver"
 836
 837   \description "Context for drawing notes in a Tab staff."
 838
 839   %% No accidental in tablature !
 840   \remove "Accidental_engraver"
 841 }
 842
 843 \context {
 844   \Staff
 845   \alias "Staff"
 846   \name "TabStaff"
 847   \denies "Voice"
 848   \consists "Tab_staff_symbol_engraver"
 849
 850   \description "Context for generating tablature. It accepts only @code{TabVoice}
 851 contexts and handles the line spacing, the tablature clef etc. properly."
 852
 853   \accepts "TabVoice"
 854   \defaultchild "TabVoice"
 855
 856   %% 6 strings, bigger spacing
 857   \override StaffSymbol.staff-space = #1.5
 858
 859   %% Don't draw stems over the tablature figures !
 860   \override Stem.avoid-note-head = ##t
 861
 862   %% No accidental in tablature !
 863   \remove "Accidental_engraver"
 864   \remove "Key_engraver"
 865
 866   \remove "Ottava_spanner_engraver"
 867   %% the clef handler
 868   \override Clef.stencil = #clef::print-modern-tab-if-set
 869   %% no time signature
 870   \override TimeSignature.stencil = ##f
 871   %% no arpeggios
 872   \override Arpeggio.stencil = ##f
 873   %% we ignore collision warnings that may occur due to
 874   %% stem overlapping, because we have no stems ;-)
 875   \override NoteColumn.ignore-collision = ##t
 876   %% Special "TAB" clef
 877   clefGlyph = #"clefs.tab"
 878   clefPosition = #0
 879   %% Change string if note results in negative fret number
 880   handleNegativeFrets = #'recalculate
 881   %% Allow open strings even if minimumFret is set
 882   restrainOpenStrings = ##f
 883
 884   %% TabStaff increase the staff-space, which in turn
 885   %% increases beam thickness and spacing; beams are
 886   %% too big. We have to adjust the beam settings:
 887   \override Beam.beam-thickness = #0.32
 888   \override Beam.length-fraction = #0.62
 889   %% the same goes for tremolo beams
 890   \override StemTremolo.beam-thickness = #0.32
 891   %% NOTE: in lily/stem-tremolo.cc, we have length-fraction = 1,
 892   %% and the tablature staff space is scaled (1.5 by default),
 893   %% so we use the inversion of the scale factor:
 894   \override StemTremolo.length-fraction = #(lambda (grob)
 895                                                (/ 1 (ly:staff-symbol-staff-space grob)))
 896   \override StemTremolo.beam-width = #stem-tremolo::calc-tab-width
 897
 898   %% make the Stems as short as possible to minimize their influence
 899   %% on the slur::calc-control-points routine
 900   \override Stem.no-stem-extend = ##t
 901   \override Flag.style = #'no-flag
 902   \override Stem.details = #'((lengths 0 0 0 0 0 0)
 903                                 (beamed-lengths 0 0 0)
 904                                 (beamed-minimum-free-lengths 0 0 0)
 905                                 (beamed-extreme-minimum-free-lengths 0 0)
 906                                 (stem-shorten 0 0))
 907   %% after all, the stubs of the stems may still be visible, so ...
 908   \override Stem.stencil = ##f
 909   \override Flag.stencil = ##f
 910   %% automatic beams should be suppressed for similar reasons ...
 911   autoBeaming = ##f
 912   %% remove beams, dots and rests ...
 913   \override Beam.stencil = ##f
 914   \override StemTremolo.stencil = ##f
 915   \override Dots.stencil = ##f
 916   \override Rest.stencil = ##f
 917   \override MultiMeasureRest.stencil = ##f
 918   \override MultiMeasureRestNumber.stencil = ##f
 919   \override MultiMeasureRestText.stencil = ##f
 920   %% ... all kinds of ties/slurs
 921   \override Tie.stencil = ##f
 922   \override RepeatTie.stencil = ##f
 923   \override LaissezVibrerTie.stencil = ##f
 924   \override Slur.stencil = #slur::draw-tab-slur
 925   \override PhrasingSlur.stencil = ##f
 926   %% 'tied to' fret numbers become invisible or parenthesized, respectively)
 927   \override Tie.after-line-breaking = #tie::handle-tab-note-head
 928   \override RepeatTie.after-line-breaking = #repeat-tie::handle-tab-note-head
 929   %% ... and all kinds of markups, spanners etc.
 930   \override TupletBracket.stencil = ##f
 931   \override TupletNumber.stencil = ##f
 932   \override DynamicText.stencil = ##f
 933   \override DynamicTextSpanner.stencil = ##f
 934   \override TextSpanner.stencil = ##f
 935   \override Hairpin.stencil = ##f
 936   \override Script.stencil = ##f
 937   \override TextScript.stencil = ##f
 938   \override Glissando.stencil = #glissando::draw-tab-glissando
 939   %% the direction for glissando lines will be automatically corrected
 940   \override Glissando.extra-dy = #glissando::calc-tab-extra-dy
 941   \override Glissando.bound-details.right = #`((attach-dir . ,LEFT)
 942                                                    (padding . 0.3))
 943   \override Glissando.bound-details.left = #`((attach-dir . ,RIGHT)
 944                                                    (padding . 0.3))
 945   %% dead notes
 946   \override TabNoteHead.glyph-name = #tab-note-head::calc-glyph-name
 947   \override TabNoteHead.stencil = #tab-note-head::whiteout-if-style-set
 948 }
 949
 950 \context {
 951   \Voice
 952   \name "VaticanaVoice"
 953   \alias "Voice"
 954   \description "Same as @code{Voice} context, except that it is
 955 accommodated for typesetting Gregorian Chant in the notational style
 956 of Editio Vaticana."
 957
 958   \remove "Slur_engraver"
 959   \remove "Stem_engraver"
 960   \remove "Ligature_bracket_engraver"
 961   \consists "Vaticana_ligature_engraver"
 962   \remove "Text_spanner_engraver"
 963   \consists "Episema_engraver"
 964
 965   %% Set default head for notes outside of \[ \].
 966   \override NoteHead.style = #'vaticana.punctum
 967
 968   %% Put some space before and after divisiones.
 969   %% FIXME: This does not seem to show any effect.
 970   \override Script.padding = #0.5
 971
 972   %% There are no beams in Gregorian Chant notation.
 973   autoBeaming = ##f
 974 }
 975
 976 \context {
 977   \Staff
 978   \name "VaticanaStaff"
 979   \alias "Staff"
 980   \denies "Voice"
 981   \accepts "VaticanaVoice"
 982   \defaultchild "VaticanaVoice"
 983
 984   \description "Same as @code{Staff} context, except that it is
 985 accommodated for typesetting Gregorian Chant in the notational style
 986 of Editio Vaticana."
 987
 988   \remove "Time_signature_engraver"
 989   \consists "Custos_engraver"
 990
 991   %% We can not remove Bar_engraver; otherwise clefs and custodes will
 992   %% not show up any more among other line breaking issues.
 993   %% Instead, we make the grob transparent.
 994   \override BarLine.transparent = ##t
 995
 996   \override StaffSymbol.line-count = #4
 997   \override StaffSymbol.thickness = #0.6
 998
 999   %% FIXME: unit on StaffSymbol's width should be \linewidth.
1000   %% \override StaffSymbol.width = #60.0
1001
1002   %% Choose vaticana do clef on 3rd line as default.
1003   clefGlyph = #"clefs.vaticana.do"
1004   middleCPosition = #1
1005   middleCClefPosition = #1
1006   clefPosition = #1
1007   clefTransposition = #0
1008
1009   %% Select vaticana style font.
1010   \override KeySignature.glyph-name-alist = #alteration-vaticana-glyph-name-alist
1011   \override Accidental.glyph-name-alist = #alteration-vaticana-glyph-name-alist
1012   \override Custos.style = #'vaticana
1013   \override Custos.neutral-position = #3
1014   \override Custos.neutral-direction = #DOWN
1015   \override Dots.style = #'vaticana
1016 }
1017
1018 \context {
1019   \Voice
1020   \name "GregorianTranscriptionVoice"
1021   \alias "Voice"
1022   \consists "Episema_engraver"
1023
1024   %% Removing ligature bracket engraver without replacing it by some
1025   %% other ligature engraver would cause a "Junking event: `LigatureEvent'"
1026   %% warning for every "\[" and "\]".  Therefore, we make the grob
1027   %% transparent instead.
1028   \override LigatureBracket.transparent = ##t
1029
1030   %% Put some space before and after divisiones.
1031   %% FIXME: This does not seem to show any effect.
1032   \override Script.padding = #0.5
1033
1034   %% There are no beams in Gregorian Chant notation.
1035   autoBeaming = ##f
1036
1037 }
1038
1039 \context {
1040   \Staff
1041   \name "GregorianTranscriptionStaff"
1042   \alias "Staff"
1043   \denies "Voice"
1044   \accepts "GregorianTranscriptionVoice"
1045   \defaultchild "GregorianTranscriptionVoice"
1046
1047   %% We can not remove Bar_engraver; otherwise clefs and custodes will
1048   %% not show up any more among other line breaking issues.
1049   %% Instead, we make the grob transparent.
1050   \override BarLine.transparent = ##t
1051 }
1052
1053 \context {
1054   \Voice
1055   \name "MensuralVoice"
1056   \alias "Voice"
1057   \description "Same as @code{Voice} context, except that it is
1058 accommodated for typesetting a piece in mensural style."
1059
1060   \remove "Slur_engraver"
1061   \remove "Ligature_bracket_engraver"
1062   \consists "Mensural_ligature_engraver"
1063
1064   %% Set default head for notes outside of \[ \].
1065   \override NoteHead.style = #'mensural
1066   \override Rest.style = #'mensural
1067   \override Flag.style = #'mensural
1068
1069   %% There are no beams in mensural notation.
1070   autoBeaming = ##f
1071 }
1072
1073 \context {
1074   \Staff
1075   \name "MensuralStaff"
1076   \alias "Staff"
1077   \denies "Voice"
1078   \defaultchild "MensuralVoice"
1079   \accepts "MensuralVoice"
1080   \description "Same as @code{Staff} context, except that it is
1081 accommodated for typesetting a piece in mensural style."
1082
1083   \consists "Custos_engraver"
1084
1085   %% We can not remove Bar_engraver; otherwise clefs and custodes will
1086   %% not show up any more among other line breaking issues.
1087   %% Instead, we make the grob transparent.
1088   \override BarLine.transparent = ##t
1089
1090   \override StaffSymbol.thickness = #0.6
1091
1092   %% FIXME: unit on StaffSymbol's width should be \linewidth.
1093   %% \override StaffSymbol.width = #60.0
1094
1095   %% Choose mensural g clef on 2nd line as default.
1096   clefGlyph = #"clefs.mensural.g"
1097   middleCClefPosition = #-6
1098   middleCPosition = #-6
1099   clefPosition = #-2
1100   clefTransposition = #0
1101
1102   %% Select mensural style font.
1103   \override TimeSignature.style = #'mensural
1104   \override KeySignature.glyph-name-alist = #alteration-mensural-glyph-name-alist
1105   \override Accidental.glyph-name-alist = #alteration-mensural-glyph-name-alist
1106   \override Custos.style = #'mensural
1107   \override Custos.neutral-position = #3
1108   \override Custos.neutral-direction = #DOWN
1109
1110   %% Accidentals are valid only once (same as
1111   %% \accidentalStyle forget)
1112   extraNatural = ##f
1113   autoAccidentals = #`(Staff ,(make-accidental-rule 'same-octave -1))
1114   autoCautionaries = #'()
1115   printKeyCancellation = ##f
1116 }
1117
1118 \context {
1119   \Voice
1120   \name "PetrucciVoice"
1121   \alias "Voice"
1122   \description "Same as @code{Voice} context, except that it is
1123 accommodated for typesetting a piece in Petrucci style."
1124
1125   \remove "Ligature_bracket_engraver"
1126   \consists "Mensural_ligature_engraver"
1127
1128   %% Set glyph styles.
1129   \override NoteHead.style = #'petrucci
1130   \override Rest.style = #'mensural
1131
1132   % Thickens and shortens stems.
1133   \override Stem.thickness = #1.7
1134   \override Stem.length = #5
1135
1136   %% There are no beams in Petrucci notation.
1137   autoBeaming = ##f
1138 }
1139
1140 \context {
1141   \Staff
1142   \name "PetrucciStaff"
1143   \alias "Staff"
1144   \denies "Voice"
1145   \defaultchild "PetrucciVoice"
1146   \accepts "PetrucciVoice"
1147   \description "Same as @code{Staff} context, except that it is
1148 accommodated for typesetting a piece in Petrucci style."
1149
1150   \consists "Custos_engraver"
1151
1152   \override StaffSymbol.thickness = #1.3
1153
1154   %% Choose Petrucci g clef on 2nd line as default.
1155   clefGlyph = #"clefs.petrucci.g"
1156   middleCClefPosition = #-6
1157   middleCPosition = #-6
1158   clefPosition = #-2
1159   clefTransposition = #0
1160
1161   \override Custos.style = #'mensural
1162   \override Custos.neutral-position = #3
1163   \override Custos.neutral-direction = #DOWN
1164
1165   %% Accidentals are valid only once (if the following note is different)
1166   extraNatural = ##f
1167   autoAccidentals = #`(Staff ,(make-accidental-rule 'same-octave 0)
1168                              ,neo-modern-accidental-rule)
1169   autoCautionaries = #'()
1170   printKeyCancellation = ##f
1171 }
1172
1173 \context {
1174  \Voice
1175  \name "KievanVoice"
1176  \alias "Voice"
1177  \description "Same as @code{Voice} context, except that it is
1178 accommodated for typesetting a piece in Kievan style."
1179
1180   \remove "Ligature_bracket_engraver"
1181   \consists "Kievan_ligature_engraver"
1182
1183  %% Set glyph styles.
1184  \override NoteHead.style = #'kievan
1185  \override Stem.X-offset = #stem::kievan-offset-callback
1186  \override Stem.stencil = ##f
1187  \override Flag.stencil = ##f
1188  \override Rest.style = #'mensural
1189  \override Accidental.glyph-name-alist = #alteration-kievan-glyph-name-alist
1190  \override Dots.style = #'kievan
1191  \override Slur.stencil = ##f
1192  \override Stem.length = #0.0
1193  \override Beam.positions = #beam::get-kievan-positions
1194  \override Beam.quantized-positions = #beam::get-kievan-quantized-positions
1195  \override NoteHead.duration-log = #note-head::calc-kievan-duration-log
1196
1197  %% There are beams in Kievan notation, but they are invoked manually
1198  autoBeaming = ##f
1199 }
1200
1201 \context {
1202  \Staff
1203  \name "KievanStaff"
1204  \alias "Staff"
1205  \denies "Voice"
1206  \defaultchild "KievanVoice"
1207  \accepts "KievanVoice"
1208  \description "Same as @code{Staff} context, except that it is
1209 accommodated for typesetting a piece in Kievan style."
1210
1211  \remove "Time_signature_engraver"
1212
1213  %% Choose Kievan tsefaut clef
1214  clefGlyph = #"clefs.kievan.do"
1215  middleCClefPosition = #0
1216  middleCPosition = #0
1217  clefPosition = #0
1218  clefTransposition = #0
1219
1220  %% Accidentals are valid only once (if the following note is different)
1221  extraNatural = ##f
1222  autoAccidentals = #`(Staff ,(make-accidental-rule 'same-octave 0)
1223                             ,neo-modern-accidental-rule)
1224  autoCautionaries = #'()
1225  printKeyCancellation = ##f
1226
1227 }
1228
1229 %% Keep the old definitions in here for compatibility (they erase previous
1230 %% settings to the corresponding context!).
1231 %% For new scores, one should simply insert the \RemoveEmptyStaves settings
1232 %% into the desired context. That's just as easy, requires only one line more
1233 %% (the \*Staff), but preserves previous context mods.
1234 %% TODO: DEPRECATED_2.13.17, remove at some point in the future
1235 RemoveEmptyStaffContext = \context {
1236   \Staff
1237   \RemoveEmptyStaves
1238 }
1239
1240 AncientRemoveEmptyStaffContext = \context {
1241   \VaticanaStaff
1242   \RemoveEmptyStaves
1243 }
1244
1245 RemoveEmptyDrumStaffContext = \context {
1246   \DrumStaff
1247   \RemoveEmptyStaves
1248 }
1249
1250 RemoveEmptyRhythmicStaffContext = \context {
1251   \RhythmicStaff
1252   \RemoveEmptyStaves
1253 }
1254
1255 RemoveEmptyTabStaffContext = \context {
1256   \TabStaff
1257   \RemoveEmptyStaves
1258 }