Documentation/snippets/tweaking-clef-properties.ly

   1 %% DO NOT EDIT this file manually; it is automatically
   2 %% generated from LSR http://lsr.dsi.unimi.it
   3 %% Make any changes in LSR itself, or in Documentation/snippets/new/ ,
   4 %% and then run scripts/auxiliar/makelsr.py
   5 %%
   6 %% This file is in the public domain.
   7 \version "2.14.0"
   8
   9 \header {
  10 %% Translation of GIT committish: bbf8fd2b5a3ebf20a1fdc91613dc49045a53a270
  11   texidocit = "
  12 Il comando @code{\\clef \"treble_8\"} equivale a impostare
  13 @code{clefGlyph}, @code{clefPosition} (che regola la posizione
  14 verticale della chiave), @code{middleCPosition} e
  15 @code{clefOctavation}. Viene stampata una chiave quando cambia una
  16 di queste proprietà, eccetto @code{middleCPosition}.
  17
  18
  19 La modifica del glifo, della posizione della chiave o
  20 dell'ottavazione non è sufficiente per cambiare la posizione delle
  21 note che seguono sul rigo: bisogna anche specificare la posizione
  22 del Do centrale (middle C). I parametri di posizione sono relativi
  23 alla linea centrale del rigo, con i numeri positivi che indicano
  24 la parte superiore: ogni linea e spazio valgono uno.  Il valore
  25 @code{clefOctavation} di norma è impostato su 7, -7, 15
  26 o -15, ma altri valori sono considerati validi.
  27
  28
  29 Quando un cambio di chiave avviene in corrispondenza di un'interruzione di
  30 linea, di norma il simbolo della nuova chiave viene inserito sia alla fine
  31 del rigo precedente sia all'inizio di quello successivo.  Se la
  32 chiave di avvertimento a fine rigo non fosse necessaria,
  33 può essere nascosta impostando la proprietà @code{explicitClefVisibility}
  34 del contesto @code{Staff} su @code{end-of-line-invisible}. Il comportamento
  35 predefinito può essere ripristinato con @code{\\unset Staff.explicitClefVisibility}.
  36
  37 Gli esempi seguenti mostrano le possibilità date dall'impostazione
  38 manuale di tali proprietà. Sulla prima linea le modifiche manuali preservano
  39 il posizionamento relativo standard di chiavi e note, mentre sulla seconda
  40 linea non lo fanno.
  41
  42
  43 "
  44   doctitleit = "Modifiche manuali della proprietà della chiave"
  45
  46   lsrtags = "pitches, staff-notation, tweaks-and-overrides"
  47
  48
  49
  50
  51 %% Translation of GIT committish: 6977ddc9a3b63ea810eaecb864269c7d847ccf98
  52   doctitlees = "Trucaje de las propiedades de clave"
  53   texidoces = "
  54 La instrucción @code{\\clef \"treble_8\"} equivale a un ajuste de
  55 @code{clefGlyph}, @code{clefPosition} (que controla la posición
  56 vertical de la clave), @code{middleCPosition} y
  57 @code{clefOctavation}.  Se imprime una clave cada vez que se
  58 modifica cualquiera de las propiedades excepto
  59 @code{middleCPosition}.
  60
  61 Observe que la modificación del glifo, la posición de la clave o
  62 su octavación, no cambian 'per se' la posición de las siguientes
  63 notas del pentagrama: para hacer esto también se debe especificar
  64 la posición del Do central.  Los parámetros posicionales están en
  65 relación con la tercera línea del pentagrama, los números
  66 positivos desplazan hacia arriba, contando una unidad por cada
  67 línea y espacio.  El valor de @code{clefOctavation} se
  68 establecería normalmente a 7, -7, 15 or -15, pero son válidos
  69 otros valores.
  70
  71 Cuando se produce un cambio de clave en el salto de línea se
  72 imprime la clave nueva tanto al final de la línea anterior como al
  73 principio de la nueva, de forma predeterminada.  Si no se necesita
  74 la clave de advertencia al final de la línea anterior, se puede
  75 quitar estableciendo el valor de la propiedad
  76 @code{explicitClefVisibility} de @code{Staff}, a
  77 @code{end-of-line-invisible}.  El comportamiento predeterminado se
  78 puede recuperar con @code{\\unset Staff.explicitClefVisibility}.
  79
  80 Los siguientes ejemplos muestran las posibilidades cuando se
  81 ajustan estas propiedades manualmente.  En la primera línea, los
  82 cambios manuales preservan el posicionamiento relativo estándar de
  83 las claves y las notas, pero no lo hacen en la segunda línea.
  84 "
  85
  86
  87 %% Translation of GIT committish: 0a868be38a775ecb1ef935b079000cebbc64de40
  88   doctitlede = "Eigenschaften des Schlüssels optimieren"
  89   texidocde = "
  90 Der Befehl @code{\\clef \"treble_8\"} ist gleichbedeutend mit einem
  91 expliziten Setzen der Eigenschaften von @code{clefGlyph},
  92 @code{clefPosition} (welche die vertikale Position des Schlüssels bestimmt),
  93 @code{middleCPosition} und @code{clefOctavation}.  Ein Schlüssel wird
  94 ausgegeben, wenn eine der Eigenschaften außer @code{middleCPosition} sich
  95 ändert.
  96
  97 Eine Änderung des Schriftzeichens (Glyph), der Schlüsselposition oder der
  98 Oktavierung selber ändert noch nicht die Position der darauf folgenden Noten
  99 auf dem System: das geschieht nur, wenn auch die Position des
 100 eingestrichenen@tie{}C (middleCPosition) angegeben wird.  Die
 101 Positionsparameter sind relativ zur Mittellinie des Systems, dabei versetzen
 102 positive Zahlen die Position nach oben, jeweils eine Zahl für jede Linie
 103 plus Zwischenraum.  Der @code{clefOctavation}-Wert ist normalerweise auf 7,
 104 -7, 15 oder -15 gesetzt, aber auch andere Werte sind gültig.
 105
 106 Wenn ein Schlüsselwechsel an einem Zeilenwechsel geschieht, wird das neue
 107 Symbol sowohl am Ende der alten Zeilen als auch am Anfang der neuen Zeile
 108 ausgegeben.  Wenn der Warnungs-Schlüssel am Ende der alten Zeile nicht
 109 erforderlich ist, kann er unterdrückt werden, indem die
 110 @code{explicitClefVisibility}-Eigenschaft des @code{Staff}-Kontextes auf den
 111 Wert @code{end-of-line-invisible} gesetzt wird.  Das Standardverhalten kann
 112 mit @code{\\unset Staff.explicitClefVisibility} wieder hergestellt werden.
 113
 114 Die folgenden Beispiele zeigen die Möglichkeiten, wenn man diese
 115 Eigenschaften manuell setzt.  Auf der ersten Zeile erhalten die manuellen
 116 Änderungen die ursprüngliche relative Positionierung von Schlüssel und
 117 Noten, auf der zweiten Zeile nicht.
 118 "
 119
 120 %% Translation of GIT committish: 3b125956b08d27ef39cd48bfa3a2f1e1bb2ae8b4
 121   texidocfr = "
 122 La commande @code{\\clef \"treble_8\"} équivaut à définir @code{clefGlyph},
 123 @code{clefPosition} -- qui contrôle la position verticale de la clé --
 124 @code{middleCPosition} et @code{clefOctavation}.  Une clé est imprimée
 125 lorsque l'une de ces propriétés, hormis @code{middleCPosition}, est
 126 modifiée.  Les exemples suivant font apparaître des possibilités de
 127 réglage manuel de ces propriétés.
 128
 129
 130 Modifier le glyphe, la position de la clef ou son octaviation ne
 131 changera pas la position des notes@tie{}; il faut pour y parvenir
 132 modifier aussi la position du do médium.  Le positionnement est relatif
 133 à la ligne médiane, un nombre positif faisant monter, chaque ligne ou
 134 interligne comptant pour@tie{}1.  La valeur de @code{clefOctavation}
 135 devrait être de 7, -7, 15 ou -15, bien que rien ne vous empêche de lui
 136 affecter une autre valeur.
 137
 138
 139 Lorsqu'un changement de clef intervient en même temps qu'un saut de
 140 ligne, la nouvelle clef est imprimée à la fois en fin de ligne et au
 141 début de la suivante.  Vous pouvez toujours supprimer cette @qq{clef de
 142 précaution} en affectant la valeur @code{end-of-line-invisible} à la
 143 propriété @code{explicitClefVisibility} du contexte @code{Staff}.  Le
 144 comportement par défaut sera réactivé par
 145 @w{@code{\\unset@tie{}Staff.explicitClefVisibility}}.
 146
 147
 148 Les exemples qui suivent illustrent les différentes possibilités de
 149 définir ces propriétés manuellement.  Sur la première ligne, la
 150 position relative des notes par rapport aux clefs est préservée, ce
 151 qui n'est pas le cas pour la deuxième ligne.
 152
 153 "
 154   doctitlefr = "Affinage des propriétés d'une clef"
 155
 156   texidoc = "
 157 The command @code{\\clef \"treble_8\"} is equivalent to setting
 158 @code{clefGlyph}, @code{clefPosition} (which controls the vertical
 159 position of the clef), @code{middleCPosition} and
 160 @code{clefOctavation}. A clef is printed when any of the properties
 161 except @code{middleCPosition} are changed.
 162
 163
 164 Note that changing the glyph, the position of the clef, or the
 165 octavation does not in itself change the position of subsequent notes
 166 on the staff: the position of middle C must also be specified to do
 167 this. The positional parameters are relative to the staff center line,
 168 positive numbers displacing upwards, counting one for each line and
 169 space. The @code{clefOctavation} value would normally be set to 7, -7,
 170 15 or -15, but other values are valid.
 171
 172
 173 When a clef change takes place at a line break the new clef symbol is
 174 printed at both the end of the previous line and the beginning of the
 175 new line by default. If the warning clef at the end of the previous
 176 line is not required it can be suppressed by setting the @code{Staff}
 177 property @code{explicitClefVisibility} to the value
 178 @code{end-of-line-invisible}. The default behavior can be recovered
 179 with  @code{\\unset Staff.explicitClefVisibility}.
 180
 181 The following examples show the possibilities when setting these
 182 properties manually. On the first line, the manual changes preserve the
 183 standard relative positioning of clefs and notes, whereas on the second
 184 line, they do not.
 185
 186 "
 187   doctitle = "Tweaking clef properties"
 188 } % begin verbatim
 189
 190 \layout { ragged-right = ##t }
 191
 192 {
 193   % The default treble clef
 194   c'1
 195   % The standard bass clef
 196   \set Staff.clefGlyph = #"clefs.F"
 197   \set Staff.clefPosition = #2
 198   \set Staff.middleCPosition = #6
 199   c'1
 200   % The baritone clef
 201   \set Staff.clefGlyph = #"clefs.C"
 202   \set Staff.clefPosition = #4
 203   \set Staff.middleCPosition = #4
 204   c'1
 205   % The standard choral tenor clef
 206   \set Staff.clefGlyph = #"clefs.G"
 207   \set Staff.clefPosition = #-2
 208   \set Staff.clefOctavation = #-7
 209   \set Staff.middleCPosition = #1
 210   c'1
 211   % A non-standard clef
 212   \set Staff.clefPosition = #0
 213   \set Staff.clefOctavation = #0
 214   \set Staff.middleCPosition = #-4
 215   c'1 \break
 216
 217   % The following clef changes do not preserve
 218   % the normal relationship between notes and clefs:
 219
 220   \set Staff.clefGlyph = #"clefs.F"
 221   \set Staff.clefPosition = #2
 222   c'1
 223   \set Staff.clefGlyph = #"clefs.G"
 224   c'1
 225   \set Staff.clefGlyph = #"clefs.C"
 226   c'1
 227   \set Staff.clefOctavation = #7
 228   c'1
 229   \set Staff.clefOctavation = #0
 230   \set Staff.clefPosition = #0
 231   c'1
 232
 233   % Return to the normal clef:
 234
 235   \set Staff.middleCPosition = #0
 236   c'1
 237 }
 238