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.46"
   4
   5 \header {
   6   lsrtags = "pitches, staff-notation, tweaks-and-overrides"
   7
   8 texidoces = "
   9 La instrucción @code{\clef \"treble_8\"} equivale a un ajuste de
  10 @code{clefGlyph}, @code{clefPosition} (que controla la posición
  11 vertical de la clave), @code{middleCPosition} y
  12 @code{clefOctavation}. Se imprime una clave cada vez que se
  13 modifica cualquiera de las propiedades excepto
  14 @code{middleCPosition}.
  15
  16
  17 Observe que la modificación del glifo, la posición de la clave o
  18 su octavación, no cambian 'per se' la posición de las siguientes
  19 notas del pentagrama: para hacer esto también se debe especificar
  20 la posición del Do central. Los parámetros posicionales están en
  21 relación con la tercera línea del pentagrama, los números
  22 positivos desplazan hacia arriba, contando una unidad por cada
  23 línea y espacio. El valor de @code{clefOctavation} se
  24 establecería normalmente a 7, -7, 15 or -15, pero son válidos
  25 otros valores.
  26
  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   texidoc = "
  43 The command @code{\\clef \"treble_8\"} is equivalent to setting
  44 @code{clefGlyph}, @code{clefPosition} (which controls the vertical
  45 position of the clef), @code{middleCPosition} and
  46 @code{clefOctavation}. A clef is printed when any of the properties
  47 except @code{middleCPosition} are changed.
  48
  49
  50 Note that changing the glyph, the position of the clef, or the
  51 octavation does not in itself change the position of subsequent notes
  52 on the staff: the position of middle C must also be specified to do
  53 this. The positional parameters are relative to the staff center line,
  54 positive numbers displacing upwards, counting one for each line and
  55 space. The @code{clefOctavation} value would normally be set to 7, -7,
  56 15 or -15, but other values are valid.
  57
  58
  59 When a clef change takes place at a line break the new clef symbol is
  60 printed at both the end of the previous line and the beginning of the
  61 new line by default. If the warning clef at the end of the previous
  62 line is not required it can be suppressed by setting the @code{Staff}
  63 property @code{explicitClefVisibility} to the value
  64 @code{end-of-line-invisible}. The default behavior can be recovered
  65 with  @code{\\unset Staff.explicitClefVisibility}.
  66
  67 The following examples show the possibilities when setting these
  68 properties manually. On the first line, the manual changes preserve the
  69 standard relative positioning of clefs and notes, whereas on the second
  70 line, they do not.
  71
  72 "
  73   doctitle = "Tweaking clef properties"
  74 } % begin verbatim
  75 {
  76   % The default treble clef
  77   c'1
  78   % The standard bass clef
  79   \set Staff.clefGlyph = #"clefs.F"
  80   \set Staff.clefPosition = #2
  81   \set Staff.middleCPosition = #6
  82   c'1
  83   % The baritone clef
  84   \set Staff.clefGlyph = #"clefs.C"
  85   \set Staff.clefPosition = #4
  86   \set Staff.middleCPosition = #4
  87   c'1
  88   % The standard choral tenor clef
  89   \set Staff.clefGlyph = #"clefs.G"
  90   \set Staff.clefPosition = #-2
  91   \set Staff.clefOctavation = #-7
  92   \set Staff.middleCPosition = #1
  93   c'1
  94   % A non-standard clef
  95   \set Staff.clefPosition = #0
  96   \set Staff.clefOctavation = #0
  97   \set Staff.middleCPosition = #-4
  98   c'1 \break
  99
 100   % The following clef changes do not preserve
 101   % the normal relationship between notes and clefs:
 102
 103   \set Staff.clefGlyph = #"clefs.F"
 104   \set Staff.clefPosition = #2
 105   c'1
 106   \set Staff.clefGlyph = #"clefs.G"
 107   c'1
 108   \set Staff.clefGlyph = #"clefs.C"
 109   c'1
 110   \set Staff.clefOctavation = #7
 111   c'1
 112   \set Staff.clefOctavation = #0
 113   \set Staff.clefPosition = #0
 114   c'1
 115
 116   % Here we go back to the normal clef:
 117
 118   \set Staff.middleCPosition = #0
 119   c'1
 120 }