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   texidoc = "
  45 The command @code{\\clef \"treble_8\"} is equivalent to setting
  46 @code{clefGlyph}, @code{clefPosition} (which controls the vertical
  47 position of the clef), @code{middleCPosition} and
  48 @code{clefOctavation}. A clef is printed when any of the properties
  49 except @code{middleCPosition} are changed.
  50
  51
  52 Note that changing the glyph, the position of the clef, or the
  53 octavation does not in itself change the position of subsequent notes
  54 on the staff: the position of middle C must also be specified to do
  55 this. The positional parameters are relative to the staff center line,
  56 positive numbers displacing upwards, counting one for each line and
  57 space. The @code{clefOctavation} value would normally be set to 7, -7,
  58 15 or -15, but other values are valid.
  59
  60
  61 When a clef change takes place at a line break the new clef symbol is
  62 printed at both the end of the previous line and the beginning of the
  63 new line by default. If the warning clef at the end of the previous
  64 line is not required it can be suppressed by setting the @code{Staff}
  65 property @code{explicitClefVisibility} to the value
  66 @code{end-of-line-invisible}. The default behavior can be recovered
  67 with  @code{\\unset Staff.explicitClefVisibility}.
  68
  69 The following examples show the possibilities when setting these
  70 properties manually. On the first line, the manual changes preserve the
  71 standard relative positioning of clefs and notes, whereas on the second
  72 line, they do not.
  73
  74 "
  75   doctitle = "Tweaking clef properties"
  76 } % begin verbatim
  77 {
  78   % The default treble clef
  79   c'1
  80   % The standard bass clef
  81   \set Staff.clefGlyph = #"clefs.F"
  82   \set Staff.clefPosition = #2
  83   \set Staff.middleCPosition = #6
  84   c'1
  85   % The baritone clef
  86   \set Staff.clefGlyph = #"clefs.C"
  87   \set Staff.clefPosition = #4
  88   \set Staff.middleCPosition = #4
  89   c'1
  90   % The standard choral tenor clef
  91   \set Staff.clefGlyph = #"clefs.G"
  92   \set Staff.clefPosition = #-2
  93   \set Staff.clefOctavation = #-7
  94   \set Staff.middleCPosition = #1
  95   c'1
  96   % A non-standard clef
  97   \set Staff.clefPosition = #0
  98   \set Staff.clefOctavation = #0
  99   \set Staff.middleCPosition = #-4
 100   c'1 \break
 101
 102   % The following clef changes do not preserve
 103   % the normal relationship between notes and clefs:
 104
 105   \set Staff.clefGlyph = #"clefs.F"
 106   \set Staff.clefPosition = #2
 107   c'1
 108   \set Staff.clefGlyph = #"clefs.G"
 109   c'1
 110   \set Staff.clefGlyph = #"clefs.C"
 111   c'1
 112   \set Staff.clefOctavation = #7
 113   c'1
 114   \set Staff.clefOctavation = #0
 115   \set Staff.clefPosition = #0
 116   c'1
 117
 118   % Here we go back to the normal clef:
 119
 120   \set Staff.middleCPosition = #0
 121   c'1
 122 }