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