GNU LilyPond: Manual de aprendizaje

Este documento también está disponible en formato PDF y como una sola página.

Este archivo es la documentación de GNU LilyPond orientada a quienes empiezan con el programa.

Copyright © 1999–2008 por los autores

La traducción de la siguiente nota de copyright se ofrece como cortesía para las personas de habla no inglesa, pero únicamente la nota en inglés tiene validez legal.

The translation of the following copyright notice is provided for courtesy to non-English speakers, but only the notice in English legally counts.

Se otorga permiso para copiar, distribuir y/o modificar este documento bajo los términos de la Licencia de Documentación Libre de GNU, versión 1.1 o cualquier versión posterior publicada por la Free Software Foundation; sin ninguna de las secciones invariantes. Se incluye una copia de esta licencia dentro de la sección titulada “Licencia de Documentación Libre de GNU”.

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections. A copy of the license is included in the section entitled “GNU Free Documentation License”.

El presente documento es el manual de aprendizaje de GNU LilyPond, versión 2.11.65. Para ver más información sobre la relación entre éste y el resto de los documentos, consulte Sobre la documentación.

Encontrará más información en http://www.lilypond.org/. La página web contiene copias en línea de la presente y otras documentaciones.

Apéndices

Preámbulo

Debió ser en el transcurso de un ensayo de la EJE (Joven Orquesta de Eindhoven), allá por 1995 cuando Jan, uno de los violistas chiflados, le habló a Han-Wen, uno de los trompistas distorsionados, acerca del gran proyecto en que estaba trabajando. Era un sistema automático para imprimir música (concretamente se trataba de MPP, un preprocesador para MusiXTeX). Resulta que Han-Wen quiso imprimir unas particellas a partir de una partitura, así que empezó a echarle un vistazo al programa, pero se quedó estancado rápidamente. Decidieron que MPP era un callejón sin salida. Después de muchísimo filosofar y de montañas de encendidas conversaciones por correo electrónico, Han-Wen inició el proyecto LilyPond en 1996. Esta vez fue Jan quien resultó absorbido por el nuevo proyecto de Han-Wen.

En ciertos aspectos, desarrollar un programa de ordenador es como aprender a tocar un instrumento. Al principio es divertido descubrir cómo funciona, y supone un divertido reto intentar aquello de lo que aún no eres capaz. Una vez pasado el entusiasmo inicial, hay que practicar más y más. Las escalas y los estudios pueden llegar a aturdir, y si no está motivado por otras personas (profesores, directores o el público) uno siempre está tentado de abandonarlo. Uno persevera y, poco a poco, tocar se convierte en parte de la vida de uno. Algunos días se acoge de forma natural, y es estupendo, y otros simplemente la cosa no funciona, pero uno sigue tocando día tras día.

Igual que hacer música, trabajar en LilyPond puede ser un trabajo muy duro y hay días en que uno se siente como pisando un hormiguero. A pesar de todo, se ha convertido en parte de nuestra vida y seguimos haciéndolo. Con toda probabilidad la motivación más importante es que nuestro programa realmente hace algo útil por las personas. Cuando navegamos por la red encontramos mucha gente que utiliza LilyPond y produce unas partituras impresionantes con él. De esta observación se desprende una sensación algo irreal, pero muy agradable.

Nuestros usuarios no sólo nos transmiten buenas vibraciones por usar el programa, también muchos de ellos nos ayudan enviando sugerencias e informes de fallo; por ello nos gustaría agradecer a todos los usuarios que nos han enviado estos informes, emitido sugerencias o contribuido a LilyPond de cualquier otra forma.

Tocar e imprimir música es algo más que una bonita analogía. Programar juntos es muy divertido, y ayudar a las personas es algo profundamente gratificante, pero en último término trabajar en LilyPond es una forma de expresar nuestro profundo amor por la música. ¡Ojalá le ayude a elaborar montañas de preciosas partituras!

Han-Wen y Jan

Utrecht/Eindhoven, Holanda, julio de 2002.

1. Introducción

En este capítulo se presentan al lector LilyPond y su documentación.

1.1 Antecedentes

Esta sección se ocupa de las metas principales y la arquitectura de LilyPond.

Grabado

El arte de la tipografía musical se conoce como grabado (en plancha). El término deriva del proceso tradicional de la impresión musical. Hace sólo unas décadas, la música impresa se hacía estampando la música sobre planchas de zinc o estaño de forma invertida como en un espejo. Después la plancha se entintaba y las depresiones causadas por los cortes y estampados retenían la tinta. Al presionar una hoja de papel sobre la plancha, se formaba una imagen. El estampado y cortado se hacía completamente a mano. Cualquier corrección era muy fastidiosa de realizar, si es que era posible hacerla siquiera, así que el grabado tenía que quedar perfecto a la primera. El grabado era una habilidad altamente especializada; un artesano necesitaba unos cinco años de preparación antes de poder ostentar el título de maestro grabador, y se necesitaban otros cinco años de experiencia para ser un auténtico experto.

Hoy en día, toda la música impresa nueva se produce con ordenadores. Esto tiene unas ventajas evidentes: las copias son más baratas de producir y el trabajo editorial se puede repartir por correo electrónico. Desgraciadamente la penetrante utilización de ordenadores también ha hecho disminuir la calidad gráfica de las partituras. Las impresiones de ordenador tienen un aspecto insulso y mecánico, lo que hace que sea desagradable tocar a partir de ellas.

Las imágenes siguientes ilustran la diferencia entre el grabado tradicional y la salida típica de ordenador, y la tercera imagen muestra cómo LilyPond imita el aspecto tradicional. La imagen de la izquierda presenta el dibujo escaneado de un símbolo de bemol sacado de una edición publicada en el año 2000. La del centro es un símbolo procedente de una edición de Bärenreiter grabada a mano de la misma música. La de la izquierda ilustra los típicos puntos débiles de la impresión por ordenador: las líneas del pentagrama son muy delgadas, el peso del símbolo del bemol es también demasiado ligero como las líneas del pentagrama, y tiene una apariencia rectilínea con esquinas afiladas. En contraste, el bemol de Bärenreiter tiene una apariencia redonda, pesada, casi voluptuosa. Nuestro símbolo del bemol se diseñó según éste, entre otros. Es de forma redondeada y su peso está en armonía con el grosor de nuestras líneas de pentagrama, que son asimismo mucho más gruesas que las de la edición por ordenador.

	Henle (2000)	Bärenreiter (1950)	Tipografía Feta de LilyPond (2003)

Tratándose del espaciado, la distribución del espacio debe reflejar las duraciones que hay entre las notas. Sin embargo muchas partituras modernas se atañen a las duraciones con precisión matemática, lo que lleva a unos resultados bastante pobres. En el siguiente ejemplo se muestra un ejemplo dos veces: una utilizando espaciado matemáticamente exacto, y otra con ciertas correcciones. ¿Puede adivinar cuál es cuál?

Cada uno de los dos compases de este fragmento tiene solamente notas de duración constante. El espaciado debería reflejarlo. Desgraciadamente el ojo nos engaña un poco; no solamente percibe la distancia entre las cabezas de las notas, sino que tiene también en cuenta la distancia entre las plicas. Como resultado, las notas de una combinación plica arriba/plica abajo se tendrían que separar más, y las notas de una combinación plica abajo/plica arriba deberían juntarse, todo ello dependiendo de las posiciones combinadas de las notas. Los dos compases de arriba están impresos con esta corrección y los de abajo sin ella, formando grupos de notas pegadas con plica abajo/plica arriba.

Los músicos están normalmente más concentrados en tocar que en estudiar el aspecto de una partitura, y por ello las pequeñeces sobre los detalles tipográficos pueden parecer académicas. Pero no lo son. En las partituras más largas con ritmos monótonos, las correcciones de espaciado llevan a sutiles variaciones en la disposición de cada una de las líneas dándoles una especie de firma visual distintiva. Sin esta firma, todas las líneas parecerían iguales, y se convertirían en un laberinto. Si un músico aparta la mirada o tiene un lapsus de concentración, las líneas podrían perder su lugar sobre el papel.

De forma similar, la fuerza visual de unos símbolos pesados sobre gruesas líneas de pentagrama se sostiene mejor cuando el lector se aleja del papel, por ejemplo cuando está sobre un atril. Una distribución cuidadosa del espacio blanco permite disponer la música muy apretada sin que los símbolos se toquen unos a otros. El resultado reduce a un mínimo las vueltas de página, lo que es una gran ventaja.

Ésta es una característica normal del arte tipográfico. La disposición de la página tiene que ser bonita, no sólo por sí misma, sino sobre todo porque así ayuda al lector en su tarea. Para los materiales destinados a la interpretación, como las partituras, esto es de una importancia doble: los músicos tienen una capacidad de concentración limitada. Cuanta menos atención necesiten para el acto de leer, más se pueden dedicar al acto de tocar la música. Dicho de otra forma: una mejor tipografía se traduce en una mejor interpretación.

Estos ejemplos demuestran que la tipografía musical es un arte sutil y complejo, y que su elaboración requiere una experiencia considerable, que los músicos no suelen tener. LilyPond representa nuestro esfuerzo para llevar la excelencia visual de la música grabada a mano a la era de la informática, y ponerla a disposición de los músicos normales. Hemos ido afinando nuestros algoritmos, diseños de tipografía y preferencias del programa para producir una impresión cuya calidad se equipara con la de las viejas ediciones que tanto nos gusta contemplar y de las que tanto nos gusta tocar.

Grabado automático

¿Cómo nos las arreglamos para implementar la tipografía? Si un artesano necesita más de diez años para convertirse en un auténtico maestro ¿cómo vamos a poder nosotros, simples «hackers», escribir un programa que les quite el trabajo?

La respuesta es: no podemos. Puesto que la tipografía se fundamenta en el juicio humano sobre la apariencia, nunca se puede sustituir completamente a las personas. Sin embargo, se puede automatizar gran parte del trabajo más duro y repetitivo. Si LilyPond resuelve la mayoría de las situaciones comunes de forma correcta, esto ya será una tremenda mejoría sobre los programas existentes. El resto de los casos se podrán afinar a mano. Con el transcurso de los años, el software se puede refinar para que haga un mayor número de cosas de forma automática, de tal forma que los ajustes manuales tienden a ser cada vez menos necesarios.

Cuando empezamos, escribimos el programa LilyPond completamente en el lenguaje C++; la funcionalidad del programa quedaba como esculpida en piedra por los desarrolladores. Este esquema resultó no ser muy satisfactorio por una serie de motivos:

• Cuando LilyPond comete fallos, los usuarios tienen la necesidad de superar las decisiones de formateo. Por ello el usuario debe tener acceso al motor de formateo. De aquí que no podamos dejar establecidas las reglas y valores durante la compilación, sino que los usuarios deben poder acceder a ellos durante la ejecución del programa.
• El grabado de música es cosa de juicio visual y por ello es cuestión de gustos. A pesar de saber tanto como creemos saber, los usuarios pueden no estar de acuerdo con nuestras decisiones personales. Por tanto la definición del estilo tipográfico también debe estar al alcance del usuario.
• Por último, estamos continuamente refinando los algoritmos de formateo y por tanto necesitamos un enfoque flexible para las reglas. El lenguaje C++ fuerza un cierto método para agrupar las reglas que no encaja bien con la manera de funcionar de la notación musical.

Estos problemas se han solucionado integrando un intérprete del lenguaje Scheme y reescribiendo parte del código de LilyPond en Scheme. La actual arquitectura de formateo se construye alrededor del concepto de objetos gráficos, descrita por variables y funciones de Scheme. Esta arquitectura puede tratar al mismo tiempo con las reglas de formateo, el estilo tipográfico y las decisiones de formateo individuales. El usuario tiene acceso directo a la mayor parte de estos controles.

Las variables de Scheme controlan las decisiones de formateo. Por ejemplo, muchos objetos gráficos tienen una variable de dirección que codifica la elección entre arriba y abajo (o izquierda y derecha). Aquí puede ver dos acordes con acentos y signos de arpegio. En el primer acorde los objetos gráficos tienen todas sus direcciones hacia abajo (o hacia la izquierda). El segundo acorde tiene todas las direcciones hacia arriba (o hacia la derecha).

El proceso de formatear una partitura consiste en leer y escribir las variables de los objetos gráficos. Ciertas variables tienen un valor predefinido. Por ejemplo, el grosor de muchas líneas (una característica del estilo tipográfico) son variables con un valor preestablecido. Podemos alterar este valor libremente dando así a nuestra partitura una impresión tipográfica distinta.

Las reglas de formateo también son variables que están predefinidas: cada objeto tiene unas variables que contienen procedimientos. Estos procedimientos realizan el trabajo real de formateo y sustituyéndolos por otros podemos alterar el aspecto de los objetos. En el siguiente ejemplo, la regla que define cómo se dibuja la cabeza de una nota se altera durante el transcurso del fragmento musical.

¿Qué símbolos grabar?

El proceso de formateo toma las decisiones sobre dónde colocar los símbolos. Sin embargo esto sólo se puede hacer una vez que se ha decidido qué símbolos han de imprimirse, o dicho de otro modo: qué notación utilizar.

La notación musical común es un sistema de registro de música que ha venido evolucionando desde hace mil años. La forma que se usa en nuestros días data de los primeros tiempos del Renacimiento. Aunque la forma básica (es decir: puntos sobre una pauta de cinco líneas) no ha cambiado, los detalles continúan evolucionando para expresar todas las innovaciones de la notación contemporánea. Por tanto abarca unos quinientos años de música. Sus aplicaciones se extienden sobre un amplio rango que abarca desde melodías monofónicas hasta monstruosos contrapuntos para gran orquesta.

¿Cómo podemos tratar con una bestia de tantas cabezas, y obligarla a que se encierre dentro de los límites de un programa de ordenador? Nuestra solución es trocear el problema de la notación (por oposición al grabado, esto es, a la tipografía) en fragmentos digeribles y más fáciles de programar: cada tipo de símbolo se maneja por un módulo separado que recibe el nombre de «plug-in». Cada «plug-in» es completamente modular e independiente, de forma que puede desarrollarse y mejorarse por separado. Estos «plug-ins» se llaman engravers (grabadores), por analogía con los artesanos que traducen las ideas musicales a símbolos gráficos.

En el siguiente ejemplo vemos cómo comenzamos con un plug-in para las cabezas de las notas, el Note_heads_engraver.

A continuación un Staff_symbol_engraver (grabador del pentagrama) añade la pauta.

El Clef_engraver (grabador de la clave) define un punto de referencia para el pentagrama.

y el Stem_engraver (grabador de las plicas) añade las plicas.

El Stem_engraver (grabador de plicas) recibe una notificación cuando llega una cabeza. Cada vez que se ve una cabeza (o más, si es un acorde), se crea un objeto plica y se conecta a la cabeza. Añadiendo grabadores para las barras, ligaduras, acentos, alteraciones, líneas divisorias, indicación de compás y armadura conseguimos una notación completa.

Este sistema funciona bien para la música monofónica, pero ¿y con la polifonía? En notación polifónica muchas voces pueden compartir el mismo pentagrama.

En esta situación, las alteraciones y la pauta se comparten, pero las plicas, ligaduras, barras, etc. son propias de cada voz. Por tanto los grabadores han de agruparse. Los grabadores de cabezas, plicas, ligaduras, etc. se unen en un grupo llamado ‘Contexto de voz’, mientras que los grabadores de la armadura, alteraciones, compás, etc. van a un grupo que se llama ‘Contexto de la pauta’. En el caso de la polifonía, un único Contexto de pauta contiene más de un Contexto de voz. De forma semejante, varios Contextos de pauta pueden agruparse en un único Contexto de partitura. El Contexto de partitura es el contexto de notación de más alto nivel.

Véase también

Referencia de funcionamiento interno: Contexts.

Representación musical

Idealmente el formato de entrada para cualquier sistema de formateo de alto nivel es una descripción abstracta del contenido. En este caso, eso constituiría la propia música, lo que plantea un tremendo problema: ¿cómo podemos definir qué es realmente la música? En lugar de intentar hallar una respuesta, le hemos dado la vuelta a la pregunta. Escribimos un programa capaz de producir partituras y ajustamos el formato para que sea tan escueto como sea posible. Cuando el formato ya no puede reducirse más, por definición nos habremos quedado con el contenido musical propiamente dicho. Nuestro programa sirve como definición formal de un documento musical.

La sintaxis también es el interfaz de usuario de LilyPond, así que es fácil teclear

{
  c'4 d'8
}

un Do4 (Do central) negra, y un Re4 (el Re por encima del Do central) corchea.

A una escala microscópica, dicha sintaxis es fácil de utilizar. A una escala mayor, la sintaxis también requiere una estructura. ¿De qué otra forma podríamos introducir piezas complejas como sinfonías u óperas? La estructura se forma mediante el concepto de expresiones musicales: al combinar pequeños fragmentos de música dentro de otros mayores, se pueden expresar ideas musicales más complejas. Por ejemplo

f4

Los acordes se pueden construir encerrando las notas entre << y >>

<<c4 d4 e4>>

Esta expresión se coloca en secuencia encerrándola dentro de llaves { … }

{ f4 <<c4 d4 e4>> }

Lo anterior, a su vez también es una expresión, y por ello se puede combinar de nuevo con otra expresión simultánea (una blanca) usando <<, \\, y >>

<< g2 \\ { f4 <<c4 d4 e4>> } >>

Las mencionadas estructuras recursivas se pueden especificar de forma nítida y formal dentro de una gramática independiente del contexto. El código de análisis también se genera a partir de esta gramática. En otras palabras, la sintaxis de LilyPond está definida de una forma clara y sin ambigüedades.

Los interfaces de usuario y la sintaxis son lo que la persona ve y con lo que trata principalmente. En parte, son fruto de preferencias personales y como tales están sujetas a mucha discusión. Aunque las discusiones sobre el gusto tienen su mérito, no son demasiado productivas. Dentro de la escena global de LilyPond, la sintaxis de la entrada tiene una importancia relativamente pequeña: inventarse una sintaxis elegante es fácil, pero escribir un código de formateo decente es mucho más difícil. Esto también queda ilustrado por la cantidad de líneas de código de los componentes respectivos: el análisis y la representación se llevan menos del 10% del código fuente.

Aplicaciones de ejemplo

Escribimos LilyPond como un experimento de cómo condensar el arte del grabado de música dentro de un programa de ordenador. Gracias a todo este duro trabajo, el programa ahora se puede usar para hacer trabajos útiles. La aplicación más sencilla es imprimir notas.

Añadiendo los nombres de acordes y la letra, obtenemos una hoja guía de acordes (lead sheet).

También se puede imprimir notación polifónica y música para piano. El ejemplo siguiente combina algunas otras construcciones exóticas.

Todos los fragmentos mostrados se han escrito a mano, pero esto no es necesariamente así. Puesto que el motor de formateo es casi completamente automático, puede servir como medio de salida para otros programas que manipulan música. Por ejemplo, se puede usar también para convertir bases de datos de fragmentos musicales en imágenes con destino a páginas web y presentaciones multimedia.

Este manual también es un ejemplo de aplicación: el formato de entrada es texto sencillo, y por ello se puede empotrar fácilmente dentro de otros formatos basados en texto, como LaTeX, HTML, o en el caso concreto de este manual, Texinfo. A través de un programa especial, los fragmentos de entrada se pueden sustituir por imágenes musicales dentro de los archivos de salida PDF o HTML resultantes. Esto convierte la tarea de mezclar música y texto dentro de los documentos, en algo muy sencillo.

1.2 Sobre la documentación

Esta sección explica la distintas partes de la documentación.

Sobre el Manual de aprendizaje

Este libro explica cómo empezar a aprender LilyPond, así como algunos conceptos clave en términos sencillos. Se recomienda leer estos capítulos de forma secuencial.

• Introducción: explica los antecedentes y las metas generales de LilyPond.
• Tutorial: da una amable introducción a la tipografía musical. Los usuarios que se acercan por primera vez deben comenzar por aquí.
• Conceptos fundamentales: explica algunos conceptos generales sobre el formato de los archivos de entrada de LilyPond. Si no está seguro de dónde colocar una instrucción ¡lea este capítulo!
• Trucar la salida: muestra la manera de cambiar el grabado predeterminado que produce LilyPond.
• Trabajar en proyectos de LilyPond: trata los usos prácticos de LilyPond y cómo evitar ciertos problemas bastante comunes. ¡Léalo antes de emprender proyectos grandes!

El Manual de aprendizaje contiene también apéndices que no forman parte de la lectura lineal recomendada. Pueden ser útiles para una mirada posterior:

• Plantillas: muestra plantillas de piezas de LilyPond, listas para usar. Tan sólo tiene que cortar y pegar una plantilla en un archivo, escribir las notas, y ¡habrá terminado!
• Tutorial de Scheme: presenta una breve introducción a Scheme, el lenguaje de programación que usan las funciones musicales. Se trata de material para trucos avanzados; muchos usuarios jamás llegan siquiera a tocar el Scheme.

Sobre el Glosario Musical

Glosario musical: explica términos musicales e incluye traducciones a varios idiomas. Si no está familiarizado con la notación o la terminología musicales (especialmente si no es un anglófono nativo), es muy recomendable que consulte el glosario.

Sobre la Referencia de la notación

Este libro explica todas las instrucciones de LilyPond que producen notación impresa. Da por supuesto que el lector está familiarizado con los conceptos del manual de aprendizaje.

• Notación musical: trata ciertos temas agrupados según las construcciones de notación. Esta sección proporciona detalles sobre notación básica que probablemente serán de utilidad en casi cualquier proyecto de notación.
• Notación especializada: también trata los temas agrupados por construcciones de notación. Esta sección proporciona detalles sobre notación especial que solamente será útil para ciertos grupos de instrumentos (o voces).
• Entrada y salida generales: trata de información general sobre los archivos de LilyPond y el control sobre la salida.
• Problemas de espaciado: trata asuntos que afectan a la salida global, como la elección del tamaño del papel o la especificación de los saltos de página.
• Cambiar los valores por omisión: explica cómo hacer los ajustes que permitan a LilyPond producir exactamente la notación que desee.
• Interfaces para programadores: explica cómo crear funciones musicales con Scheme.

El manual de Referencia de la notación también contiene unos apéndices con útiles tablas de referencia.

• Lista bibliográfica: contiene un conjunto de libros de referencia muy útiles para aquellas personas que desean saber más sobre notación y grabado.
• Tablas del manual sobre notación: son un conjunto de tablas que relacionan los nombres de los acordes, instrumentos MIDI, nombres de los colores y la tipografía Feta.
• Hoja de referencia rápida: es una manejable referencia de las instrucciones de LilyPond más comunes.
• Índice de instrucciones de LilyPond: un úndice de todas las \instrucciones de LilyPond.
• Índice de LilyPond: un índice completo.

Sobre el manual de Utilización del programa

Este libro explica la manera de ejecutar el programa y cómo integrar la notación de LilyPond con otros programas.

• Instalación: explica cómo instalar LilyPond (incluyendo la compilación, si se desea).
• Configuración: describe cómo debe configurar el sistema para una utilización óptima de LilyPond, como por ejemplo el uso de entornos especiales para determinados editores de texto.
• Ejecutar LilyPond: trata sobre cómo ejecutar LilyPond y sus programas de apoyo. Además, esta sección explica cómo actualizar las partituras a partir de versiones anteriores de LilyPond.
• LilyPond-book: da los detalles que se encuentran detrás de la creación de documentos con ejemplos de música insertados, como este mismo manual.
• Conversión desde otros formatos: explica cómo ejecutar los programas de conversión. Estos programas vienen incluidos en el mismo paquete que el propio LilyPond, y convierten una amplia variedad de formatos de música al formato .ly.

Sobre la lista de fragmentos de código

Lista de fragmentos de código de LilyPond: presenta un conjunto seleccionado de fragmentos de código de LilyPond procedentes del Repositorio de Fragmentos de Código (LSR). Todos los fragmentos se encuentran en el dominio público.

Observe que este documento no es un subconjunto exacto de LSR. El LSR ejecuta una versión estable de LilyPond, por lo que cualquier fragmento de código que muestre posibilidades nuevas de una versión de desarrollo se tiene que añadir por separado. Éstas se almacenan en ‘input/new/’ dentro del árbol del código fuente de LilyPond.

La lista de fragmentos de código para cada una de las subsecciones del Manual de Referencia de la Notación también se encuentran enlazados desde la parte Véase también.

Sobre el Manual de Referencia de Funcionamiento Interno

Referencia de funcionamiento interno: es un conjunto de páginas HTML con una tupida red de enlaces cruzados, que documentan al detalle el meollo de todas y cada una de las clases, objetos y funciones de LilyPond. Se produce directamente a partir de las definiciones de formateo que se utilizan.

Casi toda la funcionalidad de formateo que se emplea internamente, se encuentra disponible para el usuario de forma directa. Por ejemplo, todas las variables que controlan los valores de grosor, distancias, etc., se pueden cambiar dentro de los archivos de entrada. Hay un enorme número de opciones de formateo, y todas ellas se describen en este documento. Cada sección del manual de notación tiene una subsección Véase también, que hace referencia a la documentación generada. En el documento HTML, estas subsecciones llevan enlaces que se pueden seguir, pulsando sobre ellos.

Otros documentos

Existen algunos otros lugares que pueden resultar muy valiosos como fuente de información.

• News: es un resumen de los cambios importantes y las posibilidades nuevas de LilyPond desde la versión anterior.
• Los archivos de la lista de correo de usuarios lilypond-user: es una recopilación de todos los mensajes de correo que se han enviado a la lista de usuarios. Hay muchas preguntas que se han formulado varias veces; muy probablemente, si tiene alguna pregunta, la respuesta puede encontrarse en estos archivos.
• Los archivos de la lista de correo de desarrollo lilypond-devel: es una recopilación de todos los mensajes de correo que se han enviado a la lista de los desarrolladores. Aquí la discusión tiene un carácter más técnico; si tiene una pregunta avanzada relacionada con el funcionamiento interno de lilypond, la respuesta puede estar en estos archivos.
• Fragmentos de música incrustados: en todos los documentos en HTML que tienen fragmentos de música incluidos, el código de entrada exacto de LilyPond que se utilizó para producir dicha imagen se puede ver pulsando sobre ella.
• Archivos de inicio: La localización exacta de los archivos de documentación que hemos mencionado puede variar de un sistema a otro. En ocasiones este manual hace referencia a archivos de inicialización y de ejemplo. A lo largo del manual, nos referimos a archivos de entrada por su ruta relativa respecto de directorio de nivel más alto de los archivos de código fuente. Por ejemplo, ‘input/lsr/carpeta/bla.ly’ puede referirse al archivo ‘lilypond2.x.y/input/lsr/carpeta/bla.ly’. En los paquetes binarios para la plataforma UNIX, normalmente la documentación y los ejemplos se encuentran en algún lugar dentro de ‘/usr/share/doc/lilypond/’. Los archivos de inicialización, como por ejemplo ‘scm/lily.scm’, o ‘ly/engraver-init.ly’, se encuentran normalmente en el directorio ‘/usr/share/lilypond/’. Para ver más detalles, consulte Otras fuentes de información.

2. Tutorial

Este tutorial comienza con una introducción al lenguaje musical LilyPond y explica cómo producir música impresa. Después de este primer contacto, explicaremos cómo crear música impresa de forma bella, que contenga notación musical usual.

2.1 Primeros pasos

Esta sección le ofrece una introducción básica al trabajo con LilyPond.

2.1.1 Compilar un archivo

“Compilación” es una palabra que significa procesar un texto de entrada en formato de LilyPond para producir un archivo que se puede imprimir y (de manera opcional) un archivo MIDI que se puede reproducir. El primer ejemplo muestra el aspecto de un sencillo archivo de texto de entrada.

Para crear una partitura, escribimos un archivo de texto que detalla la notación deseada. Por ejemplo, si escribimos

{
  c' e' g' e'
}

el resultado tiene este aspecto:

Además, la entrada de LilyPond es sensible a las mayúsculas. { c d e } es una entrada válida; { C D E } produce un mensaje de error.

Introducir música y ver la salida

En esta sección vamos a explicar qué órdenes hay que ejecutar y cómo, para ver o imprimir el resultado.

Tenga en cuenta que están disponibles varios otros editores de texto con un mejor apoyo a la edición de texto de LilyPond. Para ver más información, consulte Apoyo respecto de los editores de texto.

MacOS X

Si hace doble clic sobre LilyPond.app, se abrirá con un archivo de ejemplo. Guárdelo, por ejemplo, como ‘prueba.ly’ en el Escritorio, y a continuación procéselo con la orden de menú ‘Compilar > Componer archivo’. El PDF resultante se mostrará en la pantalla.

Para posteriores usos de LilyPond, debería comenzar eligiendo ‘Nuevo’ o ‘Abrir’. Tiene que grabar el archivo antes de componerlo tipográficamente. Si se produce algún error durante el proceso, observe la ventana del registro.

Windows

En Windows, si hace doble clic sobre el icono de LilyPond que está en el escritorio, se abrirá un sencillo editor de texto con un archivo de ejemplo. Guárdelo, por ejemplo, con el nombre ‘prueba.ly’ en el escritorio y después haga doble clic sobre el icono del archivo para procesarlo (el icono tiene la forma de una corchea). Transcurridos unos segundos, obtendrá un archivo ‘prueba.pdf’ en el escritorio. Haga doble clic sobre este archivo PDF para ver la partitura compuesta tipográficamente. Un método alternativo para procesar el archivo ‘prueba.ly’ es arrastrarlo y soltarlo sobre el icono de LilyPond utilizando el ratón.

Para editar un archivo ‘.ly’ existente, haga clic sobre él con el botón derecho del ratón y elija “Editar la fuente”. Para empezar con un archivo vacío, arranque el editor como se describe más arriba y elija “Nuevo” del menú “Archivo”, o haga clic con el botón derecho sobre el escritorio y elija “Nuevo..Documento de texto”, cámbiele el nombre por otro de su elección y cambie la extensión del archivo a .ly. Edítelo y luego haga doble click sobre él para procesarlo como se explicó antes.

Al hacer doble clic sobre el archivo no sólo se obtiene como resultado un archivo PDF, sino también un archivo ‘.log’ que contiene cierta información acerca de lo que LilyPond ha hecho con el archivo. Si se produce algún error, examine este archivo de registro.

UNIX

Cree un archivo de texto con el nombre ‘prueba.ly’ y escriba en él:

{
  c' e' g' e'
}

Para procesar el archivo ‘prueba.ly’ haga lo siguiente:

lilypond prueba.ly

Verá algo parecido a:

lilypond prueba.ly
GNU LilyPond 2.11.65
Procesando `prueba.ly'
Analizando...
Interpretando la música...
Preprocesando los objetos gráficos...
Buscando el número de páginas ideal...
Disponiendo la música en 1 página...
Dibujando los sistemas...
Escribiendo la página de salida en `prueba.ps'...
Convirtiendo a `prueba.pdf'...

2.1.2 Notación sencilla

LilyPond añadirá ciertos elementos de notación de manera automática. En el siguiente ejemplo hemos especificado solamente cuatro alturas, pero LilyPond ha añadido la clave, el compás y las duraciones.

{
  c' e' g' e'
}

Este comportamiento se puede modificar, pero en general estos valores automáticos son adecuados.

Alturas

Glosario musical: altura, intervalo, escala, Do central, octava, alteración accidental.

La manera más sencilla de introducir las notas es mediante la utilización del modo \relative (relativo). En este modo, se elige la octava automáticamente bajo la suposición de que la siguiente nota se colocará siempre lo más cerca de la nota actual, es decir, se colocará en la octava comprendida dentro de hasta tres espacios de pentagrama a partir de la nota anterior. Comenzaremos por introducir el fragmento musical más elemental: una escala, donde cada nota está comprendida dentro de tan sólo un espacio de pentagrama desde la nota anterior.

% fijar el punto de inicio en Do central
\relative c' {
  c d e f
  g a b c
}

La nota inicial es el Do central. Cada nota sucesiva se coloca lo más cerca posible de la nota previa (en otras palabras: la primera ‘c’ es el Do más cercano al Do central; a éste le sigue el Re más cercano a la nota previa, y así sucesivamente). Podemos crear melodías con intervalos mayores, aún sin dejar de utilizar el modo relativo:

\relative c' {
  d f a g
  c b f d
}

No es necesario que la primera nota de la melodía comience exactamente en aquella que especifica la altura de inicio. En el ejemplo anterior, la primera nota (d) es el Re más cercano al Do central.

Añadiendo (o eliminando) comillas simples ' o comas , a la instrucción \relative c' {, podemos cambiar la octava de inicio:

% una octava por encima del Do central
\relative c'' {
  e c a c
}

Al principio, el modo relativo puede resultar algo confuso, pero es la forma más sencilla de introducir la mayor parte de las melodías. Veamos cómo funciona en la práctica este cálculo relativo. Comenzando por Si, que está situado en la línea central en clave de Sol, podemos alcanzar Do, Re y Mi dentro de los tres espacios de pentagrama hacia arriba, y La, Sol y Fa dentro de los tres espacios hacia abajo. Por tanto, si la nota siguiente a Si es Do, Re o Mi se supondrá que está por encima del Si, mientras que La, Sol o Fa se entenderán situados por debajo.

\relative c'' {
  b c  % el Do está un espacio por encima, es el Do agudo
  b d  % el Re está 2 por encima ó 5 por debajo, es el Re agudo
  b e  % el Mi está 3 por encima ó 4 por debajo, es el Mi agudo
  b a  % el La está 6 por encima ó 1 por debajo, es el La grave
  b g  % el Sol está 5 por encima ó 2 por debajo, es el Sol grave
  b f  % el Fa está 4 por encima ó 3 por debajo, es el Fa grave
}

Lo mismo exactamente ocurre cuando cualquiera de esas notas llevan un sostenido o un bemol. Las Alteraciones accidentales se ignoran totalmente en el cálculo de la posición relativa. Exactamente la misma cuenta de espacios de pentagrama se hace a partir de una nota situada en cualquier otro lugar del mismo.

Para añadir intervalos mayores de tres espacios de pentagrama, podemos elevar la octava añadiendo una comilla simple ' (o apóstrofo) a continuación del nombre de la nota. También podemos bajar la octava escribiendo una coma , a continuación del nombre de la nota.

\relative c'' {
  a a, c' f,
  g g'' a,, f'
}

Para subir o bajar una nota en dos (¡o más!) octavas, utilizamos varias '' ó ,, (pero tenga cuidado de utilizar dos comillas simples '' ¡y no una comilla doble " !) El valor inicial de \relative c' también puede modificarse de esta forma.

Duraciones (valores rítmicos)

Glosario musical: barra, duración, redonda, blanca, negra, figura con puntillo.

La duración de una nota se especifica mediante un número después del nombre de la nota. 1 significa redonda, 2 significa blanca, 4 significa negra y así sucesivamente. Las barras de corchea se añaden automáticamente.

Si no especifica una duración, se utiliza la duración previa para la nota siguiente. La figura por omisión de la primera nota es una negra.

\relative c'' {
  a1
  a2 a4 a8 a
  a16 a a a a32 a a a a64 a a a a a a a a2
}

Para crear notas con puntillo, añada un punto . al número de la duración. La duración de una nota con puntillo se debe especificar de forma explícita (es decir: mediante un número).

\relative c'' {
  a a a4. a8
  a8. a16 a a8. a8 a4.
}

Silencios

Glosario musical: silencio.

Un silencio se introduce igual que si fuera una nota con el nombre r :

\relative c'' {
  a r r2
  r8 a r4 r4. r8
}

Indicación de compás

Glosario musical: indicación de compás.

La indicación de compás se puede establecer con la orden \time :

\relative c'' {
  \time 3/4
  a4 a a
  \time 6/8
  a4. a
  \time 4/4
  a4 a a a
}

Clave

Glosario musical: clave.

La clave se puede establecer utilizando la orden \clef :

\relative c' {
  \clef treble
  c1
  \clef alto
  c1
  \clef tenor
  c1
  \clef bass
  c1
}

Todo junto

He aquí un pequeño ejemplo que muestra todos los elementos anteriores juntos:

\relative c, {
  \time 3/4
  \clef bass
  c2 e8 c' g'2.
  f4 e d c4 c, r4
}

Véase también

Referencia de la notación: Escritura de notas, Escritura de las duraciones (valores rítmicos), Escritura de silencios, Indicación de compás, Clave.

2.1.3 Trabajar sobre los archivos de entrada

Los archivos de entrada de LilyPond son como los archivos fuente de muchos lenguajes de programación corrientes. Son sensibles a las mayúsculas e insensibles al número de espacios. Las expresiones se forman con llaves { } y los comentarios se denotan por un signo de porcentaje (%) o por %{ ... %}.

Si la frase anterior no tiene sentido para usted ¡no se preocupe! A continuación explicaremos el significado de todos estos términos:

• Sensible a las mayúsculas: tiene importancia el hecho de que introduzca una letra en minúsculas (p.ej. a, b, s, t) o en mayúsculas (p.ej. A, B, S, T). Las notas son minúsculas: { c d e } es una entrada válida; { C D E } produciría un mensaje de error.
• Insensible al número de espacios: no importa cuántos espacios (o saltos de línea) añada. { c d e } significa lo mismo que { c       d e } y que

  { c                        d
                     e   }
  

  Por supuesto, el ejemplo anterior es difícil de leer. Una regla práctica es sangrar los bloques de código con un carácter de tabulación, o bien con dos espacios:

  {
    c d e
  }
  

• Expresiones: Todo fragmento de código de entrada para LilyPond ha de llevar { llaves } antes y después de la entrada. Estas llaves le dicen a LilyPond que la entrada es una expresión musical unitaria, igual que los paréntesis ‘()’ de las matemáticas. Las llaves deben ir rodeadas de un espacio a no ser que se encuentren al comienzo o al final de una línea, para evitar cualquier ambigüedad.

  Una instrucción de LilyPond seguida de una expresión simple entre llaves (como por ejemplo \relative { }) también es una expresión musical unitaria.

• Comentarios: Un comentario es una nota para el lector humano de la entrada musical; se ignora cuando esta entrada se analiza, de manera que no tiene ningún efecto sobre la salida impresa. Existen dos tipos de comentarios. El símbolo de porcentaje ‘%’ introduce un comentario de línea; todo lo que se encuentra después de ‘%’ en esa línea se ignora. Por convenio, una línea de comentario se coloca por encima del código a que se refiere el comentario.

  a4 a a a
  % este comentario se refiere a las notas Si
  b2 b
  

  Un comentario de bloque marca una sección entera de entrada musical como comentario. Todo lo que está encerrado dentro de %{ y %} se ignora (pero los comentarios no pueden anidarse, lo que significa que un comentario de bloque no puede incluir otros comentarios de bloque). Si lo hiciera, el primer %} daría por terminado los dos comentarios de bloque. El siguiente fragmento muestra algunos posibles usos para los comentarios:

  % a continuación van las notas de campanitas del lugar
    c4 c g' g a a g2
  
  %{
    Esta línea y las notas que aparecen más abajo
    se ignoran, por estar dentro de un
    comentario de bloque.
  
    f f e e d d c2
  %}
  

2.1.4 Cómo leer el manual

Como ya vimos en Trabajar sobre los archivos de entrada, el código de entrada de LilyPond debe estar rodeado de llaves { } o de \relative c'' { ... }. Durante el resto del presente manual, la mayor parte de los ejemplos omitirán las llaves. Para reproducir los ejemplos, deberá copiar y pegar la entrada que se muestra, pero deberá escribir el \relative c'' { }, de la siguiente forma:

\relative c'' {
  ... aquí va el ejemplo...
}

¿Por qué omitir las llaves? Casi todos los ejemplos del presente manual se pueden insertar en medio de un fragmento mayor de música. Para estos ejemplos no tiene ningún sentido añadir \relative c'' { } (¡no debería poner un \relative dentro de otro \relative!); si hubiésemos incluido \relative c'' { } rodeando a cada uno de los ejemplos, usted no podría copiar un ejemplo pequeño procedente de la documentación y pegarlo dentro de su propia pieza. La mayoría querrá insertar el código dentro de una pieza más grande, por eso hemos formateado el manual de esta manera.

Ejemplos con enlace

Muchas personas aprenden a utilizar programas probando y enredando con ellos. Esto también puede hacerse con LilyPond. Si hace clic sobre una imagen en la versión en HTML de este manual, podrá ver la entrada exacta de LilyPond que se utilizó para generar esa imagen. Pruébelo sobre esta imagen:

Cortando y pegando todo lo que se encuentra dentro de la sección “ly snippet” (fragmento de tipo ly), tendrá una plantilla inicial para sus experimentos. Para poder ver exactamente el mismo resultado (con igual anchura de línea y todo), copie todo lo que está desde “Start cut-&-pastable section” hasta el final del archivo.

Véase también

Podrá encontrar más consejos y trucos para la construcción de archivos de entrada en Sugerencias para escribir archivos de LilyPond; pero quizá sea mejor leer primero el resto del tutorial.

2.2 Notación en un solo pentagrama

Esta sección es una introducción a la notación corriente que se utiliza para una voz o un pentagrama.

2.2.1 Alteraciones accidentales y armaduras

Alteraciones accidentales

Glosario musical: sostenido, bemol, doble sostenido, doble bemol, alteración accidental.

Una nota con sostenido se hace añadiendo is al nombre, y una nota bemol añadiendo es. Como ha podido adivinar, un doble sostenido o doble bemol se hace añadiendo isis o eses. Esta sintaxis se deriva de las convenciones de nomenclatura de las notas en las lenguas nórdicas y germánicas como el alemán y el holandés. Para utilizar otros nombres para las alteraciones accidentales, véase Nombres de las notas en otros idiomas.

cis1 ees fisis, aeses

Armaduras

Glosario musical: armadura de la tonalidad, mayor, menor.

La armadura de la tonalidad se establece mediante la instrucción \key seguido de una nota y \major o \minor.

\key d \major
a1
\key c \minor
a

Advertencia: armaduras y alturas

Glosario musical: alteración accidental, armadura de la tonalidad, altura, bemol, becuadro, sostenido, transposición.

Para determinar si hay que imprimir una alteración accidental, LilyPond examina las notas y la armadura de la tonalidad. La armadura solamente afecta a las alteraciones impresas, ¡no a las propias notas! Esta funcionalidad suele confundir a los que están empezando con el programa, por ello permítanos explicarla en detalle.

LilyPond hace una clara distinción entre el contenido musical y la presentación. La alteración (bemol, becuadro o sostenido) de una nota es parte de la altura, y por tanto es contenido musical. Si una alteración (un signo impreso de bemol, becuadro o sostenido) se imprime o no delante de la nota correspondiente, es una cuestión de presentación. La presentación es algo que sigue unas reglas, así que las alteraciones accidentales se imprimen automáticamente según dichas reglas. Las alturas de las notas en su música son obras de arte, por tanto no se añadirán automáticamente, y usted deberá introducir aquello que quiera oír.

En el siguiente ejemplo:

\key d \major
d cis fis

ninguna nota lleva una alteración impresa, pero de todas formas usted debe añadir el is a cis y a fis.

El texto b no significa “imprimir una bolita negra en la tercera línea del pentagrama.” Más bien significa: “hay una nota Si natural.” En la tonalidad de La bemol mayor, lleva una alteración accidental:

\key aes \major
b

Poner todas las alteraciones de forma explícita puede que requiera algo más de trabajo al teclear, pero la ventaja es que la transposición es más fácil, y las alteraciones se pueden imprimir siguiendo varias convenciones distintas. Consulte Alteraciones accidentales automáticas para ver ejemplos de cómo se pueden imprimir las alteraciones de acuerdo a reglas diferentes.

Véase también

Referencia de la notación: Nombres de las notas en otros idiomas, Alteraciones accidentales, Alteraciones accidentales automáticas, Armadura de la tonalidad.

Glosario musical: Nombres de las notas.

2.2.2 Ligaduras de unión y de expresión

Ligaduras de unión

Glosario musical: ligadura de unión.

Una ligadura de unión se crea adjuntando un carácter de tilde curva ~ a la primera nota ligada:

g4~ g c2~
c4 ~ c8 a8 ~ a2

Ligaduras de expresión

Glosario musical: ligadura de expresión.

Una ligadura de expresión es una curva que se traza abarcando varias notas. Las notas inicial y final se marcan mediante ( y ) respectivamente.

d4( c16) cis( d e c cis d) e( d4)

Ligaduras de fraseo

Glosario musical: ligadura de expresión, fraseo.

Las ligaduras que se utilizan para indicar fraseos más largos se pueden introducir mediante \( y \). Puede haber al mismo tiempo ligaduras de legato y ligaduras de fraseo, pero no es posible tener legatos simultáneos o ligaduras de expresión simultáneas.

a8(\( ais b c) cis2 b'2 a4 cis,\)

Advertencias: ligaduras de expresión frente a ligaduras de unión

Glosario musical: articulación, ligadura de expresión, ligadura de unión.

Una ligadura de expresión parece una ligadura de unión, pero tiene un significado distinto. Una ligadura (de unión) sencillamente hace que la primera nota sea más larga, y sólo se puede utilizar sobre parejas de notas iguales. Las ligaduras de expresión indican la articulación de las notas, y se pueden utilizar sobre grupos mayores de notas. Las ligaduras de unión y de expresión se pueden anidar unas dentro de otras.

c2~( c8 fis fis4 ~ fis2 g2)

Véase también

Referencia de la notación: Ligaduras de unión, Ligaduras de expresión, Ligaduras de fraseo.

2.2.3 Articulaciones y matices dinámicos

Articulaciones

Glosario musical: articulación.

Las articulaciones más corrientes se pueden añadir a las notas utilizando un guión - seguido de un carácter único:

c-. c-- c-> c-^ c-+ c-_

Digitaciones

Glosario musical: digitaciones.

De manera similar, las digitaciones se pueden añadir a una nota utilizando un guión (-) seguido del dígito deseado:

c-3 e-5 b-2 a-1

Las articulaciones y digitaciones normalmente se colocan de forma automática, pero puede especificar una dirección mediante ^ (encima) o _ (debajo). También puede usar varias articulaciones sobre la misma nota. Sin embargo, casi siempre es mejor dejar que LilyPond determine la dirección de las articulaciones.

c_-^1 d^. f^4_2-> e^-_+

Matices dinámicos

Glosario musical: matices dinámicos, crescendo, decrescendo.

Las expresiones de matiz o signos dinámicos se hacen añadiendo las marcas (con una barra invertida) a la nota:

c\ff c\mf c\p c\pp

Los crescendi y decrescendi comienzan con las órdenes \< y \>. La siguiente indicación de matiz, como por ejemplo \f, dará por terminado el (de)crescendo, o bien se puede usar la instrucción \!:

c2\< c2\ff\> c2 c2\!

Véase también

Referencia de la notación: Articulaciones y ornamentos, Indicaciones de digitación, Matices dinámicos.

2.2.4 Añadir texto

Es posible añadir texto a la partitura:

c1^"espr" a_"legato"

Se puede aplicar un formateo adicional mediante la instrucción \markup:

c1^\markup{ \bold espr}
a1_\markup{
  \dynamic f \italic \small { 2nd } \hspace #0.1 \dynamic p
}

Véase también

Referencia de la notación: Escritura del texto.

2.2.5 Barras automáticas y manuales

Glosario musical: barra.

Todas las barras de las figuras se dibujan automáticamente:

a8 ais d ees r d c16 b a8

Si no le gustan las barras automáticas, pueden forzarse manualmente. Marque la primera nota que comprende la barra con [ y la última con ].

a8[ ais] d[ ees r d] a b

Si quiere desactivar completamente el barrado automático o para una sección extensa de música, utilice la instrucción \autoBeamOff para apagarlo y \autoBeamOn para activarlo de nuevo.

\autoBeamOff
a8 c b4 d8. c16 b4
\autoBeamOn
a8 c b4 d8. c16 b4

Véase también

Referencia de la notación: Barras automáticas, Barras manuales.

2.2.6 Instrucciones rítmicas avanzadas

Compás parcial

Glosario musical: anacrusa.

Una anacrusa se introduce con la palabra clave \partial. Va seguida de una duración: \partial 4 es una anacrusa de negra y \partial 8 de corchea.

\partial 8
f8 c2 d

Grupos especiales

Glosario musical: figura, tresillo.

Los grupos especiales como los tresillos se hacen con la palabra clave \times. Requiere dos argumentos: una fracción y un fragmento de música. La duración del fragmento de música se multiplica por la fracción. Los tresillos hacen que las notas ocupen 2/3 de su duración expresa, por tanto un tresillo lleva una fracción de 2/3:

\times 2/3 { f8 g a }
\times 2/3 { c r c }
\times 2/3 { f,8 g16[ a g a] }
\times 2/3 { d4 a8 }

Notas de adorno

Glosario musical: notas de adorno, acciaccatura, appoggiatura.

Las notas de adorno se crean con la instrucción \grace, aunque también se pueden conseguir precediendo una expresión musical por la palabra clave \appoggiatura o \acciaccatura

c2 \grace { a32[ b] } c2
c2 \appoggiatura b16 c2
c2 \acciaccatura b16 c2

Véase también

Referencia de la notación: Notas de adorno, Grupos especiales, Anacrusas.

2.3 Varias notas a la vez

Esta sección es una introducción a las notas simultáneas: varios instrumentos, varios pentagramas para un solo instrumento (p.ej. piano) y acordes.

La palabra “polifonía” en música hace referencia al hecho de tener más de una voz en un momento determinado dentro de una pieza musical. La palabra “polifonía” en LilyPond se refiere al hecho de tener más de una voz en el mismo pentagrama.

2.3.1 Explicación de las expresiones musicales

En los archivos de entrada de LilyPond, la música se representa mediante expresiones musicales. Una sola nota es una expresión musical:

a4

Al encerrar un grupo de notas dentro de llaves creamos una expresión musical compuesta. Aquí hemos creado una expresión musical compuesta con dos notas:

{ a4 g4 }

Si colocamos un grupo de expresiones musicales (p.ej.: notas) dentro de llaves, eso significa que se encuentran en secuencia (es decir, cada una sigue a la anterior). El resultado es otra expresión musical:

{ { a4 g } f g }

Analogía: expresiones matemáticas

Este mecanismo es semejante a las fórmulas matemáticas: una fórmula grande se construye combinando fórmulas pequeñas. Dichas fórmulas se llaman expresiones, y su definición es recursiva de tal forma que se pueden construir expresiones de un tamaño y complejidad arbitrarios. Por ejemplo:

1

1 + 2

(1 + 2) * 3

((1 + 2) * 3) / (4 * 5)

Ésta es una secuencia de expresiones donde cada expresión se encuentra contenida dentro de la siguiente, más grande. Las expresiones más simples son números, y las mayores se hacen combinando expresiones mediante operadores (como +, * y /) y paréntesis. Del mismo modo que las expresiones matemáticas, las expresiones musicales se pueden anidar a una profundidad arbitraria, lo que se hace necesario para músicas complejas como las partituras polifónicas.

Expresiones musicales simultáneas: varios pentagramas

Glosario musical: polifonía.

Esta técnica es muy útil para la música polifónica. Para introducir música con más voces o con más pentagramas, lo que hacemos es combinar varias expresiones en paralelo. Para indicar que dos voces se deben interpretar al mismo tiempo, sencillamente introduzca una combinación simultánea de expresiones musicales. Una expresión musical ‘simultánea’ se forma encerrando las expresiones dentro de << y >>. En el ejemplo que sigue, tres secuencias (cada una de las cuales contiene dos notas diferentes) se combinan de forma simultánea:

\relative c'' {
  <<
    { a4 g }
    { f e }
    { d b }
  >>
}

Tenga en cuenta que hemos sangrado cada nivel jerárquico de la entrada con un margen distinto. A LilyPond no le importa cuánto (o cuán poco) espacio haya al comienzo de una línea, pero el establecimiento de márgenes distintos dentro del código de LilyPond, de esta forma, lo hace mucho más fácil de leer por nosotros los seres humanos.

Expresiones musicales simultáneas: un solo pentagrama

Para determinar el número de pentagramas en una pieza, LilyPond examina la primera expresión. Si ésta consiste en una sola nota, hay un solo pentagrama; si hay una expresión simultánea, hay más de un pentagrama.

\relative c'' {
  c2 <<c e>>
  << { e f } { c <<b d>> } >>
}

2.3.2 Varios pentagramas

Como ya hemos visto en Explicación de las expresiones musicales, los archivos de entrada para LilyPond se construyen a base de expresiones musicales. Si la partitura comienza con expresiones musicales simultáneas, LilyPond crea varios pentagramas. Sin embargo es más fácil ver lo que ocurre si creamos cada uno de los pentagramas de forma explícita.

Para imprimir más de un pentagrama, cada fragmento de música que constituye un pentagrama se marca escribiendo \new Staff antes de él. Estos elementos Staff se combinan después en paralelo con << y >>:

\relative c'' {
  <<
    \new Staff { \clef treble c }
    \new Staff { \clef bass c,, }
  >>
}

La instrucción \new inaugura un ‘contexto de notación’. Un contexto de notación es un entorno dentro del que se interpretan los acontecimientos musicales (como las notas o las instrucciones \clef). Para piezas sencillas, tales contextos de notación se crean automáticamente. Para piezas más complicadas, es mejor marcar los contextos de forma explícita.

Existen varias clases de contextos. Score, Staff y Voice manejan la notación melódica, mientras que Lyrics se ocupa de los textos cantados y ChordNames imprime los nombres de los acordes.

En términos de sintaxis, la anteposición de \new a una expresión musical crea una expresión musical mayor. Es semejante al signo menos de las matemáticas. La fórmula (4+5) es una expresión, por tanto -(4+5) es una expresión más amplia.

Las indicaciones de compás escritas en un pentagrama afectan al resto de ellos, de forma predeterminada. En cambio, la armadura de la tonalidad de un pentagrama no afecta a los otros pentagramas. Este comportamiento predeterminado diferente es a causa de que las partituras con instrumentos transpositores son más comunes que las partituras polirrítmicas.

\relative c'' {
  <<
    \new Staff { \clef treble \key d \major \time 3/4 c }
    \new Staff { \clef bass c,, }
  >>
}

2.3.3 Grupos de pentagramas

Glosario musical: llave.

La música para piano se compone tipográficamente en forma de dos pentagramas unidos mediante una llave. El aspecto impreso de este sistema de pentagramas se parece al ejemplo polifónico que aparece en Varios pentagramas, pero en esta ocasión la expresión completa se coloca dentro de un PianoStaff:

\new PianoStaff <<
  \new Staff …
  \new Staff …
>>

He aquí un pequeño ejemplo:

\relative c'' {
  \new PianoStaff <<
    \new Staff { \time 2/4 c4 e g g, }
    \new Staff { \clef bass c,, c' e c }
  >>
}

Otros grupos de pentagramas se declaran mediante \new GrandStaff, que es apropiado para partituras orquestales, y \new ChoirStaff, que es apropiado para partituras vocales. Cada uno de estos grupos de pautas forma un tipo de contexto distinto, que produce la llave a la izquierda y que también controla el alcance de las líneas divisorias.

Véase también

Referencia de la notación: Teclados y otros instrumentos de varios pentagramas, Impresión de los pentagramas.

2.3.4 Combinar notas para formar acordes

Glosario musical: acorde.

Hemos visto con anterioridad cómo se pueden combinar las notas formando acordes que indican que son simultáneas, encerrándolas entre dobles ángulos. Sin embargo, la forma normal de indicar un acorde es encerrar las notas entre ángulos sencillos. Observe que todas las notas de un acorde deben tener la misma duración, y que la duración se escribe después del ángulo de cierre.

r4 <c e g>4 <c f a>2

Debemos pensar en los acordes como algo casi equivalente a las notas sencillas: casi todo lo que se puede adjuntar a una nota se puede adjuntar también a un acorde, y todo debe ir por fuera de los ángulos. Por ejemplo, puede combinar marcas como barras y ligaduras, con acordes. Tan sólo debe recordar que se escriben por fuera de los ángulos.

r4 <c e g>8[ <c f a>]~ <c f a>2
r4 <c e g>8( <c e g>\> <c e g>4 <c f a>\!)

2.3.5 Polifonía en un solo pentagrama

Cuando distintas líneas melódicas se combinan sobre un solo pentagrama, se imprimen como voces polifónicas; cada voz lleva sus propias plicas, ligaduras y barras de corchea, y la voz superior tiene las plicas hacia arriba mientras que la voz inferior las tiene hacia abajo.

La introducción de estas partes se hace escribiendo cada voz en forma de secuencia (con {...}) y combinando éstas de forma simultánea, separando las voces con \\

<<
  { a4 g2 f4~ f4 } \\
  { r4 g4 f2 f4 }
>>

Para el tipografiado de música polifónica, puede ser conveniente la utilización de silencios separadores, o sea, silencios que no aparecen impresos. Son muy útiles para rellenar voces que temporalmente no están cantando. He aquí el mismo ejemplo con un silencio separador (s) en vez de un silencio normal (r):

<<
  { a4 g2 f4~ f4 } \\
  { s4 g4 f2 f4 }
>>

Una vez más, las expresiones de este tipo se pueden anidar de forma arbitraria.

<<
  \new Staff <<
    { a4 g2 f4~ f4 } \\
    { s4 g4 f2 f4 }
  >>
  \new Staff <<
    \clef bass
    { <c g>1 ~ <c g>4 } \\
    { e,,4 d e2 ~ e4}
  >>
>>

Véase también

Referencia de la notación: Notas simultáneas.

2.4 Canciones

En esta sección presentamos cómo elaborar música vocal y hojas de canción sencillas.

2.4.1 Elaborar canciones sencillas

Glosario musical: letra.

Presentamos a continuación el inicio de la melodía de una canción infantil, “Girls and boys come out to play”:

\relative c'' {
  \key g \major
  \time 6/8
  d4 b8 c4 a8 d4 b8 g4
}

La letra se puede asignar a esas notas, combinando ambas con la palabra clave \addlyrics. La letra se escribe separando cada sílaba mediante un espacio.

<<
  \relative c'' {
    \key g \major
    \time 6/8
    d4 b8 c4 a8 d4 b8 g4
  }
  \addlyrics {
    Girls and boys come out to play,
  }
>>

Observe las llaves rodeando tanto la música como la letra, y los ángulos dobles << ... >> alrededor del fragmento entero para expresar que la música y la letra han de suceder al mismo tiempo.

2.4.2 Alineación de la letra a una melodía

Glosario musical: melisma, línea extensora.

La siguiente línea de la canción infantil es The moon doth shine as bright as day. A continuación vamos a ampliarla:

<<
  \relative c'' {
    \key g \major
    \time 6/8
    d4 b8 c4 a8 d4 b8 g4
    g8 a4 b8 c b a d4 b8 g4.
  }
  \addlyrics {
    Girls and boys come out to play,
    The moon doth shine as bright as day;
  }
>>

Podemos observar que la letra adicional no se alinea correctamente con las notas. La palabra ‘shine’ se debe cantar sobre dos notas, no una. Esto se conoce como melisma, una sílaba única que se canta sobre más de una nota. Existen varias formas de hacer que una sílaba recaiga sobre varias notas, siendo la más sencilla escribir una ligadura de expresión sobre ellas (véase Ligaduras de unión y de expresión):

<<
  \relative c'' {
    \key g \major
    \time 6/8
    d4 b8 c4 a8 d4 b8 g4
    g8 a4 b8 c( b) a d4 b8 g4.
  }
  \addlyrics {
    Girls and boys come out to play,
    The moon doth shine as bright as day;
  }
>>

Ahora la letra se alinea correctamente con las notas, pero el barrado automático de las notas que corresponden a shine as no parece correcto. Podemos remediarlo insertando instrucciones de barrado manual para sobreescribir el barrado automático; para ver más detalles consulte Barras automáticas y manuales.

<<
  \relative c'' {
    \key g \major
    \time 6/8
    d4 b8 c4 a8 d4 b8 g4
    g8 a4 b8 c([ b]) a d4 b8 g4.
  }
  \addlyrics {
    Girls and boys come out to play,
    The moon doth shine as bright as day;
  }
>>

Como alternativa a la utilización de ligaduras de expresión, los melismas se pueden indicar solamente en la letra utilizando un guión bajo, _, para cada nota que queremos incluir dentro del melisma:

<<
  \relative c'' {
    \key g \major
    \time 6/8
    d4 b8 c4 a8 d4 b8 g4
    g8 a4 b8 c[ b] a d4 b8 g4.
  }
  \addlyrics {
    Girls and boys come out to play,
    The moon doth shine _ as bright as day;
  }
>>

Si una sílaba se extiende sobre varias notas o una sola nota muy larga, normalmente se traza una línea extensora desde la sílaba que se extiende y por debajo de todas las notas que corresponden a dicha sílaba. Se escribe como dos guiones bajos __. He aquí un ejemplo extraído de los primeros tres compases del Lamento de Dido, de Dido y Eneas de Purcell:

<<
  \relative c'' {
    \key g \minor
    \time 3/2
    g2 a bes bes( a)
    b c4.( bes8 a4. g8 fis4.) g8 fis1
  }
  \addlyrics {
    When I am laid,
    am laid __ in earth,
  }
>>

Hasta el momento, ninguno de los ejemplos implicaban palabras que tuviesen más de una sílaba. Estas palabras se reparten por lo general a razón de una nota por cada sílaba, con guiones cortos entre las sílabas. Dichos guiones separadores se teclean como dos guiones, con el resultado de un guión corto centrado entre las sílabas. Presentamos a continuación un ejemplo que demuestra esto y todo lo que hemos aprendido hasta el momento acerca de la alineación de la letra a las notas.

<<
  \relative c' {
    \key g \major
    \time 3/4
    \partial 4
    d4 g4 g a8( b) g4 g4
    b8( c) d4 d e4 c2
  }
  \addlyrics {
    A -- way in a __ man -- ger,
    no __ crib for a bed, __
  }
>>

Algunos textos (especialmente los que están en italiano o en español) requieren lo contrario: colocar más de una sílaba a una única nota. Esto se consigue enlazando las sílabas entre sí mediante un guión bajo simple _ (sin ningún espacio), o bien encerrándolas entre corchetes. Aquí aparece un ejemplo procedente del Barbero de Sevilla de Rossini, donde la sílaba al se canta sobre la misma nota que la sílaba go de la palabra ‘Largo’ en el aria de Fígaro Largo al factotum:

<<
  \relative c' {
    \clef bass
    \key c \major
    \time 6/8
    c4.~ c8 d b c([ d]) b c d b c
  }
  \addlyrics {
    Lar -- go_al fac -- to -- tum del -- la cit -- tà
  }
>>

Véase también

Referencia de la notación: Música vocal.

2.4.3 Letra en varios pentagramas

La solución sencilla que utiliza \addlyrics se puede usar para poner letra a más de un pentagrama. Aquí aparece un ejemplo sacado del Judas Macabeo de Haendel:

<<
  \relative c'' {
    \key f \major
    \time 6/8
    \partial 8
    c8 c([ bes]) a a([ g]) f f'4. b, c4.~ c4
  }
  \addlyrics {
    Let flee -- cy flocks the hills a -- dorn, __
  }
  \relative c' {
    \key f \major
    \time 6/8
    \partial 8
    r8 r4. r4 c8 a'([ g]) f f([ e]) d e([ d]) c bes'4
  }
  \addlyrics {
    Let flee -- cy flocks the hills a -- dorn,
  }
>>

Cualquier partitura de una complejidad mayor que la de este sencillo ejemplo se hace mejor separando la letra de la estructura de pentagramas mediante variables (expresiones con nombre). Éstas se tratan en Organizar las piezas mediante variables.

Véase también

Referencia de la notación: Música vocal.

2.5 Retoques finales

Éste es el último apartado del tutorial; muestra la forma de dar los toques finales a piezas sencillas, y ofrece una introducción al resto del manual.

2.5.1 Organizar las piezas mediante variables

Cuando los elementos que hemos discutido anteriormente se combinan para producir archivos mayores, las expresiones musicales se hacen enormes. En música polifónica con muchos pentagramas, los archivos de entrada pueden volverse muy propensos a la confusión. Podemos reducir esta confusión utilizando las variables.

Con las variables (también conocidas como identificadores o macros), podemos trocear las expresiones musicales complejas. Una variable se asigna de la manera siguiente:

musicaConNombre = { … }

El contenido de la expresión musical musicaConNombre se puede usar posteriormente colocando una barra invertida delante del nombre (\musicaConNombre, igual que una orden normal de LilyPond).

violin = \new Staff {
  \relative c'' {
    a4 b c b
  }
}
cello = \new Staff {
  \relative c {
    \clef bass
    e2 d
  }
}
{
  <<
    \violin
    \cello
  >>
}

El nombre de una variable debe consistir enteramente en caracteres alfabéticos, es decir sin números, guiones ni guiones bajos.

Las variables se deben definir antes de la expresión musical principal, pero se pueden usar tantas veces como se quiera, en cualquier lugar, una vez que han sido definidas. Incluso se pueden usar dentro de la definición de otra variable, proporcionando una vía para acortar el código si una sección musical se repite muchas veces.

tresilloA = \times 2/3 { c,8 e g }
compasA = { \tresilloA \tresilloA \tresilloA \tresilloA }

\relative c'' {
 \compasA \compasA
}

Las variables se pueden usar para otros muchos tipos de objetos dentro del código de entrada. Por ejemplo,

ancho = 4.5\cm
nombre = "Wendy"
papelAcinco = \paper { paperheight = 21.0 \cm }

Dependiendo de su contenido, la variable se puede usar en distintos lugares. El siguiente ejemplo utiliza las variables anteriores:

\paper {
  \aFivePaper
  line-width = \width
}
{
  c4^\name
}

2.5.2 Número de la versión

La indicación \version deja registrado para qué versión de LilyPond se escribió el archivo:

\version "2.11.65"

por convenio se sitúa al principio del archivo de partitura de LilyPond.

Estas anotaciones hacen menos problemáticas las subsiguientes actualizaciones de LilyPond. Los cambios en la sintaxis se tratan mediante un programa especial, convert-ly, y utiliza \version para determinar qué reglas hay que aplicar. Para ver más detalles, consulte Actualizar ficheros con convert-ly).

2.5.3 Añadir títulos

La información sobre el título, autor, número de Opus y similares se escriben en el bloque \header. Éste se encuentra fuera de la expresión musical principal; el bloque \header normalmente se sitúa por debajo del número de versión.

\version "2.11.65"
\header {
  title = "Sinfonía"
  composer = "Yo"
  opus = "Op. 9"
}

{
  … música …
}

Cuando se procesa el archivo, el título y el autor se imprimen por encima de la música. Puede obtener más información sobre los títulos en Crear títulos.

2.5.4 Nombres de nota absolutos

Hasta el momento siempre hemos utilizado \relative para definir las alturas. Ésta es la forma más sencilla de escribir la mayor parte de la música, pero existe otra forma de definir las alturas: el modo absoluto.

Si omite el \relative, LilyPond tratará todas las alturas como valores absolutos. Un