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