-@c -*- coding: utf-8; mode: texinfo; -*-
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: es -*-
@c This file is part of lilypond.tely
@ignore
- Translation of GIT committish: 23542761090f167ad42dbff7ef11d44a9c1374ac
+ Translation of GIT committish: 9b6add29eb85dc6cd860593a2c8826a366f8a719
When revising a translation, copy the HEAD committish of the
version that you are working on. See TRANSLATION for details.
@end ignore
-@c \version "2.11.51"
+@c \version "2.11.61"
@node Tweaking output
@chapter Tweaking output
@menu
-* Tweaking basics::
-* The Internals Reference manual::
-* Appearance of objects::
-* Placement of objects::
-* Collisions of objects::
-* Further tweaking::
+* Tweaking basics::
+* The Internals Reference manual::
+* Appearance of objects::
+* Placement of objects::
+* Collisions of objects::
+* Further tweaking::
@end menu
@node Tweaking basics
@section Tweaking basics
@menu
-* Introduction to tweaks::
-* Objects and interfaces::
-* Naming conventions of objects and properties::
-* Tweaking methods::
+* Introduction to tweaks::
+* Objects and interfaces::
+* Naming conventions of objects and properties::
+* Tweaking methods::
@end menu
@node Introduction to tweaks
@node Objects and interfaces
@subsection Objects and interfaces
-@cindex objetos
-@cindex grobs
-@cindex selectores
-@cindex interfaces
+@cindex objeto
+@cindex grob
+@cindex objeto de extensión
+@cindex interfaz
+@cindex propiedades de objetos
+@cindex objeto, propiedades de
+@cindex layout (disposición), objeto de
+@cindex objeto de disposición (layout)
El trucaje consiste en modificar el funcionamiento y estructura
interna del programa LilyPond, por lo que en primer lugar
@node Naming conventions of objects and properties
@subsection Naming conventions of objects and properties
+@cindex nomemclatura, convenciones de, para objetos
+@cindex nomemclatura, convenciones de, para propiedades
+@cindex objetos, convenciones de nomenclatura
+@cindex propiedades, convenciones de nomenclatura
+
Ya hemos visto ciertas convenciones de nomenclatura de objetos, en la
sección @ref{Contexts and engravers}. En este lugar, para más fácil
referencia, presentamos una lista de los tipos de objetos y
propiedades más comunes, junto con las convenciones según las cuales
reciben su nombre, y un par de ejemplos de nombres reales. Hemos
-utilizado una «A» mayúscula para denotar cualquier carácter alfabético
-en mayúsculas, y «aaa» para cualquier número de caracteres alfabéticos
-en minúscula. Otros caracteres se utilizan literalmente como están.
+utilizado una @q{A} mayúscula para denotar cualquier carácter
+alfabético en mayúsculas, y @q{aaa} para cualquier número de
+caracteres alfabéticos en minúscula. Otros caracteres se utilizan
+literalmente como están.
@multitable @columnfractions .33 .33 .33
@headitem Objeto o tipo de propiedad
@tab Convención de nomenclatura
- @tab Ejemplo
+ @tab Ejemplos
@item Contextos
@tab Aaaa o AaaaAaaaAaaa
@tab Staff, GrandStaff
@node Tweaking methods
@subsection Tweaking methods
+@cindex trucaje, métodos de
+
@strong{La instrucción \override}
@cindex override, instrucción
+@cindex override (sobreescritura), sintaxis de
+
@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
La sintaxis genérica de esta instrucción es:
@example
-\override @emph{contexto}.@emph{objeto_de_presentación}
- #'@emph{propiedad_de_presentación} = #@emph{valor}
+\override @var{Contexto}.@var{ObjetoDePresentación} #'@var{propiedad-de-presentación} =
+#@var{valor}
@end example
@noindent
Esto establecerá la propiedad de nombre
-@emph{propiedad_de_presentación} del objeto de presentación con el
-nombre @emph{objeto_de_presentación}, que es miembro del contexto
-@emph{contexto}, al valor @emph{valor}.
+@var{propiedad-de-presentación} del objeto de presentación con el
+nombre @var{ObjetoDePresentación}, que es miembro del contexto
+@var{Contexto}, al valor @var{valor}.
-El @emph{contexto} se puede omitir (y normalmente así es) cuando el
+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
@strong{La instrucción \revert}
@cindex revert, instrucción
+
@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
se han utilizado varias instrucciones @code{\override}.
@example
-\revert @emph{contexto}.@emph{objeto_de_presentación} #'@emph{propiedad_de_presentación}
+\revert @var{Contexto}.@var{ObjetoDePresentación} #'@var{propiedad-de-presentación}
@end example
-Una vez más, igual que @emph{contexto} dentro de la instrucción
+Una vez más, igual que @var{Contexto} dentro de la instrucción
@code{\override}, con frecuencia no es necesario especificar el
-@emph{contexto}. Se omitirá en muchos de los ejemplos siguientes.
+@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:
@strong{El prefijo \once}
+@funindex \once
+@funindex once
+
Tanto la instrucción @code{\override} como @code{\set} se pueden
preceder por @code{\once}. Esto ocasiona que la siguiente instrucción
@code{\override} o @code{\set} sea efectiva solamente durante el
@strong{La instrucción \overrideProperty}
@cindex overrideProperty, instrucción
+
@funindex \overrideProperty
+@funindex overrideProperty
Hay otra forma para la instrucción de sobreescritura,
@code{\overrideProperty}, que ocasionalmente es necesaria. La
@strong{La instrucción \tweak}
@cindex tweak, instrucción
+
@funindex \tweak
+@funindex tweak
La última instrucción de trucaje que está disponible es @code{\tweak}.
Se debe utilizar para cambiar las propiedades de objetos que suceden
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 nota
-intermedia (el Mi) en un acorde de Do mayor. En primer lugar, veamos
-lo que haría @code{\once \override}:
+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
+primer lugar, veamos lo que haría @code{\once \override}:
@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
<c e g>4
@end lilypond
Vemos que la sobreescritura con override afecta a @emph{todas} 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
+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.
-Sin embargo, es efectivo solamente sobre objetos que se crean
-directamente a partir del flujo de entrada, en esencia las cabezas y
-las articulaciones (los objetos como las plicas y las alteraciones se
-crean con posterioridad y no se pueden trucar de esta forma). Es más,
+La instrucción @code{\tweak} opera de una forma distinta. Actúa sobre
+el elemento inmediatamente siguiente dentro del flujo de entrada. Sin
+embargo, es efectivo solamente sobre objetos que se crean directamente
+a partir del flujo de entrada, en esencia las cabezas y las
+articulaciones; los objetos como las plicas y las alteraciones se
+crean con posterioridad y no se pueden trucar de esta forma. Es más,
cuando se aplica a las cabezas de las notas, éstas @emph{deben} estar
dentro de un acorde, es decir, dentro de ángulos simples, así que para
trucar una sola nota la instrucción @code{\tweak} se debe colocar
presentación se deben especificar; de hecho, generaría un error
hacerlo. Los dos están implícitos por el siguiente elemento del flujo
de entrada. Así que la sintaxis genérica de la instrucción
-@code{\tweak} es, simplemente:
+@code{\tweak} es, simplemente,
@example
-\tweak #'@emph{propiedad_de_presentación} = #@emph{valor}
+\tweak #'@var{propiedad-de-presentación} = #@var{valor}
@end example
Una instrucción @code{\tweak} también se puede usar para modificar
-\tweak #'color #green _Green
@end lilypond
+@noindent
Observe que la instrucción @code{\tweak} debe venir precedida de una
marca de articulación como si ella misma fuera una articulación.
@cindex corchete del grupo especial
@cindex grupo especial, corchete de
@cindex tresillo, corchete de
+
@funindex TupletBracket
La instrucción @code{\tweak} también se debe usar para cambiar la
}
@end lilypond
-Encontrará más detalles de la instrucción @code{\tweak} en
-@ruser{Objects connected to the input}.
-
Si los grupos anidados no comienzan en el mismo momento, su apariencia
se puede modificar de la forma usual mediante instrucciones
@code{\override}:
}
@end lilypond
+@seealso
+
+Referencia de la notación:
+@ruser{The tweak command}.
+
+
@node The Internals Reference manual
@section The Internals Reference manual
@cindex Internals Reference
@menu
-* Properties of layout objects::
-* Properties found in interfaces::
-* Types of properties::
+* Properties of layout objects::
+* Properties found in interfaces::
+* Types of properties::
@end menu
@node Properties of layout objects
@cindex propiedades de los grobs
@cindex grobs, propiedades de
@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
Utilicemos un ejemplo concreto con un sencillo fragmento de música
real:
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+@lilypond[quote,verbatim,relative=2]
{
\time 6/8
{
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 html, no la @q{en una sola
+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.
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
+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 del funcionamiento interno. Este enlace le llevará
-directamente a esta página, aunque con frecuencia es 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
respuesta es: @q{Dentro de la música, antes de la primera ligadura y
cerca de ella.} Hagámoslo así:
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+@lilypond[quote,verbatim,relative=2]
{
\time 6/8
{
continuación.
@subheading Finding the context
+
@cindex contexto, encontrar
+@cindex contexto, buscar, correcto
Pero en primer lugar ¿qué habría pasado si hubiésemos tenido que
especificar el contexto? ¿Cuál sería? Podemos suponer que las
@cindex sobreescritura por una sola vez
@cindex once override
+
@funindex \once
+@funindex once
Como puede ver, @emph{todas} las ligaduras son más gruesas en el
último ejemplo. Pero ¿y si quisiéramos que solamente la primera
la instrucción que lleva @code{\once} se debe reposicionar de la forma
siguiente:
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+@lilypond[quote,verbatim,relative=2]
{
\time 6/8
{
@subheading Reverting
@cindex revert
-@cindex predeterminadas, devolver a las propiedades
+@cindex predeterminadas, recuperar las propiedades
+
@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
inmediatamente antes de cada una de las notas en que comienzan las
ligaduras:
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+@lilypond[quote,verbatim,relative=2]
{
\time 6/8
{
del grosor, @code{thickness}, a su valor predeterminado después de la
segunda ligadura:
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+@lilypond[quote,verbatim,relative=2]
{
\time 6/8
{
@node Properties found in interfaces
@subsection Properties found in interfaces
+@cindex interface
@cindex propiedades de los interfaces
@cindex interfaces, propiedades
interface.
Mire de nuevo la página del RFI que describe a LyricText. Al final de
-la página hay una lista de enlaces (en las versiones de html del RFI)
-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.
+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.
Ahora vemos todas las propiedades ajustables por el usuario que
controlan las tipografías, entre ellas @code{font-shape(symbol)},
Como nota aparte, aunque una nota importante, observe que a causa de
que los valores de @code{font-shape} son símbolos, deben ir precedidos
-de un apóstrofe, @code{'}. Esa es la razón por la que se necesitan
-apóstrofes antes de @code{thickness} en el ejemplo anterior y en
+de un apóstrofo, @code{'}. Esa es la razón por la que se necesitan
+apóstrofos antes de @code{thickness} en el ejemplo anterior y en
@code{font-shape}. Los dos son también símbolos. Los símbolos son
nombres especiales que son conocidos por LilyPond internamente.
Algunos de ellos son nombres de propiedades, como @code{thickness} o
-@code{font-shape}, otros son en efecto valores especiales que se les
-puede dar a las propiedades, como @code{italic}. Observe la
-distinción entre esto y las cadenas de texto arbitrarias, que
-aparecerían entrecomilladas como @code{"a text string"}.
+@code{font-shape}, otros se utilizan como valores que se les puede dar
+a las propiedades, como @code{italic}. Observe la distinción entre
+esto y las cadenas de texto arbitrarias, que aparecerían
+entrecomilladas como @code{"a text string"}. Para ver más detalles
+relacionados con los símbolos y las cadenas, consulte @ref{Scheme
+tutorial}.
-De acuerdo, entonces la instrucción @code{\override} que necesitamos
-para imprimir la letra en cursiva sería
+Así pues, la instrucción @code{\override} que necesitamos para
+imprimir la letra en cursiva sería
@example
\override LyricText #'font-shape = #'italic
y toda la letra se imprime en cursiva.
@subheading Specifying the context in lyric mode
+
@cindex contexto, especificación en modo letra
+@cindex letra, modo, especificar el contexto en
En el caso de la letra, si intenta especificar el contexto en el
formato que acabamos de dar, la instrucción no funcionará. Una
escriba siempre espacios antes y después del punto que separa el
nombre del contexto y el nombre del objeto.}
+@seealso
+
+Manual de aprendizaje:
+@ref{Scheme tutorial}.
+
@node Types of properties
@subsection Types of properties
@tab Un número decimal positivo (en unidades de espacios de pentagrama)
@tab @code{2.5}, @code{0.34}
@item Dirección
- @tab Una constante válida de dirección o su equivalente numérico
- @tab @code{#LEFT}, @code{#CENTER}, @code{#UP},
+ @tab Una constante válida de dirección o su equivalente numérico (se permiten valores decimales entre -1 y 1)
+ @tab @code{LEFT}, @code{CENTER}, @code{UP},
@code{1}, @code{-1}
@item Entero
@tab Un número entero positivo
@tab @code{3}, @code{1}
@item Lista
- @tab Un conjunto de elementos entre paréntesis separados por espacios y precedido de un apóstrofe
+ @tab Un conjunto de valores separados por espacios, encerrado entre paréntesis y precedido de un apóstrofo
@tab @code{'(left-edge staff-bar)}, @code{'(1)},
@code{'(1.0 0.25 0.5)}
@item Marcado
@tab Cualquier valor decimal positivo o negativo
@tab @code{3.5}, @code{-2.45}
@item Pareja (de números)
- @tab Dos números separados por un @q{espacio . espacio}, encerrado entre paréntesis y precedido de un apóstrofe
+ @tab Dos números separados por un @q{espacio . espacio}, encerrado entre paréntesis y precedido de un apóstrofo
@tab @code{'(2 . 3.5)}, @code{'(0.1 . -3.2)}
@item Símbolo
- @tab Cualquiera del conjunto de símbolos permitidos para esa propiedad, precedido de un apóstrofe
+ @tab Cualquiera del conjunto de símbolos permitidos para esa propiedad, precedido de un apóstrofo
@tab @code{'italic}, @code{'inside}
@item Desconocido
- @tab Un procedimiento o @code{#f} (para no producir ninguna acción)
+ @tab Un procedimiento o @code{#f} para no producir ninguna acción
@tab @code{bend::print}, @code{ly:text-interface::print},
@code{#f}
@item Vector
- @tab Una lista de tres elementos encerrados entre paréntesis y precedida de una almohadilla, @code{#}.
- @tab @code{#(#t #t #f)}
+ @tab Una lista de tres elementos encerrados entre paréntesis y precedida de apóstrofo-almohadilla, @code{'#}.
+ @tab @code{'#(#t #t #f)}
@end multitable
+@seealso
+
+Manual de aprendizaje:
+@ref{Scheme tutorial}.
+
@node Appearance of objects
@section Appearance of objects
cambiar el aspecto de la música impresa.
@menu
-* Visibility and color of objects::
-* Size of objects::
-* Length and thickness of objects::
+* Visibility and color of objects::
+* Size of objects::
+* Length and thickness of objects::
@end menu
@node Visibility and color of objects
Antes de enredarnos con esto, recordemos que las propiedades de los
objetos se agrupan en lo que hemos llamado @emph{interfaces} (véase
@ref{Properties found in interfaces}). Esto es simplemente agrupar
-las propiedades que normalmente se necesitan juntas: si una de ellas
-se necesita para un objeto, también las otras. Así, ciertos objetos
-necesitan las propiedades de algunos interfaces, otros necesitan 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.
+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{Properties of layout objects}. Usando el mismo enfoque, vamos al
considerar cada uno de ellos por orden.
@subheading stencil
+
@cindex stencil (sello), propiedad
Esta propiedad controla la apariencia de las barras de compás mediante
se imprimen al final de una línea, en mitad de una línea, y al
principio de las líneas. Para nuestro ejemplo, queremos que todas las
barras de compás se supriman, por lo que el valor que necesitamos es
-@code{#(#f #f #f)}. Vamos a probarlo, recordando incluir el contexto
-de @code{Staff}. Observa también que al escribir este valor tenemos
-dos símbolos de almohadilla antes del paréntesis de apertura. Se
-necesita uno como parte del valor para introducir un vector, y se
-necesita otro más, como siempre, para preceder el propio valor dentro
-de la instrucción @code{\override}.
+@code{'#(#f #f #f)}. Vamos a probarlo, recordando incluir el contexto
+de @code{Staff}. Observe también que al escribir este valor tenemos
+@code{#'#} antes del paréntesis de apertura. Se necesita @code{'#}
+como parte del valor para introducir un vector, y el primer símbolo de
+almohadilla @code{#} se necesita, como siempre, para preceder el valor
+en sí dentro de la instrucción @code{\override}.
@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
{
Y podemos ver que esto también quita todas las líneas divisorias.
@subheading transparent
+
@cindex transparente, propiedad
+@cindex transparencia
En la relación de propiedades que se especifican en la página del
@code{grob-interface} del RFI podemos ver que la propiedad
lo dejamos donde está, pero lo hacemos invisible.
@subheading color
+
@cindex color, propiedad
-Para finalizar, podríamos hacer invisibles las barras de compás
-pintándolas de color blanco. 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{List of colors}. Para poner las líneas divisorias de color
-blanco, escribimos:
+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{Painting objects white}; 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{List of colors}. Para
+poner las líneas divisorias de color blanco, escribimos:
@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
{
@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óstrofe: no es un
+Observe que @emph{white} no viene precedido de un apóstrofo: no es un
símbolo, sino una @emph{función}. Cuando se invoca, 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 funciones.
@cindex colores de X11
@cindex X11, colores de
+@funindex x11-color
+
La segunda forma de cambiar el color es utilizar la lista de nombres
de colores de X11 que aparecen en la segunda lista de @ruser{List of
colors}. Sin embargo, éstos deben ir precedidos de otra función, que
@noindent
Observe que en este caso la función @code{x11-color} toma un símbolo
-como argumento, así que el símbolo debe ir precedido de un apóstrofe y
+como argumento, así que el símbolo debe ir precedido de un apóstrofo y
los dos deben ir entre paréntesis.
@cindex rgb, colores
@cindex color, rgb
+@funindex rgb-color
+
Aún hay una tercera 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
@node Size of objects
@subsection Size of objects
+@cindex cambiar el tamaño de los objetos
+@cindex tamaño de los objetos
+@cindex objetos, tamaño de
+@cindex objetos, cambiar el tamaño de
+
Empezaremos examinando de nuevo un ejemplo anterior (véase
@ref{Nesting music expressions}) que nos mostraba cómo introducir un
pentagrama temporal, como en un @rglos{ossia}.
@section Placement of objects
@menu
-* Automatic behaviour::
-* Within-staff objects::
-* Outside staff objects::
+* Automatic behaviour::
+* Within-staff objects::
+* Outside-staff objects::
@end menu
@node Automatic behaviour
@subsection Automatic behaviour
+@cindex dentro del pentagrama, objetos
+@cindex fuera del pentagrama, 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,
hacia abajo. Esto se controla automáticamente cuando está establecida
la propiedad @code{direction}.
+@cindex abajo
+@cindex arriba
+@cindex centro
+@cindex neutro
+
El ejemplo siguiente muestra en el compás 1 el comportamiento
predeterminado de las plicas, con las de las notas agudas apuntando
hacia abajo y las graves hacia arriba, seguidas de cuatro notas con
sencillas. Aquí podemos ver una tabla de las más comunes. Se
menciona el significado de cada una allí donde no es obvio.
-@multitable @columnfractions .2 .2 .2 .4
+@multitable @columnfractions .2 .2 .25 .35
@headitem Abajo o Izquierda
@tab Arriba o Derecha
@tab Anular
nota afectada por la instrucción @code{\xxxNeutral} correspondiente.
@subheading Fingering
+
@cindex digitación, colocación
+@cindex digitación de acordes
-La colocación de las digitaciones también resulta afectada por el
-valor de su propiedad @code{direction}, pero 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; el primer compás muestra el comportamiento
-predeterminado, y después el efecto de especificar @code{DOWN} y
-@code{UP}:
+digitaciones aplicadas a notas sueltas. Se muestra en el primer
+compás el comportamiento predeterminado, y en los dos comases
+siguiente el efecto de especificar @code{DOWN} y @code{UP}:
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+@lilypond[quote,verbatim,relative=2]
c-5 a-3 f-1 c'-5
\override Fingering #'direction = #DOWN
c-5 a-3 f-1 c'-5
c-5 a-3 f-1 c'-5
@end lilypond
-Así es como se controla la digitación sobre notas aisladas, pero la
-propiedad @code{direction} se ignora para los acordes. En su lugar,
-de forma predeterminada las digitaciones se colocan automáticamente
-encima y debajo de las notas del acorde, como se muestra aquí:
+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:
-@lilypond[quote,fragment,ragged-right,verbatim,relative=2]
+@lilypond[quote,verbatim,relative=2]
+c-5 a-3 f-1 c'-5
+c_5 a_3 f_1 c'_5
+c^5 a^3 f^1 c'^5
+@end lilypond
+
+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í:
+
+@lilypond[quote,verbatim,relative=2]
<c-5 g-3>
<c-5 g-3 e-2>
<c-5 g-3 e-2 c-1>
@end lilypond
-Es posible tener un mayor control sobre la situación exacta de las
+@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:
+
+@lilypond[quote,verbatim,relative=2]
+<c-5 g-3 e-2 c-1>
+<c^5 g_3 e_2 c_1>
+<c^5 g^3 e^2 c_1>
+@end lilypond
+
+Es posible ejercer un control aún mayor sobre la colocación de las
digitaciones mediante la utilización de la instrucción @code{\set
-fingeringOrientations}. El formato de esta instrucción es
+fingeringOrientations}. El formato de esta instrucción es:
@example
@code{\set fingeringOrientations = #'([up] [left/right] [down])}
@code{left} y @code{right} son mutuamente excluyentes: las
digitaciones pueden situarse en un lado o en el otro, no en los dos.
-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.
+@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.}
Aquí podemos ver algunos ejemplos:
< c-1 e-2 g-3 b-5 > 4
@end lilypond
-@node Outside staff objects
-@subsection Outside staff objects
+
+@node Outside-staff objects
+@subsection Outside-staff objects
Los objetos fuera-del-pentagrama se colocan automáticamente para
evitar las colisiones. Los objetos que tienen el valor más bajo de la
de ellos.
@cindex texto, extensiones de
+@cindex octava alta y baja, corchete de
+
@funindex \startTextSpan
+@funindex startTextSpan
@funindex \stopTextSpan
-@cindex octava alta y baja, corchete de
+@funindex stopTextSpan
@lilypond[quote,fragment,ragged-right,verbatim,relative=1]
% Set details for later Text Spanner
% Place dynamics above staff
\dynamicUp
% Start Ottava Bracket
-#(set-octavation 1)
+\ottava #1
c' \startTextSpan
% Add Dynamic Text
c\pp
% Add Dynamic Text
c\ff c \stopTextSpan
% Stop Ottava Bracket
-#(set-octavation 0)
+\ottava #0
c, c c c
@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
+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
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 marcas metronómicas
+@cindex metrónomo, situación de las indicaciones de
+@cindex trucar la situación de las letras de ensayo
+@cindex ensayo, letras, trucar la colocación
+
Observe que los números de compás, las indicaciones metronómicas y las
mercas de ensayo no se muestran. De forma predeterminada, se crean
dentro del contexto @code{Score} y su prioridad
%Place following Ottava Bracket below Text Spanners
\once \override Staff.OttavaBracket #'outside-staff-priority = #340
% Start Ottava Bracket
-#(set-octavation 1)
+\ottava #1
c' \startTextSpan
% Add Dynamic Text
c\pp
% Add Dynamic Text
c\ff c \stopTextSpan
% Stop Ottava Bracket
-#(set-octavation 0)
+\ottava #0
c, c c c
@end lilypond
@subheading \textLengthOn
-@funindex \textLengthOn
@cindex notas, espaciar junto al texto
+@funindex \textLengthOn
+@funindex 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
con @code{\override}, @code{\set}, @code{\revert} o @code{unset}, así
que no se puede usar con @code{\textLengthOn}.
+@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
@subheading Dynamics
+@cindex trucar la colocación de los matices
+@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
@cindex grob, cambio de tamaño de un
@cindex escala de los grobs
-@cindex @code{X-offset}
-@cindex @code{Y-offset}
-@cindex @code{X-extent}
-@cindex @code{Y-extent}
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
@section Collisions of objects
@menu
-* Moving objects::
-* Fixing overlapping notation::
-* Real music example::
+* Moving objects::
+* Fixing overlapping notation::
+* Real music example::
@end menu
@node Moving objects
@subsection Moving objects
+@cindex mover objetos superpuestos
+@cindex mover objetos que colisionan
+@cindex moving grobs que colisionan
+@cindex objetos que colisionan, mover
+@cindex grobs, mover, que colisionan
+
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á 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
@item
izquierda), @code{right-padding} (relleno por la derecha),
@code{staff-padding} (relleno de pentagrama)
+@cindex relleno
@cindex left-padding, propiedad
@cindex padding, propiedad
@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
alteraciones se controla con @code{left-padding} y
@code{right-padding}. Estas propiedades se encontrarán en el objeto
@code{AccidentalPlacement} que, observe, vive dentro del contexto de
-@strong{staff}. Como las alteraciones accidentales siempre se
-posicionan según las cabezas de las notas y a su izquierda, solamente
-tiene algún efecto la propiedad de relleno por la derecha
-@code{right-padding}.
+@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. 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
@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
@code{extra-spacing-width} (anchura de separación adicional)
@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
@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
@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
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
superpone.
@subheading padding property
-@cindex relleno, propiedad
-@cindex padding, propiedad
+
+@cindex relleno
+@cindex arreglar notación que se superpone
+@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
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{Constructing a
-tweak}.
+inadvertidos. Para ver más detalles, consulte @ruser{Modifying
+properties}.
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
@subheading left-padding and right-padding
+
@cindex left-padding, propiedad
@cindex right-padding, propiedad
@noindent
@subheading staff-padding property
-@cindex staff-padding, propiedad
+
+@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 altura fija sobre el
@subheading self-alignment-X property
-@cindex self-alignment-X, propiedad
El ejemplo siguiente muestra cómo esto puede resolver la colisión
entre un objeto de digitación de cuerda y la plica de una nota
@end lilypond
@subheading staff-position property
-@cindex staff-position, propiedad
+
+@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
la línea adicional por encima del silencio se inserta automáticamente.
@subheading extra-offset property
-@cindex extra-offset, propiedad
+
+@cindex posicionar objetos
+@cindex posicionar grobs
+@cindex objetos, posicionar
+@cindex grobs, posicionar
La propiedad @code{extra-offset} da un completo control sobre el
posicionamiento de un objeto tanto vertical como horizontalmente.
@subheading positions property
-@cindex positions, propiedad
+
+@cindex controlar manualmente grupos especiales, ligaduras y barras
+@cindex manual, control, de grupos especiales, ligaduras y barras
+@cindex grupos especiales, barras de, control manual
+@cindex ligaduras de expresión, control manual
+@cindex ligaduras de fraseo, control manual
+@cindex barras de corchea, control manual
La propiedad @code{positions} permite controlar manualmente la
posición e inclinación de los tresillos, ligaduras de expresión y de
@end lilypond
@noindent
-pero si por algún motivo no pudiéramos hacerlo, la otra alternativa
+Pero si por algún motivo no pudiéramos hacerlo, la otra alternativa
sería mover el extremo izquierdo de la ligadura de fraseo un poco
hacia abajo usando la propiedad @code{positions}. Esto también
resuelve la forma algo indecente de la ligadura.
segunda voz.
@subheading force-hshift property
-@cindex force-hshift, propiedad
+
@c FIXME: formatting stuff (ie not important right now IMO)
@c @a nchor Chopin finally corrected TODOgp
bes1~ |
\bar "||"
\time 6/4
- \override Staff.NoteCollision #'merge-differently-headed = ##t
- \override Staff.NoteCollision #'merge-differently-dotted = ##t
+ \mergeDifferentlyHeadedOn
+ \mergeDifferentlyDottedOn
bes2.^\markup {\bold "Moderato"} r8
<<
{c,8[ d fis bes a] | }
\\
{s4 fis4.}
>>
- \revert Staff.NoteCollision #'merge-differently-headed
- \revert Staff.NoteCollision #'merge-differently-dotted
+ \mergeDifferentlyHeadedOff
+ \mergeDifferentlyDottedOff
g2.\)
}
tutorial nos enseñó cómo escribir texto en negrita mediante la
instrucción @code{\markup}, por lo que añadir @q{Moderato} en negrita
es fácil. Pero ahora ¿cómo fundimos notas que están en distintas
-voces? El índice de la Referencia de la Notación no menciona la
-mezcla de notas, pero una búsqueda de texto por la palabra @q{fusión}
-o @q{mezcla} nos lleva rápidamente a las sobreescrituras necesarias
-para mezclar o fusionar notas con distinta cabeza y con o sin puntillo
-en @ruser{Collision resolution}. 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
+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{Collision resolution}. 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
-\override Staff.NoteCollision #'merge-differently-headed = ##t
-\override Staff.NoteCollision #'merge-differently-dotted = ##t
+\mergeDifferentlyHeadedOn
+\mergeDifferentlyDottedOn
@end example
@noindent
al principio de la sección, y
@example
-\revert Staff.NoteCollision #'merge-differently-headed
-\revert Staff.NoteCollision #'merge-differently-dotted
+\mergeDifferentlyHeadedOff
+\mergeDifferentlyDottedOff
@end example
@noindent
\bar "||"
\time 6/4
bes2.^\markup {\bold "Moderato"} r8
- \override Staff.NoteCollision #'merge-differently-headed = ##t
- \override Staff.NoteCollision #'merge-differently-dotted = ##t
+ \mergeDifferentlyHeadedOn
+ \mergeDifferentlyDottedOn
% Start polyphonic section of four voices
<<
{c,8[ d fis bes a] | }
\\
{s4 fis4. | }
>>
- \revert Staff.NoteCollision #'merge-differently-headed
- \revert Staff.NoteCollision #'merge-differently-dotted
+ \mergeDifferentlyHeadedOff
+ \mergeDifferentlyDottedOff
g2.\)
}
\bar "||"
\time 6/4
bes2.^\markup {\bold "Moderato"} r8
- \override Staff.NoteCollision #'merge-differently-headed = ##t
- \override Staff.NoteCollision #'merge-differently-dotted = ##t
+ \mergeDifferentlyHeadedOn
+ \mergeDifferentlyDottedOn
% Start polyphonic section of four voices
<<
{c,8[ d fis bes a] | }
\\
{s4 fis4. | }
>>
- \revert Staff.NoteCollision #'merge-differently-headed
- \revert Staff.NoteCollision #'merge-differently-dotted
+ \mergeDifferentlyHeadedOff
+ \mergeDifferentlyDottedOff
g2.\)
}
\bar "||"
\time 6/4
bes2.^\markup {\bold "Moderato"} r8
- \override Staff.NoteCollision #'merge-differently-headed = ##t
- \override Staff.NoteCollision #'merge-differently-dotted = ##t
+ \mergeDifferentlyHeadedOn
+ \mergeDifferentlyDottedOn
<<
{c,8[ d fis bes a] | }
\\
\\
{s4 fis4.}
>>
- \revert Staff.NoteCollision #'merge-differently-headed
- \revert Staff.NoteCollision #'merge-differently-dotted
+ \mergeDifferentlyHeadedOff
+ \mergeDifferentlyDottedOff
g2.\)
}
@section Further tweaking
@menu
-* Other uses for tweaks::
-* Using variables for tweaks::
-* Other sources of information::
-* Avoiding tweaks with slower processing::
-* Advanced tweaks with Scheme::
+* Other uses for tweaks::
+* Using variables for tweaks::
+* Other sources of information::
+* Avoiding tweaks with slower processing::
+* Advanced tweaks with Scheme::
@end menu
@node Other uses for tweaks
@cindex objetos, hace invisibles
@cindex eliminar objetos
@cindex objetos, eliminar
+@cindex objetos, ocultar
@cindex ocultar objetos
@cindex invisibles, objetos
+@cindex objetos invisibles
@cindex ligar notas entre voces distintas
@subheading Tying notes across voices
>>
@end lilypond
-@subheading Simulating a fermata
+@subheading Simulating a fermata in MIDI
@cindex sello, uso de la propiedad
@cindex fermata, realización en MIDI
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 o entre las notas del 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:
+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:
@lilypond[quote,verbatim,ragged-right]
\score {
\tempo 4=120
a4 a a
\once \override Score.MetronomeMark #'transparent = ##t
- % Invisible tempo marking to lengthen fermata note in MIDI
+ % Invisible tempo marking to lengthen fermata in MIDI
\tempo 4=80
a\fermata
- \once \override Score.MetronomeMark #'stencil = ##f
- % Invisible tempo marking to restore tempo in MIDI
+ % New tempo for next section
+ \tempo 4=100
+ a a a a
+ }
+ \layout { }
+ \midi { }
+}
+@end lilypond
+
+@lilypond[quote,verbatim,ragged-right]
+\score {
+ \relative c'' {
+ % Visible tempo marking
\tempo 4=120
+ a4 a a
+ \once \override Score.MetronomeMark #'stencil = ##f
+ % Invisible tempo marking to lengthen fermata in MIDI
+ \tempo 4=80
+ a\fermata
+ % New tempo for next section
+ \tempo 4=100
a a a a
}
\layout { }
@end lilypond
@noindent
-Ambos métodos quitan la indicación metronómica de la salida impresa, y
-los dos afectan al tempo del MIDI tal y como queríamos, pero la
-primera indicación de metrónomo (la transparente) aún influye sobre la
-separación de las notas, mientras que la segunda (sin «sello») no
-influye.
+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, meintras que la segunda (con el sello suprimido) no lo hace.
@node Using variables for tweaks
@subsection Using variables for tweaks
+@cindex variables, uso de, para trucos
+@cindex usar variables para hacer trucos
+@cindex trucos, 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.
Suponga 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} no funcionan dentro de la letra de las
-canciones, así que tenemos de usar en su lugar las siguientes
-instrucciones @code{\override} y @code{\revert}:
+@code{\italic} y @code{\bold} sólo funcionan dentro de la letra de las
+canciones si están incluidas dentro de un @code{\markup}, lo que las
+hace tediosas de escribir. ¿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 serían extremadamente tediosas de escribir si
-hubiera muchas palabras que quisiéramos subrayar. Entonces, en vez de
-esto las definimos como dos variables, y las usamos de la siguiente
-forma:
+Estas instrucciones también serían extremadamente tediosas de escribir
+si hubiera muchas palabras que quisiéramos subrayar. Entonces, en vez
+de esto las definimos como dos variables, y las usamos de la siguiente
+forma, aunque normalmente quizá elegiríamos unos nombres de variable
+más cortos para que fueran más rápidos de teclear:
@lilypond[quote,verbatim]
-emph = {
+emphasize = {
\override Lyrics . LyricText #'font-shape = #'italic
\override Lyrics . LyricText #'font-series = #'bold
}
-norm = {
+normal = {
\revert Lyrics . LyricText #'font-shape
\revert Lyrics . LyricText #'font-series
}
global = { \time 4/4 \partial 4 \key c \major}
-SopMusic = \relative c' { c4 | e4. e8 g4 g | a a g }
+SopranoMusic = \relative c' { c4 | e4. e8 g4 g | a a g }
AltoMusic = \relative c' { c4 | c4. c8 e4 e | f f e }
TenorMusic = \relative c { e4 | g4. g8 c4. b8 | a8 b c d e4 }
BassMusic = \relative c { c4 | c4. c8 c4 c | f8 g a b c4 }
-VerseOne = \lyrics { E -- | ter -- nal \emph Fa -- ther, \norm | strong to save, }
-VerseTwo = \lyricmode { O | \emph Christ, \norm whose voice the | wa -- ters heard, }
-VerseThree = \lyricmode { O | \emph Ho -- ly Spi -- rit, \norm | who didst brood }
-VerseFour = \lyricmode { O | \emph Tri -- ni -- ty \norm of | love and pow'r }
+VerseOne = \lyrics { E -- | ter -- nal \emphasize Fa -- ther, \normal | strong to save, }
+VerseTwo = \lyricmode { O | \emphasize Christ, \normal whose voice the | wa -- ters heard, }
+VerseThree = \lyricmode { O | \emphasize Ho -- ly Spi -- rit, \normal | who didst brood }
+VerseFour = \lyricmode { O | \emphasize Tri -- ni -- ty \normal of | love and pow'r }
\score {
\new ChoirStaff <<
\new Staff <<
\clef "treble"
- \new Voice = "Sop" { \voiceOne \global \SopMusic }
+ \new Voice = "Soprano" { \voiceOne \global \SopranoMusic }
\new Voice = "Alto" { \voiceTwo \AltoMusic }
- \new Lyrics \lyricsto "Sop" { \VerseOne }
- \new Lyrics \lyricsto "Sop" { \VerseTwo }
- \new Lyrics \lyricsto "Sop" { \VerseThree }
- \new Lyrics \lyricsto "Sop" { \VerseFour }
+ \new Lyrics \lyricsto "Soprano" { \VerseOne }
+ \new Lyrics \lyricsto "Soprano" { \VerseTwo }
+ \new Lyrics \lyricsto "Soprano" { \VerseThree }
+ \new Lyrics \lyricsto "Soprano" { \VerseFour }
>>
\new Staff <<
\clef "bass"
@end lilypond
-
@node Other sources of information
@subsection 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 busque la carpeta correspondiente
-a su sistema, de la siguiente forma:
+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 Linux, o instalado
+bajo fink o cygwin) o fue compilado a partir de la fuente, y (b) de
+qué sistema operativo está utilizando:
+
+
+@strong{Descargado de lilypond.org}
-@strong{Linux}
+@itemize @bullet
+@item Linux
Diríjase a
-@file{@var{installdir}/lilypond/usr/share/lilypond/current/}
+@file{@var{CARPETA_DE_INSTALACIÓN}/lilypond/usr/share/lilypond/current/}
-@strong{MacOS X}
+@item MacOS X
Diríjase a
-@file{@var{installdir}/LilyPond.app/Contents/Resources/share/lilypond/current/}
+@file{@var{CARPETA_DE_INSTALACIÓN}/LilyPond.app/Contents/Resources/share/lilypond/current/}
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}.
-@strong{Windows}
+@item Windows
Mediante el Explorador de Windows, diríjase a
-@file{@var{installdir}/LilyPond/usr/share/lilypond/current/}
+@file{@var{CARPETA_DE_INSTALACIÓN}/LilyPond/usr/share/lilypond/current/}
+
+@end itemize
+
+@strong{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.
+
+@smallspace
Dentro de esta carpeta, las dos subcarpetas interesantes son
@itemize
-@item @file{../ly/ } - contiene archivos en formato LilyPond
-@item @file{../scm/} - contiene archivos en formato Scheme
+@item @file{ly/} - contiene archivos en formato LilyPond
+@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 @code{.ly}
-servirá perfectamente. Este archivo contiene las definiciones de
-todas las instrucciones incorporadas como estándar dentro de LilyPond,
-como por ejemplo @code{\stemUp} 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:
+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 @code{.ly} servirá perfectamente.
+Este archivo contiene las definiciones de todas las instrucciones
+estándar predefinidas de LilyPond, como por ejemplo @code{\stemUp} 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
tieDotted = @{
@end example
Si no le gustan los valores predeterminados, estas instrucciones
-incorporadas se pueden redefinir con facilidad como cualquier otra
+predefinidas se pueden redefinir con facilidad como cualquier otra
variable, al principio de su archivo de código de entrada.
Los siguientes son los archivos más útiles que se encuentran en
-@file{../ly/}:
+@file{ly/}:
@multitable @columnfractions .4 .6
@headitem Archivo
@tab Contenido
-@item @file{../ly/engraver-init.ly}
+@item @file{ly/engraver-init.ly}
@tab Definiciones de Contextos de grabadores
-@item @file{../ly/paper-defaults.ly}
+@item @file{ly/paper-defaults-init.ly}
@tab especificaciones de valores predeterminados relacionados con el papel
-@item @file{../ly/performer-init.ly}
+@item @file{ly/performer-init.ly}
@tab Definiciones de Contextos de interpretación
-@item @file{../ly/property-init.ly}
- @tab Definiciones de todas las instrucciones incorporadas que son comunes
+@item @file{ly/property-init.ly}
+ @tab Definiciones de todas las instrucciones predefinidas que son comunes
+@item @file{ly/spanner-init.ly}
+ @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)
@multitable @columnfractions .4 .6
@headitem Archivo
@tab Contenido
-@item @file{../scm/auto-beam.scm}
+@item @file{scm/auto-beam.scm}
@tab Valores predeterminados de sub-barrado
-@item @file{../scm/define-grobs.scm}
+@item @file{scm/define-grobs.scm}
@tab valores predeterminados de las propiedades de grobs
-@item @file{../scm/define-markup-commands.scm}
+@item @file{scm/define-markup-commands.scm}
@tab Especificar todas las instrucciones de marcado
-@item @file{../scm/midi.scm}
+@item @file{scm/midi.scm}
@tab Ajustes predeterminados para la salida MIDI
-@item @file{../scm/output-lib.scm}
+@item @file{scm/output-lib.scm}
@tab Ajustes que afectan al aspecto de los trastes, colores, alteraciones, lineas divisorias, etc.
-@item @file{../scm/parser-clef.scm}
+@item @file{scm/parser-clef.scm}
@tab Definiciones de las claves contempladas
-@item @file{../scm/script.scm}
+@item @file{scm/script.scm}
@tab Ajustes predeterminados para las articulaciones
@end multitable
\relative c' {
% Arrange to obtain color from color-notehead procedure
\override NoteHead #'color = #color-notehead
- c2 c' |
- b4 g8 a b4 c |
- c,2 a' |
+ c2 c' |
+ b4 g8 a b4 c |
+ c,2 a' |
g1 |
}
\addlyrics {
projects / lilypond.git / blobdiff