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