Documentation/snippets/tweaking-clef-properties.ly

   1 %% Do not edit this file; it is auto-generated from LSR http://lsr.dsi.unimi.it
   2 %% This file is in the public domain.
   3 \version "2.13.1"
   4
   5 \header {
   6   lsrtags = "pitches, staff-notation, tweaks-and-overrides"
   7
   8 %% Translation of GIT committish: 4866dfd58d5c3a8cab4c6c06d5c4fca8e05a3cd7
   9   doctitlees = "Trucaje de las propiedades de clave"
  10   texidoces = "
  11 La instrucción @code{\\clef \"treble_8\"} equivale a un ajuste de
  12 @code{clefGlyph}, @code{clefPosition} (que controla la posición
  13 vertical de la clave), @code{middleCPosition} y
  14 @code{clefOctavation}.  Se imprime una clave cada vez que se
  15 modifica cualquiera de las propiedades excepto
  16 @code{middleCPosition}.
  17
  18 Observe que la modificación del glifo, la posición de la clave o
  19 su octavación, no cambian 'per se' la posición de las siguientes
  20 notas del pentagrama: para hacer esto también se debe especificar
  21 la posición del Do central.  Los parámetros posicionales están en
  22 relación con la tercera línea del pentagrama, los números
  23 positivos desplazan hacia arriba, contando una unidad por cada
  24 línea y espacio.  El valor de @code{clefOctavation} se
  25 establecería normalmente a 7, -7, 15 or -15, pero son válidos
  26 otros valores.
  27
  28 Cuando se produce un cambio de clave en el salto de línea se
  29 imprime la clave nueva tanto al final de la línea anterior como al
  30 principio de la nueva, de forma predeterminada.  Si no se necesita
  31 la clave de advertencia al final de la línea anterior, se puede
  32 quitar estableciendo el valor de la propiedad
  33 @code{explicitClefVisibility} de @code{Staff}, a
  34 @code{end-of-line-invisible}.  El comportamiento predeterminado se
  35 puede recuperar con @code{\\unset Staff.explicitClefVisibility}.
  36
  37 Los siguientes ejemplos muestran las posibilidades cuando se
  38 ajustan estas propiedades manualmente.  En la primera línea, los
  39 cambios manuales preservan el posicionamiento relativo estándar de
  40 las claves y las notas, pero no lo hacen en la segunda línea.
  41 "
  42
  43 %% Translation of GIT committish: 2f4e16a76afee992a5f8d11e119667efe7238e7d
  44   doctitlede = "Eigenschaften des Schlüssels optimieren"
  45   texidocde = "
  46 Der Befehl @code{\\clef \"treble_8\"} ist gleichbedeutend mit einem
  47 expliziten Setzen der Eigenschaften von @code{clefGlyph},
  48 @code{clefPosition} (welche die vertikale Position des Schlüssels bestimmt),
  49 @code{middleCPosition} und @code{clefOctavation}.  Ein Schlüssel wird
  50 ausgegeben, wenn eine der Eigenschaften außer @code{middleCPosition} sich
  51 ändert.
  52
  53 Eine Änderung des Schriftzeichens (Glyph), der Schlüsselposition oder der
  54 Oktavierung selber ändert noch nicht die Position der darauf folgenden Noten
  55 auf dem System: das geschieht nur, wenn auch die Position des
  56 eingestrichenen@tie{}C (middleCPosition) angegeben wird.  Die
  57 Positionsparameter sind relativ zur Mittellinie des Systems, dabei versetzen
  58 positive Zahlen die Position nach oben, jeweils eine Zahl für jede Linie
  59 plus Zwischenraum.  Der @code{clefOctavation}-Wert ist normalerweise auf 7,
  60 -7, 15 oder -15 gesetzt, aber auch andere Werte sind gültig.
  61
  62 Wenn ein Schlüsselwechsel an einem Zeilenwechsel geschieht, wird das neue
  63 Symbol sowohl am Ende der alten Zeilen als auch am Anfang der neuen Zeile
  64 ausgegeben.  Wenn der Warnungs-Schlüssel am Ende der alten Zeile nicht
  65 erforderlich ist, kann er unterdrückt werden, indem die
  66 @code{explicitClefVisibility}-Eigenschaft des @code{Staff}-Kontextes auf den
  67 Wert @code{end-of-line-invisible} gesetzt wird.  Das Standardverhalten kann
  68 mit @code{\\unset Staff.explicitClefVisibility} wieder hergestellt werden.
  69
  70 Die folgenden Beispiele zeigen die Möglichkeiten, wenn man diese
  71 Eigenschaften manuell setzt.  Auf der ersten Zeile erhalten die manuellen
  72 Änderungen die ursprüngliche relative Positionierung von Schlüssel und
  73 Noten, auf der zweiten Zeile nicht.
  74 "
  75
  76   texidoc = "
  77 The command @code{\\clef \"treble_8\"} is equivalent to setting
  78 @code{clefGlyph}, @code{clefPosition} (which controls the vertical
  79 position of the clef), @code{middleCPosition} and
  80 @code{clefOctavation}. A clef is printed when any of the properties
  81 except @code{middleCPosition} are changed.
  82
  83
  84 Note that changing the glyph, the position of the clef, or the
  85 octavation does not in itself change the position of subsequent notes
  86 on the staff: the position of middle C must also be specified to do
  87 this. The positional parameters are relative to the staff center line,
  88 positive numbers displacing upwards, counting one for each line and
  89 space. The @code{clefOctavation} value would normally be set to 7, -7,
  90 15 or -15, but other values are valid.
  91
  92
  93 When a clef change takes place at a line break the new clef symbol is
  94 printed at both the end of the previous line and the beginning of the
  95 new line by default. If the warning clef at the end of the previous
  96 line is not required it can be suppressed by setting the @code{Staff}
  97 property @code{explicitClefVisibility} to the value
  98 @code{end-of-line-invisible}. The default behavior can be recovered
  99 with  @code{\\unset Staff.explicitClefVisibility}.
 100
 101 The following examples show the possibilities when setting these
 102 properties manually. On the first line, the manual changes preserve the
 103 standard relative positioning of clefs and notes, whereas on the second
 104 line, they do not.
 105
 106 "
 107   doctitle = "Tweaking clef properties"
 108 } % begin verbatim
 109
 110 \layout { ragged-right = ##t }
 111
 112 {
 113   % The default treble clef
 114   c'1
 115   % The standard bass clef
 116   \set Staff.clefGlyph = #"clefs.F"
 117   \set Staff.clefPosition = #2
 118   \set Staff.middleCPosition = #6
 119   c'1
 120   % The baritone clef
 121   \set Staff.clefGlyph = #"clefs.C"
 122   \set Staff.clefPosition = #4
 123   \set Staff.middleCPosition = #4
 124   c'1
 125   % The standard choral tenor clef
 126   \set Staff.clefGlyph = #"clefs.G"
 127   \set Staff.clefPosition = #-2
 128   \set Staff.clefOctavation = #-7
 129   \set Staff.middleCPosition = #1
 130   c'1
 131   % A non-standard clef
 132   \set Staff.clefPosition = #0
 133   \set Staff.clefOctavation = #0
 134   \set Staff.middleCPosition = #-4
 135   c'1 \break
 136
 137   % The following clef changes do not preserve
 138   % the normal relationship between notes and clefs:
 139
 140   \set Staff.clefGlyph = #"clefs.F"
 141   \set Staff.clefPosition = #2
 142   c'1
 143   \set Staff.clefGlyph = #"clefs.G"
 144   c'1
 145   \set Staff.clefGlyph = #"clefs.C"
 146   c'1
 147   \set Staff.clefOctavation = #7
 148   c'1
 149   \set Staff.clefOctavation = #0
 150   \set Staff.clefPosition = #0
 151   c'1
 152
 153   % Return to the normal clef:
 154
 155   \set Staff.middleCPosition = #0
 156   c'1
 157 }
 158