]> git.donarmstrong.com Git - lilypond.git/blob - ly/property-init.ly
Issue 1954: Implement event type filtering for pointAndClick events.
[lilypond.git] / ly / property-init.ly
1 % property-init.ly
2
3 \version "2.15.10"
4
5 %% for dashed slurs, phrasing slurs, and ties
6 #(define (make-simple-dash-definition dash-fraction dash-period)
7     (list (list 0 1 dash-fraction dash-period)))
8
9 %% common definition for all note head styles reverting
10 %% (palm mute, harmonics, dead notes, ...)
11 defaultNoteHeads =
12 #(define-music-function (parser location) ()
13    (_i "Revert to the default note head style.")
14    (revert-head-style '(NoteHead TabNoteHead)))
15
16
17
18 %% arpeggios
19
20 % For drawing vertical chord brackets with \arpeggio
21 % This is a shorthand for the value of the print-function property
22 % of either Staff.Arpeggio or PianoStaff.Arpeggio, depending whether
23 % cross-staff brackets are desired.
24
25 arpeggio = #(make-music 'ArpeggioEvent)
26 arpeggioArrowUp = {
27   \revert Arpeggio  #'stencil
28   \revert Arpeggio #'X-extent
29   \override Arpeggio  #'arpeggio-direction = #UP
30 }
31 arpeggioArrowDown = {
32   \revert Arpeggio #'stencil
33   \revert Arpeggio #'X-extent
34   \override Arpeggio  #'arpeggio-direction = #DOWN
35 }
36 arpeggioNormal = {
37   \revert Arpeggio #'stencil
38   \revert Arpeggio #'X-extent
39   \revert Arpeggio #'arpeggio-direction
40   \revert Arpeggio #'dash-definition
41 }
42 arpeggioBracket = {
43   \revert Arpeggio #'X-extent
44   \override Arpeggio #'stencil = #ly:arpeggio::brew-chord-bracket
45 }
46 arpeggioParenthesis = {
47   \override Arpeggio #'stencil = #ly:arpeggio::brew-chord-slur
48   \override Arpeggio #'X-extent = #ly:grob::stencil-width
49   \revert Arpeggio #'dash-definition
50 }
51 arpeggioParenthesisDashed = {
52   \override Arpeggio #'stencil = #ly:arpeggio::brew-chord-slur
53   \override Arpeggio #'X-extent = #ly:grob::stencil-width
54   \override Arpeggio #'dash-definition = #'((0 1 0.4 0.75))
55 }
56
57
58 %% auto beaming
59
60 autoBeamOn  = \set autoBeaming = ##t
61 autoBeamOff = \set autoBeaming = ##f
62
63
64 %% balloon length
65
66 balloonLengthOn = {
67   \override BalloonTextItem #'extra-spacing-width = #'(0 . 0)
68   \override BalloonTextItem #'extra-spacing-height = #'(-inf.0 . +inf.0)
69 }
70 balloonLengthOff = {
71   \override BalloonTextItem #'extra-spacing-width = #'(+inf.0 . -inf.0)
72   \override BalloonTextItem #'extra-spacing-height = #'(0 . 0)
73 }
74
75
76 %% bass figures
77
78 bassFigureExtendersOn = {
79   \set useBassFigureExtenders = ##t
80   \set Staff.useBassFigureExtenders = ##t
81 }
82 bassFigureExtendersOff = {
83   \set useBassFigureExtenders = ##f
84   \set Staff.useBassFigureExtenders = ##f
85 }
86 bassFigureStaffAlignmentDown =
87   \override Staff.BassFigureAlignmentPositioning #'direction = #DOWN
88 bassFigureStaffAlignmentUp =
89   \override Staff.BassFigureAlignmentPositioning #'direction = #UP
90 bassFigureStaffAlignmentNeutral =
91   \revert Staff.BassFigureAlignmentPositioning #'direction
92
93
94 %% cadenzas
95
96 cadenzaOn  = {
97   \set Timing.timing = ##f
98   \set Timing.autoBeaming = ##f
99 }
100
101 cadenzaOff = {
102   \set Timing.timing = ##t
103   \set Timing.measurePosition = #ZERO-MOMENT
104   \set Timing.autoBeaming = ##t
105 }
106
107
108 %% chord names
109
110 frenchChords = {
111   \set chordRootNamer = #(chord-name->italian-markup #t)
112   \set chordPrefixSpacer = #0.4
113 }
114 germanChords = {
115   \set chordRootNamer = #(chord-name->german-markup #t)
116   \set chordNoteNamer = #note-name->german-markup
117 }
118 semiGermanChords = {
119   \set chordRootNamer = #(chord-name->german-markup #f)
120   \set chordNoteNamer = #note-name->german-markup
121 }
122 italianChords = {
123   \set chordRootNamer = #(chord-name->italian-markup #f)
124   \set chordPrefixSpacer = #0.4
125 }
126 powerChords = {
127   \set chordNameExceptions = #powerChordExceptions
128 }
129
130
131 %% compressFullBarRests
132
133 compressFullBarRests = \set Score.skipBars = ##t
134 expandFullBarRests   = \set Score.skipBars = ##f
135
136
137 %% dots
138
139 dotsUp      = \override Dots #'direction = #UP
140 dotsDown    = \override Dots #'direction = #DOWN
141 dotsNeutral = \revert Dots #'direction
142
143
144 %% dynamics
145
146 dynamicUp = {
147   \override DynamicText #'direction = #UP
148   \override DynamicLineSpanner #'direction = #UP
149 }
150 dynamicDown = {
151   \override DynamicText #'direction = #DOWN
152   \override DynamicLineSpanner #'direction = #DOWN
153 }
154 dynamicNeutral = {
155   \revert DynamicText #'direction
156   \revert DynamicLineSpanner #'direction
157 }
158
159
160 %% easy heads
161
162 easyHeadsOn = {
163   \override NoteHead #'stencil = #note-head::brew-ez-stencil
164   \override NoteHead #'font-size = #-8
165   \override NoteHead #'font-family = #'sans
166   \override NoteHead #'font-series = #'bold
167 }
168 easyHeadsOff = {
169   \revert NoteHead #'stencil
170   \revert NoteHead #'font-size
171   \revert NoteHead #'font-family
172   \revert NoteHead #'font-series
173 }
174
175
176 %% endincipit
177
178 %% End the incipit and print a ``normal line start''.
179 endincipit = \context Staff {
180   \partial 16 s16  % Hack to handle e.g. \bar ".|" \endincipit
181   \once \override Staff.Clef #'full-size-change = ##t
182   \once \override Staff.Clef #'non-default = ##t
183   \bar ""
184 }
185
186
187 %% fermata markup
188
189 fermataMarkup =
190 #(make-music 'MultiMeasureTextEvent
191              'tweaks (list
192                       ;; Set the 'text based on the 'direction
193                       (cons 'text (lambda (grob)
194                                     (if (eq? (ly:grob-property grob 'direction) DOWN)
195                                         (markup #:musicglyph "scripts.dfermata")
196                                         (markup #:musicglyph "scripts.ufermata"))))
197                       (cons 'outside-staff-priority 40)
198                       (cons 'outside-staff-padding 0)))
199
200 %% font sizes
201
202 teeny      = \set fontSize = #-3
203 tiny       = \set fontSize = #-2
204 small      = \set fontSize = #-1
205 normalsize = \set fontSize = #0
206 large      = \set fontSize = #1
207 huge       = \set fontSize = #2
208
209
210 %% glissando
211
212 glissando = #(make-music 'GlissandoEvent)
213
214
215 %% harmonics
216
217 harmonicsOn =
218 #(define-music-function (parser location) ()
219    (_i "Set the default note head style to a diamond-shaped style.")
220    (override-head-style '(NoteHead TabNoteHead) 'harmonic))
221 harmonicsOff = \defaultNoteHeads
222 harmonicNote =
223 #(define-music-function (parser location note) (ly:music?)
224    (_i "Print @var{note} with a diamond-shaped note head.")
225    (style-note-heads 'NoteHead 'harmonic note))
226
227
228 %% hideNotes
229
230 hideNotes = {
231   % hide notes, accidentals, etc.
232   \override Dots #'transparent = ##t
233   \override NoteHead #'transparent = ##t
234   \override NoteHead #'no-ledgers = ##t
235   \override Stem #'transparent = ##t
236   \override Flag #'transparent = ##t
237   \override Beam #'transparent = ##t
238   \override Accidental #'transparent = ##t
239 }
240 unHideNotes = {
241   \revert Accidental #'transparent
242   \revert Beam #'transparent
243   \revert Stem #'transparent
244   \revert Flag #'transparent
245   \revert NoteHead #'transparent
246   \revert NoteHead #'no-ledgers
247   \revert Dots #'transparent
248 }
249
250
251 %% improvisation
252
253 improvisationOn = {
254   \set squashedPosition = #0
255   \override NoteHead #'style = #'slash
256   \override Accidental #'stencil = ##f
257   \override AccidentalCautionary #'stencil = ##f
258 }
259 improvisationOff = {
260   \unset squashedPosition
261   \revert NoteHead #'style
262   \revert Accidental #'stencil
263   \revert AccidentalCautionary #'stencil
264 }
265
266
267 %% merging
268
269 mergeDifferentlyDottedOn =
270   \override Staff.NoteCollision #'merge-differently-dotted = ##t
271 mergeDifferentlyDottedOff =
272   \revert Staff.NoteCollision #'merge-differently-dotted
273 mergeDifferentlyHeadedOn =
274   \override Staff.NoteCollision #'merge-differently-headed = ##t
275 mergeDifferentlyHeadedOff =
276   \revert Staff.NoteCollision #'merge-differently-headed
277
278
279 %% numeric time signature
280
281 numericTimeSignature = \override Staff.TimeSignature #'style = #'numbered
282 defaultTimeSignature = \revert Staff.TimeSignature #'style
283
284
285 %% palm mutes
286
287 palmMuteOn =
288 #(define-music-function (parser location) ()
289    (_i "Set the default note head style to a triangle-shaped style.")
290    (override-head-style 'NoteHead 'do))
291 palmMuteOff = \defaultNoteHeads
292 palmMute =
293 #(define-music-function (parser location note) (ly:music?)
294    (_i "Print @var{note} with a triangle-shaped note head.")
295    (style-note-heads 'NoteHead 'do note))
296
297
298 %% phrasing slurs
299
300 % directions
301 phrasingSlurUp      = \override PhrasingSlur #'direction = #UP
302 phrasingSlurDown    = \override PhrasingSlur #'direction = #DOWN
303 phrasingSlurNeutral = \revert PhrasingSlur #'direction
304
305 % dash-patterns (make-simple-dash-definition defined at top of file)
306 phrasingSlurDashPattern =
307 #(define-music-function (parser location dash-fraction dash-period)
308    (number? number?)
309    (_i "Set up a custom style of dash pattern for @var{dash-fraction} ratio of
310 line to space repeated at @var{dash-period} interval for phrasing slurs.")
311   #{
312      \override PhrasingSlur #'dash-definition =
313        $(make-simple-dash-definition dash-fraction dash-period)
314   #})
315 phrasingSlurDashed =
316   \override PhrasingSlur #'dash-definition = #'((0 1 0.4 0.75))
317 phrasingSlurDotted =
318   \override PhrasingSlur #'dash-definition = #'((0 1 0.1 0.75))
319 phrasingSlurHalfDashed =
320   \override PhrasingSlur #'dash-definition = #'((0 0.5 0.4 0.75)
321                                                 (0.5 1 1 1))
322 phrasingSlurHalfSolid =
323   \override PhrasingSlur #'dash-definition = #'((0 0.5 1 1)
324                                                 (0.5 1 0.4 0.75))
325 phrasingSlurSolid =
326   \revert PhrasingSlur #'dash-definition
327
328
329 %% point and click
330
331 pointAndClickOn  =
332 #(define-music-function (parser location) ()
333    (_i "Enable generation of code in final-format (e.g. pdf) files to reference the
334 originating lilypond source statement;
335 this is helpful when developing a score but generates bigger final-format files.")
336    (ly:set-option 'point-and-click #t)
337    (make-music 'SequentialMusic 'void #t))
338
339 pointAndClickOff =
340 #(define-music-function (parser location) ()
341    (_i "Suppress generating extra code in final-format (e.g. pdf) files to point
342 back to the lilypond source statement.")
343    (ly:set-option 'point-and-click #f)
344    (make-music 'SequentialMusic 'void #t))
345
346 pointAndClickTypes =
347 #(define-void-function (parser location types) (list-or-symbol?)
348   (_i "Set a type or list of types (such as @code{#'note-event}) for which point-and-click info is generated.")
349   (ly:set-option 'point-and-click types))
350
351 %% predefined fretboards
352
353 predefinedFretboardsOff =
354   \set predefinedDiagramTable = ##f
355 predefinedFretboardsOn =
356   \set predefinedDiagramTable = #default-fret-table
357
358
359 %% shape note heads
360
361 aikenHeads      = \set shapeNoteStyles = #'#(do re miMirror fa sol la ti)
362 aikenHeadsMinor = \set shapeNoteStyles = #'#(la ti do re miMirror fa sol)
363 funkHeads =
364   \set shapeNoteStyles = #'#(doFunk reFunk miFunk faFunk solFunk laFunk tiFunk)
365 funkHeadsMinor =
366   \set shapeNoteStyles = #'#(laFunk tiFunk doFunk reFunk miFunk faFunk solFunk)
367 sacredHarpHeads = \set shapeNoteStyles = #'#(fa sol la fa sol la mi)
368 sacredHarpHeadsMinor = \set shapeNoteStyles = #'#(la mi fa sol la fa sol)
369 southernHarmonyHeads =
370   \set shapeNoteStyles = #'#(faThin sol laThin faThin sol laThin miThin)
371 southernHarmonyHeadsMinor =
372   \set shapeNoteStyles = #'#(laThin miThin faThin sol laThin faThin sol)
373 walkerHeads =
374   \set shapeNoteStyles = #'#(doWalker reWalker miWalker faWalker solFunk laWalker tiWalker)
375 walkerHeadsMinor =
376   \set shapeNoteStyles = #'#(laWalker tiWalker doWalker reWalker miWalker faWalker solFunk)
377
378
379 %% shifts
380
381 shiftOn   = \override NoteColumn #'horizontal-shift = #1
382 shiftOnn  = \override NoteColumn #'horizontal-shift = #2
383 shiftOnnn = \override NoteColumn #'horizontal-shift = #3
384 shiftOff  = \revert NoteColumn #'horizontal-shift
385
386
387 %% slurs
388
389 % directions
390 slurUp         = \override Slur #'direction = #UP
391 slurDown       = \override Slur #'direction = #DOWN
392 slurNeutral    = \revert Slur #'direction
393
394 % dash-patterns (make-simple-dash-definition defined at top of file)
395 slurDashPattern =
396 #(define-music-function (parser location dash-fraction dash-period)
397   (number? number?)
398   (_i "Set up a custom style of dash pattern for @var{dash-fraction}
399 ratio of line to space repeated at @var{dash-period} interval for slurs.")
400   #{
401      \override Slur #'dash-definition =
402        $(make-simple-dash-definition dash-fraction dash-period)
403   #})
404 slurDashed     = \override Slur #'dash-definition = #'((0 1 0.4 0.75))
405 slurDotted     = \override Slur #'dash-definition = #'((0 1 0.1 0.75))
406 slurHalfDashed = \override Slur #'dash-definition = #'((0 0.5 0.4 0.75)
407                                                        (0.5 1 1 1))
408 slurHalfSolid  = \override Slur #'dash-definition = #'((0 0.5 1 1)
409                                                        (0.5 1 0.4 0.75))
410 slurSolid      = \revert Slur #'dash-definition
411
412
413 %% staff switches
414
415 showStaffSwitch = \set followVoice = ##t
416 hideStaffSwitch = \set followVoice = ##f
417
418
419 %% stems
420
421 stemUp      = \override Stem #'direction = #UP
422 stemDown    = \override Stem #'direction = #DOWN
423 stemNeutral = \revert Stem #'direction
424
425
426 %% tablature
427
428 % switch to full notation
429 tabFullNotation = {
430   % time signature
431   \revert TabStaff.TimeSignature #'stencil
432   % stems (the half note gets a double stem)
433   \revert TabVoice.Stem #'length
434   \revert TabVoice.Stem #'no-stem-extend
435   \revert TabVoice.Flag #'style
436   \revert TabVoice.Stem #'details
437   \revert TabVoice.Stem #'transparent
438   \override TabVoice.Stem #'stencil = #tabvoice::draw-double-stem-for-half-notes
439   \set autoBeaming = ##t
440   \revert NoteColumn #'ignore-collision
441   % beams, dots
442   \revert TabVoice.Beam #'stencil
443   \revert TabVoice.StemTremolo #'stencil
444   \revert TabVoice.Dots #'stencil
445   \revert TabVoice.Tie #'stencil
446   \revert TabVoice.Tie #'after-line-breaking
447   \revert TabVoice.RepeatTie #'stencil
448   \revert TabVoice.RepeatTie #'after-line-breaking
449   \revert TabVoice.LaissezVibrerTie #'stencil
450   \revert TabVoice.Slur #'stencil
451   \revert TabVoice.PhrasingSlur #'stencil
452   % tuplet stuff
453   \revert TabVoice.TupletBracket #'stencil
454   \revert TabVoice.TupletNumber #'stencil
455   % dynamic signs
456   \revert TabVoice.DynamicText #'transparent
457   \revert TabVoice.DynamicTextSpanner #'stencil
458   \revert TabVoice.DynamicTextSpanner #'stencil
459   \revert TabVoice.Hairpin #'transparent
460   % rests
461   \revert TabVoice.Rest #'stencil
462   \revert TabVoice.MultiMeasureRest #'stencil
463   \revert TabVoice.MultiMeasureRestNumber #'transparent
464   \revert TabVoice.MultiMeasureRestText #'transparent
465   % markups etc.
466   \revert TabVoice.Glissando #'stencil
467   \revert TabVoice.Script #'stencil
468   \revert TabVoice.TextScript #'stencil
469   \revert TabVoice.TextSpanner #'stencil
470   \revert TabStaff.Arpeggio #'stencil
471   \revert TabStaff.NoteColumn #'ignore-collision
472 }
473
474 %tie/repeat tie behaviour
475 hideSplitTiedTabNotes = {
476   \override TabVoice.TabNoteHead #'(details tied-properties break-visibility) = #all-invisible
477   \override TabVoice.TabNoteHead #'(details tied-properties parenthesize) = ##f
478   \override TabVoice.TabNoteHead #'(details repeat-tied-properties note-head-visible) = ##f
479   \override TabVoice.TabNoteHead #'(details repeat-tied-properties parenthesize) = ##f
480 }
481
482 showSplitTiedTabNotes = {
483   \override TabVoice.TabNoteHead #'(details tied-properties break-visibility) = #begin-of-line-visible
484   \override TabVoice.TabNoteHead #'(details tied-properties parenthesize) = ##t
485   \override TabVoice.TabNoteHead #'(details repeat-tied-properties note-head-visible) = ##t
486   \override TabVoice.TabNoteHead #'(details repeat-tied-properties parenthesize) = ##t
487 }
488
489 %% text length
490
491 textLengthOn = {
492   \override TextScript #'extra-spacing-width = #'(0 . 0)
493   \override TextScript #'extra-spacing-height = #'(-inf.0 . +inf.0)
494 }
495 textLengthOff = {
496   \override TextScript #'extra-spacing-width = #'(+inf.0 . -inf.0)
497   \override TextScript #'extra-spacing-height = #'(0 . 0)
498 }
499
500
501 %% text spanners
502
503 textSpannerUp      = \override TextSpanner #'direction = #UP
504 textSpannerDown    = \override TextSpanner #'direction = #DOWN
505 textSpannerNeutral = \revert TextSpanner #'direction
506
507
508 %% ties
509
510 % directions
511 tieUp      = \override Tie #'direction = #UP
512 tieDown    = \override Tie #'direction = #DOWN
513 tieNeutral = \revert Tie #'direction
514
515 % dash-patterns (make-simple-dash-definition defined at top of file)
516 tieDashPattern =
517 #(define-music-function (parser location dash-fraction dash-period)
518   (number? number?)
519   (_i "Set up a custom style of dash pattern for @var{dash-fraction}
520 ratio of line to space repeated at @var{dash-period} interval for ties.")
521   #{
522      \override Tie #'dash-definition =
523        $(make-simple-dash-definition dash-fraction dash-period)
524   #})
525 tieDashed     = \override Tie #'dash-definition = #'((0 1 0.4 0.75))
526 tieDotted     = \override Tie #'dash-definition = #'((0 1 0.1 0.75))
527 tieHalfDashed = \override Tie #'dash-definition = #'((0 0.5 0.4 0.75)
528                                                      (0.5 1 1 1))
529 tieHalfSolid  = \override Tie #'dash-definition = #'((0 0.5 1 1)
530                                                      (0.5 1 0.4 0.75))
531 tieSolid      = \revert Tie #'dash-definition
532
533
534 %% tuplets
535
536 tupletUp      = \override TupletBracket #'direction = #UP
537 tupletDown    = \override TupletBracket #'direction = #DOWN
538 tupletNeutral = \revert TupletBracket #'direction
539
540
541 %% voice properties
542
543 % dynamic ly:dir?  text script, articulation script ly:dir?
544 voiceOne   = #(context-spec-music (make-voice-props-set 0)  'Voice)
545 voiceTwo   = #(context-spec-music (make-voice-props-set 1)  'Voice)
546 voiceThree = #(context-spec-music (make-voice-props-set 2)  'Voice)
547 voiceFour  = #(context-spec-music (make-voice-props-set 3)  'Voice)
548 oneVoice   = #(context-spec-music (make-voice-props-revert) 'Voice)
549
550
551 %% voice styles
552
553 voiceOneStyle = {
554   \override NoteHead #'style = #'diamond
555   \override NoteHead #'color = #red
556   \override Stem #'color = #red
557   \override Flag #'color = #red
558   \override Beam #'color = #red
559 }
560 voiceTwoStyle = {
561   \override NoteHead #'style = #'triangle
562   \override NoteHead #'color = #blue
563   \override Stem #'color = #blue
564   \override Flag #'color = #blue
565   \override Beam #'color = #blue
566 }
567 voiceThreeStyle = {
568   \override NoteHead #'style = #'xcircle
569   \override NoteHead #'color = #green
570   \override Stem #'color = #green
571   \override Flag #'color = #green
572   \override Beam #'color = #green
573 }
574 voiceFourStyle = {
575   \override NoteHead #'style = #'cross
576   \override NoteHead #'color = #magenta
577   \override Stem #'color = #magenta
578   \override Flag #'color = #magenta
579   \override Beam #'color = #magenta
580 }
581 voiceNeutralStyle = {
582   \revert NoteHead #'style
583   \revert NoteHead #'color
584   \revert Stem #'color
585   \revert Flag #'color
586   \revert Beam #'color
587 }
588
589
590 %% x notes
591
592 xNotesOn =
593 #(define-music-function (parser location) ()
594    (_i "Set the default note head style to a cross-shaped style.")
595    (override-head-style '(TabNoteHead NoteHead) 'cross))
596 xNotesOff = \defaultNoteHeads
597 xNote =
598 #(define-music-function (parser location note) (ly:music?)
599    (_i "Print @var{note} with a cross-shaped note head.")
600    (style-note-heads '(TabNoteHead NoteHead) 'cross note))
601
602
603 %% dead notes (these need to come after "x notes")
604
605 % Define aliases of cross-head notes for specific purposes
606 deadNotesOn  = \xNotesOn
607 deadNotesOff = \xNotesOff
608 deadNote     = #xNote