]> git.donarmstrong.com Git - lilypond.git/blob - input/lsr/tweaking-clef-properties.ly
Merge branch 'lilypond/translation' of ssh://jomand@git.sv.gnu.org/srv/git/lilypond
[lilypond.git] / input / lsr / tweaking-clef-properties.ly
1 %% Do not edit this file; it is auto-generated from LSR http://lsr.dsi.unimi.it
2 %% This file is in the public domain.
3 \version "2.11.62"
4
5 \header {
6   lsrtags = "pitches, staff-notation, tweaks-and-overrides"
7
8   doctitlees = "Trucaje de las propiedades de clave"
9   texidoces = "
10 Der Befehl @code{\\clef \"treble_8\"} ist gleichbedeutend mit einem
11 expliziten Setzen der Eigenschaften von @code{clefGlyph},
12 @code{clefPosition} (welche die vertikale Position des Schlüssels bestimmt),
13 @code{middleCPosition} und @code{clefOctavation}.  Ein Schlüssel wird
14 ausgegeben, wenn eine der Eigenschaften außer @code{middleCPosition} sich
15 ändert.
16
17 Eine Änderung des Schriftzeichens (Glyph), der Schlüsselposition oder der
18 Oktavierung selber ändert noch nicht die Position der darauf folgenden Noten
19 auf dem System: das geschieht nur, wenn auch die Position des
20 eingestrichenen@tie{}C (middleCPosition) angegeben wird.  Die
21 Positionsparameter sind relativ zur Mittellinie des Systems, dabei versetzen
22 positive Zahlen die Position nach oben, jeweils eine Zahl für jede Linie
23 plus Zwischenraum.  Der @code{clefOctavation}-Wert ist normalerweise auf 7,
24 -7, 15 oder -15 gesetzt, aber auch andere Werte sind gültig.
25
26 Wenn ein Schlüsselwechsel an einem Zeilenwechsel geschieht, wird das neue
27 Symbol sowohl am Ende der alten Zeilen als auch am Anfang der neuen Zeile
28 ausgegeben.  Wenn der Warnungs-Schlüssel am Ende der alten Zeile nicht
29 erforderlich ist, kann er unterdrückt werden, indem die
30 @code{explicitClefVisibility}-Eigenschaft des @code{Staff}-Kontextes auf den
31 Wert @code{end-of-line-invisible} gesetzt wird.  Das Standardverhalten kann
32 mit @code{\\unset Staff.explicitClefVisibility} wieder hergestellt werden.
33
34 Die folgenden Beispiele zeigen die Möglichkeiten, wenn man diese
35 Eigenschaften manuell setzt.  Auf der ersten Zeile erhalten die manuellen
36 Änderungen die ursprüngliche relative Positionierung von Schlüssel und
37 Noten, auf der zweiten Zeile nicht.
38 "
39
40   texidoc = "
41 The command @code{\\clef \"treble_8\"} is equivalent to setting
42 @code{clefGlyph}, @code{clefPosition} (which controls the vertical
43 position of the clef), @code{middleCPosition} and
44 @code{clefOctavation}. A clef is printed when any of the properties
45 except @code{middleCPosition} are changed.
46
47
48 Note that changing the glyph, the position of the clef, or the
49 octavation does not in itself change the position of subsequent notes
50 on the staff: the position of middle C must also be specified to do
51 this. The positional parameters are relative to the staff center line,
52 positive numbers displacing upwards, counting one for each line and
53 space. The @code{clefOctavation} value would normally be set to 7, -7,
54 15 or -15, but other values are valid.
55
56
57 When a clef change takes place at a line break the new clef symbol is
58 printed at both the end of the previous line and the beginning of the
59 new line by default. If the warning clef at the end of the previous
60 line is not required it can be suppressed by setting the @code{Staff}
61 property @code{explicitClefVisibility} to the value
62 @code{end-of-line-invisible}. The default behavior can be recovered
63 with  @code{\\unset Staff.explicitClefVisibility}.
64
65 The following examples show the possibilities when setting these
66 properties manually. On the first line, the manual changes preserve the
67 standard relative positioning of clefs and notes, whereas on the second
68 line, they do not. 
69
70 "
71   doctitle = "Tweaking clef properties"
72 } % begin verbatim
73 {
74   % The default treble clef
75   c'1
76   % The standard bass clef
77   \set Staff.clefGlyph = #"clefs.F"
78   \set Staff.clefPosition = #2
79   \set Staff.middleCPosition = #6
80   c'1
81   % The baritone clef
82   \set Staff.clefGlyph = #"clefs.C"
83   \set Staff.clefPosition = #4
84   \set Staff.middleCPosition = #4
85   c'1
86   % The standard choral tenor clef
87   \set Staff.clefGlyph = #"clefs.G"
88   \set Staff.clefPosition = #-2
89   \set Staff.clefOctavation = #-7
90   \set Staff.middleCPosition = #1
91   c'1
92   % A non-standard clef
93   \set Staff.clefPosition = #0
94   \set Staff.clefOctavation = #0
95   \set Staff.middleCPosition = #-4
96   c'1 \break
97
98   % The following clef changes do not preserve
99   % the normal relationship between notes and clefs:
100
101   \set Staff.clefGlyph = #"clefs.F"
102   \set Staff.clefPosition = #2
103   c'1
104   \set Staff.clefGlyph = #"clefs.G"
105   c'1
106   \set Staff.clefGlyph = #"clefs.C"
107   c'1
108   \set Staff.clefOctavation = #7
109   c'1
110   \set Staff.clefOctavation = #0
111   \set Staff.clefPosition = #0
112   c'1
113   
114   % Here we go back to the normal clef:
115
116   \set Staff.middleCPosition = #0
117   c'1
118 }