5.3.3 La instrucción \override

Existe un tipo especial de propiedad de contexto: la descripción de los grobs. Las decscripciones de los grobs reciben un nombre en MayúsculasDeCamello (empezando en mayúscula). Contienen los ‘ajustes predeterminados’ para un tipo particular de grob, en forma de lista asociativa. Consulte scm/define-grobs.scm para ver los ajustes de cada descripción de grob. Las descripciones de grob se modifican con \override.

La sintaxis de la instrucción \override es

\override [contexto.]NombreDelGrob.propiedad = #valor

Por ejemplo, podemos aumentar el grosor de la plica de una figura sobreescribiendo la propiedad thickness (grosor) del objeto Stem (plica):

c''4 c''
\override Voice.Stem.thickness = #3.0
c''4 c''

Si no se ha especificado ningún contexto en la instrucción \override, se utiliza el contexto del nivel inferior:

\override Staff.Stem.thickness = #3.0
<<
  \relative {
    e''4 e
    \override Stem.thickness = #0.5
    e4 e
  } \\
  \relative {
    c''4 c c c
  }
>>

Algunas opciones susceptibles de trucaje, se llaman ‘subpropiedades’ y residen dentro de las propiedades. Para efectura trujajes sobre ellas, utilice instrucciones de la forma

\override Stem.details.beamed-lengths = #'(4 4 3)

o para modificar los extremos de los objetos extensos, utilice una forma como las siguientes:

\override TextSpanner.bound-details.left.text = "left text"
\override TextSpanner.bound-details.right.text = "right text"

El efecto de una instrucción de sobreescritura \override se puede deshacer con \revert.

La sintaxis de la instrucción \revert es

\revert [Contexto.]NombreDelGrob.propiedad

Por ejemplo,

\relative {
  c''4
  \override Voice.Stem.thickness = #3.0
  c4 c
  \revert Voice.Stem.thickness
  c4
}

Los efectos de \override y \revert se aplican a todos los grobs del contexto afectado partiendo del momento actual y hacia adelante:

<<
  \relative {
    e''4
    \override Staff.Stem.thickness = #3.0
    e4 e e
  } \\
  \relative {
    c''4 c c
    \revert Staff.Stem.thickness
    c4
  }
>>

Se puede usar \once con \override o \revert para afectar solamente al instante de tiempo actual:

<<
  \relative c {
    \override Stem.thickness = #3.0
    e''4 e e e
  } \\
  \relative {
    c''4
    \once \override Stem.thickness = #3.0
    c4 c c
  }
>>

Véase también

Referencia de funcionamiento interno: Backend