@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@ignore
- Translation of GIT committish: 7fdce4f39834cc8c83f176480cc1d20900eb09f8
+ Translation of GIT committish: 5ae5c88bdb1a478263ed874cb823ec58dafc93f9
When revising a translation, copy the HEAD committish of the
version that you are working on. For details, see the Contributors'
@chapter Trucar la salida
@translationof Tweaking output
-Este capítulo trata de cómo modificar la salida. LilyPond es extremadamente
-configurable; prácticamente todos los fragmentos de la salida se pueden cambiar.
+Este capítulo trata de cómo modificar la salida. LilyPond es
+extremadamente configurable; prácticamente todos los fragmentos de
+la salida se pueden cambiar.
@menu
El @q{Trucaje} es un término de LilyPond que denota los diversos
métodos que el usuario tiene a su disposición para modificar el
proceso de interpretación del archivo de entrada y cambiar la
-apariencia de la salida impresa. Algunos trucos son muy fáciles de
-usar; otros son más complejos. Pero en su conjunto, los métodos de
-trucaje disponibles posibilitan conseguir casi cualquier apariencia
-que deseemos en la música impresa.
+apariencia de la salida impresa. Algunos trucos son muy fáciles
+de usar; otros son más complejos. Pero en su conjunto, los
+métodos de trucaje disponibles posibilitan conseguir casi
+cualquier apariencia que deseemos en la música impresa.
En esta sección vamos a estudiar los conceptos básicos que se
necesitan para comprender el trucaje. Más tarde daremos un amplio
abanico de instrucciones listas para usar, que podrá simplemente
copiar para obtener el mismo efecto en sus partituras, y al mismo
-tiempo mostraremos la forma de construir dichas instrucciones para que
-pueda aprender cómo desarrollar sus propios trucos.
+tiempo mostraremos la forma de construir dichas instrucciones para
+que pueda aprender cómo desarrollar sus propios trucos.
-Antes de comenzar con este capítulo, quizá quiera echar un vistazo a
-la sección @ref{Contextos y grabadores}, pues los Contextos, los
+Antes de comenzar con este capítulo, quizá quiera echar un vistazo
+a la sección @ref{Contextos y grabadores}, pues los Contextos, los
Grabadores y las Propiedades que se contienen en ellos son
fundamentales para comprender y construir los trucos.
introduciremos algunos términos que se usan para describir dichas
operaciones y estructuras internas.
-El término @q{Objeto} es un término genérico que se usa para referirse
-a la multitud de estructuras internas que LilyPond construye durante
-el procesado de un archivo de entrada. Así, cuando se encuentra una
-instrucción como @code{\new Staff}, se construye un objeto nuevo del
-tipo @code{Staff}. Entonces, este objeto @code{Staff} contiene todas
-las propiedades asociadas con ese pentagrama en particular, por
-ejemplo, su nombre y su armadura, además de otros detalles de los
-grabadores que se han asignado para que operen dentro del contexto del
-pentagrama. De forma similar, hay objetos que guardan las propiedades
-de todos los demás contextos, como objetos de @code{Voice}, objetos de
+El término @q{Objeto} es un término genérico que se usa para
+referirse a la multitud de estructuras internas que LilyPond
+construye durante el procesado de un archivo de entrada. Así,
+cuando se encuentra una instrucción como @code{\new Staff}, se
+construye un objeto nuevo del tipo @code{Staff}. Entonces, este
+objeto @code{Staff} contiene todas las propiedades asociadas con
+ese pentagrama en particular, por ejemplo, su nombre y su
+armadura, además de otros detalles de los grabadores que se han
+asignado para que operen dentro del contexto del pentagrama. De
+forma similar, hay objetos que guardan las propiedades de todos
+los demás contextos, como objetos de @code{Voice}, objetos de
@code{Score}, objetos de @code{Lyrics}, así como objetos que
-representan todos los elementos notacionales como líneas divisorias,
-cabezas de las notas, ligaduras, indicaciones dinámicas, etc. Cada
-objeto tiene su propio conjunto de valores de propiedad.
-
-Ciertos tipos de objetos reciben nombres especiales. Los objetos que
-representan elementos de notación sobre la salida impresa como cabezas
-de notas, plicas, ligaduras de expresión y de unión, digitaciones,
-claves, etc. reciben el nombre de @q{Objetos de presentación}, a
-menudo conocidos como @q{Objetos gráficos}, o abreviadamente
-@q{Grobs}. Aún son objetos en el sentido genérico que hemos
-mencionado, y también todos ellos tienen propiedades asociadas, como
-su posición, tamaño, color,etc.
+representan todos los elementos notacionales como líneas
+divisorias, cabezas de las notas, ligaduras, indicaciones
+dinámicas, etc. Cada objeto tiene su propio conjunto de valores
+de propiedad.
+
+Ciertos tipos de objetos reciben nombres especiales. Los objetos
+que representan elementos de notación sobre la salida impresa como
+cabezas de notas, plicas, ligaduras de expresión y de unión,
+digitaciones, claves, etc. reciben el nombre de @q{Objetos de
+presentación}, a menudo conocidos como @q{Objetos gráficos}, o
+abreviadamente @q{Grobs}. Aún son objetos en el sentido genérico
+que hemos mencionado, y también todos ellos tienen propiedades
+asociadas, como su posición, tamaño, color,etc.
Ciertos objetos de presentación son aún más especializados. Las
-ligaduras de fraseo, los reguladores, las indicaciones de octava alta
-y baja, y muchos otros objetos gráficos no están situados en un solo
-lugar: tienen un punto de inicio, un punto de final, y quizá otras
-propiedades relacionadas con su forma. Los objetos con una forma
-extendida como estos, reciben el nombre de «Objetos de extensión» o
-@q{Spanners}.
-
-Spanners cannot be tweaked after their creation. This includes both
-@code{StaffSymbol} and @code{LedgerLineSpanner} which continue
-throughout the score (except if they are terminated by the
-@code{\stopStaff} command and then recreated using @code{\startStaff}
-command.
-
-What is more, there are @q{abstract} grobs which do not print
-anything of their own, but rather collect, position and manage
-other grobs. Common examples for this are
+ligaduras de fraseo, los reguladores, las indicaciones de octava
+alta y baja, y muchos otros objetos gráficos no están situados en
+un solo lugar: tienen un punto de inicio, un punto de final, y
+quizá otras propiedades relacionadas con su forma. Los objetos
+con una forma extendida como estos, reciben el nombre de «Objetos
+de extensión» o @q{Spanners}.
+
+Los «spanners» no se pueden trucar después de haberse creado.
+Ello incluye tanto a @code{StaffSymbol} como a
+@code{LedgerLineSpanner}, que continúan a lo largo de toda la
+partitura (excepto si se les da fin con la instrucción
+@code{\stopStaff} y se vuelven a crear con la instrucción
+@code{\startStaff}.
+
+Es más, existen objetos gráficos @q{abstractos} que no impriman
+nada por sí mismos, sino que más bien recopilan, posicionan y
+gestionan a otros objetos gráficos. Los ejemplos usuales son
@code{DynamicLineSpanner}, @code{BreakAlignment},
@code{NoteColumn}, @code{VerticalAxisGroup},
-@code{NonMusicalPaperColumn} and similar. We will see how some of
-these are used later.
-
-Aún falta por explicar qué son los @q{Interfaces}. Muchos objetos,
-incluso aunque son bastante diferentes, comparten funcionalidades que
-se deben procesar de la misma manera. Por ejemplo, todos los objetos
-gráficos tienen un color, un tamaño, una posición, etc., y todas estas
-propiedades se procesan de la misma forma durante la interpretación
-del archivo de entrada por parte de LilyPond. Para simplificar estas
-operaciones internas, estas acciones y propiedades comunes se agrupan
-en un objeto llamado @code{grob-interface}, interface de grob. Hay
-muchas otras agrupaciones de propiedades comunes como ésta, y cada
-una recibe un nombre que acaba en @code{interface}. En total hay más
-de 100 interfaces de éstos. Veremos más adelante porqué esto es del
-interés y de utilidad para el usuario.
-
-Estos son, en fin, los términos principales relativos a los objetos
-que vamos a utilizar en este capítulo.
+@code{NonMusicalPaperColumn} y similares. Más tarde veremos cómo
+se usan algunos de ellos.
+
+Aún falta por explicar qué son los @q{Interfaces}. Muchos
+objetos, incluso aunque son bastante diferentes, comparten
+funcionalidades que se deben procesar de la misma manera. Por
+ejemplo, todos los objetos gráficos tienen un color, un tamaño,
+una posición, etc., y todas estas propiedades se procesan de la
+misma forma durante la interpretación del archivo de entrada por
+parte de LilyPond. Para simplificar estas operaciones internas,
+estas acciones y propiedades comunes se agrupan en un objeto
+llamado @code{grob-interface}, interface de grob. Hay muchas
+otras agrupaciones de propiedades comunes como ésta, y cada una
+recibe un nombre que acaba en @code{interface}. En total hay más
+de 100 interfaces de éstos. Veremos más adelante porqué esto es
+del interés y de utilidad para el usuario.
+
+Estos son, en fin, los términos principales relativos a los
+objetos que vamos a utilizar en este capítulo.
@node Convenciones de nombres de objetos y propiedades
@subsection Convenciones de nombres de objetos y propiedades
a partir de sus nombres.
@seealso
-Notation Reference:
-@ruser{Modifying properties}.
+Referencia de la notación:
+@ruser{Modificar las propiedades}.
@node Métodos de trucaje
@funindex \override
@funindex override
-Ya hemos visto las instrucciones @code{\set} y @code{\with}, que se
-usan para cambiar las propiedades de los @strong{contextos} y para
-quitar y poner @strong{grabadores}, en @ref{Modificar las propiedades de los contextos}
-y @ref{Añadir y eliminar grabadores}. Ahora debemos
-examinar algunas otras instrucciones importantes.
-
-La instrucción que cambia las propiedades de los @strong{objetos de
-presentación} es @code{\override}. Puesto que esta instrucción debe
-modificar propiedades internas que se encuentran en un lugar profundo
-dentro de LilyPond, su sintaxis no es tan simple como la del resto de
-las instrucciones que hemos usado hasta ahora. Tiene que saber
-exactamente qué propiedad de qué objeto y en qué contexto se debe
-modificar, y cuál debe ser su nuevo valor. Veamos cómo se hace.
+Ya hemos visto las instrucciones @code{\set} y @code{\with}, que
+se usan para cambiar las propiedades de los @strong{contextos} y
+para quitar y poner @strong{grabadores}, en
+@ref{Modificar las propiedades de los contextos} y
+@ref{Añadir y eliminar grabadores}. Ahora debemos examinar
+algunas otras instrucciones importantes.
+
+La instrucción que cambia las propiedades de los @strong{objetos
+de presentación} es @code{\override}. Puesto que esta instrucción
+debe modificar propiedades internas que se encuentran en un lugar
+profundo dentro de LilyPond, su sintaxis no es tan simple como la
+del resto de las instrucciones que hemos usado hasta ahora. Tiene
+que saber exactamente qué propiedad de qué objeto y en qué
+contexto se debe modificar, y cuál debe ser su nuevo valor.
+Veamos cómo se hace.
La sintaxis genérica de esta instrucción es:
@var{Contexto}, al valor @var{valor}.
El @var{contexto} se puede omitir (y normalmente así es) cuando el
-contexto requerido se encuentra implicado sin ambigüedad y es uno de
-los contextos del nivel más bajo, es decir: @code{Voice},
-@code{ChordNames} o @code{Lyrics}, y lo omitiremos en muchos de los
-ejemplos siguientes. Veremos más tarde cuándo se debe especificar.
-
-Las últimas secciones tratan de forma exhaustiva las propiedades y sus
-valores, véase @ref{Tipos de propiedades}. Pero en esta sección
-usaremos sólo unas cuantas propiedades y valores
-sencillos que sean fáciles de entender, para ilustrar el formato
-y la utilización de estas instrucciones.
+contexto requerido se encuentra implicado sin ambigüedad y es uno
+de los contextos del nivel más bajo, es decir: @code{Voice},
+@code{ChordNames} o @code{Lyrics}, y lo omitiremos en muchos de
+los ejemplos siguientes. Veremos más tarde cuándo se debe
+especificar.
+
+Las últimas secciones tratan de forma exhaustiva las propiedades y
+sus valores, véase @ref{Tipos de propiedades}. Pero en esta
+sección usaremos sólo unas cuantas propiedades y valores sencillos
+que sean fáciles de entender, para ilustrar el formato y la
+utilización de estas instrucciones.
Las expresiones principales de LilyPond son elementos musicales
como notas, duraciones y elementos de marcado. Las expresiones
escritura, por coherencia. Para ver más información acerca del
modo de Scheme, consulte @rextend{Sintaxis del Scheme de LilyPond}.
-@code{\override} es la
-instrucción de uso más común dentro del trucaje, y durante la mayor
-parte del resto de este capítulo presentaremos ejemplos de cómo se
-usa. A continuación hay un ejemplo sencillo para cambiar el color de
-una cabeza:
+@code{\override} es la instrucción de uso más común dentro del
+trucaje, y durante la mayor parte del resto de este capítulo
+presentaremos ejemplos de cómo se usa. A continuación hay un
+ejemplo sencillo para cambiar el color de una cabeza:
@cindex color, propiedad, ejemplo
@cindex NoteHead, ejemplo de sobreescritura
@funindex \revert
@funindex revert
-Una vez sobreescrita, la propiedad retiene su nuevo valor hasta que
-se sobreescribe de nuevo o se encuentra una instrucción
+Una vez sobreescrita, la propiedad retiene su nuevo valor hasta
+que se sobreescribe de nuevo o se encuentra una instrucción
@code{\revert}. La instrucción @code{\revert} tiene la siguiente
sintaxis y ocasiona que el valor de la propiedad se devuelva a su
-valor predeterminado original; observe que no es a su valor previo si
-se han utilizado varias instrucciones @code{\override}.
+valor predeterminado original; observe que no es a su valor previo
+si se han utilizado varias instrucciones @code{\override}.
@example
\revert @var{Contexto}.@var{ObjetoDePresentación}.@var{propiedad-de-presentación}
Una vez más, igual que @var{Contexto} dentro de la instrucción
@code{\override}, con frecuencia no es necesario especificar el
@var{Contexto}. Se omitirá en muchos de los ejemplos siguientes.
-Aquí devolvemos el color de la cabeza al valor predeterminado para las
-dos últimas notas:
+Aquí devolvemos el color de la cabeza al valor predeterminado para
+las dos últimas notas:
@cindex color, propiedad, ejemplo
@cindex NoteHead, ejemplo de sobreescritura
@funindex \once
@funindex once
-@code{\override}, @code{\revert}. @code{\set}, and @code{\unset}
-se pueden
-preceder por @code{\once}. Esto ocasiona que la instrucción
-sea efectiva solamente durante el
-tiempo musical en curso y antes de que la propiedad vuelva a tener
-otra vez su valor anterior (que puede ser distinto de su valor
-predeterminado si aún se está aplicando otra instrucción
-@code{\override} de sobreescritura). Utilizando el mismo ejemplo,
-podemos cambiar el color de una sola nota de la siguiente manera:
+@code{\override}, @code{\revert}, @code{\set} y @code{\unset} se
+pueden hacer preceder por @code{\once}. Esto hace que la
+instrucción sea efectiva solamente durante el tiempo musical en
+curso y antes de que la propiedad vuelva a tener otra vez su valor
+anterior (que puede ser distinto de su valor predeterminado si aún
+se está aplicando otra instrucción @code{\override} de
+sobreescritura). Utilizando el mismo ejemplo, podemos cambiar el
+color de una sola nota de la siguiente manera:
@cindex color, propiedad, ejemplo
@cindex NoteHead, ejemplo de sobreescritura
@end lilypond
El prefijo @code{\once} también se puede usar delante de muchas
-instrucciones predefinidas para limitar su efecto a un solo momento
-musical:
+instrucciones predefinidas para limitar su efecto a un solo
+momento musical:
@lilypond[quote,verbatim]
\relative {
Hay otra forma para la instrucción de sobreescritura,
@code{\overrideProperty}, que ocasionalmente es necesaria. La
-mencionamos aquí con un propósito de exhaustividad, pero para ver más
-detalles consulte @rextend{Trucos difíciles}.
+mencionamos aquí con un propósito de exhaustividad, pero para ver
+más detalles consulte @rextend{Trucos difíciles}.
@c Maybe explain in a later iteration -td
@funindex \tweak
@funindex tweak
-La última instrucción de trucaje que está disponible es @code{\tweak}.
-Se debe utilizar cuando varios objetos tienen lugar
-en el mismo momento musical pero solo queremos cambiar las propiedades
-de algunos de ellos, como una sola nota dentro de un acorde.
-El uso de
-@code{\override} para la sobreescritura afectaría a todas las notas
-del acorde, mientras que @code{\tweak} afecta solamente al siguiente
-elemento del flujo de entrada.
+La última instrucción de trucaje que está disponible es
+@code{\tweak}. Se debe utilizar cuando varios objetos tienen
+lugar en el mismo momento musical pero solo queremos cambiar las
+propiedades de algunos de ellos, como una sola nota dentro de un
+acorde. El uso de @code{\override} para la sobreescritura
+afectaría a todas las notas del acorde, mientras que @code{\tweak}
+afecta solamente al siguiente elemento del flujo de entrada.
He aquí un ejemplo. Suponga que queremos cambiar el tamaño de la
cabeza de la nota intermedia (el Mi) en un acorde de Do mayor. En
@end lilypond
Vemos que la sobreescritura con override afecta a @emph{todas} las
-cabezas de las notas del acorde. Esto es así porque todas las notas
-de un acorde ocurren en el mismo @emph{momento musical}, y la acción
-de @code{\once} es aplicar la sobreescritura a todos los objetos de
-presentación del tipo especificado que ocurren en el mismo momento
-musical que la propia instrucción de sobreescritura @code{\override}.
-
-La instrucción @code{\tweak} opera de una forma distinta. Actúa sobre
-el elemento inmediatamente siguiente dentro del flujo de entrada.
-En su forma más sencilla es efectivo solamente sobre objetos
-que se crean directamente
-a partir del elemento siguiente, en esencia las cabezas y las
-articulaciones.
-
-Así pues, volviendo a nuestro ejemplo, el tamaño de la nota intermedia
-se cambiaría de la siguiente forma:
+cabezas de las notas del acorde. Esto es así porque todas las
+notas de un acorde ocurren en el mismo @emph{momento musical}, y
+la acción de @code{\once} es aplicar la sobreescritura a todos los
+objetos de presentación del tipo especificado que ocurren en el
+mismo momento musical que la propia instrucción de sobreescritura
+@code{\override}.
+
+La instrucción @code{\tweak} opera de una forma distinta. Actúa
+sobre el elemento inmediatamente siguiente dentro del flujo de
+entrada. En su forma más sencilla es efectivo solamente sobre
+objetos que se crean directamente a partir del elemento siguiente,
+en esencia las cabezas y las articulaciones.
+
+Así pues, volviendo a nuestro ejemplo, el tamaño de la nota
+intermedia se cambiaría de la siguiente forma:
@cindex font-size, propiedad, ejemplo
@cindex @code{\tweak}, ejemplo
@end lilypond
Observe que la sintaxis de @code{\tweak} no es igual que la de
-@code{\override}. El contexto no se
-debe especificar; de hecho, generaría un error hacerlo.
-Tanto el contexto como el objeto de presentación
-están implícitos por el siguiente elemento del flujo de entrada.
-Observe también que no debe haber un signo igual. Así que la sintaxis
-de la instrucción @code{\tweak} en su forma sencilla es:
+@code{\override}. El contexto no se debe especificar; de hecho,
+generaría un error hacerlo. Tanto el contexto como el objeto de
+presentación están implícitos por el siguiente elemento del flujo
+de entrada. Observe también que no debe haber un signo igual. Así
+que la sintaxis de la instrucción @code{\tweak} en su forma
+sencilla es:
@example
\tweak @var{propiedad-de-presentación} #@var{valor}
@end lilypond
@noindent
-Observe que la instrucción @code{\tweak} debe venir precedida de una
-marca de articulación porque la propia expresión trucada debe aplicarse
-como una articulación. En el caso de más de una sobreescritura de dirección
-(@code{^} o @code{_}), gana la sobreescritura situada más a la izquierda
-porque se aplica en último lugar.
+Observe que la instrucción @code{\tweak} debe venir precedida de
+una marca de articulación porque la propia expresión trucada debe
+aplicarse como una articulación. En el caso de más de una
+sobreescritura de dirección (@code{^} o @code{_}), gana la
+sobreescritura situada más a la izquierda porque se aplica en
+último lugar.
@cindex @code{\tweak}, Accidental
@cindex @code{\tweak}, specific layout object
-Los objetos tales como plicas y alteraciones accidentales se crean más
-tarde, y no directamente a partir del evento que viene a continuación.
-Aún es posible utilizar @code{\tweak} sobre tales objetos creados
-indirectamente mediante el nombrado explícito del objeto de
-presentación, siempre y cuando LilyPond pueda rastrear su origen hasta
-el evento original:
+Los objetos tales como plicas y alteraciones accidentales se crean
+más tarde, y no directamente a partir del evento que viene a
+continuación. Aún es posible utilizar @code{\tweak} sobre tales
+objetos creados indirectamente mediante el nombrado explícito del
+objeto de presentación, siempre y cuando LilyPond pueda rastrear
+su origen hasta el evento original:
@lilypond[quote,fragment,ragged-right,verbatim]
<\tweak Accidental.color #red cis''4
@funindex TupletBracket
La instrucción @code{\tweak} también se debe usar para cambiar la
-apariencia de uno solo de un conjunto de grupos especiales anidados
-que comiencen en el mismo instante musical. En el siguiente ejemplo,
-el corchete del tresillo largo y el primero de los tres corchetes
-cortos empiezan en el mismo momento musical, y por ello cualquier
-instrucción @code{\override} se aplicaría a los dos. En el ejemplo se
-usa @code{\tweak} para distinguir entre ellos. La primera instrucción
-@code{\tweak} especifica que el corchete del tresillo largo se debe
-colocar por encima de las notas y el segundo especifica que el número
-del tresillo se debe imprimir en rojo sobre el corchete del primer
-tresillo corto.
+apariencia de uno solo de un conjunto de grupos especiales
+anidados que comiencen en el mismo instante musical. En el
+siguiente ejemplo, el corchete del tresillo largo y el primero de
+los tres corchetes cortos empiezan en el mismo momento musical, y
+por ello cualquier instrucción @code{\override} se aplicaría a los
+dos. En el ejemplo se usa @code{\tweak} para distinguir entre
+ellos. La primera instrucción @code{\tweak} especifica que el
+corchete del tresillo largo se debe colocar por encima de las
+notas y el segundo especifica que el número del tresillo se debe
+imprimir en rojo sobre el corchete del primer tresillo corto.
@cindex @code{\tweak}, ejemplo
@cindex direction, propiedad, ejemplo
}
@end lilypond
-Si los grupos anidados no comienzan en el mismo momento, su apariencia
-se puede modificar de la forma usual mediante instrucciones
-@code{\override}:
+Si los grupos anidados no comienzan en el mismo momento, su
+apariencia se puede modificar de la forma usual mediante
+instrucciones @code{\override}:
@cindex text, propiedad, ejemplo
@cindex tuplet-number, función, ejemplo
Referencia de la notación:
@ruser{La instrucción tweak}.
-@node The single prefix
-@unnumberedsubsubsec The @code{@bs{}single} prefix
+@node El prefijo single
+@unnumberedsubsubsec El prefijo @code{@bs{}single}
+@translationof The single prefix
@funindex \single
-@cindex tweak, generated from override
+@cindex truco, generado a partir de una sobreescritura
-Suppose we wanted to emphasize particular note heads by coloring them
-red and increasing their size, and to make it easy suppose also we
-have defined a function to do this:
+Supongamos que queremos enfatizar la cabeza de algunas notas
+trazándolas de color e incrementando su tamaño, y supongamos
+también hemos programado una función para hacer la tarea más
+cómoda:
@lilypond[quote,verbatim]
emphNoteHead = {
}
@end lilypond
-The @code{\once} prefix works fine to emphasize single notes or
-complete chords, but it cannot be used to emphasize a single note
-@emph{within} a chord. Earlier we have seen how @code{\tweak} can
-be used to do this, see
-@ref{The tweak command,,The @code{@bs{}tweak} command}. But
-@code{\tweak} cannot be used with a function; that's where
-@code{\single} comes in:
+El prefijo @code{\once} funciona perfectamente para enfatizar
+notas únicas o acordes completos, pero no se puede usar para
+enfatizar una sola nota @emph{dentro} de un acorde. Anteriormente
+vimos cómo se puede usar la instrucción @code{\tweak} para
+hacerlo, véase @ref{La instrucción tweak,,La instrucción
+@code{@bs{}tweak}}. Pero @code{\tweak} no se puede usar con una
+función; ahí es donde entra la instrucción @code{\single}:
@lilypond[quote,verbatim]
emphNoteHead = {
}
@end lilypond
-In summary, @code{\single} converts overrides into tweaks so when
-there are several objects at the same point in musical time (like
-noteheads in a chord), @code{\single} will only affect a single one,
-the one generated by the immediately following music expression, in
-contrast to @code{\once} which will affect all of those objects.
+En resumen, @code{\single} convierte las sobreescrituras hechas
+con@code{\override} en trucos hechos con @code{\tweak} de tal
+manera que cuando hay varios objetos en el mismo instante de
+tiempo musical (como las notas de un acorde), @code{\single}
+afecta a una única nota, la que se genera por la expresión que
+sigue inmediatamente, a diferencia de @code{\once} que afecta a
+todos esos objetos.
-By using @code{\single} in this way any shorthand function
-containing just overrides may be applied to individual notes in a
-chord. However, @code{\single} does not convert @code{\revert},
-@code{\set} or @code{\unset} into tweaks.
+El uso de @code{\single} de esta forma con una función cualquiera
+que contenga solamente sobreescrituras, puede aplicarse a las
+notas individuales de un acorde. Sin embargo, @code{\single} no
+convierte @code{\revert}, @code{\set} ni @code{\unset} en trucos
+de @code{\tweak}.
@seealso
-Learning Manual:
-@ref{The tweak command,,The @code{@bs{}tweak} command},
-@ref{Using variables for layout adjustments}.
+Manual de aprendizaje:
+@ref{La instrucción tweak,,La instrucción @code{@bs{}tweak}},
+@ref{Uso de variables para los ajustes de disposición}.
@node Manual de referencia de funcionamiento interno
@section Manual de referencia de funcionamiento interno
@translationof The Internals Reference manual
-@cindex Internals Reference
+@cindex Referencia de funcionamiento interno
@menu
* Propiedades de los objetos de presentación::
@cindex presentación, propiedades de los objetos de
@cindex Referencia de funcionamiento interno
-Suponga que tiene una partitura con una ligadura de expresión que para
-su gusto es demasiado fina y quiere trazarla un poco más gruesa. ¿Cómo
-debe proceder? Ya sabe, por las afirmaciones anteriores acerca de la
-flexibilidad de LilyPond, que tal posibilidad existe, y seguramente
-piensa que una cierta instrucción de sobreescritura @code{\override}
-será necesaria. Pero ¿existe una propiedad de grosor para las
-ligaduras? y, si la hay, ¿cómo se puede modificar? Aquí es donde
-interviene el Manual de Funcionamiento Interno. Contiene toda la
-información que puede necesitar para construir ésta y todas las demás
-instrucciones @code{\override}, de sobreescritura.
+Suponga que tiene una partitura con una ligadura de expresión que
+para su gusto es demasiado fina y quiere trazarla un poco más
+gruesa. ¿Cómo debe proceder? Ya sabe, por las afirmaciones
+anteriores acerca de la flexibilidad de LilyPond, que tal
+posibilidad existe, y seguramente piensa que una cierta
+instrucción de sobreescritura @code{\override} será necesaria.
+Pero ¿existe una propiedad de grosor para las ligaduras? y, si la
+hay, ¿cómo se puede modificar? Aquí es donde interviene el Manual
+de Funcionamiento Interno. Contiene toda la información que puede
+necesitar para construir ésta y todas las demás instrucciones
+@code{\override}, de sobreescritura.
Una advertencia antes de dirigir nuestra mirada a la referencia de
-funcionamiento interno. Éste es un documento de @strong{referencia},
-lo que significa que hay pocas o ninguna explicación en él: su
-propósito es presentar la información de forma precisa y concisa. Por
-tanto, podrá parecerle desalentador a primera vista. ¡No se preocupe!
-La guía y las explicaciones que presentamos aquí le permitirán extraer
-la información de la referencia de funcionamiento interno por sí mismo
-con tan sólo algo de práctica.
+funcionamiento interno. Éste es un documento de
+@strong{referencia}, lo que significa que hay pocas o ninguna
+explicación en él: su propósito es presentar la información de
+forma precisa y concisa. Por tanto, podrá parecerle desalentador
+a primera vista. ¡No se preocupe! La guía y las explicaciones
+que presentamos aquí le permitirán extraer la información de la
+referencia de funcionamiento interno por sí mismo con tan sólo
+algo de práctica.
@cindex sobreescritura, ejemplo de
@cindex Referencia de Funcionamiento Interno, ejemplo de utilización
Suponga ahora que decidimos que nos gustan las ligaduras algo más
gruesas. ¿Es posible? La ligadura es, ciertamente, un objeto de
presentación, así que la cuestión es @q{¿Hay una propiedad
-perteneciente a las ligaduras de expresión que controle su grosor?}
-Para responder a esta pregunta debemos mirar el manual de Referencia
-de Funcionamiento Interno, abreviadamente RFI@footnote{@strong{IR}
-(Internals Reference) en inglés}.
-
-El RFI de la versión de LilyPond que está usando se puede encontrar en
-la página web de LilyPond en @uref{http://lilypond.org}. Vaya a la
-página de la documentación y siga el enlace Manual de Referencia de
-Funcionamiento Interno (RFI). Para nuestros propósitos pedagógicos
-sería mejor que utilizase la versión en HTML, no la @q{en una sola
-página} ni el PDF. Para que los siguientes párrafos tengan algún
-sentido deberá consultarlo realmente al tiempo que lee.
+perteneciente a las ligaduras de expresión que controle su
+grosor?} Para responder a esta pregunta debemos mirar el manual
+de Referencia de Funcionamiento Interno, abreviadamente
+RFI@footnote{@strong{IR} (Internals Reference) en inglés}.
+
+El RFI de la versión de LilyPond que está usando se puede
+encontrar en la página web de LilyPond en
+@uref{http://lilypond.org}. Vaya a la página de la documentación
+y siga el enlace Manual de Referencia de Funcionamiento Interno
+(RFI). Para nuestros propósitos pedagógicos sería mejor que
+utilizase la versión en HTML, no la @q{en una sola página} ni el
+PDF. Para que los siguientes párrafos tengan algún sentido deberá
+consultarlo realmente al tiempo que lee.
@c Link names in English as those pages are not yet translated. FV
Bajo el encabezamiento @strong{Top} podrá ver cinco enlaces.
Seleccione el enlace @emph{Backend}, que es donde se encuentra la
-información sobre los objetos de presentación. Una vez allí, bajo el
-encabezamiento @strong{Backend}, siga el enlace @emph{All layout
-objects}. La página que aparece relaciona todos los objetos de
-presentación que se usan en su versión de LilyPond, en orden
-alfabético. Siga el enlace Slur (ligadura de expresión), y aparecerán
-relacionadas las propiedades de las ligaduras de expresión o Slurs.
+información sobre los objetos de presentación. Una vez allí, bajo
+el encabezamiento @strong{Backend}, siga el enlace @emph{All
+layout objects}. La página que aparece relaciona todos los
+objetos de presentación que se usan en su versión de LilyPond, en
+orden alfabético. Siga el enlace Slur (ligadura de expresión), y
+aparecerán relacionadas las propiedades de las ligaduras de
+expresión o Slurs.
Una forma alternativa de encontrar esta página es a partir de la
-Referencia de la Notación. En una de las páginas que tratan de las
-ligaduras de expresión podrá encontrar un enlace al manual de
+Referencia de la Notación. En una de las páginas que tratan de
+las ligaduras de expresión podrá encontrar un enlace al manual de
referencia del funcionamiento interno. Este enlace le llevará
-directamente a esta página, aunque si tiene una idea del nombre del
-objeto de presentación que pretende trucar, le resultará más fácil ir
-directamente al RFI y buscar allí.
+directamente a esta página, aunque si tiene una idea del nombre
+del objeto de presentación que pretende trucar, le resultará más
+fácil ir directamente al RFI y buscar allí.
-Esta página sobre las ligaduras de expresión dentro del manual RFI nos
-dice en primer lugar que los objetos Slur se crean por el grabador
-Slur_engraver. A continuación relaciona los ajustes estándar.
-Navegue por ellos buscando una propiedad que pudiera controlar
-el grosor de las ligaduras, y encontrará
+Esta página sobre las ligaduras de expresión dentro del manual RFI
+nos dice en primer lugar que los objetos Slur se crean por el
+grabador Slur_engraver. A continuación relaciona los ajustes
+estándar. Navegue por ellos buscando una propiedad que pudiera
+controlar el grosor de las ligaduras, y encontrará
@example
@code{thickness} (number)
Line thickness, generally measured in @code{line-thickness}
@end example
-Esto promete ser una buena opción para cambiar el grosor. Nos dice
-que el valor de @code{thickness} es un simple @emph{número}, que el
-valor predeterminado es 1.2, y que las unidades están dentro de otra
-propiedad llamada @code{line-thickness}.
+Esto promete ser una buena opción para cambiar el grosor. Nos
+dice que el valor de @code{thickness} es un simple @emph{número},
+que el valor predeterminado es 1.2, y que las unidades están
+dentro de otra propiedad llamada @code{line-thickness}.
Como dijimos con anterioridad, existen entre pocas y ninguna
explicación en el RFI, pero ya tenemos información suficiente para
-probar a cambiar el grosor de la ligadura. Vemos que el nombre del
-objeto de presentación es @code{Slur}, que el nombre de la propiedad
-que debemos cambiar es @code{thickness} y que el nuevo valor debe ser
-un número algo más grande que 1.2 si queremos hacer las ligaduras más
-gruesas.
+probar a cambiar el grosor de la ligadura. Vemos que el nombre
+del objeto de presentación es @code{Slur}, que el nombre de la
+propiedad que debemos cambiar es @code{thickness} y que el nuevo
+valor debe ser un número algo más grande que 1.2 si queremos hacer
+las ligaduras más gruesas.
Ahora podemos construir la instrucción de sobreescritura
-@code{\override} simplemente mediante la sustitución de los valores
-que hemos encontrado para los nombres, omitiendo el contexto.
-Usaremos un valor muy grande para el grosor al principio, para estar
-seguros de que la instrucción está funcionando. Obtenemos lo
-siguiente:
+@code{\override} simplemente mediante la sustitución de los
+valores que hemos encontrado para los nombres, omitiendo el
+contexto. Usaremos un valor muy grande para el grosor al
+principio, para estar seguros de que la instrucción está
+funcionando. Obtenemos lo siguiente:
@example
\override Slur.thickness = #5.0
@end example
-¡No olvide el @code{#'} antes del nombre de la propiedad y@tie{}@code{#}
-antes del valor nuevo!
+¡No olvide el @code{#'} antes del nombre de la propiedad
+y@tie{}@code{#} antes del valor nuevo!
La pregunta final es @q{¿Dónde se debe colocar esta instrucción?}
Aunque nos falta seguridad y estamos todavía aprendiendo, la mejor
-respuesta es: @q{Dentro de la música, antes de la primera ligadura y
-cerca de ella.} Hagámoslo así:
+respuesta es: @q{Dentro de la música, antes de la primera ligadura
+y cerca de ella.} Hagámoslo así:
@cindex Slur, ejemplo de sobreescritura
@cindex thickness, propiedad, ejemplo
complicaciones más con las que nos encontraremos en secciones
posteriores, pero ahora conoce todos los principios esenciales que
necesita para hacerlo por sí mismo (aunque aún necesita algo de
-práctica). La cual vendrá proporcionada por los ejemplos que vienen a
-continuación.
+práctica). La cual vendrá proporcionada por los ejemplos que
+vienen a continuación.
@subsubsubheading Búsqueda del contexto
Pero en primer lugar ¿qué habría pasado si hubiésemos tenido que
especificar el contexto? ¿Cuál sería? Podemos suponer que las
-ligaduras están en el contexto de Voz, por estar claramente asociados
-de manera estrecha con las líneas individuales de música, pero
-¿podemos estar seguros? Para averiguarlo, vayamos de nuevo al inicio
-de la página del RFI que describe las ligaduras (Slur), donde dice
-@q{Slur objects are created by: Slur engraver} («Los objetos de
-ligadura de expresión se crean por: el grabador Slur»). Así pues, las
-ligaduras de expresión se crean en cualquier contexto en el que se
-encuentre el grabador @code{Slur_engraver}. Siga el enlace a la
-página del grabador @code{Slur_engraver}. Al final del todo, dice que
-el grabador @code{Slur_engraver} es parte de siete contextos de voz,
-incluido el contexto de voz estándar, @code{Voice}, por lo que nuestra
-suposición era acertada. Y a causa de que @code{Voice} es uno de los
-contextos de más bajo nivel que se encuentra implícito sin ambigüedad
-por el hecho de que estamos escribiendo notas, podemos omitirlo en
-este lugar concreto.
+ligaduras están en el contexto de Voz, por estar claramente
+asociados de manera estrecha con las líneas individuales de
+música, pero ¿podemos estar seguros? Para averiguarlo, vayamos de
+nuevo al inicio de la página del RFI que describe las ligaduras
+(Slur), donde dice @q{Slur objects are created by: Slur engraver}
+(«Los objetos de ligadura de expresión se crean por: el grabador
+Slur»). Así pues, las ligaduras de expresión se crean en
+cualquier contexto en el que se encuentre el grabador
+@code{Slur_engraver}. Siga el enlace a la página del grabador
+@code{Slur_engraver}. Al final del todo, dice que el grabador
+@code{Slur_engraver} es parte de siete contextos de voz, incluido
+el contexto de voz estándar, @code{Voice}, por lo que nuestra
+suposición era acertada. Y a causa de que @code{Voice} es uno de
+los contextos de más bajo nivel que se encuentra implícito sin
+ambigüedad por el hecho de que estamos escribiendo notas, podemos
+omitirlo en este lugar concreto.
@subsubsubheading Sobreescritura por una sola vez
Como puede ver, @emph{todas} las ligaduras son más gruesas en el
último ejemplo. Pero ¿y si quisiéramos que solamente la primera
ligadura fuese más gruesa? Esto se consigue con la instrucción o
-prefijo @code{\once}. Colocado inmediatamente antes de la instrucción
-@code{\override} ocasiona que solamente cambie la ligadura que
-comienza en la nota @strong{inmediata siguiente}. Si la nota
-inmediata siguiente no da inicio a una ligadura, la instrucción no
-tiene ningún efecto en absoluto: no se recuerda hasta que se
-encuentre alguna ligadura, sino que simplemente se ignora. Así pues,
-la instrucción que lleva @code{\once} se debe reposicionar de la forma
-siguiente:
+prefijo @code{\once}. Colocado inmediatamente antes de la
+instrucción @code{\override} ocasiona que solamente cambie la
+ligadura que comienza en la nota @strong{inmediata siguiente}. Si
+la nota inmediata siguiente no da inicio a una ligadura, la
+instrucción no tiene ningún efecto en absoluto: no se recuerda
+hasta que se encuentre alguna ligadura, sino que simplemente se
+ignora. Así pues, la instrucción que lleva @code{\once} se debe
+reposicionar de la forma siguiente:
@cindex Slur, ejemplo de sobreescritura
@cindex thickness, propiedad, ejemplo
@end lilypond
@noindent
-Hemos hecho que ahora solamente la primera ligadura sea más gruesa.
+Hemos hecho que ahora solamente la primera ligadura sea más
+gruesa.
-La instrucción o prefijo @code{\once} también se puede usar antes de
-la instrucción @code{\set}.
+La instrucción o prefijo @code{\once} también se puede usar antes
+de la instrucción @code{\set}.
@subsubsubheading Recuperación del ajuste
@funindex \revert
@funindex revert
-Finalmente ¿y si quisiéramos que solamente las dos primeras ligaduras
-fuesen más gruesas? En fin; podríamos usar dos instrucciones, cada
-una de ellas precedida por el prefijo @code{\once}, situadas
-inmediatamente antes de cada una de las notas en que comienzan las
-ligaduras:
+Finalmente ¿y si quisiéramos que solamente las dos primeras
+ligaduras fuesen más gruesas? En fin; podríamos usar dos
+instrucciones, cada una de ellas precedida por el prefijo
+@code{\once}, situadas inmediatamente antes de cada una de las
+notas en que comienzan las ligaduras:
@cindex Slur, ejemplo de sobreescritura
@cindex thickness, propiedad, ejemplo
@end lilypond
@noindent
-o podríamos omitir la instrucción prefija @code{\once} y utilizar la
-instrucción @code{\revert} (restablecer) para devolver la propiedad
-del grosor, @code{thickness}, a su valor predeterminado después de la
-segunda ligadura:
+o podríamos omitir la instrucción prefija @code{\once} y utilizar
+la instrucción @code{\revert} (restablecer) para devolver la
+propiedad del grosor, @code{thickness}, a su valor predeterminado
+después de la segunda ligadura:
@cindex Slur, ejemplo de sobreescritura
@cindex thickness, propiedad, ejemplo
@noindent
la instrucción @code{\revert} se puede utilizar para devolver
cualquier propiedad que se haya cambiado con @code{\override} a su
-valor predeterminado. Puede utilizar el método que mejor se adapte a
-aquello que quiere hacer.
+valor predeterminado. Puede utilizar el método que mejor se
+adapte a aquello que quiere hacer.
-Así finaliza nuestra introducción al manual de RFI, y el método básico
-de trucaje. A continuación, en las últimas secciones de este capítulo
-encontrará varios ejemplos, en parte para introducirle en algunas de
-las posibilidades adicionales del manual RFI, y en parte para
-proporcionarle más práctica en cómo extraer información de él. Estos
-ejemplos irán conteniendo cada vez menos palabras de guía y
-explicación.
+Así finaliza nuestra introducción al manual de RFI, y el método
+básico de trucaje. A continuación, en las últimas secciones de
+este capítulo encontrará varios ejemplos, en parte para
+introducirle en algunas de las posibilidades adicionales del
+manual RFI, y en parte para proporcionarle más práctica en cómo
+extraer información de él. Estos ejemplos irán conteniendo cada
+vez menos palabras de guía y explicación.
@node Propiedades de los interfaces
@subsection Propiedades de los interfaces
@cindex propiedades de los interfaces
@cindex interfaces, propiedades
-Suponga ahora que queremos imprimir la letra de la canción en cursiva.
-¿Qué forma de instrucción @code{\override} necesitamos para hacerlo?
-En primer lugar miramos en la página del RFI que relaciona todos los
-objetos, @q{All layout objects}, como antes, y buscamos un objeto que
-pueda controlar la letra de la canción. Encontramos @code{LyricText},
-que parece adecuado. Al seguir este enlace se presentan las
-propiedades ajustables para el texto de la letra. Estos incluyen
-@code{font-series} y @code{font-size}, pero nada que pudiera aplicar
-una forma cursiva. Esto es porque la propiedad de la forma es común a
-todos los objetos de fuente tipográfica, y por tanto, en vez de
-incluirlo en cada uno de los objetos de presentación, se agrupa junto
-con otras propiedades comunes similares y se deposita en un
-@strong{Interface}, el interface de las fuentes tipográficas
-@code{font-interface}.
-
-Por tanto, ahora necesitamos aprender cómo encontrar las propiedades
-de los interfaces, y descubrir qué objetos usan estas propiedades de
-interface.
-
-Mire de nuevo la página del RFI que describe a LyricText. Al final de
-la página hay una lista de enlaces a los interfaces que LyricText
-contempla. La lista tiene siete elementos, entre ellos
+Suponga ahora que queremos imprimir la letra de la canción en
+cursiva. ¿Qué forma de instrucción @code{\override} necesitamos
+para hacerlo? En primer lugar miramos en la página del RFI que
+relaciona todos los objetos, @q{All layout objects}, como antes, y
+buscamos un objeto que pueda controlar la letra de la canción.
+Encontramos @code{LyricText}, que parece adecuado. Al seguir este
+enlace se presentan las propiedades ajustables para el texto de la
+letra. Estos incluyen @code{font-series} y @code{font-size}, pero
+nada que pudiera aplicar una forma cursiva. Esto es porque la
+propiedad de la forma es común a todos los objetos de fuente
+tipográfica, y por tanto, en vez de incluirlo en cada uno de los
+objetos de presentación, se agrupa junto con otras propiedades
+comunes similares y se deposita en un @strong{Interface}, el
+interface de las fuentes tipográficas @code{font-interface}.
+
+Por tanto, ahora necesitamos aprender cómo encontrar las
+propiedades de los interfaces, y descubrir qué objetos usan estas
+propiedades de interface.
+
+Mire de nuevo la página del RFI que describe a LyricText. Al
+final de la página hay una lista de enlaces a los interfaces que
+LyricText contempla. La lista tiene siete elementos, entre ellos
@code{font-interface}. Al seguir este enlace llegamos a las
-propiedades asociadas con este interface, que también son propiedades
-de todos los objetos que lo llevan, entre ellos LyricText.
+propiedades asociadas con este interface, que también son
+propiedades de todos los objetos que lo llevan, entre ellos
+LyricText.
Ahora vemos todas las propiedades ajustables por el usuario que
controlan las tipografías, entre ellas @code{font-shape(symbol)},
@code{italics} (cursiva)o @code{caps} (mayúsculas pequeñas).
Observará que @code{font-series} y @code{font-size} también se
-encuentran aquí relacionadas. Esto inmediatamente hace que surja la
-pregunta: ¿Por qué están las propiedades comunes de tipografía
+encuentran aquí relacionadas. Esto inmediatamente hace que surja
+la pregunta: ¿Por qué están las propiedades comunes de tipografía
@code{font-series} y @code{font-size} relacionadas bajo
-@code{LyricText} así como bajo el interface @code{font-interface} pero
-@code{font-shape} no lo está? La respuesta es que @code{font-series}
-y @code{font-size} se cambian a partir de sus valores predeterminados
-globales cuando se crea un objeto @code{LyricText}, pero
-@code{font-shape} no lo hace. Entonces los elementos de la lista
-@code{LyricText} le dicen los valores para esas dos propiedades que
-son de aplicación para @code{LyricText}. Otros objetos que contemplan
-@code{font-interface} establecerán dichas propiedades de forma
-diferente cuando se crean.
-
-Veamos si ahora podemos construir la instrucción @code{\override} para
-cambiar la letra a cursiva. El objeto es @code{LyricText}, la
-propiedad es @code{font-shape} y el valor es @code{italic}. Igual que
-antes, omitiremos el contexto.
+@code{LyricText} así como bajo el interface @code{font-interface}
+pero @code{font-shape} no lo está? La respuesta es que
+@code{font-series} y @code{font-size} se cambian a partir de sus
+valores predeterminados globales cuando se crea un objeto
+@code{LyricText}, pero @code{font-shape} no lo hace. Entonces los
+elementos de la lista @code{LyricText} le dicen los valores para
+esas dos propiedades que son de aplicación para @code{LyricText}.
+Otros objetos que contemplan @code{font-interface} establecerán
+dichas propiedades de forma diferente cuando se crean.
+
+Veamos si ahora podemos construir la instrucción @code{\override}
+para cambiar la letra a cursiva. El objeto es @code{LyricText},
+la propiedad es @code{font-shape} y el valor es @code{italic}.
+Igual que antes, omitiremos el contexto.
Como nota aparte, aunque es importante, observe que ciertas
propiedades toman valores que son símbolos, como @code{italic}, y
detalles sobre los símbolos y las cadenas, consulte
@rextend{Tutorial de Scheme}.
-Así pues, la instrucción @code{\override} necesaria para imprimir la
-letra en cursiva, es:
+Así pues, la instrucción @code{\override} necesaria para imprimir
+la letra en cursiva, es:
@example
\override LyricText.font-shape = #'italic
@end example
@noindent
-Esto debe escribirse justo delante de la letra a la que debe afectar,
-de esta forma:
+Esto debe escribirse justo delante de la letra a la que debe
+afectar, de esta forma:
@cindex font-shape, propiedad, ejemplo
@cindex italic, ejemplo
Hasta ahora hemos visto dos tipos de propiedad:: @code{número} y
@code{símbolo}. Para que sea válido, el valor que se da a una
-propiedad debe ser del tipo correcto y obedecer las reglas de dicho
-tipo. El tipo de la propiedad se muestra siempre entre paréntesis
-después del nombre de la propiedad en el RFI. He aquí una lista de
-los tipos que podrá necesitar, junto con las reglas de dicho tipo, y
-algunos ejemplos. Debe escribir siempre un símbolo de almohadilla,
-@code{#}, por supuesto, delante de estos valores cuando se introducen
-en la instrucción @code{\override}, incluso si el propio valor ya
-comienza por@tie{}@code{#}. Solamente ofrecemos aquí ejemplos para
-constantes; si quiere calcular un valor usando Scheme, consulte
-@rextend{Cálculos en Scheme}.
+propiedad debe ser del tipo correcto y obedecer las reglas de
+dicho tipo. El tipo de la propiedad se muestra siempre entre
+paréntesis después del nombre de la propiedad en el RFI. He aquí
+una lista de los tipos que podrá necesitar, junto con las reglas
+de dicho tipo, y algunos ejemplos. Debe escribir siempre un
+símbolo de almohadilla, @code{#}, por supuesto, delante de estos
+valores cuando se introducen en la instrucción @code{\override},
+incluso si el propio valor ya comienza por@tie{}@code{#}.
+Solamente ofrecemos aquí ejemplos para constantes; si quiere
+calcular un valor usando Scheme, consulte @rextend{Cálculos en
+Scheme}.
@multitable @columnfractions .2 .45 .35
@headitem Tipo de propiedad
@subsection Visibilidad y color de los objetos
@translationof Visibility and color of objects
-Dentro de un uso educativo de la música, podríamos desear imprimir una
-partitura con ciertos elementos omitidos como ejercicio para el
-alumno, a quien se le pide que los complete. A la manera de ejemplo
-sencillo, supongamos que el ejercicio es escribir las líneas
-divisorias que faltan en un fragmento musical. Pero las líneas
-divisorias normalmente se insertan automáticamente. ¿Cómo hacemos para
-que no se impriman?
-
-Antes de enredarnos con esto, recordemos que las propiedades de los
-objetos se agrupan en lo que hemos llamado @emph{interfaces} (véase
-@ref{Propiedades de los interfaces}). Esto es simplemente agrupar
-las propiedades que se pueden usar juntas para trucar un objeto
-gráfico: si una de ellas se necesita para un objeto, también las
-otras. Así, ciertos objetos usan las propiedades de algunos
-interfaces, otros usan las de otros interfaces. Los interfaces que
-contienen las propiedades que un determinado grob necesita se
-encuentran relacionadas en el manual RFI al final de la página que
-describe dicho grob, y esas propiedades se pueden ver mirando dichos
-interfaces.
+Dentro de un uso educativo de la música, podríamos desear imprimir
+una partitura con ciertos elementos omitidos como ejercicio para
+el alumno, a quien se le pide que los complete. A la manera de
+ejemplo sencillo, supongamos que el ejercicio es escribir las
+líneas divisorias que faltan en un fragmento musical. Pero las
+líneas divisorias normalmente se insertan automáticamente. ¿Cómo
+hacemos para que no se impriman?
+
+Antes de enredarnos con esto, recordemos que las propiedades de
+los objetos se agrupan en lo que hemos llamado @emph{interfaces}
+(véase @ref{Propiedades de los interfaces}). Esto es simplemente
+agrupar las propiedades que se pueden usar juntas para trucar un
+objeto gráfico: si una de ellas se necesita para un objeto,
+también las otras. Así, ciertos objetos usan las propiedades de
+algunos interfaces, otros usan las de otros interfaces. Los
+interfaces que contienen las propiedades que un determinado grob
+necesita se encuentran relacionadas en el manual RFI al final de
+la página que describe dicho grob, y esas propiedades se pueden
+ver mirando dichos interfaces.
Hemos explicado cómo encontrar información sobre los grobs en
@ref{Propiedades de los objetos de presentación}. Usando el mismo
enfoque, vamos al RFI para buscar el objeto de presentación que
-imprime las líneas divisorias. A través del enlace @emph{Backend} y
-@emph{All layout objects} encontramos que hay un objeto de
+imprime las líneas divisorias. A través del enlace @emph{Backend}
+y @emph{All layout objects} encontramos que hay un objeto de
presentación llamado @code{BarLine}. Entre sus propiedades se
-encuentran dos que controlan la visibilidad: @code{break-visibility} y
-@code{stencil}. Las líneas divisorias también contemplan un número de
-interfaces, entre ellos el @code{grob-interface}, donde podemos
-encontrar las propiedades @code{transparent} y @code{color}. Todas
-ellas pueden afectar la visibilidad de las barras de compás (y, por
-supuesto, por extensión, también la de muchos otros objetos de
-presentación). Vamos a considerar cada uno de ellos por orden.
+encuentran dos que controlan la visibilidad:
+@code{break-visibility} y @code{stencil}. Las líneas divisorias
+también contemplan un número de interfaces, entre ellos el
+@code{grob-interface}, donde podemos encontrar las propiedades
+@code{transparent} y @code{color}. Todas ellas pueden afectar la
+visibilidad de las barras de compás (y, por supuesto, por
+extensión, también la de muchos otros objetos de presentación).
+Vamos a considerar cada uno de ellos por orden.
@menu
* La propiedad stencil (sello)::
@cindex stencil (sello), propiedad
-Esta propiedad controla la apariencia de las barras de compás mediante
-la especificación del símbolo (o «glifo») que se debe imprimir. Igual
-que como otras muchas propiedades, se puede establecer de forma que no
-imprima nada ajustando su valor a @code{#f}. Vamos a probarlo, como
-antes, omitiendo el Contexto implícito, @code{Voice}:
+Esta propiedad controla la apariencia de las barras de compás
+mediante la especificación del símbolo (o «glifo») que se debe
+imprimir. Igual que como otras muchas propiedades, se puede
+establecer de forma que no imprima nada ajustando su valor a
+@code{#f}. Vamos a probarlo, como antes, omitiendo el Contexto
+implícito, @code{Voice}:
@cindex BarLine, ejemplo de sobreescritura
@cindex stencil, propiedad, ejemplo
}
@end lilypond
-Las barras de compás todavía se imprimen. ¿Qué es lo que está mal?
-Vuelva al RFI y mire de nuevo la página que ofrece las propiedades del
-objeto BarLine. Al principio de la página dice @qq{Barline objects
-are created by: Bar_engraver} (los objetos Barline se crean por el
-grabador Bar_engraver). Vaya a la página del grabador
-@code{Bar_engraver} siguiendo el enlace. Al final da una lista de
-contextos en los que el grabador de líneas divisorias opera. Todos
-ellos son del tipo @code{Staff}, y así la razón de que la instrucción
-@code{\override} no funcionara como esperábamos, es porque
-@code{Barline} no se encuentra en el contexto predeterminado
-@code{Voice}. Si el contexto no se especifica correctamente, la
-instrucción simplemente no funciona. No se produce ningún mensaje de
-error, y no se registra nada en el archivo log de registro. Vamos a
-intentar corregirlo escribiendo el contexto correcto:
+Las barras de compás todavía se imprimen. ¿Qué es lo que está
+mal? Vuelva al RFI y mire de nuevo la página que ofrece las
+propiedades del objeto BarLine. Al principio de la página dice
+@qq{Barline objects are created by: Bar_engraver} (los objetos
+Barline se crean por el grabador Bar_engraver). Vaya a la página
+del grabador @code{Bar_engraver} siguiendo el enlace. Al final da
+una lista de contextos en los que el grabador de líneas divisorias
+opera. Todos ellos son del tipo @code{Staff}, y así la razón de
+que la instrucción @code{\override} no funcionara como
+esperábamos, es porque @code{Barline} no se encuentra en el
+contexto predeterminado @code{Voice}. Si el contexto no se
+especifica correctamente, la instrucción simplemente no funciona.
+No se produce ningún mensaje de error, y no se registra nada en el
+archivo log de registro. Vamos a intentar corregirlo escribiendo
+el contexto correcto:
@cindex BarLine, ejemplo de sobreescritura
@cindex stencil, propiedad, ejemplo
Sin embargo, observe que el establecimiento de la propiedad
@code{stencil} al valor @code{#f} produce errores cuando las se
-requieren las dimensiones del objeto para un procesamiento correcto.
-Por ejemplo, se generan errores si la propiedad @code{stencil} del
-objeto @code{NoteHead} se establece al valor @code{#f}. Si es el
-caso, podemos en vez de ello utilizar la función @code{point-stencil},
-que establece el sello a un objeto con tamaño nulo:
+requieren las dimensiones del objeto para un procesamiento
+correcto. Por ejemplo, se generan errores si la propiedad
+@code{stencil} del objeto @code{NoteHead} se establece al valor
+@code{#f}. Si es el caso, podemos en vez de ello utilizar la
+función @code{point-stencil}, que establece el sello a un objeto
+con tamaño nulo:
@lilypond[quote,verbatim]
\relative {
En la relación de propiedades que se especifican en la página del
@code{grob-interface} del RFI podemos ver que la propiedad
-@code{transparent} es un valor booleano. Esto se debe establecer a
-@code{#t} para hacer que el grob sea transparente. En el ejemplo
-siguiente vamos a hacer que la indicación de compás, y no las líneas
-divisorias, sea transparente. Para hacerlo tenemos que buscar el
-nombre del grob de la indicación de compás. Volviendo a la página
-@q{All layout objects} del RFI, buscamos las propiedades del objeto de
-presentación @code{TimeSignature}. Se produce por parte del grabador
-@code{Time_signature_engraver} que como puede comprobar vive dentro
-del contexto de @code{Staff} y también contempla el interface
-@code{grob-interface}. Así pues, la instrucción que hace transparente
-a la indicación de compás es:
+@code{transparent} es un valor booleano. Esto se debe establecer
+a @code{#t} para hacer que el grob sea transparente. En el
+ejemplo siguiente vamos a hacer que la indicación de compás, y no
+las líneas divisorias, sea transparente. Para hacerlo tenemos que
+buscar el nombre del grob de la indicación de compás. Volviendo a
+la página @q{All layout objects} del RFI, buscamos las propiedades
+del objeto de presentación @code{TimeSignature}. Se produce por
+parte del grabador @code{Time_signature_engraver} que como puede
+comprobar vive dentro del contexto de @code{Staff} y también
+contempla el interface @code{grob-interface}. Así pues, la
+instrucción que hace transparente a la indicación de compás es:
@cindex TimeSignature, ejemplo de sobreescritura
@cindex transparent, propiedad, ejemplo
@cindex color, propiedad
Para finalizar, intentemos hacer invisibles las barras de compás
-pintándolas de color blanco (hay un problema relacionado, que consiste
-en que la línea divisoria blanca puede tapar o no tapar las líneas del
-pentagrama a las que cruza. Podrá observar en algunos de los ejemplos
-que aparecen a continuación, que esto sucede de forma impredecible.
-Los detalles sobre por qué esto ocurre así, y cómo controlarlo, se
-estudian en @ruser{Pintar los objetos de blanco}; de momento estamos
-estudiando el color, por lo que le rogamos que acepte esta limitación
-por ahora).
+pintándolas de color blanco (hay un problema relacionado, que
+consiste en que la línea divisoria blanca puede tapar o no tapar
+las líneas del pentagrama a las que cruza. Podrá observar en
+algunos de los ejemplos que aparecen a continuación, que esto
+sucede de forma impredecible. Los detalles sobre por qué esto
+ocurre así, y cómo controlarlo, se estudian en @ruser{Pintar los
+objetos de blanco}; de momento estamos estudiando el color, por lo
+que le rogamos que acepte esta limitación por ahora).
El interface @code{grob-interface} especifica que la propiedad del
-color es una lista, pero no hay ninguna explicación sobre lo que debe
-ir en esa lista. La lista que requiere es realmente una lista de
-valores en unidades internas, pero para evitar tener que saber cuáles
-son, se ofrecen varias vías para la especificación de los colores. La
-primera forma es utilizar uno de los colores @q{normales} que están
-relacionados en la primera tabla de la @ruser{Lista de colores}. Para
-poner las líneas divisorias de color blanco, escribimos:
+color es una lista, pero no hay ninguna explicación sobre lo que
+debe ir en esa lista. La lista que requiere es realmente una
+lista de valores en unidades internas, pero para evitar tener que
+saber cuáles son, se ofrecen varias vías para la especificación de
+los colores. La primera forma es utilizar uno de los colores
+@q{normales} que están relacionados en la primera tabla de la
+@ruser{Lista de colores}. Para poner las líneas divisorias de
+color blanco, escribimos:
@cindex BarLine, ejemplo de sobreescritura
@cindex color, propiedad, ejemplo
@end lilypond
@noindent
-y de nuevo podemos comprobar que las barras de compás no son visibles.
-Observe que @emph{white} no viene precedido de un apóstrofo: no es un
-símbolo, sino una @emph{variable}. Cuando se evalúa, proporciona la
-lista de valores internos que se requieren para establecer el color a
-blanco. Los otros colores de la lista normal también son variables.
-Para convencerse de que esto funciona, quizá quiera cambiar el color a
-una de las otras variables de la lista.
+y de nuevo podemos comprobar que las barras de compás no son
+visibles. Observe que @emph{white} no viene precedido de un
+apóstrofo: no es un símbolo, sino una @emph{variable}. Cuando se
+evalúa, proporciona la lista de valores internos que se requieren
+para establecer el color a blanco. Los otros colores de la lista
+normal también son variables. Para convencerse de que esto
+funciona, quizá quiera cambiar el color a una de las otras
+variables de la lista.
@cindex colores de X11
@cindex X11, colores de
@funindex rgb-color
Aún existe otra función, que convierte valores RGB en colores
-internos: la función @code{rgb-color}. Toma tres argumentos que dan
-las intensidades de rojo, verde y azul. Cada uno de ellos puede tomar
-valores entre 0 y 1. Por lo tanto, para establecer el color a rojo el
-valor debe ser @code{(rgb-color 1 0 0)} y para blanco debe ser
-@code{(rgb-color 1 1 1)}:
+internos: la función @code{rgb-color}. Toma tres argumentos que
+dan las intensidades de rojo, verde y azul. Cada uno de ellos
+puede tomar valores entre 0 y 1. Por lo tanto, para establecer el
+color a rojo el valor debe ser @code{(rgb-color 1 0 0)} y para
+blanco debe ser @code{(rgb-color 1 1 1)}:
@cindex BarLine, ejemplo de sobreescritura
@cindex color, propiedad, ejemplo
Finalmente, existe también una escala de grises como parte del
conjunto de colores de X11. Varían desde el negro, @code{'grey0},
-hasta el blanco, @code{'grey100}, en pasos de 1. Vamos a ilustrar esto
-estableciendo todos los objetos de presentación de nuestro ejemplo a
-varias gradaciones de gris:
+hasta el blanco, @code{'grey100}, en pasos de 1. Vamos a ilustrar
+esto estableciendo todos los objetos de presentación de nuestro
+ejemplo a varias gradaciones de gris:
@cindex StaffSymbol, ejemplo de sobreescritura
@cindex TimeSignature, ejemplo de sobreescritura
@noindent
Observe los contextos asociados con cada uno de los objetos de
-presentación. Es importante que estén correctamente escritos, o las
-instrucciones ¡no funcionarán! Recuerde que el contexto es aquel en
-que se encuentra el grabador correspondiente. El contesto
-predeterminado para los grabadores puede encontrarse empezando por el
-objeto de presentación, de ahí al grabador que lo produce, y en la
-página del grabador del RFI aparece en qué contexto se puede encontrar
-normalmente el grabador.
+presentación. Es importante que estén correctamente escritos, o
+las instrucciones ¡no funcionarán! Recuerde que el contexto es
+aquel en que se encuentra el grabador correspondiente. El
+contesto predeterminado para los grabadores puede encontrarse
+empezando por el objeto de presentación, de ahí al grabador que lo
+produce, y en la página del grabador del RFI aparece en qué
+contexto se puede encontrar normalmente el grabador.
@node Tamaño de los objetos
}
@end lilypond
-Los fragmentos de Ossia se escriben normalmente sin clave ni compás, y
-por lo normal se imprimen más pequeños que el pentagrama principal.
-Ya sabemos cómo quitar la clave y el compás: simplemente establecemos
-el sello de cada uno de ellos a @code{#f}, como sigue:
+Los fragmentos de Ossia se escriben normalmente sin clave ni
+compás, y por lo normal se imprimen más pequeños que el pentagrama
+principal. Ya sabemos cómo quitar la clave y el compás:
+simplemente establecemos el sello de cada uno de ellos a
+@code{#f}, como sigue:
@cindex alignAboveContext, propiedad, ejemplo
@cindex @code{\with}, ejemplo
@end lilypond
@noindent
-donde el par de llaves adicional después de la cláusula @code{\with}
-es necesario para asegurar que la sobreescritura encerrada y la música
-se aplican al pentagrama de ossia.
-
-Pero ¿cuál es la diferencia entre modificar el contexto de pentagrama
-usando @code{\with} y modificar los sellos de clave y de compás con
-\override, o en este caso
-@code{\omit}? La diferencia principal es que los cambios que se realizan
-en una cláusula @code{\with} se hacen en el momento en que se crea el
-contexto, y permanecen activos como valores @strong{predeterminados}
-durante toda la duración de dicho contexto, mientras que las
-instrucciones @code{\set} o @code{\override} incluidas dentro de la
-música son dinámicas: hacen cambios sincronizados con un punto
-concreto de la música. Si los cambios se deshacen o se devuelven
-mediante @code{\unset} o @code{\revert} volverán a su valor
-predeterminado que será el establecido en la cláusula @code{\with}, o
-si no se ha establecido ninguno en este lugar, los valores
-predeterminados normales.
-
-Ciertas propiedades de contexto se pueden modificar solamente dentro
-de cláusulas @code{\with}. Son aquellas propiedades que no se pueden
-cambiar después de que el contexto se ha creado.
-@code{alignAboveContext} y su compañero, @code{alignBelowContext}, son
-dos de tales propiedades: una vez que el pentagrama se ha creado, su
-alineación está decidida y no tendría sentido intentar cambiarla más
-tarde.
+donde el par de llaves adicional después de la cláusula
+@code{\with} es necesario para asegurar que la sobreescritura
+encerrada y la música se aplican al pentagrama de ossia.
+
+Pero ¿cuál es la diferencia entre modificar el contexto de
+pentagrama usando @code{\with} y modificar los sellos de clave y
+de compás con \override, o en este caso @code{\omit}? La
+diferencia principal es que los cambios que se realizan en una
+cláusula @code{\with} se hacen en el momento en que se crea el
+contexto, y permanecen activos como valores
+@strong{predeterminados} durante toda la duración de dicho
+contexto, mientras que las instrucciones @code{\set} o
+@code{\override} incluidas dentro de la música son dinámicas:
+hacen cambios sincronizados con un punto concreto de la música.
+Si los cambios se deshacen o se devuelven mediante @code{\unset} o
+@code{\revert} volverán a su valor predeterminado que será el
+establecido en la cláusula @code{\with}, o si no se ha establecido
+ninguno en este lugar, los valores predeterminados normales.
+
+Ciertas propiedades de contexto se pueden modificar solamente
+dentro de cláusulas @code{\with}. Son aquellas propiedades que no
+se pueden cambiar después de que el contexto se ha creado.
+@code{alignAboveContext} y su compañero, @code{alignBelowContext},
+son dos de tales propiedades: una vez que el pentagrama se ha
+creado, su alineación está decidida y no tendría sentido intentar
+cambiarla más tarde.
Los valores predeterminados de las propiedades de los objetos de
presentación también se pueden establecer dentro de cláusulas
@code{\with}. Simplemente utilice la instrucción @code{\override}
-normal dejando aparte el nombre del contexto, ya que está definido sin
-ambigüedad como el contexto que la cláusula @code{\with} está
+normal dejando aparte el nombre del contexto, ya que está definido
+sin ambigüedad como el contexto que la cláusula @code{\with} está
modificando. De hecho, se producirá un error si se especifica un
contexto en este lugar.
}
@end lilypond
-Finalmente llegamos a la forma de cambiar el tamaño de los objetos de
-presentación.
-
-Ciertos objetos de presentación se crean como glifos sacados de una
-fuente tipográfica. Entre ellos se encuentran las cabezas,
-alteraciones, elementos de marcado, claves, indicaciones de compás,
-indicaciones dinámicas y la letra de las canciones. Su tamaño se
-cambia mediante la modificación de la propiedad @code{font-size}, como
-veremos en breve. Otros objetos de presentación como ligaduras de
-unión y de expresión (en general, objetos de extensión) se trazan
-individualmente, por lo que no hay un tamaño de tipografía
-@code{font-size} asociado a ellos. Estos objetos generalmente derivan
-su tamaño de los objetos a los que están adosados, y por ello
-normalmente no hay necesidad de cambiarles el tamaño manualmente. Aún
-otras propiedades como la longitud de las plicas y las barras de
-compás, el grosor de las barras de corchea y otras líneas, y la
-separación de las líneas del pentagrama se deben modificar de otras
-formas especiales.
+Finalmente llegamos a la forma de cambiar el tamaño de los objetos
+de presentación.
+
+Ciertos objetos de presentación se crean como glifos sacados de
+una fuente tipográfica. Entre ellos se encuentran las cabezas,
+alteraciones, elementos de marcado, claves, indicaciones de
+compás, indicaciones dinámicas y la letra de las canciones. Su
+tamaño se cambia mediante la modificación de la propiedad
+@code{font-size}, como veremos en breve. Otros objetos de
+presentación como ligaduras de unión y de expresión (en general,
+objetos de extensión) se trazan individualmente, por lo que no hay
+un tamaño de tipografía @code{font-size} asociado a ellos. Estos
+objetos generalmente derivan su tamaño de los objetos a los que
+están adosados, y por ello normalmente no hay necesidad de
+cambiarles el tamaño manualmente. Aún otras propiedades como la
+longitud de las plicas y las barras de compás, el grosor de las
+barras de corchea y otras líneas, y la separación de las líneas
+del pentagrama se deben modificar de otras formas especiales.
Volviendo al ejemplo del ossia, vamos a cambiar en primer lugar el
tamaño de la tipografía. Podemos hacerlo de dos formas. Podemos
\override NoteHead.font-size = #-2
@end example
-o podemos cambiar el tamaño de todas las tipografías estableciendo una
-propiedad especial, @code{fontSize}, utilizando @code{\set}, o
-mediante su inclusión dentro de una cláusula @code{\with} (pero sin el
-@code{\set}).
+o podemos cambiar el tamaño de todas las tipografías estableciendo
+una propiedad especial, @code{fontSize}, utilizando @code{\set}, o
+mediante su inclusión dentro de una cláusula @code{\with} (pero
+sin el @code{\set}).
@example
\set fontSize = #-2
@end example
Los dos enunciados producirían una reducción del tamaño de la
-tipografía en dos pasos a partir de su valor previo, donde cada paso
-reduce o aumenta el tamaño aproximadamente en un 12%.
+tipografía en dos pasos a partir de su valor previo, donde cada
+paso reduce o aumenta el tamaño aproximadamente en un 12%.
Vamos a probarlo en nuestro ejemplo del ossia:
}
@end lilypond
-Aún no está demasiado bien. Las cabezas y los corchetes de las notas
-son más pequeños, pero las plicas son demasiado largas en proporción,
-y las líneas del pentagrama están demasiado separadas entre sí. Se
-debe reducir su escala en proporción a la reducción de la tipografía.
-El siguiente apartado trata sobre cómo se hace esto.
+Aún no está demasiado bien. Las cabezas y los corchetes de las
+notas son más pequeños, pero las plicas son demasiado largas en
+proporción, y las líneas del pentagrama están demasiado separadas
+entre sí. Se debe reducir su escala en proporción a la reducción
+de la tipografía. El siguiente apartado trata sobre cómo se hace
+esto.
@node Longitud y grosor de los objetos
@subsection Longitud y grosor de los objetos
Las distancias y longitudes en LilyPond se miden generalmente en
espacios de pentagrama, la distancia entre líneas adyacentes de la
-pauta (o de manera ocasional medios espacios), mientras que la mayoría
-de las propiedades de @code{thickness} (grosor) se miden en unidades
-de una propiedad interna llamada @code{line-thickness.} Por ejemplo,
-de forma predeterminada, a las líneas de los reguladores se les da un
-grosor de 1 unidad de @code{line-thickness}, mientras que el
-@code{thickness} de una plica es 1.3. Observe sin embargo que ciertas
-propiedades de grosor son diferentes; por ejemplo, el grosor de las
-barras de corchea se controla por medio del valor de
-@code{beam-thickness}, que se mide en espacios de pentagrama.
-
-Entonces ¿cómo se tienen que escalar las longitudes en proporción al
-tamaño de la tipografía? Se puede hacer con la ayuda de una función
-especial que se llama @code{magstep}, pensada especialmente para este
-propósito. Toma un argumento, el cambio de tamaño de la tipografía
-(#-2 en nuestro ejemplo) y devuelve un factor de escalado adecuado
-para reducir otros objetos en la misma proporción. Se usa de la
-siguiente forma:
+pauta (o de manera ocasional medios espacios), mientras que la
+mayoría de las propiedades de @code{thickness} (grosor) se miden
+en unidades de una propiedad interna llamada
+@code{line-thickness.} Por ejemplo, de forma predeterminada, a
+las líneas de los reguladores se les da un grosor de 1 unidad de
+@code{line-thickness}, mientras que el @code{thickness} de una
+plica es 1.3. Observe sin embargo que ciertas propiedades de
+grosor son diferentes; por ejemplo, el grosor de las barras de
+corchea se controla por medio del valor de @code{beam-thickness},
+que se mide en espacios de pentagrama.
+
+Entonces ¿cómo se tienen que escalar las longitudes en proporción
+al tamaño de la tipografía? Se puede hacer con la ayuda de una
+función especial que se llama @code{magstep}, pensada
+especialmente para este propósito. Toma un argumento, el cambio
+de tamaño de la tipografía (#-2 en nuestro ejemplo) y devuelve un
+factor de escalado adecuado para reducir otros objetos en la misma
+proporción. Se usa de la siguiente forma:
@cindex alignAboveContext, propiedad, ejemplo
@cindex @code{\with}, ejemplo
@noindent
Puesto que la longitud de las plicas y muchas otras propiedades
-relacionadas con la longitudes calculan siempre con relación al valor
-de la propiedad @code{staff-space}, su longitud también ve reducida su
-escala automáticamente. Observe que esto afecta solamente a la escala
-vertical del ossia: la escala horizontal se determina por medio de la
-disposición de la música principal con el objeto de mantenerse en
-sincronía con ella, de forma que no resulte afectada por ninguno de
-estos cambios de tamaño. Por supuesto, si la escala de toda la música
-principal se cambiase de esta forma, entonces el espaciado horizontal
-se vería afectado. Trataremos de esto más tarde en la sección sobre
-la disposición.
+relacionadas con la longitudes calculan siempre con relación al
+valor de la propiedad @code{staff-space}, su longitud también ve
+reducida su escala automáticamente. Observe que esto afecta
+solamente a la escala vertical del ossia: la escala horizontal se
+determina por medio de la disposición de la música principal con
+el objeto de mantenerse en sincronía con ella, de forma que no
+resulte afectada por ninguno de estos cambios de tamaño. Por
+supuesto, si la escala de toda la música principal se cambiase de
+esta forma, entonces el espaciado horizontal se vería afectado.
+Trataremos de esto más tarde en la sección sobre la disposición.
Esto, en fin, completa la creación de un ossia. Los tamaños y
longitudes del resto de los objetos se pueden modificar de manera
Para cambios de escala pequeños, como en el ejemplo de arriba, el
grosor de las diversas líneas dibujadas como divisorias, barras de
-corchea, reguladores, ligaduras, etc, no requieren normalmente ningún
-ajuste global. Si el grosor de cualquier objeto de presentación en
-particular necesita ajustarse, se puede hacer mejor mediante la
-sobreescritura de su propiedad @code{thickness}. Anteriormente
-mostramos un ejemplo de cambio de grosor en las ligaduras, en
-@ref{Propiedades de los objetos de presentación}. El grosor de todos los objetos
-trazados (es decir, aquellos que no se producen a partir de una
-tipografía) se pueden cambiar de la misma forma.
+corchea, reguladores, ligaduras, etc, no requieren normalmente
+ningún ajuste global. Si el grosor de cualquier objeto de
+presentación en particular necesita ajustarse, se puede hacer
+mejor mediante la sobreescritura de su propiedad @code{thickness}.
+Anteriormente mostramos un ejemplo de cambio de grosor en las
+ligaduras, en @ref{Propiedades de los objetos de presentación}.
+El grosor de todos los objetos trazados (es decir, aquellos que no
+se producen a partir de una tipografía) se pueden cambiar de la
+misma forma.
@node Colocación de los objetos
@cindex objetos dentro del pentagrama
@cindex objetos fuera del pentagrama
-Hay ciertos objetos en notación musical que pertenecen al pentagrama y
-otros cuyo lugar se sitúa fuera del pentagrama. Reciben el nombre de
-objetos dentro-del-pentagrama y objetos fuera-del-pentagrama,
-respectivamente.
+Hay ciertos objetos en notación musical que pertenecen al
+pentagrama y otros cuyo lugar se sitúa fuera del pentagrama.
+Reciben el nombre de objetos dentro-del-pentagrama y objetos
+fuera-del-pentagrama, respectivamente.
Los objetos dentro-del-pentagrama son los que se sitúan sobre la
-pauta: cabezas, plicas, alteraciones, etc. Sus posiciones normalmente
-se fijan por la propia música; se posicionan verticalmente sobre
-líneas específicas del pentagrama o están unidos a otros objetos
-posicionados de esta forma. Las colisiones entre cabezas, plicas y
-alteraciones en acordes de notas muy juntas, normalmente se evitan
-automáticamente. Hay instrucciones y sobreescrituras que pueden
-modificar este comportamiento automático, como veremos en breve.
-
-Entre los objetos que pertenecen al exterior de la pauta se encuentran
-cosas como las marcas de ensayo, las marcas de texto y las de
-dinámica. La regla de LilyPond para la colocación vertical de los
-objetos fuera-de-pentagrama es colocarlos tan cerca del pentagrama
-como sea posible, pero no tan cerca como para que puedan chocar con
-algún otro objeto. LilyPond utiliza la propiedad
-@code{outside-staff-priority} para determinar el orden en que se deben
-situar los objetos, como veremos ahora.
+pauta: cabezas, plicas, alteraciones, etc. Sus posiciones
+normalmente se fijan por la propia música; se posicionan
+verticalmente sobre líneas específicas del pentagrama o están
+unidos a otros objetos posicionados de esta forma. Las colisiones
+entre cabezas, plicas y alteraciones en acordes de notas muy
+juntas, normalmente se evitan automáticamente. Hay instrucciones
+y sobreescrituras que pueden modificar este comportamiento
+automático, como veremos en breve.
+
+Entre los objetos que pertenecen al exterior de la pauta se
+encuentran cosas como las marcas de ensayo, las marcas de texto y
+las de dinámica. La regla de LilyPond para la colocación vertical
+de los objetos fuera-de-pentagrama es colocarlos tan cerca del
+pentagrama como sea posible, pero no tan cerca como para que
+puedan chocar con algún otro objeto. LilyPond utiliza la
+propiedad @code{outside-staff-priority} para determinar el orden
+en que se deben situar los objetos, como veremos ahora.
En primer lugar, LilyPond sitúa todos los objetos
dentro-del-pentagrama. Después ordena los objetos
fuera-del-pentagrama de acuerdo con su prioridad
-@code{outside-staff-priority}. Los objetos fuera-del-pentagrama se
-toman de uno en uno, comenzando por el que tiene la prioridad
-@code{outside-staff-priority} más baja, y se sitúan de forma que no
-colisionen con ningún objeto que se haya colocado ya. Esto es, si dos
-grobs fuera-del-pentagrama compiten por el mismo espacio, el que tiene
-la prioridad @code{outside-staff-priority} más baja se colocará más
-cerca del pentagrama. Si dos objetos tienen la misma
-@code{outside-staff-priority}, el que se ha encontrado primero se
-situará más cerca de la pauta.
-
-En el siguiente ejemplo, todos los textos de marcado tienen la misma
-prioridad (pues no se ha establecido explícitamente). Observe que
-@q{Text3} se posiciona de nuevo automáticamente cerca del pentagrama,
-acomodado por debajo de @q{Text2}.
+@code{outside-staff-priority}. Los objetos fuera-del-pentagrama
+se toman de uno en uno, comenzando por el que tiene la prioridad
+@code{outside-staff-priority} más baja, y se sitúan de forma que
+no colisionen con ningún objeto que se haya colocado ya. Esto es,
+si dos grobs fuera-del-pentagrama compiten por el mismo espacio,
+el que tiene la prioridad @code{outside-staff-priority} más baja
+se colocará más cerca del pentagrama. Si dos objetos tienen la
+misma @code{outside-staff-priority}, el que se ha encontrado
+primero se situará más cerca de la pauta.
+
+En el siguiente ejemplo, todos los textos de marcado tienen la
+misma prioridad (pues no se ha establecido explícitamente).
+Observe que @q{Text3} se posiciona de nuevo automáticamente cerca
+del pentagrama, acomodado por debajo de @q{Text2}.
@cindex markup, ejemplo
c''2^"Text4" |
@end lilypond
-Los pentagramas también se posicionan, de forma predeterminada, tan
-cerca unos de otros como sea posible (sujeto a una separación mínima).
-Si las notas se proyectan muy lejos en dirección a un pentagrama
-adyacente, forzarán a alejarse a los pentagramas sólo si en caso
-contrario fuese a ocurrir un solapamiento de la notación. El ejemplo
-siguiente muestra esta acomodación @q{nestling} de las notas sobre
-pentagramas adyacentes:
+Los pentagramas también se posicionan, de forma predeterminada,
+tan cerca unos de otros como sea posible (sujeto a una separación
+mínima). Si las notas se proyectan muy lejos en dirección a un
+pentagrama adyacente, forzarán a alejarse a los pentagramas sólo
+si en caso contrario fuese a ocurrir un solapamiento de la
+notación. El ejemplo siguiente muestra esta acomodación
+@q{nestling} de las notas sobre pentagramas adyacentes:
@lilypond[quote,ragged-right,verbatim]
<<
@subsection Objetos interiores al pentagrama
@translationof Within-staff objects
-Ya hemos visto cómo las instrucciones @code{\voiceXXX} afectan a la
-dirección de las ligaduras de expresión y de unión, digitaciones y
-todo lo demás que dependa de la dirección de las plicas (véase
-@ref{Voces explícitas}). Cuando se
-escribe música polifónica, estas instrucciones son esenciales para que
-puedan distinguirse varias líneas melódicas entrelazadas. Pero
-ocasionalmente puede ser necesario sobreescribir este comportamiento
-automático. Se puede hacer por secciones de música completas o
-incluso para una nota individual. La propiedad que controla este
-comportamiento es la propiedad de @code{direction} (dirección) de cada
-objeto de presentación. En primer lugar explicaremos qué hace esto, y
-luego introduciremos algunas instrucciones listas para usar que le
-evitarán tener que codificar sobreescrituras explícitas para las
-modificaciones más comunes.
+Ya hemos visto cómo las instrucciones @code{\voiceXXX} afectan a
+la dirección de las ligaduras de expresión y de unión,
+digitaciones y todo lo demás que dependa de la dirección de las
+plicas (véase @ref{Voces explícitas}). Cuando se escribe música
+polifónica, estas instrucciones son esenciales para que puedan
+distinguirse varias líneas melódicas entrelazadas. Pero
+ocasionalmente puede ser necesario sobreescribir este
+comportamiento automático. Se puede hacer por secciones de música
+completas o incluso para una nota individual. La propiedad que
+controla este comportamiento es la propiedad de @code{direction}
+(dirección) de cada objeto de presentación. En primer lugar
+explicaremos qué hace esto, y luego introduciremos algunas
+instrucciones listas para usar que le evitarán tener que codificar
+sobreescrituras explícitas para las modificaciones más comunes.
Algunos objetos de presentación como las ligaduras se curvan hacia
-arriba o hacia abajo; otros como las plicas y los corchetes también se
-mueven a la derecha o a la izquierda cuando apuntan hacia arriba o
-hacia abajo. Esto se controla automáticamente cuando está establecida
-la propiedad @code{direction}.
+arriba o hacia abajo; otros como las plicas y los corchetes
+también se mueven a la derecha o a la izquierda cuando apuntan
+hacia arriba o hacia abajo. Esto se controla automáticamente
+cuando está establecida la propiedad @code{direction}.
@menu
* La propiedad direction (dirección)::
@cindex center
@cindex neutral
-The following example shows the default positioning of slurs in the
-first bar, with slurs starting on high notes positioned above the notes
-and those starting on low notes positioned below, followed by a bar
-with both slurs forced down, a bar with both slurs forced up, and
-finally a bar with both slurs reverted back to the default behavior.
+El ejemplo siguiente muestra en el primer compás la colocación
+predeterminada de las ligaduras de expresión, estando por encima
+las que comienzan en notas agudas y por debajo las que comienzan
+en notas graves, seguido de un compás con ambas ligaduras forzadas
+hacia abajo, otro compás con las dos forzadas hacia arriba y por
+último un compás con las ligaduras devueltas a su comportamiento
+predeterminado.
@cindex Slur, ejemplo de sobreescritura
@cindex direction, propiedad, ejemplo
(arriba). Éstos tienen los valores @w{@code{-1}} y @code{+1}
respectivamente, y dichos valores numéricos también se pueden usar
directamente. El valor @code{0} también se puede usar en algunos
-casos. Se trata simplemente con el significado de @code{UP} para las
-ligaduras de expresión, pero para algunos objetos tiene el significado de
-@q{centrado}. Existe una constante @code{CENTER} que tiene el valor
-@code{0}.
+casos. Se trata simplemente con el significado de @code{UP} para
+las ligaduras de expresión, pero para algunos objetos tiene el
+significado de @q{centrado}. Existe una constante @code{CENTER}
+que tiene el valor @code{0}.
Sin embargo, estas sobreescrituras no se usan muy a menudo porque
están disponibles instrucciones predefinidas equivalentes más
@code{\once} de la misma forma en que lo haría con las
sobreescrituras explícitas.
-Or, if just a single layout object needs to be forced up or down, the
-direction indicators, @code{^} or @code{_}, may be used:
+O bien, si un único objeto de presentación necesita forzarse hacia
+arriba o hacia abajo, pueden usarse los indicadores de dirección,
+@code{^} o @code{_}:
@lilypond[quote,fragment,verbatim]
a'4( g') c''( a') |
@cindex digitación, colocación
@cindex digitación de acordes
-La colocación de las digitaciones sobre notas sueltas también se puede
-controlar mediante la propiedad @code{direction}, pero los cambios
-sobre @code{direction} no tienen ningún efecto sobre las notas de los
-acordes. Como veremos, existen instrucciones especiales que permiten
-controlar las digitaciones de notas individuales, situando la
-digitación encima, debajo, a la izquierda o a la derecha de cada nota.
+La colocación de las digitaciones sobre notas sueltas también se
+puede controlar mediante la propiedad @code{direction}, pero los
+cambios sobre @code{direction} no tienen ningún efecto sobre las
+notas de los acordes. Como veremos, existen instrucciones
+especiales que permiten controlar las digitaciones de notas
+individuales, situando la digitación encima, debajo, a la
+izquierda o a la derecha de cada nota.
En primer lugar, he aquí el efecto de @code{direction} sobre las
digitaciones aplicadas a notas sueltas. Se muestra en el primer
}
@end lilypond
-Sin embargo, la sobreescritura de la propiedad @code{direction} no es
-la forma más sencilla de especificar manualmente la digitación por
-encima o por debajo de las notas; suele ser preferible usar @code{_} o
-@code{^} en lugar de @code{-}, antes del número de la digitación.
-Este es el ejemplo anterior utilizando este método:
+Sin embargo, la sobreescritura de la propiedad @code{direction} no
+es la forma más sencilla de especificar manualmente la digitación
+por encima o por debajo de las notas; suele ser preferible usar
+@code{_} o @code{^} en lugar de @code{-}, antes del número de la
+digitación. Este es el ejemplo anterior utilizando este método:
@cindex fingering, ejemplo
@cindex digitación, ejemplo
La propiedad @code{direction} se ignora para los acordes, pero los
prefijos direccionales @code{_} y @code{^} sí funcionan. De forma
-predeterminada, las digitaciones se colocan automáticamente encima y
-debajo de las notas de un acorde, como se muestra aquí:
+predeterminada, las digitaciones se colocan automáticamente encima
+y debajo de las notas de un acorde, como se muestra aquí:
@cindex fingering, ejemplo
@cindex digitación, ejemplo
@end lilypond
@noindent
-pero se puede forzar de manera que todos o algunos de los números de
-digitación estén por encima o por debajo:
+pero se puede forzar de manera que todos o algunos de los números
+de digitación estén por encima o por debajo:
@cindex fingering, ejemplo
@cindex digitación, ejemplo
@noindent
se utiliza @code{\set} porque @code{fingeringOrientations} es una
-propiedad del contexto @code{Voice}, creado y usado por el grabador
-@code{New_fingering_engraver}.
-
-La propiedad se puede establecer al valor de una lista de entre uno y
-tres valores. Controla si las digitaciones se pueden colocar por
-encima (si @code{up} aparece en la lista), por debajo (si aparece
-@code{down}), a la izquierda (si aparece @code{left}) o a la derecha
-(si aparece @code{right}). A la inversa, si una colocación no está en
-la lista, no se sitúa ninguna digitación en dicho lugar. LilyPond
-coma estas restricciones y se trabaja la mejor colocación para la
-digitación de las notas de los acordes que siguen. Observe que
-@code{left} y @code{right} son mutuamente excluyentes: las
-digitaciones pueden situarse en un lado o en el otro, no en los dos.
+propiedad del contexto @code{Voice}, creado y usado por el
+grabador @code{New_fingering_engraver}.
+
+La propiedad se puede establecer al valor de una lista de entre
+uno y tres valores. Controla si las digitaciones se pueden
+colocar por encima (si @code{up} aparece en la lista), por debajo
+(si aparece @code{down}), a la izquierda (si aparece @code{left})
+o a la derecha (si aparece @code{right}). A la inversa, si una
+colocación no está en la lista, no se sitúa ninguna digitación en
+dicho lugar. LilyPond coma estas restricciones y se trabaja la
+mejor colocación para la digitación de las notas de los acordes
+que siguen. Observe que @code{left} y @code{right} son mutuamente
+excluyentes: las digitaciones pueden situarse en un lado o en el
+otro, no en los dos.
@warning{Para controlar la colocación de la digitación de una sola
-nota usando esta instrucción es necesario escribirla como un acorde de
-una sola nota encerrándola entre ángulos simples.}
+nota usando esta instrucción es necesario escribirla como un
+acorde de una sola nota encerrándola entre ángulos simples.}
Aquí podemos ver algunos ejemplos:
@noindent
Si la digitación parece un poco superpoblada, se puede reducir el
-tamaño @code{font-size}. El valor predeterminado puede verse en el
-objeto @code{Fingering} del RFI que es @w{@code{-5}}, así que probaremos
-@w{@code{-7}}:
+tamaño @code{font-size}. El valor predeterminado puede verse en
+el objeto @code{Fingering} del RFI que es @w{@code{-5}}, así que
+probaremos @w{@code{-7}}:
@lilypond[quote,ragged-right,verbatim]
\relative {
@subsection Objetos fuera del pentagrama
@translationof Outside-staff objects
-Los objetos fuera-del-pentagrama se sitúan automáticamente para evitar
-las colisiones. Existen varias formas de sobreescribir la colocación
-automática si el posicionado no resulta óptimo.
+Los objetos fuera-del-pentagrama se sitúan automáticamente para
+evitar las colisiones. Existen varias formas de sobreescribir la
+colocación automática si el posicionado no resulta óptimo.
@menu
* La propiedad outside-staff-priority (prioridad fuera del pentagrama)::
@translationof The outside-staff-priority property
Los objetos fuera-del-pentagrama se colocan automáticamente para
-evitar las colisiones. Los objetos que tienen el valor más bajo de la
-propiedad @code{outside-staff-priority} se sitúan más cerca del
-pentagrama, y entonces otros objetos fuera-del-pentagrama se elevan
-tanto como sea necesario para evitar la colisión. La prioridad
-@code{outside-staff-priority} se defina en el @code{grob-interface} y
-así es una propiedad de todos los objetos de presentación. De forma
-predeterminada se establece a @code{#f} para todos los objetos
-dentro-del-pentagrama, y a un valor numérico adecuado a cada objeto
-fuera-del-pentagrama cuando se crea el objeto. La tabla siguiente
-presenta los valores numéricos predeterminados para algunos de los
-objetos fuera-del-pentagrama más comunes.
+evitar las colisiones. Los objetos que tienen el valor más bajo
+de la propiedad @code{outside-staff-priority} se sitúan más cerca
+del pentagrama, y entonces otros objetos fuera-del-pentagrama se
+elevan tanto como sea necesario para evitar la colisión. La
+prioridad @code{outside-staff-priority} se defina en el
+@code{grob-interface} y así es una propiedad de todos los objetos
+de presentación. De forma predeterminada se establece a @code{#f}
+para todos los objetos dentro-del-pentagrama, y a un valor
+numérico adecuado a cada objeto fuera-del-pentagrama cuando se
+crea el objeto. La tabla siguiente presenta los valores numéricos
+predeterminados para algunos de los objetos fuera-del-pentagrama
+más comunes.
@cindex objetos de extensión
Observe los nombres algo inusuales de algunos de los objetos: los
objetos de extensión se crean automáticamente para controlar el
-posicionamiento vertical de los grobs que (quizá) comienzan y terminan
-en distintos momentos musicales, de manera que cualquier modificación
-a la prioridad @code{outside-staff-priority} del grob subyacente no
-tiene ningún efecto. Por ejemplo, cambiar la
-@code{outside-staff-priority} del objeto de regulador @code{Hairpin}
-no tiene efecto sobre la posición vertical de los reguladores: en
-lugar de eso, tenemos que cambiar la @code{outside-staff-priority} del
-objeto asociado @code{DynamicLineSpanner}. Esta sobreescritura se
-debe escribir al comienzo del objeto de extensión, que podría incluir
-varios reguladores o matices dinámicos encadenados.
+posicionamiento vertical de los grobs que (quizá) comienzan y
+terminan en distintos momentos musicales, de manera que cualquier
+modificación a la prioridad @code{outside-staff-priority} del grob
+subyacente no tiene ningún efecto. Por ejemplo, cambiar la
+@code{outside-staff-priority} del objeto de regulador
+@code{Hairpin} no tiene efecto sobre la posición vertical de los
+reguladores: en lugar de eso, tenemos que cambiar la
+@code{outside-staff-priority} del objeto asociado
+@code{DynamicLineSpanner}. Esta sobreescritura se debe escribir
+al comienzo del objeto de extensión, que podría incluir varios
+reguladores o matices dinámicos encadenados.
@multitable @columnfractions .3 .3 .3
@headitem Objeto de presentación
@tab Trinos mantenidos
@end multitable
-He aquí un ejemplo que muestra la situación predeterminada de algunos
-de ellos.
+He aquí un ejemplo que muestra la situación predeterminada de
+algunos de ellos.
@cindex texto, extensiones de
@cindex octava alta y baja, corchete de
@end lilypond
Este ejemplo también muestra cómo crear textos con extensión (Text
-Spanners): textos con líneas extensoras por encima de una sección de
-música. El extensor abarca desde la instrucción @code{\startTextSpan}
-hasta la instrucción @code{\stopTextSpan}, y el formado del texto se
-define por medio de la instrucción @code{\override TextSpanner}. Para
-ver más detalles, consulte @ruser{Extensiones de texto}.
+Spanners): textos con líneas extensoras por encima de una sección
+de música. El extensor abarca desde la instrucción
+@code{\startTextSpan} hasta la instrucción @code{\stopTextSpan}, y
+el formado del texto se define por medio de la instrucción
+@code{\override TextSpanner}. Para ver más detalles, consulte
+@ruser{Extensiones de texto}.
-También muestra la manera de crear corchetes de octava alta y baja.
+También muestra la manera de crear corchetes de octava alta y
+baja.
@cindex trucar la situación de los números de compás
@cindex números de compás, ajustar posición
@cindex trucar la situación de las letras de ensayo
@cindex ensayo, letras, trucar la colocación
-Si los valores predeterminados de @code{outside-staff-priority} no le
-ofrecen las colocaciones deseadas se puede sobreescribir la prioridad
-de cualquiera de los objetos. Suponga que quisiéramos que el corchete
-de octava estuviera situado por debajo del elemento extensor de texto
-en el ejemplo de arriba. Todo lo que debemos hacer es localizar la
-prioridad de @code{OttavaBracket} en el RFI o en las tablas
-anteriores, y reducirlo a un valor inferior al de @code{TextSpanner},
-recordando que @code{OttavaBracket} se crea dentro del contexto de
-@code{Staff}:
+Si los valores predeterminados de @code{outside-staff-priority} no
+le ofrecen las colocaciones deseadas se puede sobreescribir la
+prioridad de cualquiera de los objetos. Suponga que quisiéramos
+que el corchete de octava estuviera situado por debajo del
+elemento extensor de texto en el ejemplo de arriba. Todo lo que
+debemos hacer es localizar la prioridad de @code{OttavaBracket} en
+el RFI o en las tablas anteriores, y reducirlo a un valor inferior
+al de @code{TextSpanner}, recordando que @code{OttavaBracket} se
+crea dentro del contexto de @code{Staff}:
@cindex TextSpanner, ejemplo de sobreescritura
@cindex bound-details, propiedad, ejemplo
Observe que algunos de estos objetos, concretamente los números de
compás, las indicaciones metronómicas y las letras de ensayo, se
-alojan de forma predeterminada dentro del contexto @code{Score}; así
-pues, debe asegurarse de que utiliza el contexto adecuado cuando se
-sobreescriben sus propiedades.
+alojan de forma predeterminada dentro del contexto @code{Score};
+así pues, debe asegurarse de que utiliza el contexto adecuado
+cuando se sobreescriben sus propiedades.
@cindex ligaduras y outside-staff-priority
@cindex ligaduras y articulaciones
@cindex articulaciones y ligaduras
-De forma predeterminada, las ligaduras de expresión están clasificadas
-como objetos dentro-del-pentagrama, pero con frecuencia aparecen
-encima del pentagrama si las notas que une son muy agudas. Ello puede
-empujar a una posición muy elevada a los objetos fuera-del-pentagrama
-como las articulaciones, pues la ligadura se colocará en primer lugar.
-La propiedad @code{avoid-slur} de la articulación se puede establecer
-al valor @code{'inside} (por dentro) para llevarla al interior de la
-ligadura, pero la propiedad @code{avoid-slur} es efectiva solamente si
-la prioridad @code{outside-staff-priority} está también ajustada al
-valor @code{#f}. De forma alternativa, la prioridad
-@code{outside-staff-priority} de la ligadura se puede fijar en un
-valor numérico para hacer que se sitúe en línea con otros objetos
-fuera del pentagrama de acuerdo con este valor. He aquí un ejemplo
-que muestra el efecto de los dos métodos:
+De forma predeterminada, las ligaduras de expresión están
+clasificadas como objetos dentro-del-pentagrama, pero con
+frecuencia aparecen encima del pentagrama si las notas que une son
+muy agudas. Ello puede empujar a una posición muy elevada a los
+objetos fuera-del-pentagrama como las articulaciones, pues la
+ligadura se colocará en primer lugar. La propiedad
+@code{avoid-slur} de la articulación se puede establecer al valor
+@code{'inside} (por dentro) para llevarla al interior de la
+ligadura, pero la propiedad @code{avoid-slur} es efectiva
+solamente si la prioridad @code{outside-staff-priority} está
+también ajustada al valor @code{#f}. De forma alternativa, la
+prioridad @code{outside-staff-priority} de la ligadura se puede
+fijar en un valor numérico para hacer que se sitúe en línea con
+otros objetos fuera del pentagrama de acuerdo con este valor. He
+aquí un ejemplo que muestra el efecto de los dos métodos:
@lilypond[quote,verbatim]
\relative c'' {
}
@end lilypond
-Los cambios en @code{outside-staff-priority} también se pueden emplear
-para controlar la situación vertical de los objetos individuales,
-aunque los resultados pueden no siempre ser deseables. Suponga que
-quiere que @qq{Text3} se sitúe por encima de @qq{Text4} en el ejemplo
-bajo el epígrafe Comportamiento Automático de más arriba (véase
-@ref{Comportamiento automático}). Todo lo que debemos hacer es localizar la
-prioridad de @code{TextScript} en el RFI o en las tablas de arriba, y
-aumentar la prioridad de @qq{Text3} hasta un valor superior:
+Los cambios en @code{outside-staff-priority} también se pueden
+emplear para controlar la situación vertical de los objetos
+individuales, aunque los resultados pueden no siempre ser
+deseables. Suponga que quiere que @qq{Text3} se sitúe por encima
+de @qq{Text4} en el ejemplo bajo el epígrafe Comportamiento
+Automático de más arriba (véase @ref{Comportamiento automático}).
+Todo lo que debemos hacer es localizar la prioridad de
+@code{TextScript} en el RFI o en las tablas de arriba, y aumentar
+la prioridad de @qq{Text3} hasta un valor superior:
@cindex TextScript, ejemplo de sobreescritura
@cindex outside-staff-priority, propiedad, ejemplo
c''2^"Text4" |
@end lilypond
-Esto, ciertamente, eleva a @qq{Text3} por encima de @qq{Text4} pero
-también lo eleva por encima de @qq{Text2}, y @qq{Text4} ahora se
-desploma hacia abajo. Quizá no sea tan buena idea. ¿Y si lo que
-realmente queremos hacer es posicionar todas las anotaciones a la
-misma distancia por encima del pentagrama? Para hacerlo, vamos a
-necesitar claramente espaciar las notas en sentido horizontal para
-hacer sitio para el texto. Esto se hace empleando la instrucción
-@code{textLengthOn}.
+Esto, ciertamente, eleva a @qq{Text3} por encima de @qq{Text4}
+pero también lo eleva por encima de @qq{Text2}, y @qq{Text4} ahora
+se desploma hacia abajo. Quizá no sea tan buena idea. ¿Y si lo
+que realmente queremos hacer es posicionar todas las anotaciones a
+la misma distancia por encima del pentagrama? Para hacerlo, vamos
+a necesitar claramente espaciar las notas en sentido horizontal
+para hacer sitio para el texto. Esto se hace empleando la
+instrucción @code{textLengthOn}.
@node La instrucción textLengthOn
@unnumberedsubsubsec La instrucción @code{@bs{}textLengthOn}
@funindex \textLengthOff
@funindex textLengthOff
-De forma predeterminada, el texto producido mediante marcado no ocupa
-ningún espacio horizontal en cuanto se refiere a la disposición de la
-música. La instrucción @code{\textLengthOn} invierte este
-comportamiento, ocasionando que las notas resulten tan espaciadas como
-sea necesario para acomodar el texto:
+De forma predeterminada, el texto producido mediante marcado no
+ocupa ningún espacio horizontal en cuanto se refiere a la
+disposición de la música. La instrucción @code{\textLengthOn}
+invierte este comportamiento, ocasionando que las notas resulten
+tan espaciadas como sea necesario para acomodar el texto:
@lilypond[quote,fragment,ragged-right,verbatim]
\textLengthOn % Cause notes to space out to accommodate text
La instrucción para volver al comportamiento predeterminado es
@code{\textLengthOff}. De forma alternativa, se puede usar
-@code{\once} con @code{\textLengthOn} si el efecto se ha de limitar a
-un solo momento musical.
-The corresponding spacing behavior for rehearsal marks and tempo
-indications is independently controlled with the commands
-@code{\markLengthOn} and @code{\markLengthOff}.
+@code{\once} con @code{\textLengthOn} si el efecto se ha de
+limitar a un solo momento musical. El comportamiento de espaciado
+correspondiente para las llamadas de ensayo y las indicaciones de
+tempo se controla independientemente con las instrucciones
+@code{\markLengthOn} y @code{\markLengthOff}.
@cindex marcado, texto de, permitir las colisiones en
El texto de marcado también evita las notas que se proyectan por
encima del pentagrama. Si esto no es lo que deseamos, el
-desplazamiento automático hacia arriba se puede desactivar mediante el
-establecimiento de la prioridad a @code{#f}. He aquí un ejemplo que
-muestra cómo el texto de marcado interactúa con tales notas.
+desplazamiento automático hacia arriba se puede desactivar
+mediante el establecimiento de la prioridad a @code{#f}. He aquí
+un ejemplo que muestra cómo el texto de marcado interactúa con
+tales notas.
@cindex TextScript, ejemplo de sobreescritura
@cindex outside-staff-priority, propiedad, ejemplo
@cindex dinámica, trucar la colocación de las indicaciones de
@cindex matices, trucar la colocación
-Las indicaciones de matiz dinámico normalmente se colocarán por debajo
-del pentagrama, pero se pueden posicionar por encima con la
-instrucción @code{\dynamicUp}. Se situarán verticalmente respecto a la
-nota a la que van adosadas, y flotarán por debajo (o por encima) de
-todos los objetos dentro-del-pentagrama tales como ligaduras de fraseo
-y números de compás. Esto puede ofrecer resultados bastante
-aceptables, como muestra este ejemplo:
+Las indicaciones de matiz dinámico normalmente se colocarán por
+debajo del pentagrama, pero se pueden posicionar por encima con la
+instrucción @code{\dynamicUp}. Se situarán verticalmente respecto
+a la nota a la que van adosadas, y flotarán por debajo (o por
+encima) de todos los objetos dentro-del-pentagrama tales como
+ligaduras de fraseo y números de compás. Esto puede ofrecer
+resultados bastante aceptables, como muestra este ejemplo:
@lilypond[quote,ragged-right,verbatim]
\relative {
}
@end lilypond
-Sin embargo, si las notas y sus indicaciones dinámicas adosadas están
-muy cerca, la colocación automática evitará las colisiones desplazando
-las marcas dinámicas posteriores más lejos, aunque este puede no ser
-el lugar óptimo, como muestra el siguiente ejemplo más bien
-artificial:
+Sin embargo, si las notas y sus indicaciones dinámicas adosadas
+están muy cerca, la colocación automática evitará las colisiones
+desplazando las marcas dinámicas posteriores más lejos, aunque
+este puede no ser el lugar óptimo, como muestra el siguiente
+ejemplo más bien artificial:
@lilypond[quote,ragged-right,verbatim,fragment]
\dynamicUp
@end lilypond
@noindent
-Si se presentara una situación similar en música @q{real}, podría ser
-preferible espaciar las notas un poco más entre sí, de forma que todas
-las marcas dinámicas puedan caber a la misma distancia vertical desde
-el pentagrama. Hemos sido capaces de hacer esto para el texto de
-marcado utilizando la instrucción @code{\textLengthOn}, pero no existe
-una instrucción equivalente para las indicaciones de matiz dinámico.
-Por tanto, tendremos que averiguar cómo hacerlo utilizando
-instrucciones @code{\override}.
+Si se presentara una situación similar en música @q{real}, podría
+ser preferible espaciar las notas un poco más entre sí, de forma
+que todas las marcas dinámicas puedan caber a la misma distancia
+vertical desde el pentagrama. Hemos sido capaces de hacer esto
+para el texto de marcado utilizando la instrucción
+@code{\textLengthOn}, pero no existe una instrucción equivalente
+para las indicaciones de matiz dinámico. Por tanto, tendremos que
+averiguar cómo hacerlo utilizando instrucciones @code{\override}.
@node Escalado de un «Grob»
@unnumberedsubsubsec Escalado de un «Grob»
@cindex grob, cambio de tamaño de un
@cindex escala de los grobs
-En primer lugar debemos aprender cómo se especifica el tamaño de los
-grobs. Todos los grobs tienen un punto de referencia definido dentro
-de ellos que se usa para colocarlos respecto a su objeto padre.
-Entonces, este punto del grob se posiciona a una distancia horizontal,
-@code{X-offset}, y una distancia vertical, @code{Y-offset}, a partir
-de su padre. La dimensión horizontal del objeto viene dada por una
-pareja de números, @code{X-extent}, que dice dónde están los límites
-izquierdo y derecho respecto del punto de referencia. La amplitud
-vertical se define de forma similar mediante una pareja de números,
-@code{Y-extent}. Éstas son propiedades de todos los grobs que
-contemplan el @code{grob-interface}.
+En primer lugar debemos aprender cómo se especifica el tamaño de
+los grobs. Todos los grobs tienen un punto de referencia definido
+dentro de ellos que se usa para colocarlos respecto a su objeto
+padre. Entonces, este punto del grob se posiciona a una distancia
+horizontal, @code{X-offset}, y una distancia vertical,
+@code{Y-offset}, a partir de su padre. La dimensión horizontal
+del objeto viene dada por una pareja de números, @code{X-extent},
+que dice dónde están los límites izquierdo y derecho respecto del
+punto de referencia. La amplitud vertical se define de forma
+similar mediante una pareja de números, @code{Y-extent}. Éstas
+son propiedades de todos los grobs que contemplan el
+@code{grob-interface}.
@cindex @code{extra-spacing-width}
@cindex objetos que colisionan, mover
@cindex grobs que colisionan, mover
-Aunque pueda sorprenderle, LilyPond no es perfecto. Ciertos elementos
-de notación se pueden superponer, lo que es una lástima, pero en
-realidad es bastante poco frecuente. Normalmente la necesidad de
-mover objetos es por claridad o razones estéticas: el aspecto es mejor
-con un poco más o un poco menos de espacio de separación.
+Aunque pueda sorprenderle, LilyPond no es perfecto. Ciertos
+elementos de notación se pueden superponer, lo que es una lástima,
+pero en realidad es bastante poco frecuente. Normalmente la
+necesidad de mover objetos es por claridad o razones estéticas: el
+aspecto es mejor con un poco más o un poco menos de espacio de
+separación.
Existen tres enfoques principales que llevan a la resolución de
-superposiciones en la notación. Se deben considerar en el siguiente
-orden:
+superposiciones en la notación. Se deben considerar en el
+siguiente orden:
@enumerate
@item
-La @strong{dirección} de uno de los objetos que se superponen se puede
-cambiar usando las instrucciones predefinidas que están relacionadas
-arriba para los objetos dentro-del-pentagrama (véase @ref{Objetos interiores al pentagrama}).
-Se pueden recolocar fácilmente las
-plicas, ligaduras de expresión y de unión, barras de corchea,
-indicaciones dinámicas, texto y grupos de valoración especial de esta
-forma. La limitación es que sólo tiene la posibilidad de elegir entre
-dos posiciones, y podría ser que ninguna de ellas sea la adecuada.
+La @strong{dirección} de uno de los objetos que se superponen se
+puede cambiar usando las instrucciones predefinidas que están
+relacionadas arriba para los objetos dentro-del-pentagrama (véase
+@ref{Objetos interiores al pentagrama}). Se pueden recolocar
+fácilmente las plicas, ligaduras de expresión y de unión, barras
+de corchea, indicaciones dinámicas, texto y grupos de valoración
+especial de esta forma. La limitación es que sólo tiene la
+posibilidad de elegir entre dos posiciones, y podría ser que
+ninguna de ellas sea la adecuada.
@item
Las @strong{propiedades del objeto}, que LilyPond usa cuando está
-colocando los objetos de presentación, se pueden modificar usando la
-instrucción de sobreescritura @code{\override}. Las ventadas de hacer
-cambios a este tipo de propiedad son: a) que algún otro objeto se
-moverá automáticamente si es necesario, para dejarle sitio, y b) una
-única sobreescritura se puede aplicar a todas las instancias del mismo
-tipo de objeto. Entre tales propiedades se encuentran:
+colocando los objetos de presentación, se pueden modificar usando
+la instrucción de sobreescritura @code{\override}. Las ventadas
+de hacer cambios a este tipo de propiedad son: a) que algún otro
+objeto se moverá automáticamente si es necesario, para dejarle
+sitio, y b) una única sobreescritura se puede aplicar a todas las
+instancias del mismo tipo de objeto. Entre tales propiedades se
+encuentran:
@itemize
@cindex right-padding, propiedad
@cindex staff-padding, propiedad
-Según un objeto se está colocando, el valor de su propiedad de relleno
-@code{padding} especifica el espacio intermedio que se debe dejar
-entre él mismo y el límite más próximo del objeto contra el que se
-está colocando. Observe que es el valor de @code{padding} del objeto
-@strong{que se está colocando} el que se usa; el valor de
-@code{padding} del objeto que ya está colocado se ignora. Los
-espacios intermedios especificados mediante @code{padding} se pueden
-aplicar a todos los objetos que contemplan el interface
-@code{side-position-interface}.
+Según un objeto se está colocando, el valor de su propiedad de
+relleno @code{padding} especifica el espacio intermedio que se
+debe dejar entre él mismo y el límite más próximo del objeto
+contra el que se está colocando. Observe que es el valor de
+@code{padding} del objeto @strong{que se está colocando} el que se
+usa; el valor de @code{padding} del objeto que ya está colocado se
+ignora. Los espacios intermedios especificados mediante
+@code{padding} se pueden aplicar a todos los objetos que
+contemplan el interface @code{side-position-interface}.
En lugar de con @code{padding}, la colocación de los grupos de
-alteraciones se controla con
-@code{right-padding}. Esta propiedad se encuentra en el objeto
-@code{AccidentalPlacement} que, observe, vive dentro del contexto de
-@strong{Staff}. Durante el proceso tipográfico, las cabezas de las
-notas se componen tipográficamente en primer lugar, y después las
-alteraciones, si existen, se añaden a la izquierda de las cabezas
-utilizando la propiedad de relleno por la derecha @code{right-padding}
-para determinar la separación entre la alteración y la cabeza, y
-de las alteraciones entre sí. Así
-pues, sólo la propiedad de relleno por la derecha @code{right-padding}
-del objeto @code{AccidentalPlacement} tiene efecto sobre la colocación
-de las alteraciones.
-
-La propiedad @code{staff-padding} está estrechamente relacionada con
-la propiedad @code{padding}: @code{padding} controla la separación
-mínima entre cualquier objeto que contemple el interface
-@code{side-position-interface} y el objeto más cercano (generalmente
-la nota o las líneas del pentagrama); @code{staff-padding} se aplica
-sólo a los objetos que siempre se sitúan fuera del pentagrama:
-controla la separación mínima entre dicho objeto y el pentagrama.
-Observe que @code{staff-padding} no tiene ningún efecto sobre objetos
-que se posicionan respecto a la nota en vez de hacerlo respecto al
-pentagrama, incluso aunque puede ser sobreescrito sin error por tales
-objetos: simplemente se ignora.
-
-Para descubrir qué propiedad de relleno se necesita para el objeto que
-quiere recolocar, debe volver al manual de RFI y buscar las
+alteraciones se controla con @code{right-padding}. Esta propiedad
+se encuentra en el objeto @code{AccidentalPlacement} que, observe,
+vive dentro del contexto de @strong{Staff}. Durante el proceso
+tipográfico, las cabezas de las notas se componen tipográficamente
+en primer lugar, y después las alteraciones, si existen, se añaden
+a la izquierda de las cabezas utilizando la propiedad de relleno
+por la derecha @code{right-padding} para determinar la separación
+entre la alteración y la cabeza, y de las alteraciones entre sí.
+Así pues, sólo la propiedad de relleno por la derecha
+@code{right-padding} del objeto @code{AccidentalPlacement} tiene
+efecto sobre la colocación de las alteraciones.
+
+La propiedad @code{staff-padding} está estrechamente relacionada
+con la propiedad @code{padding}: @code{padding} controla la
+separación mínima entre cualquier objeto que contemple el
+interface @code{side-position-interface} y el objeto más cercano
+(generalmente la nota o las líneas del pentagrama);
+@code{staff-padding} se aplica sólo a los objetos que siempre se
+sitúan fuera del pentagrama: controla la separación mínima entre
+dicho objeto y el pentagrama. Observe que @code{staff-padding} no
+tiene ningún efecto sobre objetos que se posicionan respecto a la
+nota en vez de hacerlo respecto al pentagrama, incluso aunque
+puede ser sobreescrito sin error por tales objetos: simplemente se
+ignora.
+
+Para descubrir qué propiedad de relleno se necesita para el objeto
+que quiere recolocar, debe volver al manual de RFI y buscar las
propiedades del objeto. Tenga cuidado porque las propiedades de
-relleno podrían no estar en el objeto más obvio, así que busque en los
-objetos que puedan tener alguna relación con él.
+relleno podrían no estar en el objeto más obvio, así que busque en
+los objetos que puedan tener alguna relación con él.
Todos los valores de relleno se miden en espacios del pentagrama.
Para la mayor parte de los objetos el valor se establece de forma
-predeterminada en aproximadamente 1.0 o menos (varía con cada objeto).
-Se puede sobreescribir si se necesita una separación intermedia mayor
-(o menor).
+predeterminada en aproximadamente 1.0 o menos (varía con cada
+objeto). Se puede sobreescribir si se necesita una separación
+intermedia mayor (o menor).
@item
@code{self-alignment-X} (Auto-alineamiento en el eje X)
@cindex self-alignment-X, propiedad
-Esta propiedad se puede usar para alinear el objeto a la izquierda, a
-la derecha, o centrarlo con respecto al punto de referencia del objeto
-«padre». Se puede usar con todos los objetos que contemplan el
-interface
-@code{self-alignment-interface}. En general son objetos que contienen
-texto. Los valores son @code{LEFT}, @code{RIGHT} o @code{CENTER}. De
-forma alternativa se puede especificar un valor numérico entre
-@w{@code{-1}} y @code{+1}, donde @w{@code{-1}} es alineado por la izquierda,
-@code{+1} es alineado por la derecha, y los números intermedios mueven
-el texto progresivamente desde alineado por la izquierda hasta alineado
-por la derecha. Se pueden especificar valores numéricos mayores de
-@code{1} para mover el texto incluso más lejos hacia la izquierda, o
-menos de @w{@code{-1}} para alejarlo más hacia la derecha. Un cambio en
+Esta propiedad se puede usar para alinear el objeto a la
+izquierda, a la derecha, o centrarlo con respecto al punto de
+referencia del objeto «padre». Se puede usar con todos los
+objetos que contemplan el interface
+@code{self-alignment-interface}. En general son objetos que
+contienen texto. Los valores son @code{LEFT}, @code{RIGHT} o
+@code{CENTER}. De forma alternativa se puede especificar un valor
+numérico entre @w{@code{-1}} y @code{+1}, donde @w{@code{-1}} es
+alineado por la izquierda, @code{+1} es alineado por la derecha, y
+los números intermedios mueven el texto progresivamente desde
+alineado por la izquierda hasta alineado por la derecha. Se
+pueden especificar valores numéricos mayores de @code{1} para
+mover el texto incluso más lejos hacia la izquierda, o menos de
+@w{@code{-1}} para alejarlo más hacia la derecha. Un cambio en
@code{1} en el valor corresponde a un movimiento de la mitad de la
longitud total del propio texto.
@cindex extra-spacing-width, propiedad
-Esta propiedad está disponible para todos los objetos que contemplan
-el interface @code{item-interface}. Toma dos números, el primero se
-suma al límite izquierdo y el segundo se suma al límite derecho. Los
-números negativos desplazan el límite a la izquierda y los positivos a
-la derecha, por lo que para ensanchar un objeto el primer número debe
-ser negativo y el segundo positivo. Observe que no todos los objetos
-ostentan los dos números. Por ejemplo, el objeto @code{Accidental}
-(alteración) sólo toma nota del primer número (el borde izquierdo).
+Esta propiedad está disponible para todos los objetos que
+contemplan el interface @code{item-interface}. Toma dos números,
+el primero se suma al límite izquierdo y el segundo se suma al
+límite derecho. Los números negativos desplazan el límite a la
+izquierda y los positivos a la derecha, por lo que para ensanchar
+un objeto el primer número debe ser negativo y el segundo
+positivo. Observe que no todos los objetos ostentan los dos
+números. Por ejemplo, el objeto @code{Accidental} (alteración)
+sólo toma nota del primer número (el borde izquierdo).
@item
@code{staff-position} (posición de pentagrama)
@cindex staff-position, propiedad
@code{staff-position} es una propiedad del interface
-@code{staff-symbol-referencer-interface}, que está contemplado por los
-objetos que se colocan con relación al pentagrama. Especifica la
-posición vertical del objeto con relación a la tercera línea del
-pentagrama en medios espacios de pentagrama. Es útil en la
-resolución de colisiones entre objetos de presentación como silencios
-multi-compás, ligaduras de unión y notas en distintas voces.
+@code{staff-symbol-referencer-interface}, que está contemplado por
+los objetos que se colocan con relación al pentagrama. Especifica
+la posición vertical del objeto con relación a la tercera línea
+del pentagrama en medios espacios de pentagrama. Es útil en la
+resolución de colisiones entre objetos de presentación como
+silencios multi-compás, ligaduras de unión y notas en distintas
+voces.
@item
@code{horizontal-shift}
@funindex \shiftOnnn
@funindex shiftOnnn
-Dentro de una vozm todas las notas que se producen en el mismo
+Dentro de una voz, todas las notas que se producen en el mismo
moemtno se agrupan en una columna de notas, y se crea un objeto
@code{NoteColumn} para controlar el posicionamiento horizonal de
dicho grupo de notas (véase @qq{Columnas de nota} en @ref{Voces
@item
Finalmente, cuando todo lo demás falla, los objetos se pueden
reposicionar manualmente con relación a la tercera línea del
-pentagrama verticalmente, o desplazándolas una cierta distancia a una
-nueva posición. Las desventajas son que los valores correctos para el
-reposicionamiento se deben adivinar, a menudo por ensayo y error, para
-cada objeto individual y, puesto que el movimiento se hace después de
-que LilyPond ha colocado todos los demás objetos es usuario es
-responsable de evitar cualquier colisión que pudiera producirse. Pero
-la dificultar principal con este enfoque es que los valores de
-reposicionado podrían tener que ser vueltos a calcular si la música se
-modifica más tarde. Las propiedades que se pueden usar para este tipo
-de posicionamiento manual son:
+pentagrama verticalmente, o desplazándolas una cierta distancia a
+una nueva posición. Las desventajas son que los valores correctos
+para el reposicionamiento se deben adivinar, a menudo por ensayo y
+error, para cada objeto individual y, puesto que el movimiento se
+hace después de que LilyPond ha colocado todos los demás objetos
+es usuario es responsable de evitar cualquier colisión que pudiera
+producirse. Pero la dificultar principal con este enfoque es que
+los valores de reposicionado podrían tener que ser vueltos a
+calcular si la música se modifica más tarde. Las propiedades que
+se pueden usar para este tipo de posicionamiento manual son:
@table @code
@item extra-offset (desplazamiento adicional)
@cindex extra-offset, propiedad
Esta propiedad se aplica a cualquier objeto de presentación que
-contemple el @code{grob-interface}. Toma una pareja de números que
-especifican el desplazamiento adicional en las direcciones horizontal
-y vertical. Los números negativos mueven el objeto a la izquierda o
-hacia abajo. Las unidades son espacios de pentagrama. El
-desplazamiento adicional se hace después de que la composición
-tipográfica de los objetos ha terminado, así que un objeto puede ser
-reposicionado a cualquier lugar sin afectar a ninguna otra cosa.
+contemple el @code{grob-interface}. Toma una pareja de números
+que especifican el desplazamiento adicional en las direcciones
+horizontal y vertical. Los números negativos mueven el objeto a
+la izquierda o hacia abajo. Las unidades son espacios de
+pentagrama. El desplazamiento adicional se hace después de que la
+composición tipográfica de los objetos ha terminado, así que un
+objeto puede ser reposicionado a cualquier lugar sin afectar a
+ninguna otra cosa.
@item positions (posiciones)
@cindex positions, propiedad
-Ésta es de la mayor utilidad para ajustar manualmente la inclinación y
-la altura de las barras de corchea, ligaduras de expresión y corchetes
-de grupos de valoración especial. Toma una pareja de números que dan
-la posición de los extremos izquierdo y derecho de la barra, ligadura,
-etc. con relación a la tercera línea del pentagrama. Las unidades son
-espacios de pentagrama. Observe, sin embargo, que las ligaduras de
-expresión y de fraseo no se pueden reposicionar en cantidades
-arbitrariamente grandes. LilyPond en primer lugar genera una lista de
-posiciones posibles para la ligadura y de forma predeterminada
-encuentra la ligadura que tiene @qq{mejor aspecto}. Si la propiedad
-@code{positions} se ha sobreescrito, la ligadura que está más cerca de
-las posiciones que se han solicitado, se selecciona de la lista.
+Ésta es de la mayor utilidad para ajustar manualmente la
+inclinación y la altura de las barras de corchea, ligaduras de
+expresión y corchetes de grupos de valoración especial. Toma una
+pareja de números que dan la posición de los extremos izquierdo y
+derecho de la barra, ligadura, etc. con relación a la tercera
+línea del pentagrama. Las unidades son espacios de pentagrama.
+Observe, sin embargo, que las ligaduras de expresión y de fraseo
+no se pueden reposicionar en cantidades arbitrariamente grandes.
+LilyPond en primer lugar genera una lista de posiciones posibles
+para la ligadura y de forma predeterminada encuentra la ligadura
+que tiene @qq{mejor aspecto}. Si la propiedad @code{positions} se
+ha sobreescrito, la ligadura que está más cerca de las posiciones
+que se han solicitado, se selecciona de la lista.
@end table
@end enumerate
-Un objeto en particular podría no tener todas estas propiedades. Es
-necesario ir al manual RFI para buscar qué propiedades se encuentran
-disponibles para el objeto en cuestión.
+Un objeto en particular podría no tener todas estas propiedades.
+Es necesario ir al manual RFI para buscar qué propiedades se
+encuentran disponibles para el objeto en cuestión.
Aquí presentamos una lista de los objetos que es más probable que
-estén implicados en colisiones, con el nombre del objeto que habría
-que buscar en el RFI para descubrir qué propiedades se deben usar para
-moverlos.
+estén implicados en colisiones, con el nombre del objeto que
+habría que buscar en el RFI para descubrir qué propiedades se
+deben usar para moverlos.
@multitable @columnfractions .5 .5
@headitem Tipo de objeto @tab Nombre del objeto
@subsection Arreglar notación con superposiciones
@translationof Fixing overlapping notation
-Veamos ahora cómo pueden ser de ayuda las propiedades que hemos visto
-en la sección anterior, para resolver problemas de notación que se
-superpone.
+Veamos ahora cómo pueden ser de ayuda las propiedades que hemos
+visto en la sección anterior, para resolver problemas de notación
+que se superpone.
@menu
* La propiedad padding (relleno)::
@cindex superpuesta, notación
La propiedad @code{padding} se puede ajustar para aumentar (o
-disminuir) la distancia entre símbolos impresos encima o debajo de las
-notas.
+disminuir) la distancia entre símbolos impresos encima o debajo de
+las notas.
@cindex Script, ejemplo de sobreescritura
@cindex padding, propiedad, ejemplo
d'1 |
@end lilypond
-Observe en el segundo ejemplo la gran importancia que tiene saber qué
-contexto maneja un determinado objeto. Puesto que el objeto
-@code{MetronomeMark} se maneja dentro del contexto @code{Score}, los
-cambios de propiedades en el contexto @code{Voice} pasarán
-inadvertidos. Para ver más detalles, consulte @ruser{Modificar las propiedades}.
+Observe en el segundo ejemplo la gran importancia que tiene saber
+qué contexto maneja un determinado objeto. Puesto que el objeto
+@code{MetronomeMark} se maneja dentro del contexto @code{Score},
+los cambios de propiedades en el contexto @code{Voice} pasarán
+inadvertidos.
+Para ver más detalles, consulte @ruser{Modificar las propiedades}.
-Si la propiedad de relleno @code{padding} de un objeto se incrementa
-cuando dicho objeto se encuentra en una pila de objetos que se están
-colocando de acuerdo a su prioridad @code{outside-staff-priority},
-entonces ese objeto se moverá, y también todos los que están por fuera
-de él.
+Si la propiedad de relleno @code{padding} de un objeto se
+incrementa cuando dicho objeto se encuentra en una pila de objetos
+que se están colocando de acuerdo a su prioridad
+@code{outside-staff-priority}, entonces ese objeto se moverá, y
+también todos los que están por fuera de él.
@node La propiedad right-padding (relleno por la derecha)
@cindex right-padding, propiedad
La propiedad @code{right-padding} afecta al espaciado entre la
-alteración y la nota a que se aplica. Normalmente no es necesaria,
-pero el espaciado predeterminado puede estar mal para ciertos glifos
-de alteraciones o combinaciones de glifos que se usan en música
-microtonal. Éstos tienen que introducirse sobreescribiendo el sello
-de la alteración con un elemento de marcado que contenga los símbolos
-deseados, así:
+alteración y la nota a que se aplica. Normalmente no es
+necesaria, pero el espaciado predeterminado puede estar mal para
+ciertos glifos de alteraciones o combinaciones de glifos que se
+usan en música microtonal. Éstos tienen que introducirse
+sobreescribiendo el sello de la alteración con un elemento de
+marcado que contenga los símbolos deseados, así:
@cindex Accidental, ejemplo de sobreescritura
@cindex text, propiedad, ejemplo
@noindent
Esto utiliza necesariamente una sobreescritura para el sello de la
-alteración que no se estudiará hasta más adelante. El tipo de sello
-debe ser un procedimiento, aquí modificado para que imprima el
-contenido de la propiedad @code{text} del objeto @code{Accidental},
-que a su vez está establecido como un signo de sesquisostenido.
-Entonces el signo se puede separar de la cabeza de la nota
-sobreescribiendo @code{right-padding}.
+alteración que no se estudiará hasta más adelante. El tipo de
+sello debe ser un procedimiento, aquí modificado para que imprima
+el contenido de la propiedad @code{text} del objeto
+@code{Accidental}, que a su vez está establecido como un signo de
+sesquisostenido. Entonces el signo se puede separar de la cabeza
+de la nota sobreescribiendo @code{right-padding}.
@noindent
@cindex alineación de objetos sobre la línea base
@cindex objetos, alineación sobre la línea base
-@code{staff-padding} se puede usar para alinear objetos como matices
-dinámicos a lo largo de una línea de base a una distancia fija del
-pentagrama, siempre que no exista ningún otro elemento de notación
-que fuerce una distancia mayor al pentagrama. No es una propiedad de
-@code{DynamicText} sino de @code{DynamicLineSpanner}. Esto es así
-porque la línea de base debe aplicarse por igual a @strong{todas} las
-dinámicas, entre ellas las que se han creado como objetos de
-extensión. Así que ésta es la forma de alinear las indicaciones de
-matiz en el ejemplo de la sección anterior:
+@code{staff-padding} se puede usar para alinear objetos como
+matices dinámicos a lo largo de una línea de base a una distancia
+fija del pentagrama, siempre que no exista ningún otro elemento de
+notación que fuerce una distancia mayor al pentagrama. No es una
+propiedad de @code{DynamicText} sino de @code{DynamicLineSpanner}.
+Esto es así porque la línea de base debe aplicarse por igual a
+@strong{todas} las dinámicas, entre ellas las que se han creado
+como objetos de extensión. Así que ésta es la forma de alinear
+las indicaciones de matiz en el ejemplo de la sección anterior:
@cindex DynamicText, ejemplo de sobreescritura
@cindex extra-spacing-width, propiedad, ejemplo
@unnumberedsubsubsec La propiedad @code{self-alignment-X} (auto-alineación en X)
@translationof The self-alignment-X property
-El ejemplo siguiente muestra cómo ajustar la posición
-de un objeto de digitación de cuerda en relación a la plica de una nota
-mediante el alineamiento del límite derecho con el punto de referencia
-de la nota «padre»:
+El ejemplo siguiente muestra cómo ajustar la posición de un objeto
+de digitación de cuerda en relación a la plica de una nota
+mediante el alineamiento del límite derecho con el punto de
+referencia de la nota «padre»:
@cindex StringNumber, ejemplo de sobreescritura
@cindex self-alignment-X, propiedad, ejemplo
@cindex objeto, colisión dentro del pentagrama
-Los silencios multi-compás en una voz pueden chocar con las notas en
-otra voz. Puesto que estos silencios se tipografían centrados entre
-las barras de compás se necesitaría bastante esfuerzo para que
-LilyPond averiguara qué otras notas podrían chocar con él, ya que
-actualmente todo el manejo de colisiones entre notas y silencios se
-hace solamente para notas y silencios que ocurren al mismo tiempo. He
-aquí un ejemplo de colisión de este tipo:
+Los silencios multi-compás en una voz pueden chocar con las notas
+en otra voz. Puesto que estos silencios se tipografían centrados
+entre las barras de compás se necesitaría bastante esfuerzo para
+que LilyPond averiguara qué otras notas podrían chocar con él, ya
+que actualmente todo el manejo de colisiones entre notas y
+silencios se hace solamente para notas y silencios que ocurren al
+mismo tiempo. He aquí un ejemplo de colisión de este tipo:
@lilypond[quote,verbatim,ragged-right]
<< \relative { c'4 c c c } \\ { R1 } >>
@end lilypond
-La mejor solución aquí es mover el silencio multi-compás hacia abajo,
-pues el silencio está en la voz dos. El ajuste predeterminado para
-@code{\voiceTwo} (es decir, en la segunda voz de una construcción
-@code{<<@{@dots{}@} \\ @{@dots{}@}>>}) es que @code{staff-position} tenga el
-valor -4 para MultiMeasureRest, así que tenemos que bajarlo, digamos,
-cuatro semi-espacios de pentagrama, al valor @w{@code{-8}}.
+La mejor solución aquí es mover el silencio multi-compás hacia
+abajo, pues el silencio está en la voz dos. El ajuste
+predeterminado para @code{\voiceTwo} (es decir, en la segunda voz
+de una construcción @code{<<@{@dots{}@} \\ @{@dots{}@}>>}) es que
+@code{staff-position} tenga el valor -4 para MultiMeasureRest, así
+que tenemos que bajarlo, digamos, cuatro semi-espacios de
+pentagrama, al valor @w{@code{-8}}.
@cindex MultiMeasureRest, ejemplo de sobreescritura
@cindex staff-position, propiedad, ejemplo
>>
@end lilypond
-Esto es mejor que utilizar, por ejemplo, @code{extra-offset}, porque
-la línea adicional por encima del silencio se inserta automáticamente.
+Esto es mejor que utilizar, por ejemplo, @code{extra-offset},
+porque la línea adicional por encima del silencio se inserta
+automáticamente.
@node La propiedad extra-offset (desplazamiento adicional)
@unnumberedsubsubsec La propiedad @code{extra-offset} (desplazamiento adicional)
La propiedad @code{extra-offset} da un completo control sobre el
posicionamiento de un objeto tanto vertical como horizontalmente.
-En el ejemplo siguiente, la segunda digitación se desplaza ligeramente
-a la izquierda, y 1.8 espacios de pentagrama hacia abajo:
+En el ejemplo siguiente, la segunda digitación se desplaza
+ligeramente a la izquierda, y 1.8 espacios de pentagrama hacia
+abajo:
@cindex fingering (digitación), ejemplo de sobreescritura
@cindex extra-offset, propiedad, ejemplo
@cindex barras de corchea, control manual
La propiedad @code{positions} permite controlar manualmente la
-posición vertical y de ahí también la inclinación de los tresillos,
-ligaduras de expresión y de fraseo, y barras de corchea.
+posición vertical y de ahí también la inclinación de los
+tresillos, ligaduras de expresión y de fraseo, y barras de
+corchea.
-He aquí un ejemplo en el que las ligaduras de fraseo y de expresión
-chocan entre sí:
+He aquí un ejemplo en el que las ligaduras de fraseo y de
+expresión chocan entre sí:
@lilypond[quote,verbatim,ragged-right]
\relative { a'8 \( ( a'16 ) a \) }
@cindex positions, propiedad, ejemplo
@noindent
-Una posibilidad sería mover los dos extremos de la ligadura de fraseo
-hacia arriba. Podemos tratar de establecer el extremo izquierdo a 2.5
-espacios de pentagrama por encima de la tercera línea y el extremo
-derecho a 4.5 también hacia arriba, y LilyPond seleccionaría la
-ligadura de fraseo de entre las candidatas que ha encontrado con sus
-extremos más cercanos a éstos:
+Una posibilidad sería mover los dos extremos de la ligadura de
+fraseo hacia arriba. Podemos tratar de establecer el extremo
+izquierdo a 2.5 espacios de pentagrama por encima de la tercera
+línea y el extremo derecho a 4.5 también hacia arriba, y LilyPond
+seleccionaría la ligadura de fraseo de entre las candidatas que ha
+encontrado con sus extremos más cercanos a éstos:
@lilypond[quote,verbatim,fragment,ragged-right]
\once \override PhrasingSlur.positions = #'(2.5 . 4.5)
@end lilypond
Esto supone una mejora, pero ¿por qué no bajar un poco el extremo
-derecho de la ligadura de expresión? Si lo probamos, veremos que no
-se puede hacer así. Ello es a causa de que no existen ligaduras de
-expresión candidatas que estén más bajas que la que ya se ha
-seleccionado, y en este caso la propiedad @code{positions} no tiene
-ningún efecto. Sin embargo, las ligaduras de unión, expresión y
-fraseo @emph{se pueden} colocar y conformar de manera muy exacta
-cuando se necesita. Para aprender la manera de hacerlo, consulte
-@ruser{Modificación de ligaduras de unión y de expresión}.
-
-Presentamos otro ejemplo. Vemos que la barra
-choca con las ligaduras:
+derecho de la ligadura de expresión? Si lo probamos, veremos que
+no se puede hacer así. Ello es a causa de que no existen
+ligaduras de expresión candidatas que estén más bajas que la que
+ya se ha seleccionado, y en este caso la propiedad
+@code{positions} no tiene ningún efecto. Sin embargo, las
+ligaduras de unión, expresión y fraseo @emph{se pueden} colocar y
+conformar de manera muy exacta cuando se necesita. Para aprender
+la manera de hacerlo, consulte @ruser{Modificación de ligaduras de
+unión y de expresión}.
+
+Presentamos otro ejemplo. Vemos que la barra choca con las
+ligaduras:
@lilypond[quote,verbatim,ragged-right]
{
@noindent
Esto se puede resolver manualmente elevando los dos extremos de la
-barra desde su posición a 1.81 espacios de pentagrama bajo la línea
-central hasta, digamos, 1 espacio:
+barra desde su posición a 1.81 espacios de pentagrama bajo la
+línea central hasta, digamos, 1 espacio:
@cindex Beam, ejemplo de sobreescritura
@cindex positions, propiedad, ejemplo
@end lilypond
@noindent
-Observe que la sobreescritura sigue aplicándose en la segunda voz del
-segundo compás de corcheas, pero no a ninguna de las barras de la
-primera voz, ni siquiera a las que están en el in the later second measure. As soon as the
-override should no longer apply it should be reverted, as shown.
+Observe que la sobreescritura sigue aplicándose en la segunda voz
+del segundo compás de corcheas, pero no a ninguna de las barras de
+la primera voz, ni siquiera a las que están en el segundo compás,
+que es posterior. Tan pronto como la sobreescritura no pueda
+tener ningún efecto, debería ser revertida como se muestra.
@node La propiedad force-hshift (forzar desplazamiento horizontal)
@unnumberedsubsubsec La propiedad @code{force-hshift} (forzar desplazamiento horizontal)
@translationof The force-hshift property
-Ahora podremos ver cómo aplicar las correcciones finales al ejemplo de
-Chopin que presentamos al final de @ref{Oigo voces}, que
-dejamos con este aspecto:
+Ahora podremos ver cómo aplicar las correcciones finales al
+ejemplo de Chopin que presentamos al final de @ref{Oigo voces},
+que dejamos con este aspecto:
@lilypond[quote,verbatim,fragment,ragged-right]
\new Staff \relative {
@subsection Ejemplos reales de música
@translationof Real music example
-Finalizaremos esta sección sobre los trucos mostrando los pasos que se
-deben tomar para tratar con un ejemplo complicado que necesita varios
-trucos para producir el resultado deseado. El ejemplo se ha escogido
-deliberadamente para ilustrar el uso de la Referencia de la Notación
-para resolver problemas de notación poco comunes. No es
-representativo del proceso de grabado más usual, por lo que ¡le
-recomendamos que no deje que estas dificultades le desanimen!
-¡Afortunadamente, las dificultades como éstas no son muy comunes!
+Finalizaremos esta sección sobre los trucos mostrando los pasos
+que se deben tomar para tratar con un ejemplo complicado que
+necesita varios trucos para producir el resultado deseado. El
+ejemplo se ha escogido deliberadamente para ilustrar el uso de la
+Referencia de la Notación para resolver problemas de notación poco
+comunes. No es representativo del proceso de grabado más usual,
+por lo que ¡le recomendamos que no deje que estas dificultades le
+desanimen! ¡Afortunadamente, las dificultades como éstas no son
+muy comunes!
El ejemplo está extraído de la Primera Balada de Chopin, Op. 23,
-compases 6 al 9, la transición entre el Lento inicial y el Moderato.
-Presentamos en primer lugar el aspecto que queremos que tenga el
-resultado, pero para evitar complicar demasiado el ejemplo hemos
-quitado las indicaciones dinámicas, las digitaciones y el pedal.
+compases 6 al 9, la transición entre el Lento inicial y el
+Moderato. Presentamos en primer lugar el aspecto que queremos que
+tenga el resultado, pero para evitar complicar demasiado el
+ejemplo hemos quitado las indicaciones dinámicas, las digitaciones
+y el pedal.
@c The following should appear as music without code
@c This example should not be indexed
}
@end lilypond
-Observamos en primer lugar que la parte de la mano derecha del tercer
-compás requiere cuatro voces. Son las cinco corcheas unidas por una
-barra, la nota Do ligada, el Re blanca que se funde con el Re corchea,
-y el Fa sostenido negra con puntillo, que también está fundida con la
-corchea de su misma altura. Todo lo demás está en una sola voz, así
-que lo más fácil es introducir estas tres voces adicionales, en el
-momento en que se necesiten y de forma temporal. Si ha olvidado cómo
-hacerlo, lea las secciones @ref{Oigo voces} y @ref{Voces explícitas}.
-Aquí tomamos la decisión de utilizar voces instanciadas explícitamente
-para el pasaje polifónico, dado que LilyPond es más probable que pueda
-evitar las colisiones si todas las voces se instancian explícitamente
-de esta forma.
+Observamos en primer lugar que la parte de la mano derecha del
+tercer compás requiere cuatro voces. Son las cinco corcheas
+unidas por una barra, la nota Do ligada, el Re blanca que se funde
+con el Re corchea, y el Fa sostenido negra con puntillo, que
+también está fundida con la corchea de su misma altura. Todo lo
+demás está en una sola voz, así que lo más fácil es introducir
+estas tres voces adicionales, en el momento en que se necesiten y
+de forma temporal. Si ha olvidado cómo hacerlo, lea las secciones
+@ref{Oigo voces} y @ref{Voces explícitas}. Aquí tomamos la
+decisión de utilizar voces instanciadas explícitamente para el
+pasaje polifónico, dado que LilyPond es más probable que pueda
+evitar las colisiones si todas las voces se instancian
+explícitamente de esta forma.
Vamos a comenzar introduciendo las notas como dos variables y
-disponiendo la estructura de pentagramas en un bloque Score, y veremos
-qué produce LilyPond de forma predeterminada:
+disponiendo la estructura de pentagramas en un bloque Score, y
+veremos qué produce LilyPond de forma predeterminada:
@c line-width ensures no break
@lilypond[quote,verbatim,ragged-right,line-width=6\in]
@end lilypond
Todas las notas son correctas, pero el aspecto está lejos de ser
-satisfactorio. La ligadura de unión choca con el cambio de compás,
-ciertas notas no se funden correctamente, y faltan algunos elementos de
-notación. En primer lugar trataremos con lo más fácil. Podemos
-añadir fácilmente la ligadura de expresión de la mano izquierda y la
-ligadura de fraseo de la mano derecha, pues todo ello se estudió en el
-Tutorial. Al hacerlo así obtenemos:
+satisfactorio. La ligadura de unión choca con el cambio de
+compás, ciertas notas no se funden correctamente, y faltan algunos
+elementos de notación. En primer lugar trataremos con lo más
+fácil. Podemos añadir fácilmente la ligadura de expresión de la
+mano izquierda y la ligadura de fraseo de la mano derecha, pues
+todo ello se estudió en el Tutorial. Al hacerlo así obtenemos:
@c line-width ensures no break
@lilypond[quote,verbatim,ragged-right,line-width=6\in]
@end lilypond
El primer compás ahora es correcto. El segundo compás contiene un
-arpegio y acaba en una doble barra. ¿Cómo los hacemos, pues no han
-sido mencionados en este Manual de Aprendizaje? Aquí es donde tenemos
-que volver e la Referencia de la Notación. Buscando la palabra
-@q{arpegio} y @q{línea divisoria} en el índice nos muestra rápidamente
-que un arpegio se hace añadiendo @code{\arpeggio} a un acorde, y la
-doble barra se produce por medio de la instrucción @code{\bar "||"}.
-Esto podemos hacerlo fácilmente. A continuación tenemos que corregir
-la colisión entre la ligadura de unión y la indicación de compás.
-Esto se hace mejor moviendo la ligadura hacia arriba. Estudiamos cómo
-mover objetos anteriormente en @ref{Mover objetos}, donde dice que
-los objetos que están situados de forma relativa al pentagrama se
-pueden mover verticalmente
-sobreescribiendo su propiedad @code{staff-position}, que
-se especifica en unidades de medio espacio de pentagrama respecto de
-la línea central del pentagrama. Así pues, la sobreescritura
-siguiente colocada justo antes de la primera nota ligada subirá la
-ligadura 3.5 medios espacios de pentagrama por encima de la línea
-central:
+arpegio y acaba en una doble barra. ¿Cómo los hacemos, pues no
+han sido mencionados en este Manual de Aprendizaje? Aquí es donde
+tenemos que volver e la Referencia de la Notación. Buscando la
+palabra @q{arpegio} y @q{línea divisoria} en el índice nos muestra
+rápidamente que un arpegio se hace añadiendo @code{\arpeggio} a un
+acorde, y la doble barra se produce por medio de la instrucción
+@code{\bar "||"}. Esto podemos hacerlo fácilmente. A
+continuación tenemos que corregir la colisión entre la ligadura de
+unión y la indicación de compás. Esto se hace mejor moviendo la
+ligadura hacia arriba. Estudiamos cómo mover objetos
+anteriormente en @ref{Mover objetos}, donde dice que los objetos
+que están situados de forma relativa al pentagrama se pueden mover
+verticalmente sobreescribiendo su propiedad @code{staff-position},
+que se especifica en unidades de medio espacio de pentagrama
+respecto de la línea central del pentagrama. Así pues, la
+sobreescritura siguiente colocada justo antes de la primera nota
+ligada subirá la ligadura 3.5 medios espacios de pentagrama por
+encima de la línea central:
@code{\once \override Tie.staff-position = #3.5}
}
@end lilypond
-Vayamos ahora al tercer compás y comienzo de la sección Moderato. El
-tutorial nos enseñó cómo escribir una indicación de tempo mediante la
-instrucción @code{\tempo}, por lo que añadir @qq{Moderato} es fácil. Pero ahora ¿cómo fundimos notas que están en distintas
-voces? Aquí es donde debemos volver a buscar ayuda en el manual de
-Referencia de la notación. Al buscar la palabra @qq{merge} (mezcla) en
-el índice de la Referencia de la notación llegamos rápidamente a las
-instrucciones para mezclar notas con distinta cabeza y con o sin
-puntillo, en @ruser{Resolución de las colisiones}. En nuestro ejemplo tenemos
-que fusionar ambos tipos de nota en el transcurso de la sección
-polifónica del compás 3; por tanto, en virtud de la información que
-aparece en la Referencia de la Notación, escribimos
+Vayamos ahora al tercer compás y comienzo de la sección Moderato.
+El tutorial nos enseñó cómo escribir una indicación de tempo
+mediante la instrucción @code{\tempo}, por lo que añadir
+@qq{Moderato} es fácil. Pero ahora ¿cómo fundimos notas que están
+en distintas voces? Aquí es donde debemos volver a buscar ayuda
+en el manual de Referencia de la notación. Al buscar la palabra
+@qq{merge} (mezcla) en el índice de la Referencia de la notación
+llegamos rápidamente a las instrucciones para mezclar notas con
+distinta cabeza y con o sin puntillo, en @ruser{Resolución de las
+colisiones}. En nuestro ejemplo tenemos que fusionar ambos tipos
+de nota en el transcurso de la sección polifónica del compás 3;
+por tanto, en virtud de la información que aparece en la
+Referencia de la Notación, escribimos
@example
\mergeDifferentlyHeadedOn
}
@end lilypond
-Estas sobreescrituras han fundido los dos Fa sostenido, pero no los
-dos Re. ¿Por qué no? La respuesta está en la misma sección de la
-Referencia de la Notación: las notas que se fusionan deben tener las
-plicas en direcciones opuestas y dos notas no se pueden fusionar bien
-si hay una tercera nota en la misma columna. Aquí los dos Re tienen
-las plicas hacia arriba y hay una tercera nota: el Do. Sabemos cómo
-cambiar la dirección de la plica usando @code{\stemDown}, y la
-Referencia de la Notación también explica cómo mover el Do: aplicar un
-desplazamiento usando una de las instrucciones @code{\shift}. Pero
-¿cuál? El Do está en la voz dos que tiene desactivado el
-desplazamiento, y los dos Re están en las voces uno y tres, que tienen
-el desplazamiento desactivado y activado, respectivamente. Por ello
-tenemos que desplazar el Do un nivel más todavía, usando
-@code{\shiftOnn} para evitar que interfiera con los dos Re. Al
-aplicar estos cambios obtenemos:
+Estas sobreescrituras han fundido los dos Fa sostenido, pero no
+los dos Re. ¿Por qué no? La respuesta está en la misma sección
+de la Referencia de la Notación: las notas que se fusionan deben
+tener las plicas en direcciones opuestas y dos notas no se pueden
+fusionar bien si hay una tercera nota en la misma columna. Aquí
+los dos Re tienen las plicas hacia arriba y hay una tercera nota:
+el Do. Sabemos cómo cambiar la dirección de la plica usando
+@code{\stemDown}, y la Referencia de la Notación también explica
+cómo mover el Do: aplicar un desplazamiento usando una de las
+instrucciones @code{\shift}. Pero ¿cuál? El Do está en la voz
+dos que tiene desactivado el desplazamiento, y los dos Re están en
+las voces uno y tres, que tienen el desplazamiento desactivado y
+activado, respectivamente. Por ello tenemos que desplazar el Do
+un nivel más todavía, usando @code{\shiftOnn} para evitar que
+interfiera con los dos Re. Al aplicar estos cambios obtenemos:
@cindex Tie, ejemplo de sobreescritura
@cindex staff-position, propiedad, ejemplo
}
@end lilypond
-Ya casi está. Solamente quedan dos problemas: la plica hacia abajo
-sobre el Re fusionado no tendría que estar ahí, y el Do estaría mejor
-colocado a la derecha de los Re. Sabemos cómo hacer las dos cosas a
-partir de trucos anteriores: hacemos la plica transparente, y movemos
-el Do con la propiedad @code{force-hshift}. Aquí tenemos el resultado
-final:
+Ya casi está. Solamente quedan dos problemas: la plica hacia
+abajo sobre el Re fusionado no tendría que estar ahí, y el Do
+estaría mejor colocado a la derecha de los Re. Sabemos cómo hacer
+las dos cosas a partir de trucos anteriores: hacemos la plica
+transparente, y movemos el Do con la propiedad
+@code{force-hshift}. Aquí tenemos el resultado final:
@cindex NoteColumn, ejemplo de sobreescritura
@cindex force-hshift, propiedad, ejemplo
@cindex ligar notas entre voces distintas
El ejemplo siguiente muestra cómo conectar notas que están en
-distintas voces utilizando ligaduras de unión. Normalmente sólo se
-pueden conectar mediante ligaduras de unión notas que estén en la
-misma voz. Usando dos voces, con las notas ligadas en una de ellas:
+distintas voces utilizando ligaduras de unión. Normalmente sólo
+se pueden conectar mediante ligaduras de unión notas que estén en
+la misma voz. Usando dos voces, con las notas ligadas en una de
+ellas:
@lilypond[quote]
<< { b'8~ 8\noBeam } \\ { b'8[ g'] } >>
@end lilypond
@noindent
-y borrando la primera plica (con su corchete) hacia arriba en esa voz, da la impresión
-de que la ligadura se cruza entre las voces:
+y borrando la primera plica (con su corchete) hacia arriba en esa
+voz, da la impresión de que la ligadura se cruza entre las voces:
@funindex \omit
@cindex Stem, example of removing
@end lilypond
@seealso
-Learning Manual:
-@ref{The once prefix,,The @code{@bs{}once} prefix},
-@ref{The stencil property}.
+Manual de aprendizaje
+@ref{El prefijo once,,El prefijo @code{@bs{}once}},
+@ref{La propiedad stencil (sello)}.
@node Simulación de un calderón en el MIDI
@cindex fermata, realización en MIDI
Para los objetos fuera-del-pentagrama, normalmente es mejor
-sobreescribir la propiedad @code{stencil} («sello») del objeto que su
-propiedad @code{transparent} cuando desee quitarlos de la salida
-impresa. Mediante el establecimiento de la propiedad @code{stencil}
-de un objeto al valor @code{#f} podemos quitar el objeto por completo
-de la salida impresa. Esto significa que no tiene efecto sobre la
-colocación de otros objetos que pudieran colocarse en relación a él.
-
-Por ejemplo, si quisiéramos cambiar la indicación metronómica con el
-propósito de simular un calderón en la salida MIDI, seguramente no
-querríamos que la indicación metronómica apareciese en la salida
-impresa, y no querríamos influir sobre la separación entre los dos
-sistemas ni sobre la colocación de las anotaciones adyacentes sobre el
-pentagrama. Por lo tanto, establecer su propiedad @code{stencil} al
-valor @code{#f} sería la mejor manera. Mostramos aquí el efecto de
-los dos métodos:
+sobreescribir la propiedad @code{stencil} («sello») del objeto que
+su propiedad @code{transparent} cuando desee quitarlos de la
+salida impresa. Mediante el establecimiento de la propiedad
+@code{stencil} de un objeto al valor @code{#f} podemos quitar el
+objeto por completo de la salida impresa. Esto significa que no
+tiene efecto sobre la colocación de otros objetos que pudieran
+colocarse en relación a él.
+
+Por ejemplo, si quisiéramos cambiar la indicación metronómica con
+el propósito de simular un calderón en la salida MIDI, seguramente
+no querríamos que la indicación metronómica apareciese en la
+salida impresa, y no querríamos influir sobre la separación entre
+los dos sistemas ni sobre la colocación de las anotaciones
+adyacentes sobre el pentagrama. Por lo tanto, establecer su
+propiedad @code{stencil} al valor @code{#f} sería la mejor manera.
+Mostramos aquí el efecto de los dos métodos:
@cindex MetronomeMark, ejemplo de sobreescritura
@cindex transparent, propiedad, ejemplo
@end lilypond
@noindent
-Ambos métodos quitan de la salida impresa la indicación metronómica
-que alarga el calderón, y los dos afectan al tempo del MIDI tal y como
-queríamos, pero la indicación metronómica transparente de la primera
-línea fuerza una colocación muy alta de la indicación de tempo que
-sigue, mientras que la segunda (con el sello suprimido) no lo hace.
+Ambos métodos quitan de la salida impresa la indicación
+metronómica que alarga el calderón, y los dos afectan al tempo del
+MIDI tal y como queríamos, pero la indicación metronómica
+transparente de la primera línea fuerza una colocación muy alta de
+la indicación de tempo que sigue, mientras que la segunda (con el
+sello suprimido) no lo hace.
@seealso
Glosario musical:
@cindex ajustes de disposición, usar variables para hacer
Las instrucciones de sobreescritura son con frecuencia largas y
-tediosas de escribir, y se tienen que escribir de forma absolutamente
-correcta. Si las mismas sobreescrituras se van a utilizar muchas
-veces, podría merecer la pena definir variables para guardarlas.
-
-Supongamos que queremos realzar ciertas palabras de la letra de una
-canción imprimiéndolas en cursiva y negrita. Las instrucciones
-@code{\italic} y @code{\bold} sólo funcionan dentro de la letra de las
-canciones si están incluidas, junto con la palabra o palabras que se
-pretenden modificar, dentro de un @code{\markup}, lo que las hace
-tediosas de escribir. La necesidad de incluir las propias palabras
-impide que se puedan usar en variables simples. ¿Podríamos, como
-alternativa, utilizar las instrucciones @code{\override} y
-@code{\revert}?
+tediosas de escribir, y se tienen que escribir de forma
+absolutamente correcta. Si las mismas sobreescrituras se van a
+utilizar muchas veces, podría merecer la pena definir variables
+para guardarlas.
+
+Supongamos que queremos realzar ciertas palabras de la letra de
+una canción imprimiéndolas en cursiva y negrita. Las
+instrucciones @code{\italic} y @code{\bold} sólo funcionan dentro
+de la letra de las canciones si están incluidas, junto con la
+palabra o palabras que se pretenden modificar, dentro de un
+@code{\markup}, lo que las hace tediosas de escribir. La necesidad
+de incluir las propias palabras impide que se puedan usar en
+variables simples. ¿Podríamos, como alternativa, utilizar las
+instrucciones @code{\override} y @code{\revert}?
@example
@code{\override Lyrics.LyricText.font-shape = #'italic}
@code{\revert Lyrics.LyricText.font-series}
@end example
-Estas instrucciones también serían extremadamente tediosas de escribir
-si hubiera muchas palabras que quisiéramos subrayar. Pero sí
-@emph{podemos} definirlas como dos variables y usarlas para delimitar
-las palabras que destacar. Otra ventaja de la utilización de
-variables para estas sobreescrituras es que ya no son necesarios los
-espacios que rodean al punto, puesto que no se interpretan
-directamente en el modo @code{\lyricmode}. He aquí un ejemplo de
-esto, aunque en la práctica quizá elegiríamos unos nombres de variable
-más cortos para que fueran más rápidos de teclear:
+Estas instrucciones también serían extremadamente tediosas de
+escribir si hubiera muchas palabras que quisiéramos subrayar.
+Pero sí @emph{podemos} definirlas como dos variables y usarlas
+para delimitar las palabras que destacar. Otra ventaja de la
+utilización de variables para estas sobreescrituras es que ya no
+son necesarios los espacios que rodean al punto, puesto que no se
+interpretan directamente en el modo @code{\lyricmode}. He aquí un
+ejemplo de esto, aunque en la práctica quizá elegiríamos unos
+nombres de variable más cortos para que fueran más rápidos de
+teclear:
@cindex LyricText, ejemplo de sobreescritura
@cindex font-shape, propiedad, ejemplo
@translationof Style sheets
La salida que produce LilyPond se puede modificar profundamente;
-consulte @ref{Trucar la salida} para leer detalles sobre este asunto.
-Pero ¿qué ocurre si tiene muchos archivos a los que les quiere aplicar
-sus propios trucos? O ¿qué ocurre si, sencillamente, quiere separar
-los trucos de la propia música? Todo esto es bastante fácil de
-conseguir.
+consulte @ref{Trucar la salida} para leer detalles sobre este
+asunto. Pero ¿qué ocurre si tiene muchos archivos a los que les
+quiere aplicar sus propios trucos? O ¿qué ocurre si,
+sencillamente, quiere separar los trucos de la propia música?
+Todo esto es bastante fácil de conseguir.
-Veamos un ejemplo. No se preocupe si no entiende
-las partes que tienen todos los @code{#()}. Esto se explicará en
-@ref{Trucos avanzados con Scheme}.
+Veamos un ejemplo. No se preocupe si no entiende las partes que
+tienen todos los @code{#()}. Esto se explicará en @ref{Trucos
+avanzados con Scheme}.
@lilypond[quote,verbatim,ragged-right]
mpdolce =
@end lilypond
Hagamos algo respecto a las definiciones @code{mpdolce} e
-@code{inst}. Éstas producen la salida que deseamos, pero quizá las
-querríamos utilizar en otra pieza. Podríamos simplemente copiarlas y
-pegarlas al principio de cada archivo, pero sería bastante molesto.
-También hace que se queden las definiciones a la vista dentro de
-nuestros archivos de música, y yo personalmente encuentro todos los
-@code{#()} bastante poco estéticos. Los vamos a esconder dentro de
-otro archivo:
+@code{inst}. Éstas producen la salida que deseamos, pero quizá
+las querríamos utilizar en otra pieza. Podríamos simplemente
+copiarlas y pegarlas al principio de cada archivo, pero sería
+bastante molesto. También hace que se queden las definiciones a
+la vista dentro de nuestros archivos de música, y yo personalmente
+encuentro todos los @code{#()} bastante poco estéticos. Los vamos
+a esconder dentro de otro archivo:
@example
%%% guardar esto en un archivo con el nombre "definiciones.ily"
Haremos referencia a este archivo utilizando la instrucción
@code{\include} al principio del archivo de música (la extensión
-@code{.ily} se utiliza para distinguir este archivo de inclusión --que
-se supone que no debe ser procesado de forma independiente-- del
-archivo principal). Ahora modificaremos la música (guardemos este
-archivo como @file{musica.ly}).
+@code{.ily} se utiliza para distinguir este archivo de inclusión
+--que se supone que no debe ser procesado de forma independiente--
+del archivo principal). Ahora modificaremos la música (guardemos
+este archivo como @file{musica.ly}).
@c We have to do this awkward example/lilypond-non-verbatim
@c because we can't do the \include stuff in the manual.
Eso tiene mejor aspecto, pero haremos algunos cambios más. El
glissando es difícil de ver, así que lo haremos más grueso y lo
acercaremos a las cabezas de las notas. Pondremos la indicación
-metronómica encima de la clave, en lugar de ir encima de la primera
-nota. Y por último, mi profesor de composición odia las indicaciones
-de compás @q{C}, así que la convertiremos en @q{4/4}.
+metronómica encima de la clave, en lugar de ir encima de la
+primera nota. Y por último, mi profesor de composición odia las
+indicaciones de compás @q{C}, así que la convertiremos en @q{4/4}.
Sin embargo, no debemos cambiar el archivo @file{musica.ly}.
Sustituyamos nuestro archivo @file{definiciones.ily} con éste:
}
@end lilypond
-¡Eso tiene un aspecto mucho mejor! Ahora suponga que quiere publicar
-esta pieza. A mi profesor de composición no le gustan las
-indicaciones de compás @q{C}, pero yo les tengo cierto cariño.
+¡Eso tiene un aspecto mucho mejor! Ahora suponga que quiere
+publicar esta pieza. A mi profesor de composición no le gustan
+las indicaciones de compás @q{C}, pero yo les tengo cierto cariño.
Copiaremos el archivo actual @file{definiciones.ily} a
-@file{publicar-web.ily} y modificaremos éste. Como el propósito de
-esta música es producir un PDF que va a mostrarse en la pantalla,
-también vamos a aumentar el tamaño general de la salida.
+@file{publicar-web.ily} y modificaremos éste. Como el propósito
+de esta música es producir un PDF que va a mostrarse en la
+pantalla, también vamos a aumentar el tamaño general de la salida.
@example
%%% publicar-web.ily
Ahora, en la música, simplemente sustituyo @code{\include
"definiciones.ily"} por @code{\include "publicar-web.ily"}. Por
-supuesto, podríamos hacer esto aún más práctico. Podríamos hacer un
-archivo @file{definiciones.ily} que contuviera solamente las
+supuesto, podríamos hacer esto aún más práctico. Podríamos hacer
+un archivo @file{definiciones.ily} que contuviera solamente las
definiciones de @code{mpdolce} y de @code{inst}, un archivo
@file{publicar-web.ily} que contuviera solamente la sección
@code{\layout} que se mostró en el ejemplo, y un archivo
%\include "universidad.ily"
@end example
-Este enfoque puede ser útil incluso si va a producir sólo un conjunto
-de particellas. Yo utilizo media docena de archivos de @q{hojas de
-estilo} para mis proyectos. Comienzo todos los archivos de música con
-@code{\include "../global.ily"}, que contiene
+Este enfoque puede ser útil incluso si va a producir sólo un
+conjunto de particellas. Yo utilizo media docena de archivos de
+@q{hojas de estilo} para mis proyectos. Comienzo todos los
+archivos de música con @code{\include "../global.ily"}, que
+contiene
@example
%%% global.ily
@subsection Otras fuentes de información
@translationof Other sources of information
-La documentación del manual de Referencia de Funcionamiento Interno
-contiene montañas de información sobre LilyPond, pero se puede obtener
-más información aún leyendo los archivos internos de LilyPond. Para
-echarles un vistazo, en primer lugar debe buscar la carpeta
-correspondiente a su sistema. La ubicación de esta carpeta depende
-(a) de si consiguió el programa LilyPond descargando un binario
-precompilado desde el sitio web lilypond.org o si lo instaló mediante
-un gestor de paquetes (es decir, distribuido con GNU/Linux, o instalado
-bajo fink o cygwin) o fue compilado a partir de la fuente, y (b) de
-qué sistema operativo está utilizando:
+La documentación del manual de Referencia de Funcionamiento
+Interno contiene montañas de información sobre LilyPond, pero se
+puede obtener más información aún leyendo los archivos internos de
+LilyPond. Para echarles un vistazo, en primer lugar debe buscar
+la carpeta correspondiente a su sistema. La ubicación de esta
+carpeta depende (a) de si consiguió el programa LilyPond
+descargando un binario precompilado desde el sitio web
+lilypond.org o si lo instaló mediante un gestor de paquetes (es
+decir, distribuido con GNU/Linux, o instalado bajo fink o cygwin)
+o fue compilado a partir de la fuente, y (b) de qué sistema
+operativo está utilizando:
@subsubsubheading Descargado de lilypond.org
@end example
bien haciendo @code{cd} hacia este directorio desde el Terminal, o
-bien manteniendo pulsada la tecla de Control y haciendo click sobre la
-aplicación de LilyPond, y allí eligiendo @q{Mostrar el contenido del
-paquete}.
+bien manteniendo pulsada la tecla de Control y haciendo click
+sobre la aplicación de LilyPond, y allí eligiendo @q{Mostrar el
+contenido del paquete}.
@item Windows
@subsubsubheading Instalado mediante un gestor de paquetes o compilado a partir de la fuente
-Diríjase a
-@file{@var{PREFIJO}/share/lilypond/@var{X.Y.Z}/}, donde @var{PREFIJO}
-se encuentra determinado por su administrador de paquetes o guión
-@code{configure}, y @var{X.Y.Z} es el número de la versión de
-LilyPond.
+Diríjase a @file{@var{PREFIJO}/share/lilypond/@var{X.Y.Z}/}, donde
+@var{PREFIJO} se encuentra determinado por su administrador de
+paquetes o guión @code{configure}, y @var{X.Y.Z} es el número de
+la versión de LilyPond.
@smallspace
@item @file{scm/} - contiene archivos en formato Scheme
@end itemize
-Vamos a comenzar observando algunos archivos que están en @file{ly/}.
-Abra @file{ly/property-init.ly} con un editor de textos. El mismo que
-usaría normalmente para los archivos @file{.ly} servirá perfectamente.
-Este archivo contiene las definiciones de todas las instrucciones
-estándar predefinidas de LilyPond, como por ejemplo @code{\tieUp} y
-@code{\slurDotted}. Podrá ver que no son nada más que definiciones de
-variables que contienen una o varias instrucciones @code{\override}.
-Por ejemplo, @code{\tieDotted} está definido de tal forma que su valor
+Vamos a comenzar observando algunos archivos que están en
+@file{ly/}. Abra @file{ly/property-init.ly} con un editor de
+textos. El mismo que usaría normalmente para los archivos
+@file{.ly} servirá perfectamente. Este archivo contiene las
+definiciones de todas las instrucciones estándar predefinidas de
+LilyPond, como por ejemplo @code{\tieUp} y @code{\slurDotted}.
+Podrá ver que no son nada más que definiciones de variables que
+contienen una o varias instrucciones @code{\override}. Por
+ejemplo, @code{\tieDotted} está definido de tal forma que su valor
es:
@example
@tab Definiciones de las instrucciones predefinidas relacionadas con los objetos de extensión
@end multitable
-Otros ajustes (como las definiciones de las instrucciones de marcado)
-se almacenan como archivos @file{.scm} (de Scheme). El lenguaje de
-programación Scheme se utiliza para proporcionar un interfaz
-programable en el funcionamiento interno de LilyPond. Cualquier
-explicación adicional sobre estos archivos se encuentra por el momento
-fuera del ámbito de este manual, porque se requieren conocimientos del
-lenguaje Scheme. Se advierte a los usuarios que se necesita una
-importante cantidad de conocimientos técnicos o de tiempo para
-comprender el lenguaje Scheme y estos archivos (véase @rextend{Tutorial de Scheme}).
+Otros ajustes (como las definiciones de las instrucciones de
+marcado) se almacenan como archivos @file{.scm} (de Scheme). El
+lenguaje de programación Scheme se utiliza para proporcionar un
+interfaz programable en el funcionamiento interno de LilyPond.
+Cualquier explicación adicional sobre estos archivos se encuentra
+por el momento fuera del ámbito de este manual, porque se
+requieren conocimientos del lenguaje Scheme. Se advierte a los
+usuarios que se necesita una importante cantidad de conocimientos
+técnicos o de tiempo para comprender el lenguaje Scheme y estos
+archivos (véase @rextend{Tutorial de Scheme}).
Si ya tiene estos conocimientos, los archivos de Scheme que pueden
interesarle son:
Aunque es posible hacer muchas cosas con las instrucciones
@code{\override} y @code{\tweak} , tenemos una forma incluso más
-poderosa de modificar el funcionamiento de LilyPond, a través de un
-interface programable hacia las operaciones internas de LilyPond. Se
-puede incorporar código escrito en el lenguaje de programación Scheme,
-directamente en el mecanismo de funcionamiento de LilyPond. Por
-supuesto, para hacer esto se necesitan al menos unos conocimientos
-básicos de programación en Scheme, y damos una introducción en el
-@rextend{Tutorial de Scheme}.
-
-Como ejemplo que ilustra una de las muchas posibilidades, en lugar de
-dar a una propiedad un valor constante, se puede establecer al
+poderosa de modificar el funcionamiento de LilyPond, a través de
+un interface programable hacia las operaciones internas de
+LilyPond. Se puede incorporar código escrito en el lenguaje de
+programación Scheme, directamente en el mecanismo de
+funcionamiento de LilyPond. Por supuesto, para hacer esto se
+necesitan al menos unos conocimientos básicos de programación en
+Scheme, y damos una introducción en el @rextend{Tutorial de
+Scheme}.
+
+Como ejemplo que ilustra una de las muchas posibilidades, en lugar
+de dar a una propiedad un valor constante, se puede establecer al
resultado de un procedimiento de Scheme que se invoca cada vez que
-LilyPond accede a esta propiedad. La propiedad se puede establecer
-dinámicamente a un valor determinado por el procedimiento en el
-momento en que se invoca. En este ejemplo damos a las cabezas de las
-notas un color que depende de su posición dentro del pentagrama.
+LilyPond accede a esta propiedad. La propiedad se puede
+establecer dinámicamente a un valor determinado por el
+procedimiento en el momento en que se invoca. En este ejemplo
+damos a las cabezas de las notas un color que depende de su
+posición dentro del pentagrama.
@cindex x11-color, función, ejemplo de utilización
@cindex NoteHead, ejemplo de sobreescritura
}
@end lilypond
-Se pueden encontrar ejemplos adicionales que muestran la utilización
-de estos interfaces programables, en
+Se pueden encontrar ejemplos adicionales que muestran la
+utilización de estos interfaces programables, en
@rextendnamed{Callback functions,Funciones de callback}.
projects / lilypond.git / commitdiff