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   lsrtags = "pitches, staff-notation, tweaks-and-overrides"
  11
  12 %% Translation of GIT committish: 59caa3adce63114ca7972d18f95d4aadc528ec3d
  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: 0a868be38a775ecb1ef935b079000cebbc64de40
  49   doctitlede = "Eigenschaften des Schlüssels optimieren"
  50   texidocde = "
  51 Der Befehl @code{\\clef \"treble_8\"} ist gleichbedeutend mit einem
  52 expliziten Setzen der Eigenschaften von @code{clefGlyph},
  53 @code{clefPosition} (welche die vertikale Position des Schlüssels bestimmt),
  54 @code{middleCPosition} und @code{clefOctavation}.  Ein Schlüssel wird
  55 ausgegeben, wenn eine der Eigenschaften außer @code{middleCPosition} sich
  56 ändert.
  57
  58 Eine Änderung des Schriftzeichens (Glyph), der Schlüsselposition oder der
  59 Oktavierung selber ändert noch nicht die Position der darauf folgenden Noten
  60 auf dem System: das geschieht nur, wenn auch die Position des
  61 eingestrichenen@tie{}C (middleCPosition) angegeben wird.  Die
  62 Positionsparameter sind relativ zur Mittellinie des Systems, dabei versetzen
  63 positive Zahlen die Position nach oben, jeweils eine Zahl für jede Linie
  64 plus Zwischenraum.  Der @code{clefOctavation}-Wert ist normalerweise auf 7,
  65 -7, 15 oder -15 gesetzt, aber auch andere Werte sind gültig.
  66
  67 Wenn ein Schlüsselwechsel an einem Zeilenwechsel geschieht, wird das neue
  68 Symbol sowohl am Ende der alten Zeilen als auch am Anfang der neuen Zeile
  69 ausgegeben.  Wenn der Warnungs-Schlüssel am Ende der alten Zeile nicht
  70 erforderlich ist, kann er unterdrückt werden, indem die
  71 @code{explicitClefVisibility}-Eigenschaft des @code{Staff}-Kontextes auf den
  72 Wert @code{end-of-line-invisible} gesetzt wird.  Das Standardverhalten kann
  73 mit @code{\\unset Staff.explicitClefVisibility} wieder hergestellt werden.
  74
  75 Die folgenden Beispiele zeigen die Möglichkeiten, wenn man diese
  76 Eigenschaften manuell setzt.  Auf der ersten Zeile erhalten die manuellen
  77 Änderungen die ursprüngliche relative Positionierung von Schlüssel und
  78 Noten, auf der zweiten Zeile nicht.
  79 "
  80
  81 %% Translation of GIT committish: 4ab2514496ac3d88a9f3121a76f890c97cedcf4e
  82   texidocfr = "
  83 La commande @code{\\clef \"treble_8\"} équivaut à définir @code{clefGlyph},
  84 @code{clefPosition} -- qui contrôle la position verticale de la clé --
  85 @code{middleCPosition} et @code{clefOctavation}.  Une clé est imprimée
  86 lorsque l'une de ces propriétés, hormis @code{middleCPosition}, est
  87 modifiée.  Les exemples suivant font apparaître des possibilités de
  88 réglage manuel de ces propriétés.
  89
  90
  91 Modifier le glyphe, la position de la clef ou son octaviation ne
  92 changera pas la position des notes ; il faut pour y parvenir modifier
  93 aussi la position du do médium.  Le positionnement est relatif à la
  94 ligne médiane, un nombre positif faisant monter, chaque ligne ou
  95 interligne comptant pour 1.  La valeur de @code{clefOctavation} devrait
  96 être de 7, -7, 15 ou -15, bien que rien ne vous empêche de lui affecter
  97 une autre valeur.
  98
  99
 100 Lorsqu'un changement de clef intervient en même temps qu'un saut de
 101 ligne, la nouvelle clef est imprimer à la fois en fin de ligne et au
 102 début de la suivante.  Vous pouvez toujours supprimer cette « clef de
 103 précaution » en affectant la valeur @code{end-of-line-invisible} à la
 104 propriété @code{explicitClefVisibility} du contexte @code{Staff}.  Le
 105 comportement par défaut sera réactivé par
 106 @w{@code{\\unset@tie{}Staff.explicitClefVisibility}}.
 107
 108
 109 Les exemples qui suivent illustrent les différentes possibilités de
 110 définir ces propriétés manuellement.  Sur la première ligne, la
 111 position relative des notes par rapport aux clefs sont préservées, ce
 112 qui n'est pas le cas pour la deuxième ligne.
 113
 114 "
 115   doctitlefr = "Affinage des propriétés d'une clef"
 116
 117   texidoc = "
 118 The command @code{\\clef \"treble_8\"} is equivalent to setting
 119 @code{clefGlyph}, @code{clefPosition} (which controls the vertical
 120 position of the clef), @code{middleCPosition} and
 121 @code{clefOctavation}. A clef is printed when any of the properties
 122 except @code{middleCPosition} are changed.
 123
 124
 125 Note that changing the glyph, the position of the clef, or the
 126 octavation does not in itself change the position of subsequent notes
 127 on the staff: the position of middle C must also be specified to do
 128 this. The positional parameters are relative to the staff center line,
 129 positive numbers displacing upwards, counting one for each line and
 130 space. The @code{clefOctavation} value would normally be set to 7, -7,
 131 15 or -15, but other values are valid.
 132
 133
 134 When a clef change takes place at a line break the new clef symbol is
 135 printed at both the end of the previous line and the beginning of the
 136 new line by default. If the warning clef at the end of the previous
 137 line is not required it can be suppressed by setting the @code{Staff}
 138 property @code{explicitClefVisibility} to the value
 139 @code{end-of-line-invisible}. The default behavior can be recovered
 140 with  @code{\\unset Staff.explicitClefVisibility}.
 141
 142 The following examples show the possibilities when setting these
 143 properties manually. On the first line, the manual changes preserve the
 144 standard relative positioning of clefs and notes, whereas on the second
 145 line, they do not.
 146
 147 "
 148   doctitle = "Tweaking clef properties"
 149 } % begin verbatim
 150
 151 \layout { ragged-right = ##t }
 152
 153 {
 154   % The default treble clef
 155   c'1
 156   % The standard bass clef
 157   \set Staff.clefGlyph = #"clefs.F"
 158   \set Staff.clefPosition = #2
 159   \set Staff.middleCPosition = #6
 160   c'1
 161   % The baritone clef
 162   \set Staff.clefGlyph = #"clefs.C"
 163   \set Staff.clefPosition = #4
 164   \set Staff.middleCPosition = #4
 165   c'1
 166   % The standard choral tenor clef
 167   \set Staff.clefGlyph = #"clefs.G"
 168   \set Staff.clefPosition = #-2
 169   \set Staff.clefOctavation = #-7
 170   \set Staff.middleCPosition = #1
 171   c'1
 172   % A non-standard clef
 173   \set Staff.clefPosition = #0
 174   \set Staff.clefOctavation = #0
 175   \set Staff.middleCPosition = #-4
 176   c'1 \break
 177
 178   % The following clef changes do not preserve
 179   % the normal relationship between notes and clefs:
 180
 181   \set Staff.clefGlyph = #"clefs.F"
 182   \set Staff.clefPosition = #2
 183   c'1
 184   \set Staff.clefGlyph = #"clefs.G"
 185   c'1
 186   \set Staff.clefGlyph = #"clefs.C"
 187   c'1
 188   \set Staff.clefOctavation = #7
 189   c'1
 190   \set Staff.clefOctavation = #0
 191   \set Staff.clefPosition = #0
 192   c'1
 193
 194   % Return to the normal clef:
 195
 196   \set Staff.middleCPosition = #0
 197   c'1
 198 }
 199