]> git.donarmstrong.com Git - lilypond.git/blob - Documentation/snippets/tweaking-clef-properties.ly
Merge branch 'lilypond/translation' of ssh://git.sv.gnu.org/srv/git/lilypond
[lilypond.git] / Documentation / snippets / tweaking-clef-properties.ly
1 %% Do not edit this file; it is automatically
2 %% generated from LSR http://lsr.dsi.unimi.it
3 %% This file is in the public domain.
4 \version "2.13.16"
5
6 \header {
7   lsrtags = "pitches, staff-notation, tweaks-and-overrides"
8
9 %% Translation of GIT committish: 00ef2ac3dd16e21c9ffdffaa4d6d043a3f1a76e6
10   doctitlees = "Trucaje de las propiedades de clave"
11   texidoces = "
12 La instrucción @code{\\clef \"treble_8\"} equivale a un ajuste de
13 @code{clefGlyph}, @code{clefPosition} (que controla la posición
14 vertical de la clave), @code{middleCPosition} y
15 @code{clefOctavation}.  Se imprime una clave cada vez que se
16 modifica cualquiera de las propiedades excepto
17 @code{middleCPosition}.
18
19 Observe que la modificación del glifo, la posición de la clave o
20 su octavación, no cambian 'per se' la posición de las siguientes
21 notas del pentagrama: para hacer esto también se debe especificar
22 la posición del Do central.  Los parámetros posicionales están en
23 relación con la tercera línea del pentagrama, los números
24 positivos desplazan hacia arriba, contando una unidad por cada
25 línea y espacio.  El valor de @code{clefOctavation} se
26 establecería normalmente a 7, -7, 15 or -15, pero son válidos
27 otros valores.
28
29 Cuando se produce un cambio de clave en el salto de línea se
30 imprime la clave nueva tanto al final de la línea anterior como al
31 principio de la nueva, de forma predeterminada.  Si no se necesita
32 la clave de advertencia al final de la línea anterior, se puede
33 quitar estableciendo el valor de la propiedad
34 @code{explicitClefVisibility} de @code{Staff}, a
35 @code{end-of-line-invisible}.  El comportamiento predeterminado se
36 puede recuperar con @code{\\unset Staff.explicitClefVisibility}.
37
38 Los siguientes ejemplos muestran las posibilidades cuando se
39 ajustan estas propiedades manualmente.  En la primera línea, los
40 cambios manuales preservan el posicionamiento relativo estándar de
41 las claves y las notas, pero no lo hacen en la segunda línea.
42 "
43
44
45 %% Translation of GIT committish: d96023d8792c8af202c7cb8508010c0d3648899d
46   doctitlede = "Eigenschaften des Schlüssels optimieren"
47   texidocde = "
48 Der Befehl @code{\\clef \"treble_8\"} ist gleichbedeutend mit einem
49 expliziten Setzen der Eigenschaften von @code{clefGlyph},
50 @code{clefPosition} (welche die vertikale Position des Schlüssels bestimmt),
51 @code{middleCPosition} und @code{clefOctavation}.  Ein Schlüssel wird
52 ausgegeben, wenn eine der Eigenschaften außer @code{middleCPosition} sich
53 ändert.
54
55 Eine Änderung des Schriftzeichens (Glyph), der Schlüsselposition oder der
56 Oktavierung selber ändert noch nicht die Position der darauf folgenden Noten
57 auf dem System: das geschieht nur, wenn auch die Position des
58 eingestrichenen@tie{}C (middleCPosition) angegeben wird.  Die
59 Positionsparameter sind relativ zur Mittellinie des Systems, dabei versetzen
60 positive Zahlen die Position nach oben, jeweils eine Zahl für jede Linie
61 plus Zwischenraum.  Der @code{clefOctavation}-Wert ist normalerweise auf 7,
62 -7, 15 oder -15 gesetzt, aber auch andere Werte sind gültig.
63
64 Wenn ein Schlüsselwechsel an einem Zeilenwechsel geschieht, wird das neue
65 Symbol sowohl am Ende der alten Zeilen als auch am Anfang der neuen Zeile
66 ausgegeben.  Wenn der Warnungs-Schlüssel am Ende der alten Zeile nicht
67 erforderlich ist, kann er unterdrückt werden, indem die
68 @code{explicitClefVisibility}-Eigenschaft des @code{Staff}-Kontextes auf den
69 Wert @code{end-of-line-invisible} gesetzt wird.  Das Standardverhalten kann
70 mit @code{\\unset Staff.explicitClefVisibility} wieder hergestellt werden.
71
72 Die folgenden Beispiele zeigen die Möglichkeiten, wenn man diese
73 Eigenschaften manuell setzt.  Auf der ersten Zeile erhalten die manuellen
74 Änderungen die ursprüngliche relative Positionierung von Schlüssel und
75 Noten, auf der zweiten Zeile nicht.
76 "
77
78 %% Translation of GIT committish: 59968a089729d7400f8ece38d5bc98dbb3656a2b
79   texidocfr = "
80 La commande @code{\\clef \"treble_8\"} équivaut à définir @code{clefGlyph},
81 @code{clefPosition} -- qui contrôle la position verticale de la clé --
82 @code{middleCPosition} et @code{clefOctavation}.  Une clé est imprimée
83 lorsque l'une de ces propriétés, hormis @code{middleCPosition}, est
84 modifiée. 
85  Les exemples suivant font
86 apparaître des possibilités de réglage manuel de ces propriétés.
87
88
89 Modifier le glyphe, la position de la clef ou son octaviation ne
90 changera pas la position des notes ; il faut pour y parvenir modifier
91 aussi la position du do médium.  Le positionnement est relatif à la
92 ligne médiane, un nombre positif faisant monter, chaque ligne ou
93 interligne comptant pour 1.  La valeur de @code{clefOctavation} devrait
94 être de 7, -7, 15 ou -15, bien que rien ne vous empêche de lui affecter
95 une autre valeur.
96
97
98 Lorsqu'un changement de clef intervient en même temps qu'un saut de
99 ligne, la nouvelle clef est imprimer à la fois en fin de ligne et au
100 début de la suivante.  Vous pouvez toujours supprimer cette « clef de 
101 précaution » en affectant la valeur @code{end-of-line-invisible} à la
102 propriété @code{explicitClefVisibility} du contexte @code{Staff}.  Le
103 comportement par défaut sera réactivé par 
104 @w{@code{\\unset@tie{}Staff.explicitClefVisibility}}. 
105
106
107 Les exemples qui suivent illustrent les différentes possibilités de
108 définir ces propriétés manuellement.  Sur la première ligne, la
109 position relative des notes par rapport aux clefs sont préservées, ce
110 qui n'est pas le cas pour la deuxième ligne.
111
112 "
113   doctitlefr = "Affinage des propriétés d'une clef"
114
115   texidoc = "
116 The command @code{\\clef \"treble_8\"} is equivalent to setting
117 @code{clefGlyph}, @code{clefPosition} (which controls the vertical
118 position of the clef), @code{middleCPosition} and
119 @code{clefOctavation}. A clef is printed when any of the properties
120 except @code{middleCPosition} are changed.
121
122
123 Note that changing the glyph, the position of the clef, or the
124 octavation does not in itself change the position of subsequent notes
125 on the staff: the position of middle C must also be specified to do
126 this. The positional parameters are relative to the staff center line,
127 positive numbers displacing upwards, counting one for each line and
128 space. The @code{clefOctavation} value would normally be set to 7, -7,
129 15 or -15, but other values are valid.
130
131
132 When a clef change takes place at a line break the new clef symbol is
133 printed at both the end of the previous line and the beginning of the
134 new line by default. If the warning clef at the end of the previous
135 line is not required it can be suppressed by setting the @code{Staff}
136 property @code{explicitClefVisibility} to the value
137 @code{end-of-line-invisible}. The default behavior can be recovered
138 with  @code{\\unset Staff.explicitClefVisibility}.
139
140 The following examples show the possibilities when setting these
141 properties manually. On the first line, the manual changes preserve the
142 standard relative positioning of clefs and notes, whereas on the second
143 line, they do not.
144
145 "
146   doctitle = "Tweaking clef properties"
147 } % begin verbatim
148
149 \layout { ragged-right = ##t }
150
151 {
152   % The default treble clef
153   c'1
154   % The standard bass clef
155   \set Staff.clefGlyph = #"clefs.F"
156   \set Staff.clefPosition = #2
157   \set Staff.middleCPosition = #6
158   c'1
159   % The baritone clef
160   \set Staff.clefGlyph = #"clefs.C"
161   \set Staff.clefPosition = #4
162   \set Staff.middleCPosition = #4
163   c'1
164   % The standard choral tenor clef
165   \set Staff.clefGlyph = #"clefs.G"
166   \set Staff.clefPosition = #-2
167   \set Staff.clefOctavation = #-7
168   \set Staff.middleCPosition = #1
169   c'1
170   % A non-standard clef
171   \set Staff.clefPosition = #0
172   \set Staff.clefOctavation = #0
173   \set Staff.middleCPosition = #-4
174   c'1 \break
175
176   % The following clef changes do not preserve
177   % the normal relationship between notes and clefs:
178
179   \set Staff.clefGlyph = #"clefs.F"
180   \set Staff.clefPosition = #2
181   c'1
182   \set Staff.clefGlyph = #"clefs.G"
183   c'1
184   \set Staff.clefGlyph = #"clefs.C"
185   c'1
186   \set Staff.clefOctavation = #7
187   c'1
188   \set Staff.clefOctavation = #0
189   \set Staff.clefPosition = #0
190   c'1
191
192   % Return to the normal clef:
193
194   \set Staff.middleCPosition = #0
195   c'1
196 }
197