]> git.donarmstrong.com Git - lilypond.git/blob - input/lsr/clefs-commonly-tweaked-properties.ly
Deeply revise input/lsr structure, generation and compilation
[lilypond.git] / input / lsr / clefs-commonly-tweaked-properties.ly
1 %% Do not edit this file; it is auto-generated from LSR!
2 %% Tags: pitches, staff-notation, editorial-and-educational-use
3 \version "2.11.35"
4
5 \header { texidoc = "
6 The command @code{\\clef \"treble_8\"} is equivalent to setting
7 @code{clefGlyph}, @code{clefPosition} (which controls the Y position of
8 the clef), @code{middleCPosition} and @code{clefOctavation}.  A clef is
9 printed when any of these properties are changed.
10
11
12 Note that changing the glyph, the position of the clef, or the
13 octavation, does not in itself change the position of subsequent notes
14 on the staff: the position of middle C must also be specified to do
15 this. The positional parameters are relative to the staff centre line,
16 positive numbers displacing upwards, counting 1 for each line and
17 space. The clefOctavation value would normally be set to 7, -7, 15 or
18 -15, but other values are not invalid.
19
20
21 When a clef change takes place at a line break the new clef symbol is
22 printed at both the end of the previous line and the beginning of the
23 new line by default. If the warning clef at the end of the previous
24 line in not required it can be suppressed by setting the
25 explicitClefVisibility Staff property to the value  @code{
26 end-of-line-invisible: \\set Staff.explicitClefVisibility =
27 #end-of-line-invisible  } The default behaviour can be recovered with 
28 @code{\\unset Staff.explicitClefVisibility}
29
30
31 The following examples show the possibilities when setting these
32 properties manually. On the first line, the manual changes preserve the
33 standard relative positioning of clefs and notes, whereas on the second
34 line, they do not. 
35 " }
36
37 {
38            % The default treble clef
39            c'4
40            % The standard bass clef
41            \set Staff.clefGlyph = #"clefs.F"
42            \set Staff.clefPosition = #2
43            \set Staff.middleCPosition = #6
44            c'4
45            % The baritone clef
46            \set Staff.clefGlyph = #"clefs.C"
47            \set Staff.clefPosition = #4
48            \set Staff.middleCPosition = #4
49            c'4
50            % The standard choral tenor clef
51            \set Staff.clefGlyph = #"clefs.G"
52            \set Staff.clefPosition = #-2
53            \set Staff.clefOctavation = #-7
54            \set Staff.middleCPosition = #1
55            c'4
56            % A non-standard clef
57            \set Staff.clefPosition = #0
58            \set Staff.clefOctavation = #0
59            \set Staff.middleCPosition = #-4
60            c'4 \break
61
62            % The following clef changes do not preserve
63            % the normal relationship between notes and clefs:
64
65            \set Staff.clefGlyph = #"clefs.F"
66            \set Staff.clefPosition = #2
67            c'4
68            \set Staff.clefGlyph = #"clefs.G"
69            c'4
70            \set Staff.clefGlyph = #"clefs.C"
71            c'4
72            \set Staff.clefOctavation = #7
73            c'4
74            \set Staff.clefOctavation = #0
75            \set Staff.clefPosition = #0
76            c'4
77            \set Staff.middleCPosition = #4
78            c'4
79          }