]> git.donarmstrong.com Git - lilypond.git/blob - ly/engraver-init.ly
Merge branch 'master' of ssh://git.sv.gnu.org/srv/git/lilypond into gonville
[lilypond.git] / ly / engraver-init.ly
1 %%%% This file is part of LilyPond, the GNU music typesetter.
2 %%%%
3 %%%% Copyright (C) 1996--2010 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.13.10"
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   \description "A context for displaying fret diagrams."
35
36   \consists "Fretboard_engraver"
37   \consists "Output_property_engraver"
38   \consists "Hara_kiri_engraver"
39   \consists "Separating_line_group_engraver"
40   \consists "Font_size_engraver"
41   \consists "Instrument_name_engraver"
42
43   predefinedDiagramTable = #fretboard-table
44 }
45
46 \context {
47   \type "Engraver_group"
48   \name "Staff"
49
50   \consists "Output_property_engraver"
51   \consists "Bar_engraver"
52   %% Bar_engraver must be first so default bars aren't overwritten
53   %% with empty ones.
54
55   \consists "Font_size_engraver"
56   \consists "Separating_line_group_engraver"
57   \consists "Dot_column_engraver"
58   \consists "Staff_collecting_engraver"
59
60  %% perhaps move to Voice context?
61   \consists "Ottava_spanner_engraver"
62   \consists "Clef_engraver"
63   \consists "Key_engraver"
64   \consists "Time_signature_engraver"
65   \consists "Ledger_line_engraver"
66   \consists "Staff_symbol_engraver"
67   \consists "Collision_engraver"
68   \consists "Grob_pq_engraver"
69   \consists "Rest_collision_engraver"
70   \consists "Accidental_engraver"
71   \consists "Piano_pedal_engraver"
72   \consists "Piano_pedal_align_engraver"
73   \consists "Instrument_name_engraver"
74   \consists "Axis_group_engraver"
75   \consists "Figured_bass_engraver"
76   \consists "Figured_bass_position_engraver"
77   \consists "Script_row_engraver"
78
79   localKeySignature = #'()
80   createSpacing = ##t
81   ignoreFiguredBassRest = ##f
82
83   %% explicitly set instrument, so we don't get
84   %% weird effects when doing instrument names for
85   %% piano staves
86
87   instrumentName = #'()
88   shortInstrumentName = #'()
89
90   \defaultchild "Voice"
91   \accepts "Voice"
92   \accepts "CueVoice"
93
94   \description "Handles clefs, bar lines, keys, accidentals.  It can contain
95 @code{Voice} contexts."
96
97 }
98
99 \context {
100   \Staff
101   \type "Engraver_group"
102   \name "DrumStaff"
103   \alias "Staff"
104
105   \remove "Accidental_engraver"
106   \remove "Ottava_spanner_engraver"
107   \remove "Key_engraver"
108   \remove "Piano_pedal_engraver"
109
110   \description "Handles typesetting for percussion."
111
112   \denies "Voice"
113   \accepts "DrumVoice"
114   \defaultchild "DrumVoice"
115
116   clefGlyph = #"clefs.percussion"
117   clefPosition = #0
118   \override Script #'staff-padding = #0.75
119 }
120
121
122 \context {
123   \type "Engraver_group"
124   \name "ChoirStaff"
125   \consists "Vertical_align_engraver"
126   topLevelAlignment = ##f
127
128   \consists "System_start_delimiter_engraver"
129   systemStartDelimiter = #'SystemStartBracket
130   vocalName = #'()
131   shortVocalName = #'()
132
133   \accepts "Staff"
134   \accepts "DrumStaff"
135   \accepts "RhythmicStaff"
136   \accepts "GrandStaff"
137   \accepts "PianoStaff"
138   \accepts "Lyrics"
139   \accepts "ChordNames"
140   \accepts "FiguredBass"
141   \accepts "ChoirStaff"
142   \accepts "StaffGroup"
143   \defaultchild "Staff"
144   \description "Identical to @code{StaffGroup} except that the
145 contained staves are not connected vertically."
146 }
147
148 \context{
149   \type "Engraver_group"
150
151   localKeySignature = #'()
152   createSpacing = ##t
153
154   squashedPosition = #0
155   \name RhythmicStaff
156   \alias "Staff"
157
158   \override BarLine #'bar-size = #4
159   \override VoltaBracket #'staff-padding = #3
160   \override StaffSymbol #'line-count = #1
161
162   \override Stem  #'neutral-direction = #UP
163   \override Beam  #'neutral-direction = #UP
164
165   \consists "Output_property_engraver"
166   \consists "Font_size_engraver"
167   \consists "Separating_line_group_engraver"
168   \consists "Dot_column_engraver"
169   \consists "Bar_engraver"
170   \consists "Staff_symbol_engraver"
171   \consists "Pitch_squash_engraver"
172   \consists "Time_signature_engraver"
173   \consists "Instrument_name_engraver"
174   \consists "Axis_group_engraver"
175   \consists "Ledger_line_engraver"
176
177   \accepts "Voice"
178   \accepts "CueVoice"
179   \defaultchild "Voice"
180
181   \description "A context like @code{Staff} but for printing rhythms.
182 Pitches are ignored; the notes are printed on one line."
183 }
184
185
186 \context {
187   \type "Engraver_group"
188   \name "Voice"
189
190   \description "Corresponds to a voice on a staff.  This context
191 handles the conversion of dynamic signs, stems, beams, super- and
192 subscripts, slurs, ties, and rests.
193
194 You have to instantiate this explicitly if you want to have
195 multiple voices on the same staff."
196
197   localKeySignature = #'()
198   \consists "Font_size_engraver"
199
200   \consists "Pitched_trill_engraver"
201   \consists "Output_property_engraver"
202   \consists "Arpeggio_engraver"
203   \consists "Multi_measure_rest_engraver"
204   \consists "Text_spanner_engraver"
205   \consists "Trill_spanner_engraver"
206   \consists "Grob_pq_engraver"
207   \consists "Forbid_line_break_engraver"
208   \consists "Laissez_vibrer_engraver"
209   \consists "Repeat_tie_engraver"
210   \consists "Note_head_line_engraver"
211   \consists "Glissando_engraver"
212   \consists "Ligature_bracket_engraver"
213   \consists "Breathing_sign_engraver"
214   \consists "Note_heads_engraver"
215   \consists "Dots_engraver"
216   \consists "Rest_engraver"
217   \consists "Tweak_engraver"
218
219   %% switch on to make stem directions interpolate for the
220   %% center line.
221   %  \consists "Melody_engraver"
222
223   \consists "Stem_engraver"
224   \consists "Beam_engraver"
225   \consists "Grace_beam_engraver"
226   \consists "Auto_beam_engraver"
227
228   %% must come before Script_column_engraver.
229   \consists "New_fingering_engraver"
230
231   \consists "Chord_tremolo_engraver"
232   \consists "Percent_repeat_engraver"
233   \consists "Slash_repeat_engraver"
234   \consists "Part_combine_engraver"
235
236   \consists "Text_engraver"
237   \consists "New_dynamic_engraver"
238   \consists "Dynamic_align_engraver"
239 %  \consists "Dynamic_engraver"
240   \consists "Fingering_engraver"
241   \consists "Bend_engraver"
242
243   \consists "Script_engraver"
244   \consists "Script_column_engraver"
245   \consists "Rhythmic_column_engraver"
246   \consists "Note_spacing_engraver"
247   \consists "Spanner_break_forbid_engraver"
248   \consists "Phrasing_slur_engraver"
249   \consists "Cluster_spanner_engraver"
250   \consists "Slur_engraver"
251   \consists "Tie_engraver"
252   \consists "Tuplet_engraver"
253   \consists "Grace_engraver"
254   \consists "Instrument_switch_engraver"
255 }
256
257 \context{
258   \Voice
259
260   \name CueVoice
261   \alias Voice
262   fontSize = #-4
263   \override Stem #'length-fraction = #(magstep -4)
264   \override Beam #'length-fraction = #(magstep -4)
265   \override Beam #'beam-thickness = #0.35
266 }
267
268 \context {
269   \Voice
270   \name DrumVoice
271   \alias Voice
272
273   \description "A voice on a percussion staff."
274   \remove "Arpeggio_engraver"
275   \consists "Grob_pq_engraver"
276
277   \remove "Note_head_line_engraver"
278   \remove "Glissando_engraver"
279   \remove "Ligature_bracket_engraver"
280   \remove "Note_heads_engraver"
281   \consists "Drum_notes_engraver"
282   \remove "New_fingering_engraver"
283
284   \remove "Fingering_engraver"
285
286   \remove "Cluster_spanner_engraver"
287 }
288
289 \context{
290   \type "Engraver_group"
291   \name GrandStaff
292   localKeySignature = #'()
293
294   \description "A group of staves, with a brace on the left
295 side, grouping the staves together.  The bar lines of the
296 contained staves are connected vertically."
297
298   \consists "Span_bar_engraver"
299   \consists "Span_arpeggio_engraver"
300   \consists "System_start_delimiter_engraver"
301   systemStartDelimiter = #'SystemStartBrace
302
303   \defaultchild "Staff"
304   \accepts "Staff"
305   \accepts "FiguredBass"
306   \accepts "Dynamics"
307 }
308
309 \context{
310   \GrandStaff
311   \name "PianoStaff"
312   \alias "GrandStaff"
313
314   \description "Just like @code{GrandStaff} but with support for
315 instrument names at the start of each system."
316
317   \consists "Instrument_name_engraver"
318   \consists "Vertical_align_engraver"
319   topLevelAlignment = ##f
320
321   \override StaffGrouper #'between-staff-spacing #'stretchability = #5
322
323   instrumentName = #'()
324   shortInstrumentName = #'()
325 }
326
327 \context {
328   \type "Engraver_group"
329   \name "StaffGroup"
330
331   \consists "Vertical_align_engraver"
332   topLevelAlignment = ##f
333
334   \consists "Span_bar_engraver"
335   \consists "Span_arpeggio_engraver"
336   \consists "Output_property_engraver"
337   systemStartDelimiter = #'SystemStartBracket
338
339   \consists "System_start_delimiter_engraver"
340
341   \defaultchild "Staff"
342   \accepts "Staff"
343   \accepts "RhythmicStaff"
344   \accepts "DrumStaff"
345   \accepts "GrandStaff"
346   \accepts "PianoStaff"
347   \accepts "TabStaff"
348   \accepts "Lyrics"
349   \accepts "ChordNames"
350   \accepts "FiguredBass"
351   \accepts "ChoirStaff"
352   \accepts "StaffGroup"
353
354   \description "Groups staves while adding a bracket on the left
355 side, grouping the staves together.  The bar lines of the contained
356 staves are connected vertically.  @code{StaffGroup} only consists of
357 a collection of staves, with a bracket in front and spanning bar lines."
358 }
359
360 \context {
361   \type "Engraver_group"
362   \name Dynamics
363   \alias Voice
364   \consists "Output_property_engraver"
365   \consists "Bar_engraver"
366   \consists "Piano_pedal_engraver"
367   \consists "Script_engraver"
368   \consists "New_dynamic_engraver"
369   \consists "Dynamic_align_engraver"
370   \consists "Text_engraver"
371   \consists "Text_spanner_engraver"
372   \consists "Axis_group_engraver"
373
374   pedalSustainStrings = #'("Ped." "*Ped." "*")
375   pedalUnaCordaStrings = #'("una corda" "" "tre corde")
376   \override VerticalAxisGroup #'staff-affinity = #CENTER
377   \override VerticalAxisGroup #'inter-staff-spacing = #'((space . 5) (padding . 0.5))
378   \override TextScript #'font-shape = #'italic
379   \override DynamicLineSpanner #'Y-offset = #0
380
381   \description "Holds a single line of dynamics, which will be
382 centered between the staves surrounding this context."
383 }
384
385
386 \context{
387   \type "Engraver_group"
388
389   \description "Corresponds to a voice with lyrics.  Handles the
390 printing of a single line of lyrics."
391
392   \name "Lyrics"
393   instrumentName = #'()
394   shortInstrumentName = #'()
395
396   \consists "Lyric_engraver"
397   \consists "Extender_engraver"
398   \consists "Hyphen_engraver"
399   \consists "Stanza_number_engraver"
400   \consists "Instrument_name_engraver"
401   \consists "Font_size_engraver"
402   \consists "Hara_kiri_engraver"
403
404   \override VerticalAxisGroup #'remove-first = ##t
405   \override VerticalAxisGroup #'remove-empty = ##t
406   \override VerticalAxisGroup #'staff-affinity = #UP
407   \override VerticalAxisGroup #'inter-staff-spacing = #'((space . 5.5) (stretchability . 1) (padding . 0.5))
408   \override VerticalAxisGroup #'inter-loose-line-spacing = #'((space . 0) (stretchability . 0) (padding . 0.2))
409   \override VerticalAxisGroup #'non-affinity-spacing #'padding = #1.0
410   \override SeparationItem #'padding = #0.2
411   \override InstrumentName #'self-alignment-Y = ##f
412
413   %% sync with define-grobs.scm ;
414   \override InstrumentName #'font-size = #1.0
415
416   %% make sure that barlines aren't collapsed, when
417   %% Bar_engraver is there.
418   \override BarLine #'bar-size = #0.1
419
420 }
421
422 \context {
423   \type "Engraver_group"
424   \name NoteNames
425   \description "A context for printing the names of notes."
426   \consists "Axis_group_engraver"
427
428   % FIXME: not sure what the default should be here.
429   \override VerticalAxisGroup #'staff-affinity = #DOWN
430
431   \consists "Tie_engraver"
432   \consists "Note_name_engraver"
433   \consists "Separating_line_group_engraver"
434 }
435
436 \context {
437   \type "Engraver_group"
438   \name ChordNames
439   \description "Typesets chord names."
440
441   \consists "Output_property_engraver"
442   \consists "Separating_line_group_engraver"
443   \consists "Chord_name_engraver"
444   \consists "Hara_kiri_engraver"
445 %  \consists "Note_spacing_engraver"
446   \override VerticalAxisGroup #'remove-first = ##t
447   \override VerticalAxisGroup #'remove-empty = ##t
448   \override VerticalAxisGroup #'staff-affinity = #DOWN
449   \override VerticalAxisGroup #'inter-staff-spacing #'padding = #0.5
450   \override VerticalAxisGroup #'inter-loose-line-spacing #'padding = #0.5
451 }
452
453
454 RemoveEmptyStaffContext = \context {
455   \Staff
456   \remove "Axis_group_engraver"
457   \consists "Hara_kiri_engraver"
458   \override Beam #'auto-knee-gap = #'()
459   \override VerticalAxisGroup #'remove-empty = ##t
460 }
461
462 AncientRemoveEmptyStaffContext = \context {
463 %% why not add by default?
464
465   \RemoveEmptyStaffContext
466   \accepts "VaticanaVoice"
467   \accepts "GregorianTranscriptionVoice"
468   \accepts "MensuralVoice"
469 }
470
471 \context {
472   \type "Score_engraver"
473   \name "Score"
474
475   \description "This is the top level notation context.  No
476 other context can contain a @code{Score} context.  This context
477 handles the administration of time signatures.  It also makes sure
478 that items such as clefs, time signatures, and key-signatures are
479 aligned across staves.
480
481 You cannot explicitly instantiate a @code{Score} context (since it
482 is not contained in any other context).  It is instantiated
483 automatically when an output definition (a @code{\score} or
484 @code{\layout} block) is processed."
485
486   \consists "Paper_column_engraver"
487   \consists "Vertically_spaced_contexts_engraver"
488   \consists "Repeat_acknowledge_engraver"
489   \consists "Staff_collecting_engraver"
490
491   %% move the alias along with the engraver.
492
493   \consists "Timing_translator"
494   \consists "Default_bar_line_engraver"
495   \consists "Output_property_engraver"
496   \consists "System_start_delimiter_engraver"
497   \consists "Mark_engraver"
498   \consists "Volta_engraver"
499   \consists "Metronome_mark_engraver"
500   \consists "Break_align_engraver"
501   \consists "Spacing_engraver"
502   \consists "Grace_spacing_engraver"
503   \consists "Vertical_align_engraver"
504   \consists "Stanza_number_align_engraver"
505   \consists "Bar_number_engraver"
506   \consists "Parenthesis_engraver"
507
508   \defaultchild "Staff"
509
510   \accepts "FretBoards"
511   \accepts "Staff"
512   \accepts "RhythmicStaff"
513   \accepts "TabStaff"
514   \accepts "VaticanaStaff"
515   \accepts "GregorianTranscriptionStaff"
516   \accepts "MensuralStaff"
517   \accepts "StaffGroup"
518   \accepts "DrumStaff"
519   \accepts "Lyrics"
520   \accepts "ChordNames"
521   \accepts "GrandStaff"
522   \accepts "ChoirStaff"
523   \accepts "PianoStaff"
524   \accepts "Devnull"
525   \accepts "NoteNames"
526   \accepts "FiguredBass"
527
528
529   noteToFretFunction = #determine-frets
530   predefinedDiagramTable = ##f
531   soloText = #"Solo"
532   soloIIText = #"Solo II"
533   aDueText = #"a2"
534   printPartCombineTexts = ##t
535   systemStartDelimiter =#'SystemStartBar
536
537   drumStyleTable = #drums-style
538
539   melismaBusyProperties = #default-melisma-properties
540   tieWaitForNote = ##f
541   clefGlyph = #"clefs.G"
542   clefPosition = #-2
543   middleCClefPosition = #-6
544   middleCPosition = #-6
545   firstClef = ##t
546
547   crescendoSpanner = #'hairpin
548   decrescendoSpanner = #'hairpin
549
550   defaultBarType = #"|"
551   doubleRepeatType = #":|:"
552   barNumberVisibility = #first-bar-number-invisible
553   automaticBars = ##t
554
555   explicitClefVisibility = #all-visible
556   explicitKeySignatureVisibility = #all-visible
557   implicitTimeSignatureVisibility = #end-of-line-invisible
558
559   repeatCountVisibility = #all-repeat-counts-visible
560
561   beamSettings = #default-beam-settings
562   autoBeaming = ##t
563   autoBeamCheck = #default-auto-beam-check
564   scriptDefinitions = #default-script-alist
565
566   pedalSustainStrings = #'("Ped." "*Ped." "*")
567   pedalSustainStyle = #'text
568   pedalUnaCordaStrings = #'("una corda" "" "tre corde")
569   pedalUnaCordaStyle = #'text
570
571 %% These are in ordinary italic font, including the *,
572 %% but they are unlikely to be used,
573 %% as the default pedal-style for SostenutoPedal is 'mixed':
574 %% i.e.  Sost. Ped_____________________
575   pedalSostenutoStrings = #'("Sost. Ped." "*Sost. Ped." "*")
576   pedalSostenutoStyle = #'mixed
577
578   harmonicAccidentals = ##t
579   fingeringOrientations = #'(up down)
580   stringNumberOrientations = #'(up down)
581   strokeFingerOrientations = #'(right)
582
583   lyricMelismaAlignment = #LEFT
584   markFormatter = #format-mark-letters
585   rehearsalMark = #1
586   subdivideBeams = ##f
587   extraNatural = ##t
588   autoAccidentals = #`(Staff ,(make-accidental-rule 'same-octave 0))
589   autoCautionaries = #'()
590
591   printKeyCancellation = ##t
592   keyAlterationOrder = #`(
593     (6 . ,FLAT) (2  . ,FLAT) (5 . ,FLAT ) (1  . ,FLAT) (4  . ,FLAT) (0  . ,FLAT) (3  . ,FLAT)
594     (3 . ,SHARP) (0 . ,SHARP) (4 . ,SHARP) (1 . ,SHARP) (5 . ,SHARP) (2 . ,SHARP) (6 . ,SHARP)
595     (6 . ,DOUBLE-FLAT) (2 . ,DOUBLE-FLAT) (5 . ,DOUBLE-FLAT ) (1 . ,DOUBLE-FLAT) (4 . ,DOUBLE-FLAT) (0 . ,DOUBLE-FLAT) (3 . ,DOUBLE-FLAT)
596     (3  . ,DOUBLE-SHARP) (0 . ,DOUBLE-SHARP) (4 . ,DOUBLE-SHARP) (2 . ,DOUBLE-SHARP) (5 . ,DOUBLE-SHARP) (2 . ,DOUBLE-SHARP) (6 . ,DOUBLE-SHARP)
597   )
598
599   barCheckSynchronize = ##f
600
601 %% chord names:
602   chordNameFunction = #ignatzek-chord-names
603   majorSevenSymbol = #whiteTriangleMarkup
604   chordNameSeparator = #(make-simple-markup  "/")
605   chordNameExceptions = #ignatzekExceptions
606   chordNoteNamer = #'()
607   chordRootNamer = #note-name->markup
608   chordPrefixSpacer = #0
609   chordNameExceptionsFull = #fullJazzExceptions
610   chordNameExceptionsPartial = #partialJazzExceptions
611   noChordSymbol = #(make-simple-markup "N.C.")
612
613   bassStaffProperties = #'((assign clefGlyph "clefs.F")
614   (assign clefPosition 2)
615   (assign middleCPosition 6)
616   (assign middleCClefPosition 6))
617 %% tablature:
618   stringOneTopmost = ##t
619   highStringOne = ##t
620
621 %% One may change the string tunings as follows :
622 %% The length of the list must be equal to the number of strings
623   stringTunings = #guitar-tuning
624   tablatureFormat = #fret-number-tablature-format
625   tabStaffLineLayoutFunction = #tablature-position-on-lines
626
627 %%
628   figuredBassFormatter = #format-bass-figure
629   metronomeMarkFormatter = #format-metronome-markup
630
631
632   %% See also make-voice-props-set
633   graceSettings = #`(
634     (Voice Stem direction ,UP)
635     (Voice Stem font-size -3)
636     (Voice NoteHead font-size -3)
637     (Voice TabNoteHead font-size -4)
638     (Voice Dots font-size -3)
639     (Voice Stem length-fraction 0.8)
640     (Voice Stem no-stem-extend #t)
641     (Voice Beam beam-thickness 0.384)
642     (Voice Beam length-fraction 0.8)
643     (Voice Accidental font-size -4)
644     (Voice AccidentalCautionary font-size -4)
645     (Voice Slur direction ,DOWN)
646     (Voice Script font-size -3)
647     (Voice Fingering font-size -8)
648     (Voice StringNumber font-size -8)
649   )
650
651   keepAliveInterfaces = #'(
652     rhythmic-grob-interface
653     lyric-interface
654     percent-repeat-item-interface
655     percent-repeat-interface
656
657     ;; need this, as stanza numbers are items, and appear only once.
658     stanza-number-interface
659   )
660   % \quoteDuring is supposed to quote everything, cueDuring only the essentials
661   quotedEventTypes = #'(StreamEvent)
662   quotedCueEventTypes = #'(
663     note-event
664     rest-event
665     tie-event
666     beam-event
667     tuplet-span-event)
668   instrumentTransposition = #(ly:make-pitch 0 0 0)
669
670   verticallySpacedContexts = #'(Staff)
671   topLevelAlignment = ##t
672
673   timing = ##t
674 }
675
676
677
678
679 \context {
680   \type "Engraver_group"
681   \name "FiguredBass"
682   \description "A context for printing a figured bass line."
683
684   \consists "Figured_bass_engraver"
685   \consists "Separating_line_group_engraver"
686   \consists "Hara_kiri_engraver"
687
688   \override VerticalAxisGroup #'remove-empty = ##t
689   \override VerticalAxisGroup #'remove-first = ##t
690   \override VerticalAxisGroup #'staff-affinity = #UP
691   \override VerticalAxisGroup #'inter-staff-spacing #'padding = #0.5
692   \override VerticalAxisGroup #'inter-loose-line-spacing #'padding = #0.5
693 }
694
695 \context {
696   \name "Devnull"
697   \type "Engraver_group"
698
699 %% don't want to route anything out of here:
700   \alias "Staff"
701   \alias "Voice"
702   \description "Silently discards all musical information given to this
703 context."
704 }
705
706 \context {
707   \Voice
708   \name "TabVoice"
709   \alias "Voice"
710   \consists "Tab_note_heads_engraver"
711   \consists "Tab_harmonic_engraver"
712
713   \remove "Note_heads_engraver"
714   \remove "Fingering_engraver"
715   \remove "New_fingering_engraver"
716
717   \description "Context for drawing notes in a Tab staff."
718
719   %% TabStaff increase the staff-space, which in turn
720   %% increases beam thickness and spacing; beams are
721   %% too big. We have to adjust the beam settings:
722   \override Beam #'beam-thickness = #0.32
723   \override Beam #'length-fraction = #0.62
724
725   %% No accidental in tablature !
726   \remove "Accidental_engraver"
727   %% make the Stems as short as possible to minimize their influence
728   %% on the slur::calc-control-points routine
729   \override Stem #'length = #0
730   \override Stem #'no-stem-extend = ##t
731   \override Stem #'flag-style = #'no-flag
732   \override Stem #'details = #'((lengths 0 0 0 0 0 0)
733                                 (beamed-lengths 0 0 0)
734                                 (beamed-minimum-free-lengths 0 0 0)
735                                 (beamed-extreme-minimum-free-lengths 0 0)
736                                 (stem-shorten 0 0))
737   %% after all, the stubs of the stems may still be visible, so ...
738   \override Stem #'transparent = ##t
739   %% automatic beams should be suppressed for similar reasons ...
740   autoBeaming = ##f
741   %% remove beams, dots and rests ...
742   \override Beam #'stencil = ##f
743   \override Dots #'stencil = ##f
744   \override Rest #'stencil = ##f
745   \override MultiMeasureRest #'stencil = ##f
746   \override MultiMeasureRestNumber #'transparent = ##t
747   %% ... all kinds of ties/slurs
748   \override Tie  #'stencil = ##f
749   \override RepeatTie #'stencil = ##f
750   \override LaissezVibrerTie #'stencil = ##f
751   \override Slur #'stencil = #slur::draw-tab-slur
752   \override PhrasingSlur #'stencil = ##f
753   %% 'tied to' fret numbers become invisible or parenthesized, respectively)
754   \override Tie #'after-line-breaking = #tie::handle-tab-note-head
755   \override RepeatTie #'after-line-breaking = #repeat-tie::handle-tab-note-head
756   %% ... and all kinds of markups, spanners etc.
757   \override TupletBracket #'stencil = ##f
758   \override TupletNumber #'stencil = ##f
759   \override DynamicText #'transparent = ##t
760   \override DynamicTextSpanner #'stencil = ##f
761   \override TextSpanner #'stencil = ##f
762   \override Hairpin #'transparent = ##t
763   \override Script #'stencil = ##f
764   \override TextScript #'stencil = ##f
765   %% the direction for glissando lines will be automatically corrected
766   \override Glissando #'extra-dy = #glissando::calc-tab-extra-dy
767   \override Glissando #'bound-details #'right = #`((attach-dir . ,LEFT)
768                                                    (padding . 0.3))
769   \override Glissando #'bound-details #'left = #`((attach-dir . ,RIGHT)
770                                                    (padding . 0.3))
771   %% dead notes
772   \override TabNoteHead #'glyph-name = #tab-note-head::calc-glyph-name
773   \override TabNoteHead #'stencil = #tab-note-head::whiteout-if-style-set
774 }
775
776 \context {
777   \Staff
778   \alias "Staff"
779   \name "TabStaff"
780   \denies "Voice"
781   \consists "Tab_staff_symbol_engraver"
782
783   \description "Context for generating tablature. It accepts only @code{TabVoice}
784 contexts and handles the line spacing, the tablature clef etc. properly."
785
786   \accepts "TabVoice"
787   \defaultchild "TabVoice"
788
789   %% 6 strings, bigger spacing
790   \override StaffSymbol #'staff-space = #1.5
791
792   %% Don't draw stems over the tablature figures !
793   \override Stem #'avoid-note-head = ##t
794
795   %% No accidental in tablature !
796   \remove "Accidental_engraver"
797   \remove "Key_engraver"
798
799   \remove "Ottava_spanner_engraver"
800   %% the clef handler
801   \override Clef #'stencil = #clef::print-modern-tab-if-set
802   %% no time signature
803   \override TimeSignature #'stencil = ##f
804   %% better parentheses in a TabStaff
805   \override ParenthesesItem #'stencils = #parentheses-item::calc-tabstaff-parenthesis-stencils
806   %% no arpeggios
807   \override Arpeggio #'stencil = ##f
808   %% we ignore collision warnings that may occur due to
809   %% stem overlapping, because we have no stems ;-)
810   \override NoteColumn #'ignore-collision = ##t
811   %% Special "TAB" clef
812   clefGlyph = #"clefs.tab"
813   clefPosition = #0
814 }
815
816 \context {
817   \Voice
818   \name "VaticanaVoice"
819   \alias "Voice"
820   \description "Same as @code{Voice} context, except that it is
821 accommodated for typesetting Gregorian Chant in the notational style
822 of Editio Vaticana."
823
824   \remove "Slur_engraver"
825   \remove "Stem_engraver"
826   \remove "Ligature_bracket_engraver"
827   \consists "Vaticana_ligature_engraver"
828   \remove "Text_spanner_engraver"
829   \consists "Episema_engraver"
830
831   %% Set default head for notes outside of \[ \].
832   \override NoteHead #'style = #'vaticana.punctum
833
834   %% Put some space before and after divisiones.
835   %% FIXME: This does not seem to show any effect.
836   \override Script #'padding = #0.5
837
838   %% There are no beams in Gregorian Chant notation.
839   autoBeaming = ##f
840 }
841
842 \context {
843   \Staff
844   \name "VaticanaStaff"
845   \alias "Staff"
846   \denies "Voice"
847   \accepts "VaticanaVoice"
848   \defaultchild "VaticanaVoice"
849
850   \description "Same as @code{Staff} context, except that it is
851 accommodated for typesetting Gregorian Chant in the notational style
852 of Editio Vaticana."
853
854   \remove "Time_signature_engraver"
855   \consists "Custos_engraver"
856
857   %% We can not remove Bar_engraver; otherwise clefs and custodes will
858   %% not show up any more among other line breaking issues.
859   %% Instead, we make the grob transparent.
860   \override BarLine #'transparent = ##t
861
862   \override StaffSymbol #'line-count = #4
863   \override StaffSymbol #'thickness = #0.6
864
865   %% FIXME: unit on StaffSymbol's width should be \linewidth.
866   %% \override StaffSymbol #'width = #60.0
867
868   %% Choose vaticana do clef on 3rd line as default.
869   clefGlyph = #"clefs.vaticana.do"
870   middleCPosition = #1
871   middleCClefPosition = #1
872   clefPosition = #1
873   clefOctavation = #0
874
875   %% Select vaticana style font.
876   \override KeySignature #'glyph-name-alist = #alteration-vaticana-glyph-name-alist
877   \override Accidental #'glyph-name-alist = #alteration-vaticana-glyph-name-alist
878   \override Custos #'style = #'vaticana
879   \override Custos #'neutral-position = #3
880   \override Custos #'neutral-direction = #DOWN
881   \override Dots #'style = #'vaticana
882 }
883
884 \context {
885   \Voice
886   \name "GregorianTranscriptionVoice"
887   \alias "Voice"
888   \consists "Episema_engraver"
889
890   %% Removing ligature bracket engraver without replacing it by some
891   %% other ligature engraver would cause a "Junking event: `LigatureEvent'"
892   %% warning for every "\[" and "\]".  Therefore, we make the grob
893   %% transparent instead.
894   \override LigatureBracket #'transparent = ##t
895
896   %% Put some space before and after divisiones.
897   %% FIXME: This does not seem to show any effect.
898   \override Script #'padding = #0.5
899
900   %% There are no beams in Gregorian Chant notation.
901   autoBeaming = ##f
902
903 }
904
905 \context {
906   \Staff
907   \name "GregorianTranscriptionStaff"
908   \alias "Staff"
909   \denies "Voice"
910   \accepts "GregorianTranscriptionVoice"
911   \defaultchild "GregorianTranscriptionVoice"
912
913   %% We can not remove Bar_engraver; otherwise clefs and custodes will
914   %% not show up any more among other line breaking issues.
915   %% Instead, we make the grob transparent.
916   \override BarLine #'transparent = ##t
917 }
918
919 \context {
920   \Voice
921   \name "MensuralVoice"
922   \alias "Voice"
923   \description "Same as @code{Voice} context, except that it is
924 accommodated for typesetting a piece in mensural style."
925
926   \remove "Slur_engraver"
927   \remove "Ligature_bracket_engraver"
928   \consists "Mensural_ligature_engraver"
929
930   %% Set default head for notes outside of \[ \].
931   \override NoteHead #'style = #'mensural
932   \override Rest #'style = #'mensural
933
934   %% There are no beams in mensural notation.
935   autoBeaming = ##f
936 }
937
938 \context {
939   \Staff
940   \name "MensuralStaff"
941   \alias "Staff"
942   \denies "Voice"
943   \defaultchild "MensuralVoice"
944   \accepts "MensuralVoice"
945   \description "Same as @code{Staff} context, except that it is
946 accommodated for typesetting a piece in mensural style."
947
948   \consists "Custos_engraver"
949
950   %% We can not remove Bar_engraver; otherwise clefs and custodes will
951   %% not show up any more among other line breaking issues.
952   %% Instead, we make the grob transparent.
953   \override BarLine #'transparent = ##t
954
955   \override StaffSymbol #'thickness = #0.6
956
957   %% FIXME: unit on StaffSymbol's width should be \linewidth.
958   %% \override StaffSymbol #'width = #60.0
959
960   %% Choose mensural g clef on 2nd line as default.
961   clefGlyph = #"clefs.mensural.g"
962   middleCClefPosition = #-6
963   middleCPosition = #-6
964   clefPosition = #-2
965   clefOctavation = #0
966
967   %% Select mensural style font.
968   \override TimeSignature #'style = #'mensural
969   \override KeySignature #'glyph-name-alist = #alteration-mensural-glyph-name-alist
970   \override Accidental #'glyph-name-alist = #alteration-mensural-glyph-name-alist
971   \override Custos #'style = #'mensural
972   \override Custos #'neutral-position = #3
973   \override Custos #'neutral-direction = #DOWN
974
975   %% Accidentals are valid only once (same as
976   %% #(set-accidental-style 'forget))
977   extraNatural = ##f
978   autoAccidentals = #`(Staff ,(make-accidental-rule 'same-octave -1))
979   autoCautionaries = #'()
980   printKeyCancellation = ##f
981 }
982
983 RemoveEmptyDrumStaffContext = \context {
984   \DrumStaff
985   \remove "Axis_group_engraver"
986   \override VerticalAxisGroup #'remove-empty = ##t
987   \consists "Hara_kiri_engraver"
988 }
989
990 RemoveEmptyRhythmicStaffContext = \context {
991   \RhythmicStaff
992   \remove "Axis_group_engraver"
993   \override VerticalAxisGroup #'remove-empty = ##t
994   \consists "Hara_kiri_engraver"
995 }
996
997 RemoveEmptyTabStaffContext = \context {
998   \TabStaff
999   \remove "Axis_group_engraver"
1000   \override VerticalAxisGroup #'remove-empty = ##t
1001   \consists "Hara_kiri_engraver"
1002 }
1003