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