@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@ignore
- Translation of GIT committish: 049bdd90b5ae67fe463bf85e926c2eabf51acf74
+ Translation of GIT committish: 181db07b2627d98fb77564c45fad23a96e7ee54c
- When revising a translation, copy the HEAD committish of the
- version that you are working on. For details, see the Contributors'
- Guide, node Updating translation committishes..
+ When revising a translation, copy the HEAD committish of the
+ version that you are working on. For details, see the Contributors'
+ Guide, node Updating translation committishes..
@end ignore
-@c \version "2.16.0"
+@c \version "2.19.22"
@c Translators: Jean-Charles Malahieude, Valentin Villenave
* Titres et entêtes::
* Travail sur des fichiers texte::
* Contrôle des sorties::
-* Sortie MIDI::
+* Génération de fichiers MIDI::
* Extraction d'informations musicales::
@end menu
@example
\score @{
-...
+@dots{}
@}
@end example
Les commentaires constituent l'une des rares exceptions à cette règle
immuable -- voir @ref{Structure de fichier} pour les autres. Qu'il
-s'agisse d'une seule ligne ou de tout un bloc -- délimité par @code{%@{
-.. %@}} -- un commentaire peut se placer n'importe où dans le fichier
-source, aussi bien à l'intérieur qu'à l'extérieur du bloc @code{\score},
-ou encore à l'intérieur ou à l'extérieur de l'expression musicale
-contenue dans un bloc @code{\score}.
+s'agisse d'une seule ligne ou de tout un bloc -- délimité par
+@code{%@{ @dots{} %@}} -- un commentaire peut se placer n'importe où
+dans le fichier source, aussi bien à l'intérieur qu'à l'extérieur du
+bloc @code{\score}, ou encore à l'intérieur ou à l'extérieur de
+l'expression musicale contenue dans un bloc @code{\score}.
Lorsqu'un fichier ne comprend qu'un bloc @code{\score}, celui-ci est
implicitement inclus dans un bloc @code{\book}. Le bloc @code{\book}
@example
\score @{
- @var{..musique..}
+ @var{@dots{}musique@dots{}}
@}
@end example
@example
\markup @{
- @var{..texte..}
+ @var{@dots{}texte@dots{}}
@}
@end example
@example
\score @{
- @var{..}
+ @var{@dots{}}
@}
\markup @{
- @var{..}
+ @var{@dots{}}
@}
\score @{
- @var{..}
+ @var{@dots{}}
@}
@end example
\header @{ piece = "Romance" @}
@}
\markup @{
- ..texte du second couplet..
+ @dots{}texte du second couplet@dots{}
@}
\markup @{
- ..texte du troisième couplet..
+ @dots{}texte du troisième couplet@dots{}
@}
\score @{
@dots{}
@funindex \bookpart
-Plusieurs pièces seront regroupées dans un même @qq{chapitre} à l'aide
-d'un bloc @code{\bookpart}. Ces différents @qq{chapitres} sont séparés
+Plusieurs pièces seront regroupées dans un même « chapitre » à l'aide
+d'un bloc @code{\bookpart}. Ces différents « chapitres » sont séparés
par un saut de page et peuvent comporter un titre à l'instar de
l'ouvrage dès lors que vous y insérez un bloc @code{\header}.
@example
\book @{
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
\book @{
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
\book @{
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
@end example
\book @{
\bookOutputSuffix "Romance"
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
\book @{
\bookOutputSuffix "Menuet"
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
\book @{
\bookOutputSuffix "Nocturne"
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
@end example
\book @{
\bookOutputName "Romance"
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
\book @{
\bookOutputName "Menuet"
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
\book @{
\bookOutputName "Nocturne"
\score @{ @dots{} @}
- \layout @{ @dots{} @}
+ \paper @{ @dots{} @}
@}
@end example
différents contenus seront combinés, à ceci près qu'en cas de
déclarations conflictuelles, la dernière aura préséance. Des
informations complémentaires sont disponibles à la rubrique
-@ref{Le bloc \layout}.
+@ref{Le bloc layout}.
@item
Une expression Scheme pure, telle que
@w{@code{#(ly:set-option 'point-and-click #f)}}.
@item
-Un bloc @code{\header}, dont le contenu sera de portée globale -- ce qui
-est le cas en général pour le titre ou l'auteur entre autres.
+Un bloc @code{\header}, dont le contenu sera valide pour tout le
+fichier. Il comporte en général les valeurs par défaut des champs de
+titrage, tels le titre ou l'auteur entre autres, communs à tous les
+blocs @code{\book} inclus dans le fichier -- voir
+@ref{Généralités en matière de titrages}.
@item
Un bloc @code{\score} pour la partition. Cette partition sera assemblée
avec les autres partitions se trouvant au même niveau pour composer le
@code{\book}. Vous pouvez modifier ce comportement à l'aide de la
-variable @code{toplevel-score-handler} placée en tête.
-@ignore
-@c FIXME - I cannot read "toplevel-score-handler" in scm/lily.scm -jcm
-The default handler is defined in the init file @file{../scm/lily.scm}.
-@end ignore
+variable @code{toplevel-score-handler} placée en tête. Le gestionnaire
+par défaut est défini dans le fichier d'initialisation
+@file{../scm/lily.scm}, et les réglages par défaut dans le fichier
+@file{../ly/declarations-init.ly}.
@item
Un bloc @code{\book} permet de regrouper naturellement plusieurs
un document lilypond-book qui reprendrait plusieurs @code{\score} ou
@code{\markup} dans un même extrait. Vous pouvez modifier ce
comportement à l'aide de la variable @code{toplevel-book-handler}
-placée en tête.
-@ignore
-@c FIXME - I cannot read "toplevel-book-handler" in scm/lily.scm -jcm
-The default handler is defined in the init file @file{../scm/lily.scm}.
-@end ignore
+placée en tête. Le gestionnaire par défaut est défini dans le fichier
+d'initialisation @file{../scm/lily.scm}.
@item
Un bloc @code{\bookpart}. Un ouvrage peut se découper en plusieurs
@end example
Vous pouvez modifier ce comportement à l'aide de la variable
-@code{toplevel-music-handler} placée en tête.
-@ignore
-@c FIXME - I cannot read "toplevel-music-handler" in scm/lily.scm -jcm
-The default handler is defined in the init file @file{../scm/lily.scm}.
-@end ignore
+@code{toplevel-music-handler} placée en tête. Le gestionnaire par
+défaut est défini dans le fichier d'initialisation
+@file{../scm/lily.scm}.
@item
Du texte sous forme de @emph{markup} comme les paroles d'un couplet
Une ligne de commentaire, introduite par le signe @code{%}.
@item
-Un bloc de commentaire, délimité par @code{%@{ .. %@}}.
+Un bloc de commentaire, délimité par @code{%@{ @dots{} %@}}.
@end itemize
@itemize
@item
-Autour d'une accolade, qu'elle soit ouvrant ou fermante ;
+Autour d'une accolade, qu'elle soit ouvrante ou fermante ;
@item
Après chaque commande ou variable, autrement dit tout élément qui
Pour séparer les éléments d'une expression Scheme ;
@item
-En mode parole -- @code{lyricmode} -- pour séparer les termes des
-commandes @code{\override} et @code{\set}. Précisons à ce sujet qu'en
-plus d'ajouter une espace avant et après l'intégralité de la commande,
-vous devrez encadrer d'espaces le point et le signe égal qu'elle peut
-contenir, comme dans
-@w{@code{\override Score . LyricText #'font-size = #5}}.
+En mode parole -- @code{lyricmode} -- avant et après les commandes
+@code{\override} et @code{\set}.
@end itemize
@rlearning{Organisation des fichiers LilyPond}.
Manuel de notation :
-@ref{Le bloc \layout}.
+@ref{Généralités en matière de titrages},
+@ref{Le bloc layout}.
@node Titres et entêtes
@section Titres et entêtes
@translationof Titles and headers
+@cindex titre
+@cindex entête
+@cindex pied de page
+
La plupart de la musique qui est éditée comporte un titre et le nom de
-son compositeur ; certains ouvrages divulguent beaucoup plus
-d'information.
+son compositeur ; certains ouvrages dispensent beaucoup plus
+d'informations.
@menu
* Création de titres et entête ou pied de page::
* Titrages personnalisés::
+* Création des métadonnées des fichiers de sortie::
* Notes de bas de page::
* Référencement des numéros de page::
* Table des matières::
@translationof Creating titles headers and footers
@menu
-* Contenu des blocs de titrage::
-* Mise en forme par défaut des titrages::
+* Généralités en matière de titrages::
+* Mise en forme par défaut des titrages subalternes::
* Mise en forme par défaut des entête et pied de page::
@end menu
-@node Contenu des blocs de titrage
-@unnumberedsubsubsec Contenu des blocs de titrage
-@translationof Title blocks explained
+@node Généralités en matière de titrages
+@unnumberedsubsubsec Généralités en matière de titrages
+@translationof Titles explained
-@c TODO: figure out how \bookpart titles work
+Chaque bloc @code{\book} apparaissant dans un même fichier source
+résultera en un fichier indépendant, comme indiqué à la rubrique
+@ref{Structure de fichier}. Chacun de ces fichiers résultants comporte
+trois endroits où placer des titrages : le @strong{titrage de l'ouvrage}
+au début de chaque recueil (@emph{book}), les @strong{titrages de
+partie} au début de chaque partie (@emph{bookpart}) et les
+@strong{titrages de morceau} avant chaque pièce (@emph{score}).
-Il existe en fait deux types de blocs de titrage : un bloc pour
-contenir le titre principal qui doit apparaître avant le tout premier
-@code{\score} d'un ouvrage, et un autre attaché à chacun des blocs
-@code{\score} qui le composent. Dans les deux cas, les champs qui
-composent un bloc de titrage se saisissent dans un bloc @code{\header}.
+La valeur des champs de titrage @code{title} (le titre) et
+@code{composer} (le compositeur) se définissent dans des blocs
+@code{\header} -- la syntaxe appropriée et la liste des différents
+champs disponibles par défaut sont à la section
+@ref{Mise en forme par défaut des titrages subalternes}.
+Les titrages d'un ouvrage, de ses parties ou des morceaux qu'il contient
+peuvent tous comporter les même champs bien que, par défaut, le titrage
+d'un morceau se limite à @code{piece} et @code{opus}.
-Lorsque l'ouvrage ne comporte qu'un seul morceau, le bloc @code{\header}
-peut se placer en dehors ou au sein même du bloc @code{\score}.
+Les blocs @code{\header} peuvent se placer à quatre endroits différents
+qui formeront une hiérarchie descendante :
-Dans le cas où le bloc @code{\header} est défini à l'intérieur du bloc
-@code{\score}, seuls les champs @code{piece} et @code{opus} seront
-imprimés.
+@itemize
-@lilypond[papersize=a5,quote,verbatim,noragged-right]
-\score {
- { c'4 }
- \header {
- title = "title" % not printed
- piece = "piece"
- opus = "opus"
- }
-}
-@end lilypond
+@item
+En tête du fichier source, avant même tout bloc @code{\book},
+@code{\bookpart} ou @code{\score} ;
-@funindex print-all-headers
-@noindent
-Vous pouvez modifier ce comportement et imprimer tous les champs d'un
-bloc @code{\header} défini dans un bloc @code{\score} en ajoutant
+@item
+Au sein d'un bloc @code{\book} et en dehors de tout bloc
+@code{\bookpart} ou @code{\score} qu'il contient ;
-@example
-\paper@{
- print-all-headers = ##t
-@}
-@end example
+@item
+Au sein d'un bloc @code{\bookpart} et en dehors de tout bloc
+@code{\score} qu'il contient ;
+
+@item
+Après l'expression musicale incluse dans un bloc @code{\score}.
+
+@end itemize
+
+La valeur des différents champs sera filtrée en respectant cette
+hiérarchie ; les valeurs persisteront à moins d'être écrasées par une
+autre valeur à un niveau inférieur. Ainsi :
+
+@itemize
+@item
+Le titre d'un ouvrage découle des champs définis en tête de fichier
+source, modifiés par les champs définis au sein du bloc @code{\book}.
+Les champs résultants serviront à affecter un titre de recueil à
+l'ouvrage, si tant est que quoi que ce soit génère une page au début de
+cet ouvrage, avant la première partie -- un simple saut de page forcé
+(@code{\pageBreak}) suffit.
+
+@item
+Le titre d'une partie découle des champs définis en tête du fichier
+source, modifiés par les champs définis au sein du bloc @code{\book}
+puis par ceux définis au sein du bloc @code{\bookpart}. Les valeurs qui
+en résulteront permettront d'imprimer les titrages de partie pour cette
+partie.
+
+@item
+Le titre d'un morceau découle des champs définis en tête du fichier
+source, modifiés par les champs définis au sein du bloc @code{\book}
+puis par ceux définis au sein du bloc @code{\bookpart}, et enfin par
+ceux définis au sein du bloc @code{\score}. Les valeurs qui en
+résulteront permettront d'imprimer les titrages de morceau pour ce
+morceau. Notez toutefois que, pour un morceau, seuls les champs
+@code{piece} et @code{opus} seront imprimés, à moins d'avoir valorisé
+à @code{#t} la variable @code{print-all-headers} dans la section
+@code{\paper}.
+
+@end itemize
@warning{N'oubliez pas que lorsqu'il est placé à l'intérieur d'un bloc
@code{@bs{}score}, le bloc @code{@bs{}header} doit impérativement se
trouver @strong{à la suite} de l'expression musicale.}
+Nul n'est besoin de fournir un bloc @code{\header} à chacun des quatre
+niveaux ; on peut se passer aussi bien de l'un d'eux que de tous. Dans
+la même veine, un fichier source simpliste peut ne pas mentionner de
+bloc @code{\book} ou @code{\bookpart} qui seront alors créés
+implicitement.
+
+Lorsque l'ouvrage ne comporte qu'un seul morceau, le bloc @code{\header}
+devrait prendre place en tête de fichier, de telle sorte que soit produit
+un titrage de partie qui met à disposition tous les champs de titrage.
+
+Lorsque l'ouvrage comporte plusieurs morceaux, différents arrangements
+du bloc @code{\header} permettent d'obtenir différents styles de
+publication musicale. Par exemple, si la publication comprend plusieurs
+pièces du même compositeur, un bloc @code{\header} placé en tête de
+fichier définira le titre de l'ouvrage et le compositeur, que l'on
+complètera par un bloc @code{\header} dans chaque bloc @code{\score}
+pour définir les champs @code{piece} et @code{opus}, comme ici :
+
@lilypond[papersize=a5,quote,verbatim,noragged-right]
\header {
title = "SUITE I."
}
\score {
- \new Staff \relative g, {
+ \new Staff \relative {
\clef bass
\key g \major
- \repeat unfold 2 { g16( d' b') a b d, b' d, } |
+ \repeat unfold 2 { g,16( d' b') a b d, b' d, } |
\repeat unfold 2 { g,16( e' c') b c e, c' e, } |
}
\header {
}
\score {
- \new Staff \relative b {
+ \new Staff \relative {
\clef bass
\key g \major
\partial 16 b16 |
}
@end lilypond
-Tous les champs appartenant au titrage principal d'un ouvrage peuvent se
-reporter dans chaque bloc @code{\score} ou être supprimés manuellement :
+Des agencements plus élaborés sont aussi réalisables. Par exemple, les
+champs appartenant au titrage principal d'un ouvrage peuvent se
+reporter dans chaque bloc @code{\score}, certains étant modifiés voire
+supprimés manuellement :
@c KEEP LY
@lilypond[papersize=a5,quote,verbatim,noragged-right]
\header {
title = "DAS WOHLTEMPERIRTE CLAVIER"
subtitle = "TEIL I"
- % Pas de mention spéciale pour cet ouvrage
+ % Pas de mention spéciale par défaut pour cet ouvrage
tagline = ##f
}
\markup { \vspace #1 }
@seealso
Manuel de notation :
-@ref{Structure de fichier},
-@ref{Mise en forme personnalisée des blocs de titrage}.
+@ref{Mise en forme par défaut des titrages subalternes},
+@ref{Mise en forme personnalisée des titrages},
+@ref{Structure de fichier}.
-@node Mise en forme par défaut des titrages
-@unnumberedsubsubsec Mise en forme par défaut des titrages
-@translationof Default layout of book and score title blocks
+@node Mise en forme par défaut des titrages subalternes
+@unnumberedsubsubsec Mise en forme par défaut des titrages subalternes
+@translationof Default layout of bookpart and score titles
-Voici les différentes variables attachées au bloc @code{\header} :
+Voici les différentes variables imprimables attachées au bloc
+@code{\header} :
@c KEEP LY
-@lilypond[papersize=a7,quote,verbatim,noragged-right]
+@lilypond[papersize=a6landscape,quote,verbatim,noragged-right]
\book {
\header {
% Les champs suivants sont centrés
subtitle = "Sous-titre"
subsubtitle = "Sous-sous-titre"
% Les champs suivants sont répartis sur une même ligne, et
- % le champ "instrument" apparaîtra sue les pages suivantes
+ % le champ "instrument" apparaîtra sur les pages suivantes
instrument = \markup \with-color #green "Instrument"
poet = "Librettiste"
composer = "Compositeur"
meter = "Tempo"
arranger = "Arrangeur"
% Les champs suivants sont centrés en bas de page
- tagline = "« tagline » ou mention spéciale en pied de dernière page"
- copyright = "copyright en pied de première page"
+ tagline = "Le « tagline » ou mention spéciale va en pied de dernière page"
+ copyright = "Le copyright va en pied de première page"
}
\score {
{ s1 }
{ s1 }
\header {
% Les champs suivants sont en opposition sur la même ligne
- piece = "Pièce 3 sue une nouvelle page"
+ piece = "Pièce 3 sur une nouvelle page"
opus = "Opus 3"
}
}
@item
Seuls seront imprimés les champs @code{piece} et @code{opus} inclus dans
un bloc @code{\score} dès lors que la variable @code{print-all-headers}
-reste désactivée (valeur à @code{##f}).
+reste désactivée (valeur à @code{##f}).
@item
@c Is the bit about \null markups true? -mp
@end itemize
Les possibilités de modifier la mise en forme par défaut sont abordées à
-la rubrique @ref{Mise en forme personnalisée des blocs de titrage}.
+la rubrique @ref{Mise en forme personnalisée des titrages}.
@cindex breakbefore
+Un bloc @code{\book} qui commencerait directement par un bloc
+@code{\bookpart} ne verra pas ses titrages apparaître puisqu'il n'y a
+aucune page où imprimer le titre. Si toutefois le titre de l'ouvrage
+est requis, le bloc @code{\book} devra commencer par un @emph{markup} ou
+une commande @code{\pageBreak}.
+
La variable @code{breakbefore} activée dans un bloc @code{\header} situé
dans un bloc @code{\score} force le saut de page avant le morceau
contenu dans ce @code{\score}. Vous pourrez ainsi séparer le titre
principal de la musique.
-@lilypond[papersize=a8landscape,verbatim,noragged-right]
+@lilypond[papersize=c7landscape,verbatim,noragged-right]
\book {
\header {
title = "This is my Title"
@rlearning{Organisation des fichiers LilyPond}.
Manuel de notation :
-@ref{Mise en forme personnalisée des blocs de titrage},
+@ref{Mise en forme personnalisée des titrages},
@ref{Structure de fichier}.
Fichiers d'initialisation :
@unnumberedsubsubsec Mise en forme par défaut des entête et pied de page
@translationof Default layout of headers and footers
-Les entête et pied -- @emph{headers} et @emph{footers} -- sont des
+Les entête et pied -- @emph{header} et @emph{footer} -- sont des
lignes de textes qui apparaissent en haut et en bas de chaque page,
indépendamment du texte de l'ouvrage. Ils sont contrôlés par les
variables suivantes, attachées au bloc @code{\paper} :
@end itemize
-@lilypond[papersize=a8landscape]
-\book {
- \score {
- \relative c' {
- c4 d e f
- }
- }
-}
-@end lilypond
-
-La mention spéciale se modifie en alimentant le champ @code{tagline} au
-niveau du bloc @code{\header} principal.
+Le texte de la mention spéciale par défaut se modifie en alimentant le
+champ @code{tagline} au niveau du bloc @code{\header} principal.
@lilypond[papersize=a8landscape,verbatim]
\book {
\header {
- tagline = "... music notation for Everyone"
+ tagline = "... la notation musicale pour Tous"
}
\score {
- \relative c' {
- c4 d e f
+ \relative {
+ c'4 d e f
}
}
}
@end lilypond
-Pour supprimer le @code{tagline}, il suffit de lui assigner la valeur
-@code{##f}.
+Pour supprimer le @code{tagline} par défaut, il suffit de lui assigner
+la valeur @code{##f}.
@node Titrages personnalisés
@subsection Titrages personnalisés
-@translationof Custom headers footers and titles
+@translationof Custom titles headers and footers
@c TODO: somewhere put a link to header spacing info
@c (you'll have to explain it more in NR 4).
@menu
* Mise en forme personnalisée des champs de titrage::
-* Mise en forme personnalisée des blocs de titrage::
+* Mise en forme personnalisée des titrages::
* Mise en forme personnalisée des entête et pied de page::
@end menu
@translationof Custom text formatting for title blocks
Toutes les commandes de mise en forme d'un @code{\markup} permettent de
-personnaliser le texte des entête, pied de page et éléments de titre
+personnaliser le texte des entête, pied de page et éléments de titrage
contenus dans un bloc @code{\header}.
@lilypond[quote,verbatim,noragged-right]
{ s1 }
\header {
piece = \markup { \fontsize #4 \bold "PRAELUDIUM I" }
- opus = \markup { \italic "(Excerpt)" }
+ opus = \markup { \italic "BWV 846" }
}
}
@end lilypond
@ref{Mise en forme du texte}.
-@node Mise en forme personnalisée des blocs de titrage
-@unnumberedsubsubsec Mise en forme personnalisée des blocs de titrage
-@translationof Custom layout for title blocks
+@node Mise en forme personnalisée des titrages
+@unnumberedsubsubsec Mise en forme personnalisée des titrages
+@translationof Custom layout for titles
@cindex bookTitleMarkup
@cindex scoreTitleMarkup
Le positionnement des titres, avec les valeurs par défaut de ces
variables @code{\markup}, est illustré à la rubrique
-@ref{Mise en forme par défaut des titrages}.
+@ref{Mise en forme par défaut des titrages subalternes}.
Voici les réglages par défaut de @code{scoreTitleMarkup}, tels que
définis dans le fichier @file{ly/titling-init.ly} :
@example
scoreTitleMarkup = \markup @{ \column @{
- \on-the-fly #print-all-headers @{ \bookTitleMarkup \hspace #1 @}
+ \on-the-fly \print-all-headers @{ \bookTitleMarkup \hspace #1 @}
\fill-line @{
\fromproperty #'header:piece
\fromproperty #'header:opus
}
@end lilypond
-Voici comment positionner le champ @code{piece}, dont nous modifions
-la taille et la graisse, au centre de cette ligne :
+Voici comment redéfinir le @code{scoreTitleMarkup} de telle sorte que le
+champ @code{piece}, dont nous modifions la taille et la graisse, se
+place au centre de cette ligne :
@lilypond[papersize=a5,quote,verbatim,noragged-right]
\book {
}
@end lilypond
-Les champs normalement réservés au bloc de titrage principal seront
-reportés au niveau inférieur dès lors que vous aurez activé
-l'instruction @code{print-all-headers} au sein du bloc @code{\paper}.
-Le principal inconvénient de cette fonction réside dans le fait que les
-champs réservés au bloc @code{\header} principal devront être supprimés
-dans chacun des blocs @code{\score} de votre fichier source -- voir
-@ref{Contenu des blocs de titrage}.
+Les champs normalement absents du @code{\header} d'un bloc @code{\score}
+seront toutefois imprimés dès lors que vous aurez activé l'instruction
+@code{print-all-headers} au sein du bloc @code{\paper}. Le principal
+inconvénient de cette fonction réside dans le fait que les champs
+dévolus au titrage des parties devront être supprimés dans
+chacun des blocs @code{\score} de votre fichier source -- voir
+@ref{Généralités en matière de titrages}.
Afin d'éviter ce désagrément, ajoutez le champ que vous désirez voir
apparaître à la définition de @code{scoreTitleMarkup}. Nous allons,
dans l'exemple suivant, ajouter au @code{scoreTitleMarkup} le champ
@code{composer}, normalement associé au @code{bookTitleMarkup} ;
-chaque @code{\score} pourra mentionner un compositeur différent.
+chaque @code{\score} pourra alors mentionner un compositeur différent.
@lilypond[papersize=a5,quote,verbatim,noragged-right]
\book {
@seealso
Manuel de notation :
-@ref{Contenu des blocs de titrage}.
+@ref{Généralités en matière de titrages}.
@node Mise en forme personnalisée des entête et pied de page
@cindex markup conditionnel
@cindex condition et markup
-@cindex on-the-fly
+@cindex on-the-fly (à la volée)
+
@funindex \on-the-fly
L'instruction @code{\on-the-fly} au sein d'un @code{\markup} permet
En voici la syntaxe :
@example
-@code{variable} = @code{\markup} @{
- ...
- @code{\on-the-fly} #@var{procédure} @var{markup}
- ...
+variable = \markup @{
+ @dots{}
+ \on-the-fly \@var{procédure} @var{markup}
+ @dots{}
@}
@end example
La @var{procédure} est appelée à chaque fois que la commande
@code{\markup} où elle apparaît est évaluée. La @var{procédure}
-effectuera un test de conformité particulière et interprètera, autrement
+effectuera un test de conformité particulier et interprètera, autrement
dit imprimera l'argument @var{markup} si et seulement si cette
condition est remplie.
@headitem Nom de la procédure @tab Condition testée
@item print-page-number-check-first @tab il faut imprimer ce numéro de page.
-@item create-page-number-stencil @tab 'print-page-numbers est vrai.
-@item print-all-headers @tab 'print-all-headers est vrai.
+@item create-page-number-stencil @tab print-page-numbers est vrai.
+@item print-all-headers @tab print-all-headers est vrai.
@item first-page @tab c'est la première page du @emph{book}.
-@item (on-page nombre) @tab page number = nombre
+@item not-first-page @tab ce n'est pas la première page du @emph{book}.
+@item (on-page nombre) @tab numéro de page = nombre
@item last-page @tab c'est la dernière page du @emph{book}.
@item not-first-page @tab ce n'est la première page du @emph{book}.
@item part-first-page @tab c'est la première page de la partie.
+@item not-part-first-page @tab ce n'est pas la première page de la partie.
@item part-last-page @tab c'est la dernière page de la partie.
@item not-single-page @tab cette partie fait plus d'une page.
@end multitable
@end quotation
-L'exemple suivant illustre la manière de centrer son numéro au bas de
-chaque page. Il nous faut tout d'abord annuler la définition de
+L'exemple suivant illustre la manière de centrer son numéro au bas de
+chaque page. Il nous faut tout d'abord annuler les définitions de
@code{oddHeaderMarkup} et @code{evenHeaderMarkup} à l'aide d'un
@emph{markup} @code{\null}. Nous redéfinissons ensuite
@code{oddFooterMarkup} pour qu'il contienne le numéro de page, centré.
evenHeaderMarkup = \markup \null
oddFooterMarkup = \markup {
\fill-line {
- \on-the-fly #print-page-number-check-first
+ \on-the-fly \print-page-number-check-first
\fromproperty #'page:page-number-string
}
}
l'autre se cumulent. Ainsi, par exemple,
@example
- @code{\on-the-fly #first-page}
- @code{\on-the-fly #last-page}
- @code{@{ \markup ... \fromproperty #'header: ... @}}
+ \on-the-fly \first-page
+ \on-the-fly \last-page
+ @code{@{ \markup @dots{} \fromproperty #'header: @dots{} @}}
@end example
teste si la sortie tient sur une page unique.
@seealso
Manuel de notation :
-@ref{Contenu des blocs de titrage},
-@ref{Mise en forme par défaut des titrages}.
+@ref{Généralités en matière de titrages},
+@ref{Mise en forme par défaut des titrages subalternes}.
fichiers d'initialisation :
@file{../ly/titling-init.ly}.
+@node Création des métadonnées des fichiers de sortie
+@subsection Création des métadonnées des fichiers de sortie
+@translationof Creating output file metadata
+
+@cindex PDF metadata
+@cindex MIDI metadata
+@cindex métadonnées PDF
+@cindex métadonnées MIDI
+
+En plus de s'imprimer sur la partition, les variables du bloc
+@code{\header} permettent de générer les métadonnées des fichiers de
+sortie. Dans le cas d'un fichier PDF, ces métadonnées pourront être
+affichées par le lecteur en tant que propriétés du document. Quel que
+soit le type de fichier de sortie, seules seront analysées les variables
+déterminées dans le @code{\header} du bloc définissant le fichier à
+générer, ainsi que celles des blocs hiérarchiquement supérieurs. Pour les
+fichiers PDF, seules les définitions du @code{\header} en dehors ou au
+niveau d'un bloc @code{\book} affecteront les métadonnées des documents
+PDF ; pour les fichiers MIDI seront utilisées les définitions jusqu'au
+niveau @code{\score}.
+
+Par exemple, affecter « Symphony I » à la propriété @code{title} dans le
+bloc @code{\header} donnera aussi ce titre au document PDF et à la
+séquence MIDI.
+
+@example
+\header@{
+ title = "Symphony I"
+@}
+@end example
+
+Lorsque le titre imprimé diffère de celui affiché en tant que propriété
+du PDF, devra être renseignée la propriété @code{pdftitle}.
+
+@example
+\header@{
+ title = "Symphony I"
+ pdftitle = "Symphony I by Beethoven"
+@}
+@end example
+
+Les variables @code{title}, @code{subject}, @code{keywords},
+@code{subtitle}, @code{composer}, @code{arranger}, @code{poet},
+@code{author} et @code{copyright} initialisent toutes les propriétés
+PDF, qu'il suffit de préfixer d'un « pdf » pour affecter aux propriétés
+PDF une valeur divergente de la sortie imprimable.
+
+La propriété PDF @code{Creator} prend automatiquement la valeur
+« LilyPond » additionnée deu numéro de version ; les valeurs de
+@code{CreationDate} et @code{ModDate} sont définies à la date et l'heure
+courantes -- @code{ModDate} peut être écrasé par la variable de
+@code{\header} @code{moddate} (ou @code{pdfmoddate}) pour un horodatage
+PDF valide.
+
+La variable @code{title} détermine aussi le nom de la séquence MIDI.
+L'utilisation de la variable @code{midititle} permet d'attribuer à la
+séquence MIDI un nom différent de celui attribué au fichier imprimable.
+
+
@node Notes de bas de page
@subsection Notes de bas de page
@translationof Creating footnotes
-LilyPond dispose de deux méthodes pour créer des notes de bas de page,
-l'une automatisée, et l'autre manuelle.
+@cindex bas de page, notes
+@cindex footnotes
+
+Les notes de bas de page sont utiles dans bien des situations. Dans
+tous les cas, un « appel de note » vient se placer en référence dans te
+texte ou la musique, et le « texte de la note » est reporté en bas de la
+page.
+
+Selon qu'elle est référencée dans une expression musicale ou dans du
+texte indépendant, une note de bas de page sera créée suivant une
+procédure différente.
@menu
-* Considérations générales en matière de note de bas de page::
-* Notes de bas de page automatiques::
-* Notes de bas de page manuelles::
+* Notes de bas de page dans une expression musicale::
+* Notes de bas de page dans du texte indépendant::
@end menu
-@node Considérations générales en matière de note de bas de page
-@unnumberedsubsubsec Considérations générales en matière de note de bas de page
-@translationof Footnotes overview
+@node Notes de bas de page dans une expression musicale
+@unnumberedsubsubsec Notes de bas de page dans une expression musicale
+@translationof Footnotes in music expressions
-Il est parfois judicieux, notamment lorsqu'une annotation ou un
-commentaire gênerait la lecture de la partition, de les reporter en bas
-de page.
+@cindex musique et note de bas de page
+@funindex \footnote
+
+@subsubsubheading Généralités sur l'annotation de musique
+@c VO Music footnotes overview
+
+Il existe deux catégories d'annotation concernant une expression
+musicale :
+
+@table @emph
+@item Les annotations événementielles
+se rattachent à des événements particuliers, comme une note individuelle,
+un élément d'interprétation (doigté, accent ou nuance) ou des événements
+postérieurs (liaison, ligature manuelle). Une note de bas de page
+événementielle se libelle généralement sous la forme :
-Les notes de bas de page automatiques font appel à un compteur
-numérique incrémenté automatiquement ; les notes de bas de page
-manuelles vous laissent le libre choix de l'appel (l'indicateur). Une
-note de bas de page s'applique comme un @code{\tweak} ; elle peut donc
-s'attacher directement à un objet graphique créé par la plupart des
-éléments musicaux ou événements rattachés. Lorsque ce n'est pas
-possible, par exemple sur une barre de mesure ou un changement de
-métrique -- l'objet étant alors le résultat d'une modification de
-propriété --, les notes de bas de page peuvent être spécifiées en tant
-qu'événement musical indépendant et affectant tous les objets d'un
-type particulier à un instant particulier.
+@example
+[@var{position}] \footnote [@var{marque}] @var{décalage} @var{annotation} @var{musique}
+@end example
-Examinons la forme développée d'une commande de note de bas de page :
+@item Les annotations temporelles
+se rapportent à un point particulier du déroulement d'un contexte
+musical. Certaines commandes, telles @code{\time} et @code{\clef}, ne
+reposent pas sur un événement pour la création de l'objet métrique ou
+clef. Il en va de même pour un accord : sa hampe ou ses crochets ne
+sont créés qu'à la fin d'un moment (plus exactement au travers de l'un
+des événements note qui le composent). Il n'est pas possible de
+connaître assurément lequel des événements note d'un accord est
+plus particulièrement à l'origine de la hampe ou du crochet. Il
+est donc plus aisé, pour de tels éléments, d'utiliser des
+annotations temporelles.
+
+Une annotation temporelle permet d'annoter des objets de rendus
+sans se référer à un événement. Elle se libelle généralement sous
+la forme :
@example
-\footnote @var{marque} @var{décalage} @var{nom-grob} @var{annotation}
-@var{musique}
+\footnote [@var{marque}] @var{décalage} @var{annotation} [@var{Contexte}.]@var{nom-grob}
@end example
-Ses arguments peuvent se définir ainsi :
+@end table
+
+Les arguments, quelle que soit la catégorie d'annotation, peuvent se
+définir ainsi :
@table @var
+@item position
+Lorsque la commande @code{\footnote} s'applique à un élément
+d'interprétation ou un événement rattaché, et uniquement dans ces cas,
+elle doit être précédée d'un indicateur de positionnement (@code{-, _}
+ou @code{^}) de façon à rattacher @var{musique} (avec sa marque) à
+la note ou au silence qui précède.
+
@item marque
-un @emph{markup} ou une chaîne de caractères identifiant l'annotation
+Un @emph{markup} ou une chaîne de caractères identifiant l'annotation
tant au niveau de l'appel que de la note qui apparaîtra au bas de la
page. L'absence de cet élément -- ou une valeur de @code{\default} --
-incrémentera le compteur.
+incrémentera automatiquement le compteur. Ce compteur est réinitialisé
+à chaque page comportant une annotation.
@item décalage
-une paire de nombres -- @samp{#(2 . 1)} par exemple -- spécifiant le
+Une paire de nombres -- @samp{#(2 . 1)} par exemple -- spécifiant le
décalage de la marque, en abscisse et en ordonnée, par rapport au point
-de référence.
+de référence. Des valeurs positives décalent vers la droite ou le
+haut, des valeurs négatives vers la gauche ou le bas ; des valeurs à
+zéro centrent la marque sur le point de référence. Le décalage
+s'exprime en espace de portée.
+
+@item Contexte
+Le contexte auquel appartient l'objet à annoter. Cet argument
+peut être omis dès lors qu'il s'agit d'un contexte de bas niveau
+tel que @code{Voice}.
@item nom-grob
-le type d'objet à annoter -- @samp{#'Flag} par exemple. Lorsque cet
+Le type d'objet à annoter -- @samp{Flag} par exemple. Lorsque cet
élément est spécifié, c'est l'objet en question qui servira de point de
référence, même s'il trouve son origine non pas directement dans
-l'élément @var{musique} mais dans un objet en résultant. Son absence ou
-une valeur de @code{\default} ne permet d'annoter que des objets
-directement créés.
+une expression musicale mais dans tout objet du type spécifié
+intervenant à cet instant précis de la partition.
@item annotation
un @emph{markup} ou une chaîne de caractères qui sera reporté au bas de
@item musique
l'élément qui fait l'objet du commentaire, qu'il s'agisse d'un
événement musical, de l'un des constituants d'un accord ou d'un
-événement rattaché. Bien qu'il ne puisse être omis, il peut être
-remplacé par @code{\default}, auquel cas l'annotation ne sera pas
-rattachée à une expression musicale particulière, mais plutôt à un
-instant précis. L'argument @var{nom-grob} est alors obligatoire pour
-sélectionner le type d'objet affecté -- @samp{#'TimeSignature} par
-exemple.
+événement rattaché.
+
@end table
-Tout comme pour la commande @code{\tweak}, lorsqu'un @code{\footnote}
-s'applique à un événement rattaché ou à une articulation, il devra être
-précédé d'un @code{-} de telle sorte que l'analyseur syntaxique en
-attache le résultat à la note ou au silence précédant.
+@subsubsubheading Notes de bas de page événementielles
+@c VO Event-based footnotes
-@node Notes de bas de page automatiques
-@unnumberedsubsubsec Notes de bas de page automatiques
-@translationof Automatic footnotes
+@cindex événementielle, note de bas de page
-@cindex note de bas de page automatique
-@cindex bas de page, note automatique
+Ce type de note de bas de page s'attache à un objet de rendu
+généré directement par l'événement correspondant à @var{musique}.
+Il répond à la syntaxe :
-@funindex \footnote
-@funindex footnote
+@example
+\footnote [@var{décalage}] @var{décalage} @var{annotation} @var{musique}
+@end example
+
+@c KEEP LY
+@lilypond[quote,verbatim,papersize=a8landscape]
+\book {
+ \header { tagline = ##f }
+ \relative c'' {
+ \footnote #'(-1 . 3) "Une note" a4
+ a4
+ \footnote #'(2 . 2) "Un silence" r4
+ a4
+ }
+}
+@end lilypond
-La commande @code{\footnote} permet de générer automatiquement des notes
-de bas de page. Elle requiert quatre arguments : la position
-@samp{(x . y)} de l'appel de note, le @var{nom-grob} optionnel
-spécifiant l'objet de rendu auquel s'applique le commentaire,
-l'@var{annotation} qui apparaîtra au bas de la page, et enfin la
-@var{musique} à laquelle se rapporte l'annotation.
+Un accord @emph{dans son intégralité} ne peut pas faire l'objet
+d'une note de bas de page événementielle : un accord, même s'il ne
+contient qu'une seule et unique note, ne génère aucun événement en
+propre. Une des notes @emph{au sein} de l'accord peut toutefois
+se voir attribuer une annotation :
@c KEEP LY
-@lilypond[verbatim,quote,ragged-right,papersize=a8]
+@lilypond[quote,verbatim,papersize=a8landscape]
\book {
\header { tagline = ##f }
- \relative c' {
- \footnote #'(0.5 . -2)
- \markup { La première note }
- a'4 b8
- \footnote #'(0.5 . 1) #'Flag
- \markup { La troisième note }
- e\noBeam c4 d4
+ \relative c'' {
+ \footnote #'(2 . 3) "Résultat non probant" <a-3>2
+ <\footnote #'(-2 . -3) "Résultat probant" a-3>4
+ <a-3 \footnote #'(3 . 1/2) "Tout aussi probant" c-5>4
}
}
@end lilypond
-L'annotation d'un accord suit la même règle :
+Lorsque l'annotation concerne un événement postérieur ou une
+articulation, la commande @code{\footnote} @strong{doit} être
+précédée d'un indicateur de position (@code{-, _} ou @code{^}) et
+suivie de l'événement postérieur ou l'articulation comme argument
+@var{musique}. Dans ce cas, la commande @code{\footnote} peut se
+considérer comme une copie de son dernier argument auquel on
+attache une annotation. La syntaxe consacrée est :
+
+@example
+@var{position} \footnote [@var{marque}] @var{décalage} @var{annotation} @var{musique}
+@end example
@c KEEP LY
-@lilypond[verbatim,quote,ragged-right,papersize=a8]
+@lilypond[quote,verbatim,papersize=a8landscape]
\book {
\header { tagline = ##f }
- \relative c' {
- <
- \footnote #'(1 . -1.25) "Voici un do" c
- \footnote #'(2 . -0.25) \markup { \italic "Un mi bémol" } es
- \footnote #'(2 . 3) \markup { \bold "Ceci est un sol" } g
- >1
+ \relative {
+ a'4_\footnote #'(0 . -1) "Une liaison arbitrairement en dessous" (
+ b8^\footnote #'(1 . 0.5) "Une ligature manuelle forcée en haut" [
+ b8 ]
+ c4 )
+ c-\footnote #'(1 . 1) "Tenuto" --
}
}
@end lilypond
-@warning{Lorsque plusieurs notes de bas de page se rapportent à un même
-empilement vertical, les notes apparaîtront dans l'ordre vertical des
-appels, autrement dit celui positionné le plus haut en premier, et ainsi
-de suite.}
+Les appels de note peuvent être personnalisés, et le trait reliant
+l'objet à l'appel supprimé :
-Voici quelques exemples d'objets annotés automatiquement. Vous pouvez
-constater l'agencement des annotations correspondantes avec le copyright
-et le pied de page.
-@lilypond[verbatim,quote,ragged-right,papersize=a8]
+@subsubsubheading Notes de bas de page temporelles
+@c VO Time-based footnotes
+
+@cindex temporelle, note de bas de page
+
+Lorsque la note de bas de page se réfère à un objet de rendu résultant
+d'un événement -- @code{Accidental} ou @code{Stem} découlent d'un
+@code{NoteHead} --, l'argument @var{nom-grob} de l'objet en question est
+requis après le texte de l'annotation, en lieu et place de
+@var{musique} :
+
+@c KEEP LY
+@lilypond[quote,verbatim,papersize=a8landscape]
\book {
- \header { copyright = \markup { "Copyright 1970" } }
- \relative c' {
- a'4-\footnote #'(-3 . 0) \markup { \bold Forte } \f
- -\footnote #'(0 . 1.5) \markup { A slur } (
- b8)-\footnote #'(0 . -2) \markup { Beam } [ e]
- \footnote #'(1 . -1) #'Stem
- \markup { \teeny { This is a stem } }
- c4
- \footnote #'(0 . 0.5) #'AccidentalCautionary
- \markup \italic { A cautionary accidental }
- \footnote #'(1 . 1) "The note itself"
- dis?4-\footnote #'(0.5 . -0.5) \markup \italic { Slow Down }
- _"rit."
+ \header { tagline = ##f }
+ \relative c'' {
+ \footnote #'(-1 . -3) "Un bémol" Accidental
+ aes4 c
+ \footnote #'(-1 . 0.5) "Un autre bémol" Accidental
+ ees
+ \footnote #'(1 . -2) "Une hampe" Stem
+ aes
}
}
@end lilypond
-Une note de bas de page affectant un @code{\markup} de haut niveau
-s'introduit par la commande @code{\auto-footnote} :
+Notez bien que, lorsque @var{nom-grob} est spécifié, tous les objets de
+ce type qui se trouvent à ce même instant se verront attacher une
+annotation :
-@lilypond[verbatim,quote,ragged-right,papersize=a8]
+@c KEEP LY
+@lilypond[quote,verbatim,papersize=a8landscape]
\book {
\header { tagline = ##f }
- \markup { \auto-footnote "A simple tune" \italic "By me" }
\relative c' {
- a'4 b8 e c4 d
+ \footnote #'(-1 . 3) "Un bémol" Accidental
+ <ees ges bes>4
+ \footnote #'(2 . 0.5) "Une articulation" Script
+ c'->-.
}
}
@end lilypond
+Une note incluse dans un accord peut individuellement se voir attribuer
+une annotation événementielle. Une tête de note (@code{NoteHead}) est
+le @emph{seul} objet directement généré par un constituant d'accord ;
+elle peut donc être affectée d'une annotation événementielle. Tous les
+autres objets constituant un accord sont générés indirectement. La
+commande @code{\footnote} ne dispose pas d'une syntaxe permettant de
+spécifier @emph{à la fois} un type d'objet @emph{et} un événement
+particulier auquel s'attacher. De tels objets pourront toutefois faire
+l'objet d'une annotation temporelle, préfixée d'un @code{\single} afin
+d'annoter l'événement directement consécutif :
-@node Notes de bas de page manuelles
-@unnumberedsubsubsec Notes de bas de page manuelles
-@translationof Manual footnotes
+@c KEEP LY
+@lilypond[quote,verbatim,papersize=a8landscape]
+\book {
+ \header { tagline = ##f }
+ \relative c'' {
+ < \footnote #'(1 . -2) "Un la" a
+ \single \footnote #'(-1 . -1) "Un dièse" Accidental
+ cis
+ \single \footnote #'(0.5 . 0.5) "Un bémol" Accidental
+ ees fis
+ >2
+ }
+}
+@end lilypond
-@cindex note de bas de page manuelle
-@cindex bas de page, note manuelle
+@warning{Lorsque plusieurs notes de bas de page se rapportent à un même
+empilement vertical comme ci-dessus, elles sont numérotées et
+apparaîtront selon l'ordre vertical des éléments présentés, autrement dit
+celui positionné le plus haut en premier, non dans leur ordre
+d'apparition dans le fichier source.}
+
+Les objets de rendu tels que changement de clef ou d'armure tirent leur
+origine dans la modification d'une propriété plutôt que d'un véritable
+événement. D'autres, comme les barres ou numéros de mesure, dépendent
+directement de la temporisation. C'est la raison pour laquelle de tels
+objets doivent s'annoter en fonction de leur survenance au fil de la
+musique. Les notes de bas de page temporelles sont la solution à
+privilégier lorsqu'il s'agit d'annoter les hampes ou ligatures affectant
+des accords : bien qu'une telle fonctionnalité puisse s'appliquer à l'un
+des événements constituant l'accord, rien ne laisse présager lequel
+serait le plus approprié.
+
+En matière de note de bas de page temporelle, l'objet de rendu considéré
+doit toujours être mentionné explicitement, ainsi que le contexte si
+l'objet est créé dans un autre contexte que celui du plus bas niveau.
-LilyPond permet aussi de créer des notes de bas de page manuelles :
-la commande @code{\footnote} prend alors un argument supplémentaire :
-la @var{marque}, qui contient l'appel qui s'attache à la note ou à
-l'objet référencé. Contrairement aux notes de bas de page automatiques,
-l'annotation en bas de page ne sera pas précédée de la @var{marque} ;
-l'indicateur visuel est laissé à l'appréciation de l'utilisateur.
-LilyPond ne s'attache ici qu'à faire apparaître l'annotation au bas de
-la même page.
+@c KEEP LY
+@lilypond[quote,verbatim,papersize=a8landscape]
+\book {
+ \header { tagline = ##f }
+ \relative c'' {
+ r1 |
+ \footnote #'(-0.5 . -1) "Changement de métrique" Staff.TimeSignature
+ \time 3/4
+ \footnote #'(1 . -1) "Hampe de l'accord" Stem
+ <c e g>4 q q
+ \footnote #'(-0.5 . 1) "Barre de mesure" Staff.BarLine
+ q q
+ \footnote #'(0.5 . -1) "Changement d'armure" Staff.KeySignature
+ \key c \minor
+ q
+ }
+}
+@end lilypond
-La commande @code{\footnote} s'utilise de la même manière que dans le
-cas de notes automatiques.
+Les appels de note peuvent être personnalisés, et le trait reliant
+l'objet à l'appel supprimé :
-@lilypond[verbatim,quote,ragged-right,papersize=a8]
+@c KEEP LY
+@lilypond[quote,verbatim,papersize=a8landscape]
\book {
\header { tagline = ##f }
\relative c' {
- \footnote
- "1" #'(0.5 . -2)
- \markup { \italic "1. The first note" }
- a'4
- b8
- \footnote
- \markup { \bold "2" } #'(0.5 . 1)
- "2. The second note"
- e
- c4
- d-\footnote "3" #'(0.5 . -1) "3. Piano" \p
+ \footnote "*" #'(0.5 . -2) \markup { \italic "* La première note" }
+ a'4 b8
+ \footnote \markup { \super "$" } #'(0.5 . 1)
+ \markup { \super "$" \italic " La deuxième note" }
+ e c4
+ \once \override Score.FootnoteItem #'annotation-line = ##f
+ b-\footnote \markup \tiny "+" #'(0.1 . 0.1)
+ \markup { \super "+" \italic " Éditorial" } \p
}
}
@end lilypond
-L'annotation d'un accord suit la même règle :
+D'autres exemples de personnalisation des appels de note sont donnés à
+la rubrique @ref{Notes de bas de page dans du texte indépendant}.
+
+
+@node Notes de bas de page dans du texte indépendant
+@unnumberedsubsubsec Notes de bas de page dans du texte indépendant
+@translationof Footnotes in stand-alone text
+
+@cindex texte indépendant et note de bas de page
+
+De telles notes de bas de page affectent les @emph{markup} extérieurs
+aux expressions musicales. Il n'est pas nécessaire en pareil cas
+d'indiquer un point de référence par un trait ; l'appel de note vient
+juste s'accoler au @emph{markup} qui fait l'objet de l'annotation. Les
+appels de note peuvent être gérés automatiquement, auquel cas ils seront
+numériques, ou bien manuellement en fournissant un indicateur
+particulier.
+
+Les notes de bas de page concernant du texte indépendant se gèrent
+différemment selon qu'elles sont automatiques ou manuelles.
+
+
+@subsubsubheading Notes de bas de page automatiques dans du texte
+@c VO Footnotes in stand-alone text with automatic marks
+
+La syntaxe consacrée dans le cas d'une gestion automatique des appels
+de note est :
+
+@example
+\markup @{ @dots{} \auto-footnote @var{texte} @var{annotation} @dots{} @}
+@end example
+
+Ses les éléments sont :
+
+@table @var
+
+@item texte
+le @emph{markup} ou la chaîne de caractères sur lequel porte
+l'annotation ;
+
+@item annotation
+un @emph{markup} ou une chaîne de caractères constituant le texte de
+l'annotation qui sera reportée en bas de page.
+
+@end table
+
+Par exemple :
@lilypond[verbatim,quote,ragged-right,papersize=a8]
\book {
\header { tagline = ##f }
- \relative c' {
- <
- \footnote "1" #'(1 . -1.25) "1. C" c
- \footnote
- \markup { \bold "b" } #'(2 . -0.25) "b. E-flat" es
- \footnote "3" #'(2 . 3) \markup { \italic "iii. G" } g
- >1
+ \markup {
+ "A simple"
+ \auto-footnote "tune" \italic " By me"
+ "is shown below. It is a"
+ \auto-footnote "recent" \italic " Aug 2012"
+ "composition."
+ }
+ \relative {
+ a'4 b8 e c4 d
}
}
@end lilypond
-@warning{Lorsque plusieurs notes de bas de page se rapportent à un même
-empilement vertical, les notes apparaîtront dans l'ordre vertical des
-appels, autrement dit celui positionné le plus haut en premier, et ainsi
-de suite.}
-Voici quelques exemples d'objets annotés manuellement. Vous pouvez
-constater l'agencement des annotations correspondantes avec le copyright
-et le pied de page.
+@subsubsubheading Notes de bas de page personnalisées dans du texte
+@c VO Footnotes in stand-alone text with custom marks
+
+La syntaxe consacrée dans le cas d'une gestion personnalisée des appels
+de note est :
+
+@example
+\markup @{ @dots{} \footnote @var{appel} @var{annotation} @dots{} @}
+@end example
+
+Ses les éléments sont :
+
+@table @var
+
+@item appel
+un @emph{markup} ou une chaîne de caractères représentant l'appel de
+note affecté à ce point de référence. Notez bien que cette marque ne
+sera @strong{pas} reproduite automatiquement avant le texte proprement
+dit de l'annotation.
+
+@item annotation
+un @emph{markup} ou une chaîne de caractères constituant le texte de
+l'annotation qui sera reportée en bas de page, précédé de l'@var{appel}.
+
+@end table
+
+N'importe quel caractère simple tel que @code{*} ou @code{+} peut
+s'utiliser en tant qu'appel de note, comme nous l'avons vu à la rubrique
+@ref{Notes de bas de page dans une expression musicale}. D'autres
+caractères particuliers sont accessibles sous forme de raccourci -- voir
+la rubrique @ref{Équivalents ASCII} :
@lilypond[verbatim,quote,ragged-right,papersize=a8]
\book {
+ \paper { #(include-special-characters) }
\header { tagline = ##f }
- \relative c' {
- a'4-\footnote
- \markup { \teeny 1 } #'(-3 . 0)
- \markup { 1. \bold Forte } \f
- -\footnote
- \markup { \teeny b } #'(0 . 1.5)
- \markup { b. A slur } (
- b8)-\footnote
- \markup { \teeny 3 } #'(0 . -2)
- \markup { 3. Beam } [
- e]
- \footnote
- \markup { 4 } #'(1 . -1) #'Stem
- \markup { \bold 4. { This is a stem } }
- c4
- \footnote
- \markup \concat \teeny { "sharp (v)" }
- #'(0 . 0.5) #'AccidentalCautionary
- \markup \italic { v. A cautionary accidental }
- dis?4-\footnote
- \markup \concat \teeny { "a" } #'(0.5 . -0.5)
- \markup \italic { a. Slow Down } _"rit."
- \footnote
- \markup { \teeny \musicglyph #"rests.4" }
- #'(1.5 . -0.25)
- \markup { \null } \breathe
+ \markup {
+ "A simple tune"
+ \footnote "*" \italic "* By me"
+ "is shown below. It is a recent"
+ \footnote \super † \concat {
+ \super † \italic " Aug 2012"
+ }
+ "composition."
+ }
+ \relative {
+ a'4 b8 e c4 d
}
}
@end lilypond
-L'annotation manuelle d'un @code{\markup} de haut niveau répond à la
-syntaxe suivante :
+Un appel de note peut aussi se libeller sous la forme d'un point de code
+unicode -- voir la rubrique @ref{Unicode} :
@lilypond[verbatim,quote,ragged-right,papersize=a8]
\book {
\header { tagline = ##f }
- \markup { "A simple tune" \footnote "*" \italic "* By me" }
- \relative c' {
- a'4 b8 e c4 d4
+ \markup {
+ "A simple tune"
+ \footnote \super \char##x00a7 \concat {
+ \super \char##x00a7 \italic " By me"
+ }
+ "is shown below. It is a recent"
+ \footnote \super \char##x00b6 \concat {
+ \super \char##x00b6 \italic " Aug 2012"
+ }
+ "composition."
+ }
+ \relative {
+ a'4 b8 e c4 d
}
}
@end lilypond
Manuel de notation :
@ref{Commentaires textuels},
+@ref{Équivalents ASCII},
@ref{Indications textuelles},
@ref{Info-bulle},
-@ref{Mise en forme de la page},
-@ref{Titres et entêtes}.
+@ref{Liste des caractères spéciaux},
+@ref{Unicode}.
Référence des propriétés internes :
@rinternals{FootnoteEvent},
@rinternals{Footnote_engraver}.
@knownissues
-Un silence multimesures ne peut se voir affecter une note de bas de
-page.
-
Les notes de bas de page ne peuvent que s'empiler l'une au-dessus de
l'autre ; elles ne seront jamais présentées à la queue leu leu.
+
+Silences multimesures, ligatures automatiques et paroles ne peuvent se
+voir affecter de note de bas de page.
+
Les notes de bas de page peuvent générer des chevauchements quand elles
sont trop nombreuses sur une même page.
-Dès lors que vous utilisez une commande de note de bas de page manuelle,
-le bloc @code{\paper} doit contenir la mention
-@w{@code{footnote-auto-number = ##f}}.
-
@node Référencement des numéros de page
@subsection Référencement des numéros de page
exemple @code{#'firstScore},
@item
-un @qq{emporte-pièce} afin d'estimer la longueur totale du
-@emph{markup}, et
+un « emporte-pièce » afin d'estimer la longueur totale du @emph{markup},
+et
@item
un texte de remplacement au cas où la référence ne serait pas retrouvée.
\tocItem \markup "Premier mouvement"
\score {
{
- c'4 % ...
+ c'4 % @dots{}
\tocItem \markup "Passage spécifique du premier mouvement"
- d'4 % ...
+ d'4 % @dots{}
}
}
\tocItem \markup "Second mouvement"
\score {
{
- e'4 % ...
+ e'4 % @dots{}
}
}
@end verbatim
Les @emph{markups} dévolus à la mise en forme de la table des matières
-se définissent dans le bloc @code{\paper}. Il s'agit par défaut de
-@code{tocTitleMarkup} pour le titre de la table, et de
-@code{tocItemMarkup} pour ses éléments -- composés de leur libellé et
-numéro de page. Vous pouvez bien entendu personnaliser ces variables :
+se définissent dans le bloc @code{\paper}. LilyPond dispose de deux
+@emph{markups} prédéfinis :
+
+@itemize
+
+@item
+@code{tocTitleMarkup}
+
+@noindent
+Utilisé pour mettre en forme le titre de la table des matières.
+
+@verbatim
+tocTitleMarkup = \markup \huge \column {
+ \fill-line { \null "Table of Contents" \null }
+ \null
+}
+@end verbatim
+
+@item
+@code{tocItemMarkup}
+
+@noindent
+Utilisé pour mettre en forme les éléments au sein de la table des
+matières.
+
+@verbatim
+tocItemMarkup = \markup \fill-line {
+ \fromproperty #'toc:text \fromproperty #'toc:page
+}
+@end verbatim
+
+@end itemize
+
+@noindent
+Ces variables sont adaptables.
+
+Voici comment, par exemple, franciser le titre :
@verbatim
\paper {
- %% Translate the toc title into French:
tocTitleMarkup = \markup \huge \column {
\fill-line { \null "Table des matières" \null }
\hspace #1
}
- %% use larger font size
- tocItemMarkup = \markup \large \fill-line {
- \fromproperty #'toc:text \fromproperty #'toc:page
- }
+@end verbatim
+
+L'exemple suivant illustre la manière de modifier la taille des éléments
+de la table des matières :
+
+@verbatim
+tocItemMarkup = \markup \large \fill-line {
+ \fromproperty #'toc:text \fromproperty #'toc:page
}
@end verbatim
Notez bien la manière de référencer le libellé et le numéro de page dans
la définition de @code{tocItemMarkup}.
-N'hésitez pas à définir vous-même d'autres commandes et @emph{markups}
-afin de construire une table plus élaborée :
-@itemize
-@item
-commencez par définir une nouvelle variable de type @code{markup} au
-sein du bloc @code{\paper},
+L'élément et son numéro de page peuvent se rejoindre par une ligne
+pointillée :
-@item
-puis définissez une fonction musicale chargée d'insérer un élément de la
-table à partir de cette variable.
-@end itemize
+@lilypond[verbatim,line-width=10.0\cm]
+\header { tagline = ##f }
+\paper {
+ tocItemMarkup = \tocItemWithDotsMarkup
+}
+
+\book {
+ \markuplist \table-of-contents
+ \tocItem \markup { Allegro }
+ \tocItem \markup { Largo }
+ \markup \null
+}
+@end lilypond
+
+N'hésitez pas à définir vous-même d'autres commandes et @emph{markups}
+afin de construire une table plus élaborée. Dans l'exemple qui suit,
+nous créons un nouveau style d'élément dans le but de mentionner les
+actes dans la table des matières d'un opéra :
-Dans l'exemple qui suit, nous avons créé un nouveau style d'élément dans
-le but de mentionner les actes dans la table des matières d'un opéra :
+@noindent
+Commençons par définir une nouvelle variable de type @code{markup} --
+appelée @code{tocActMarkup} -- au sein du bloc @code{\paper}.
@verbatim
\paper {
\hspace #1
}
}
+@end verbatim
+
+@noindent
+Créons ensuite une fonction musicale (@code{tocAct}) utilisant la
+nouvelle définition de @emph{markup} @code{tocActMarkup}.
+@verbatim
tocAct =
-#(define-music-function (parser location text) (markup?)
- (add-toc-item! 'tocActMarkup text))
+ #(define-music-function (text) (markup?)
+ (add-toc-item! 'tocActMarkup text))
@end verbatim
+@noindent
+Dans un fichier LilyPond, l'utilisation de cette définition
+personnalisée pourrait ressembler à ceci :
+
@lilypond[line-width=10.0\cm]
\header { tagline = ##f }
\paper {
}
tocAct =
-#(define-music-function (parser location text) (markup?)
- (add-toc-item! 'tocActMarkup text))
+ #(define-music-function (text) (markup?)
+ (add-toc-item! 'tocActMarkup text))
\book {
\markuplist \table-of-contents
\tocAct \markup { Atto Primo }
\tocItem \markup { Coro. Viva il nostro Alcide }
- \tocItem \markup { Cesare. Presti omai l'Egizzia terra }
+ \tocItem \markup { Cesare. Presti omai l'Egizia terra }
\tocAct \markup { Atto Secondo }
\tocItem \markup { Sinfonia }
\tocItem \markup { Cleopatra. V'adoro, pupille, saette d'Amore }
}
@end lilypond
-L'élément et son numéro de page peuvent se rejoindre par une ligne
-pointillée :
+Voici comment utiliser la commande @code{\fill-with-pattern} dans le
+cadre d'une table des matières :
-@lilypond[verbatim,line-width=10.0\cm]
-\header { tagline = ##f }
-\paper {
- tocItemMarkup = \tocItemWithDotsMarkup
-}
-
-\book {
- \markuplist \table-of-contents
- \tocItem \markup { Allegro }
- \tocItem \markup { Largo }
- \markup \null
-}
-@end lilypond
+@verbatim
+ tocItemMarkup = \markup { \fill-line {
+ \override #'(line-width . 70)
+ \fill-with-pattern #1.5 #CENTER . \fromproperty #'toc:text \fromproperty #'toc:page
+ }
+ }
+@end verbatim
@predefined
@funindex \table-of-contents
@example
\include "parties/VI.ly"
\include "parties/VII.ly"
-... etc.
+etc.
@end example
Les fichiers à inclure peuvent eux-mêmes contenir des instructions
fichier principal ; leur argument doit donc comporter le chemin
relativement au fichier principal et non par rapport au fichier dans
lequel cette inclusion est mentionnée. Vous pouvez toutefois influer
-sur ce comportement à l'aide de l'option @w{@code{-drelative-includes}}
-en ligne de commande ou en ajoutant une clause
-@code{#(ly:set-option 'relative-includes #t)} en tête du fichier
-principal. Une fois @code{relative-include} activé, le chemin à suivre
-pour chacune des commandes @code{\include} sera pris relativement au
-fichier qui la contient. Cette option est vouée à être activée par
+sur ce comportement de manière globale à l'aide de l'option
+@w{@code{-drelative-includes}} en ligne de commande ou en ajoutant une
+clause @code{#(ly:set-option 'relative-includes #t)} en tête du fichier
+principal.
+
+Lorsque @code{relative-include} est valorisé à @code{#t}, le chemin à
+suivre pour chacune des commandes @code{\include} sera pris relativement
+au fichier qui la contient. Cette option est vouée à être activée par
défaut dans une future version de LilyPond.
+Selon l'endroit où @code{relative-includes} est valorisé à @code{#t} ou
+@code{#f}, la commande @code{\include} permettra d'incorporer des
+fichiers contenus dans l'arborescence du répertoire principal et des
+fichiers situés ailleurs. Si, par exemple, une biblothèque générale
+libA a été créée pour utiliser des sous-fichiers à l'aide
+d'inclusions dans un fichier catalogue, les clauses @code{\include}
+devront être précédées d'un
+@code{#(ly:set-option #relative-includes #t)} de telle sorte
+qu'elles soient interprétées correctement lorsque rapatriées dans
+le fichier @file{.ly} principal. Examinons cela dans les faits :
+
+@example
+libA/
+ libA.ly
+ A1.ly
+ A2.ly
+ @dots{}
+@end example
+
+@noindent
+puis le fichier catalogue, @code{libA.ly}, qui contient
+
+@example
+#(ly:set-option 'relative-includes #t)
+\include "A1.ly"
+\include "A2.ly"
+@dots{}
+% retour au réglage par défaut
+#(ly:set-option 'relative-includes #f)
+@end example
+
+Tout fichier @code{.ly} peut désormais consulter l'intégralité de cette
+bibliothèque grâce à un simple
+
+@example
+\include "~/libA/libA.ly"
+@end example
+
+Un positionnement judicieux des commutateurs permet de gérer des
+structures de fichiers plus complexes.
+
Vous pouvez inclure des fichiers dont vous spécifierez le chemin d'accès
sur la ligne de commande au moment de lancer la compilation. L'appel à
ces fichiers ne mentionnera alors que leur nom. Par exemple, si vous
@example
\include "VI.ly"
\include "VII.ly"
-... etc
+ etc.
@end example
Lorsqu'un fichier est voué à être inclus dans nombre de partitions, vous
Au moment où vous lancez LilyPond, un certain nombre de fichiers se
retrouvent inclus par défaut ; il suffit d'activer le mode verbeux
-en faisant @w{@code{lilypond --verbose}} pour s'en rendre compte. Vous
+en faisant @w{@code{lilypond --verbose}} pour s'en rendre compte. Vous
verrez ainsi défiler, en plus de nombreuses informations, le nom d'un
certain nombre de fichiers et de chemins d'accès. Les fichiers les plus
important sont mentionnés au chapitre
@ref{Regroupement automatique de parties}. Prenons l'exemple suivant :
@lilypond[verbatim,quote]
-sopranoMusic = \relative c'' { a4 b c b8( a) }
-altoMusic = \relative g' { e4 e e f }
-tenorMusic = \relative c' { c4 b e d8( c) }
-bassMusic = \relative c' { a4 gis a d, }
-allLyrics = \lyricmode {King of glo -- ry }
+sopranoMusic = \relative { a'4 b c b8( a) }
+altoMusic = \relative { e'4 e e f }
+tenorMusic = \relative { c'4 b e d8( c) }
+bassMusic = \relative { a4 gis a d, }
+allLyrics = \lyricmode { King of glo -- ry }
<<
\new Staff = "Soprano" \sopranoMusic
\new Lyrics \allLyrics
\new PianoStaff <<
\new Staff = "RH" {
\set Staff.printPartCombineTexts = ##f
- \partcombine
- \sopranoMusic
- \altoMusic
+ \partcombine \sopranoMusic \altoMusic
}
\new Staff = "LH" {
\set Staff.printPartCombineTexts = ##f
\clef "bass"
- \partcombine
- \tenorMusic
- \bassMusic
+ \partcombine \tenorMusic \bassMusic
}
>>
>>
@funindex \tag
@funindex \keepWithTag
@funindex \removeWithTag
-@funindex \pushToTag
-@funindex \appendToTag
@cindex tag
@cindex balise
+@cindex regroupement de balises
La commande @code{\tag #'@var{partieA}} affecte à une expression
musicale le nom @var{partieA}. Les expressions ainsi balisées pourront
@tab Résultat
@item
-Musique balisée précédée de @code{\keepWithTag #'@var{nom}}
- @tab Musique non balisée et musique balisée par @var{nom} seront
- incluses ; la musique balisée autrement est exclue.
+Musique balisée précédée de @code{\keepWithTag #'@var{nom}} ou
+ @code{\keepWithTag #'(@var{nom1} @var{nom2}@dots{})}
+@tab Musique non balisée et musique balisée par l'un des noms de
+ balise fournis seront incluses ; la musique balisée
+ autrement est exclue.
@item
-Musique balisée précédée de @code{\removeWithTag #'@var{nom}}
- @tab Musique non balisée et fragments appelés autrement que @var{nom}
- seront inclus ; la musique balisée par @var{nom} est exclue.
+Musique balisée précédée de @code{\removeWithTag #'@var{nom}} ou
+ @code{\removeWithTag #'(@var{nom1} @var{nom2}@dots{})}
+@tab Musique non balisée et fragments appelés autrement que par
+ l'un des noms fournis seront inclus ; la musique balisée
+ par autre chose que les noms mentionnés est exclue.
@item
Musique balisée non précédée de @code{\keepWithTag} ou
@end multitable
-Les arguments des commandes @code{\tag}, @code{\keepWithTag} et
-@code{\removeWithTag} doivent être un symbole (tel que
-@code{#'conducteur} ou @code{#'partie}), suivi d'une expression
-musicale.
+L'argument des commandes @code{\tag}, @code{\keepWithTag} et
+@code{\removeWithTag} doit être un symbole ou une liste de symboles
+(tel que @code{#'conducteur} ou @code{#'(violonI violonII)}), suivi
+d'une expression musicale. Si, @emph{et seulement si} les symboles sont
+des indentifiants LilyPond valides (caractères alphabétiques uniquement,
+sans chiffre, souligné ou tiret) qui ne peuvent se confondre avec des
+notes, le @code{#'} peut s'omettre et, pour raccourcir, une liste de
+symbole peut utiliser le point en séparateur -- autrement dit,
+@code{\tag #'(violinI violinII)} peut s'écrire @code{\tag
+violinI.violinII}. Ceci s'applique aussi bien pour @code{\keepWithTag}
+que pour @code{\removeWithTag}.
Dans l'exemple qui suit, nous obtenons deux versions du même extrait,
l'une pour le conducteur, l'autre pour l'instrumentiste qui, elle,
comportera les ornements développés.
@lilypond[verbatim,quote]
-music = \relative g' {
- g8. c32 d
+music = \relative {
+ g'8. c32 d
\tag #'trills { d8.\trill }
\tag #'expand { \repeat unfold 3 { e32 d } }
c32 d
Il est parfois plus aisé d'exclure des fragments :
@lilypond[verbatim,quote]
-music = \relative g' {
- g8. c32 d
+music = \relative {
+ g'8. c32 d
\tag #'trills { d8.\trill }
\tag #'expand {\repeat unfold 3 { e32 d } }
c32 d
}
@end lilypond
-Ce principe de filtrage peut s'appliquer aux articulations, textes etc.
+Ce principe de filtrage peut s'appliquer aux articulations, textes, etc.
Il suffit de positionner
@example
un texte.
Vous pouvez baliser différemment la même expression musicale en
-saisissant plusieurs @code{\tag} :
+saisissant plusieurs @code{\tag} ou bien en combinant plusieurs
+balises dans une liste :
@lilypond[quote,verbatim]
music = \relative c'' {
\tag #'a \tag #'both { a4 a a a }
- \tag #'b \tag #'both { b4 b b b }
+ \tag #'(b both) { b4 b b b }
}
<<
\keepWithTag #'a \music
@end lilypond
L'application concomitante de plusieurs filtres @code{\removeWithTag} à
-la même expression musicale permet d'exclure plusieurs balisages :
+la même expression musicale permet d'exclure plusieurs balisages.
+Une liste fournie en argument à un unique @code{\removeWithTag}
+produira le même effet :
@lilypond[verbatim,quote]
music = \relative c'' {
-\tag #'A { a4 a a a }
-\tag #'B { b4 b b b }
-\tag #'C { c4 c c c }
-\tag #'D { d4 d d d }
+ \tag #'A { a4 a a a }
+ \tag #'B { b4 b b b }
+ \tag #'C { c4 c c c }
+ \tag #'D { d4 d d d }
}
-{
-\removeWithTag #'B
-\removeWithTag #'C
-\music
+\new Voice {
+ \removeWithTag #'B
+ \removeWithTag #'C
+ \music
+ \removeWithTag #'(B C)
+ \music
}
@end lilypond
expression musicale aboutit à l'exclusion de @b{tous} les balisages.
En effet, si le premier filtre exclut tous les autres balisages,
l'application du second exclura les effets du premier.
+L'utilisation d'une unique commande @code{\keepWithTag} avec une
+liste de balises est en pareil cas des plus pertinente : seront
+exclus tous les fragments non concernés par l'une quelconque des
+balises mentionnées.
+
+@lilypond[verbatim,quote]
+music = \relative c'' {
+ \tag #'violinI { a4 a a a }
+ \tag #'violinII { b4 b b b }
+ \tag #'viola { c4 c c c }
+ \tag #'cello { d4 d d d }
+}
+
+\new Staff {
+ \keepWithTag #'(violinI violinII)
+ \music
+}
+@end lilypond
+
+@noindent
+imprimera les @code{\tag}s @var{violinI} et @var{violinII}, mais ni
+@var{viola} ni @var{cello}.
+
+@cindex regroupements de balises
+@cindex balises, regroupement
+@funindex \tagGroup
+
+Bien que @code{\keepWithTag} soit efficace pour gérer @emph{un} jeu
+d'alternatives, le rejet de musique filtrée par des balises
+@emph{étrangères} se révèle problématique lorsque les @code{\tag} sont
+utilisés à plusieurs fins. Des « groupements de balises » peuvent
+alors être déclarés :
+
+@example
+\tagGroup #'(violinI violinII viola cello)
+@end example
+
+@noindent
+Les différents filtres appartiennent désormais tous à un seul
+regroupement. Notez bien qu'une balise ne saurait être membre de
+plusieurs regroupements.
+
+@example
+\keepWithTag #'violinI @dots{}
+@end example
+
+@noindent
+ne prendra désormais en compte que la musique concernée par la balise
+@code{violinI} du groupe de filtres : tout élément de la musique qui
+serait balisé par l'un des autres filtres de ce jeu sera rejeté.
+
+@lilypond[verbatim,quote]
+music = \relative {
+ \tagGroup #'(violinI violinII viola cello)
+ \tag #'violinI { c''4^"violinI" c c c }
+ \tag #'violinII { a2 a }
+ \tag #'viola { e8 e e2. }
+ \tag #'cello { d'2 d4 d }
+ R1^"non balisé"
+}
+
+\new Voice {
+ \keepWithTag #'violinI
+ \music
+}
+@end lilypond
+
+Dans le cadre de la commande @code{\keepWithTag}, seules les balises du
+regroupement mentionnées dans la commande seront visibles.
+
+@funindex \pushToTag
+@funindex \appendToTag
+@cindex raccordement dans une balise
Il peut arriver que vous ayez besoin de raccorder quelque chose en un
point particulier d'une expression musicale. Les commandes
simultanée comporte assurément des @code{éléments} :
@lilypond[verbatim,quote]
-test = { \tag #'here { \tag #'here <<c''>> } }
+music = { \tag #'here { \tag #'here <<c''>> } }
{
\pushToTag #'here c'
\pushToTag #'here e'
- \pushToTag #'here g' \test
+ \pushToTag #'here g' \music
\appendToTag #'here c'
\appendToTag #'here e'
- \appendToTag #'here g' \test
+ \appendToTag #'here g' \music
}
@end lilypond
Ces deux instructions sont affectées d'une balise, le matériau à
raccorder à chaque instance de la balise, et l'expression balisée.
-Ces instructions prennent soin de recopier tout ce qui doit être
-modifié, de telle sorte que l'expression @code{\test} originale conserve
-tout son sens.
-
+
@seealso
Manuel d'initiation :
@rlearning{Organisation du code source avec des variables}.
Manuel de notation :
-@ref{Regroupement automatique de parties},
-@ref{Insertion de fichiers LilyPond}.
-
-
-@ignore
-@c This warning is more general than this placement implies.
-@c Rests are not merged whether or not they come from tagged sections.
-@c Should be deleted? -td
+@ref{Insertion de fichiers LilyPond},
+@ref{Regroupement automatique de parties}.
@knownissues
-Lorsqu'elles comportent des silences, ceux-ci ne seront pas fusionnés
-si vous imprimez une partition avec les deux sections balisées.
-
-@end ignore
+L'application d'un @code{\relative} à une expression musicale
+obtenue par filtrage à l'aide de @code{\keepWithTag} ou
+@code{\removeWithTag} peut générer des changements d'octave,
+puisque seules les hauteurs récupérées dans ce filtre seront
+prises en considération. Une instruction @code{\relative} qui
+précède les commandes @code{\keepWithTag} ou
+@code{\removeWithTag} permet d'éviter ce risque, dans la mesure où
+elle viendra « recaler » ces hauteurs récupérées.
@node Globalisation des réglages
@seealso
Manuel d'initiation :
-@rlearning{Organisation du code source avec des variables},
-@rlearning{Feuilles de style}.
+@rlearning{Feuilles de style},
+@rlearning{Organisation du code source avec des variables}.
Manuel de notation :
@ref{Insertion de fichiers LilyPond}.
LilyPond n'effectue aucune conversion d'encodage que ce soit. Ceci
implique donc que tout texte -- un titre, des paroles ou même une
-instruction musicale -- comportant des caractères non ASCII soit
+instruction musicale -- comportant des caractères non ASCII soit
codé en UTF-8. Le plus sûr moyen de saisir du texte de la sorte
consiste à utiliser un éditeur supportant l'unicode et à enregistrer vos
fichier en UTF-8. C'est le cas pour la plupart des éditeurs actuels,
-que ce soit vim, Emacs, jEdit et GEdit. Tous les systèmes Windows
+que ce soit vim, Emacs, jEdit et Gedit. Tous les systèmes Windows
postérieurs à NT utilisent Unicode en natif ; même Notepad est
capable d'éditer et sauvegarder un fichier en UTF-8 -- sans parler de
l'excellente alternative qu'est BabelPad.
Voici un exemple utilisant du texte en cyrillique, en hébreux et en
portugais.
+@c NOTE: No verbatim in the following example as the code does not
+@c display correctly in PDF Font settings for Cyrillic and Hebrew
+
@lilypond[quote]
-%c No verbatim here as the code does not display correctly in PDF
+% Linux Libertine fonts contain Cyrillic and Hebrew glyphs.
+\paper {
+ #(define fonts
+ (set-global-fonts
+ #:roman "Linux Libertine O,serif"
+ #:sans "Linux Biolinum O,sans-serif"
+ #:typewriter "Linux Libertine Mono O,monospace"
+ ))
+}
+
% Cyrillic
bulgarian = \lyricmode {
Жълтата дюля беше щастлива, че пухът, който цъфна, замръзна като гьон.
à vo -- cê uma can -- ção legal
}
-\relative c' {
- c2 d e f g f e
+\relative {
+ c'2 d e f g f e
}
\addlyrics { \bulgarian }
\addlyrics { \hebrew }
@lilypond[quote,verbatim]
\score {
- \relative c'' {
- c1 \mark \markup { \char ##x03EE }
+ \relative {
+ c''1 \mark \markup { \char ##x03EE }
c1_\markup { \tiny { \char ##x03B1 " to " \char ##x03C9 } }
}
\addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
}
-\markup { "Copyright 2008--2012" \char ##x00A9 }
+\markup { "Copyright 2008--2015" \char ##x00A9 }
@end lilypond
@cindex copyright
@subsection Extraction de fragments musicaux
@translationof Extracting fragments of music
-LilyPond permet d'extraire des fragments d'une partition à l'instar du
-choriste amateur qui alimente son album avec des coupures de journaux.
+@cindex fragments, extraction
-Vous devrez pour cela définir les mesures à découper. La définition
-suivante, incluse dans votre fichier source,
+@funindex clip-regions
-@verbatim
-\layout {
+LilyPond permet d'extraire des fragments d'une partition, une fois
+definis explicitement le ou les emplacements de la musique concernés au
+sein du bloc @code{\layout} du fichier source, grâce à la fonction
+@code{clip-regions}, puis en lançant @command{lilypond} avec l'option
+@w{@code{-dclip-systems}}.
+
+@example
+\layout @{
clip-regions
= #(list
(cons
(make-rhythmic-location 5 1 2)
(make-rhythmic-location 7 3 4)))
-}
-@end verbatim
+@}
+@end example
@noindent
-vous permettra d'extraire un fragment compris entre le milieu de la
-cinquième mesure et quelque part dans la septième. Le triplet
-@code{5 1 2} signifie : après la durée d'une blanche dans la mesure 5 ;
-le @code{7 3 4} signifie quant à lui que l'on s'arrête à la mesure 7,
-après la durée de trois noires.
+L'exemple ci-dessus permet d'extraire un seul fragment @emph{débutant}
+après une blanche dans la cinquième mesure (@code{5 1 2}) et
+@emph{finissant} après trois noires dans la septième
+mesure (@code{7 3 4}).
+
+D'autres fragments seront extraits dès lors que d'autres paires de
+@w{@code{make-rhythmic-location}} auront été ajoutées à la liste de
+@w{@code{clip-regions}} présente dans le bloc @code{\layout}.
+
+Chaque fragment sera généré individuellement sous la forme d'un fichier
+@code{EPS}, converti en @code{PDF} ou @code{PNG} selon le format que
+vous aurez stipulé. La musique extraite est rendue comme si elle avait
+été littéralement « découpée » dans la partition. Par voie de
+conséquence, un fragment dépassant une ligne fera l'objet d'autant de
+fichiers séparés que de lignes de la partition complète.
-Rien ne vous empêche d'extraire plusieurs fragments, dès lors que vous
-définissez dans la liste d'autres paires d'emplacements rythmiques.
-
-Cette fonctionnalité n'est toutefois effective que lorsque vous lancez
-LilyPond avec l'option @w{@code{-dclip-systems}}. Les @qq{coupures}
-seront générées sous la forme de fichiers EPS, convertis en PDF ou PNG
-selon le format que vous aurez stipulé.
+@seealso
+Manuel de notation :
+@ref{Le bloc layout}.
-Pour de plus amples informations quant au format des résultats,
-consultez le chapitre @rprogram{Lancement de lilypond}.
+Manuel d'utilisation :
+@rprogram{Utilisation en ligne de commande}.
@node Ignorer des passages de la partition
processus de correction, vous pouvez @qq{escamoter} le reste et ne
générer que les dernières mesures en insérant
-@verbatim
+@example
showLastLength = R1*5
-\score { ... }
-@end verbatim
+\score @{ @dots{} @}
+@end example
@noindent
dans votre fichier source. Ceci aura pour effet de ne générer que les
événements seront escamotés, y compris les changements de tempo ou
d'instrument -- vous voilà prévenu !
-@lilypond[quote,relative=2,ragged-right,verbatim]
-c8 d
-\set Score.skipTypesetting = ##t
-e8 e e e e e e e
-\set Score.skipTypesetting = ##f
-c8 d b bes a g c2
+@lilypond[quote,ragged-right,verbatim]
+\relative c' {
+ c1
+ \set Score.skipTypesetting = ##t
+ \tempo 4 = 80
+ c4 c c c
+ \set Score.skipTypesetting = ##f
+ d4 d d d
+}
@end lilypond
Dans le cadre de musique polyphonique, @code{Score.skipTypesetting}
@subsection Changement des fontes musicales
@translationof Replacing the notation font
-Gonville est une alternative à la fonte Feta que LilyPond utilise par
-défaut. Vous pouvez la télécharger à partir de
+Gonville est une alternative à la fonte Emmentaler que LilyPond utilise
+par défaut. Vous pouvez la télécharger à partir de
@example
@uref{http://www.chiark.greenend.org.uk/~sgtatham/gonville/ ,http://www.chiark.greenend.org.uk/~sgtatham/gonville/}
@end example
@c NOTE: these images are a bit big, but that's important
@c for the font comparison. -gp
-@sourceimage{Gonville_after,,,}
+@sourceimage{Gonville_after,15cm,,}
Et ces même mesures avec la police de LilyPond, Feta :
-@sourceimage{Gonville_before,,,}
+@sourceimage{Gonville_before,15cm,,}
@subsubheading Instructions d'installation pour MacOS
@rlearning{Autres sources de documentation} à ce sujet. Renommez le
répertoire @code{fonts} qui s'y trouve en @code{fonts_orig}, puis le
répertoire @code{lilyfonts} en @code{fonts}. Il vous suffira, pour
-retrouver la fonte Feta, de renommer @code{fonts_orig} en @code{fonts}.
+retrouver la fonte Emmentaler, de renommer @code{fonts_orig} en
+@code{fonts}.
@seealso
Manuel d'initiation :
qu'à propos des conditions d'utilisation.
-@node Sortie MIDI
-@section Sortie MIDI
-@translationof MIDI output
+@node Génération de fichiers MIDI
+@section Génération de fichiers MIDI
+@translationof Creating MIDI output
@cindex son
@cindex MIDI
-MIDI (Musical Instrument Digital Interface) constitue un standard en
-matière de connexion et de contrôle des instruments électroniques. Un
-fichier MIDI contient une série de notes réparties dans différentes
-pistes. Il ne s'agit en rien d'un fichier sonore ; il vous faudra
-un logiciel capable de traduire ces séries de notes en sons réels.
-
-Vous pouvez convertir vos partition en fichier MIDI de manière à
-entendre ce que vous avez saisi. Ceci vous permet de contrôler aisément
-ce que vous avez saisi : octaves et altérations erronées heurteront
-votre oreille avertie grâce au MIDI.
-
-Le fichier MIDI généré par LilyPond est relativement brut. Vous pouvez
-cependant obtenir un meilleur rendu avec @ref{Le script Articulate}.
+LilyPond peut produire des fichiers conformes au standard MIDI (Musical
+Instrument Digital Interface), ce qui permet de vérifier le rendu à
+l'oreille grace à un logiciel ou un périphérique sachant interpréter le
+MIDI. L'écoute du rendu en MIDI permet de contrôler aisément ce que
+vous avez saisi : octaves et altérations erronées heurteront votre
+oreille avertie !
-Dans une sortie MIDI, LilyPond alloue un canal à chaque portée, tout en
-réservant le canal 10 aux percussions. Dans la mesure ou un
-périphérique MIDI ne comprend que 16 canaux, un fichier MIDI qui
-comportera plus de quinze portées verra le même canal réutilisé.
+Les fichiers MIDI, contrairement aux fichiers AAC, MP3 ou Vorbis, ne
+contiennent pas de son et nécessitent donc le recours à un logiciel
+supplémentaire pour les écouter.
@menu
-* Création de fichiers MIDI::
+* Notation prise en compte dans le MIDI::
+* Notation non prise en compte dans le MIDI::
* Le bloc MIDI::
-* Contenu de la sortie MIDI::
-* Répétitions et MIDI::
* Gestion des nuances en MIDI::
-* MIDI et percussions::
-* Le script Articulate::
+* Gestion des instruments MIDI::
+* Gestion des répétitions en MIDI::
+* Affectation des canaux MIDI::
+* Propriétés de contextes et effets MIDI::
+* Amélioration du rendu MIDI::
@end menu
+@node Notation prise en compte dans le MIDI
+@subsection Notation prise en compte dans le MIDI
+@translationof Supported notation for MIDI
+
+@cindex MIDI, éléments pris en compte
+
+LilyPond retranscrit par défaut dans un fichier MIDI les éléments de
+notation suivant :
+
+@itemize
+@item les marques de respiration,
+@item les accords nommés,
+@item les crescendos et decrescendos s'étendant sur plusieurs notes --
+le volume s'ajuste linéairement entre les deux extrêmes,
+@item les indications de nuance, de @code{ppppp} à @code{fffff}, y compris
+@code{mp}, @code{mf} et @code{sf},
+@item les microtonalités mais @emph{pas} sous forme d'accord ; leur
+rendu nécessite cependant un lecteur qui prenne en charge la
+modulation,
+@item les paroles,
+@item les hauteurs,
+@item le rythme sous forme de durée de note, y compris les n-olets,
+@item les articulations « simples » comme staccato, staccatissimo,
+accent, marcato et portato,
+@item les changements de tempo indiqués par un @code{\tempo},
+@item les liaisons de tenue,
+@item les tremolos, excepté ceux utilisant la syntaxe
+« @code{:}[@var{nombre}] ».
+@end itemize
+
+Spatialisation, balance, expression, réverbération et chorus peuvent se
+contrôler à l'aide de propriétés de contexte -- voir
+@ref{Propriétés de contextes et effets MIDI}.
+
+En combinaison avec le script @file{articulate}, d'autres éléments
+seront aussi reportés en MIDI :
+
+@itemize
+@item les appoggiatures -- celles-ci prendront la moitié de la valeur,
+dépourvue de point, de la note qui les suit -- par exemple,
+
+@example
+\appoggiatura c8 d2.
+@end example
+
+@noindent
+le do (noté @code{c}) prendra la valeur d'une noire.
+
+@item les ornements (mordants, trilles et groupettos, etc.),
+@item rallentando, accelerando, ritardando et a tempo,
+@item les liaisons y compris de phrasé,
+@item les tenutos.
+@end itemize
+
+@noindent
+Voir @ref{Amélioration du rendu MIDI}.
+
-@node Création de fichiers MIDI
-@subsection Création de fichiers MIDI
-@translationof Creating MIDI files
+@node Notation non prise en compte dans le MIDI
+@subsection Notation non prise en compte dans le MIDI
+@translationof Unsupported notation for MIDI
+
+@cindex MIDI, éléments non pris en comte
+
+Certains éléments de notation ne peuvent être retranscrits dans un
+fichier MIDI :
+
+@itemize
+@item les articulations autres que staccato, staccatissimo, accent, marcato
+et portato,
+@item les crescendos et decrescendos sur @emph{une seule} note,
+@item les points d'orgue,
+@item la basse chiffrée,
+@item les glissandos,
+@item les chutes ou sauts,
+@item les accords en microtonalité,
+@item le rythme indiqué sous forme d'annotation, comme « swing »,
+@item les changements de tempo indiqués sous forme d'annotation (sans
+@code{\tempo}),
+@item les trémolos indiqués par la syntaxe « @code{:}[@var{nombre}] ».
+@end itemize
+
+
+@node Le bloc MIDI
+@subsection Le bloc MIDI
+@translationof The MIDI block
+
+@cindex MIDI, le bloc
LilyPond générera un fichier MIDI dès que vous ajouterez un bloc
-@code{\midi} à la structure de votre partition, comme ici :
+@code{\midi}, même vide, au sein du bloc @code{\score} :
@example
\score @{
- @var{...musique...}
+ @var{@dots{}musique@dots{}}
+ \layout @{ @}
\midi @{ @}
@}
@end example
-Lorsque le bloc @code{\score} contient un bloc @code{\midi} mais pas de
-bloc @code{\layout}, LilyPond ne produira qu'une sortie MIDI. Si donc
-vous avez besoin aussi d'un support visuel, vous devrez aussi mentionner
-un bloc @code{\layout}.
+@warning{Lorsque le bloc @code{@bs{}score} contient uniquement un bloc
+@code{@bs{}midi} (autrement dit pas de bloc @code{@bs{}layout}),
+LilyPond produira uniquement la sortie MIDI -- aucun support visuel ne
+sera généré.}
+
+L'extension par défaut des fichiers MIDI générés (@code{.midi}) peut se
+modifier en ligne de commande :
@example
-\score @{
- @var{...musique...}
- \midi @{ @}
- \layout @{ @}
-@}
+lilypond -dmidi-extension=mid MonFichier.ly
@end example
-Hauteurs, durées, liaisons de prolongation, nuances et changements de
-tempo seront interprétés et traduits en événements MIDI. Les
-indications de nuances, crescendos et decrescendos sont traduits en
-niveau de volume ; les indications sous la forme d'une fraction
-déterminée du volume disponible, et crescendos et decrescendos sous la
-forme d'une progression linéaire entre les deux extrêmes. Le rendu des
-indications de nuance peut être désactivé pour le MIDI -- voir
-@ref{Le bloc MIDI}.
-
-Le tempo initial ainsi que ses changements sont normalement indiqués au
-fil de la notation à l'aide de la commande @code{\tempo} ; ils seront
-retranscrits dans le fichier MIDI. La commande @code{\tempo} donne lieu
-à l'impression d'une indication métronomique que vous pouvez toutefois
-rendre invisible, comme indiqué à la rubrique
-@ref{Indication métronomique}. Une autre manière de spécifier le tempo
-initial pour un fichier MIDI est indiquée plus avant -- voir
-@ref{Le bloc MIDI}.
-
-En raison de certaines limitations de Windows, les fichiers MIDI doivent
-y porter l'extension @code{.mid}. D'autres systèmes utilisent
-l'extension @code{.midi}. Si besoin est, placez la ligne suivante au
+Une autre manière de procéder consiste à placer la ligne suivante au
début de votre fichier source, avant l'ouverture de tout bloc
-@code{\book}, @code{\bookpart} ou @code{\score} :
+@code{\book}, @code{\bookpart} ou @code{\score} -- voir
+@ref{Structure de fichier} :
@example
-#(ly:set-option 'midi-extension "midi")
+#(ly:set-option 'midi-extension "mid")
@end example
-Cette ligne déterminera @code{.midi} comme extension par défaut pour les
-fichiers MIDI.
+@seealso
+Manuel de notation :
+@ref{Structure de fichier}.
-Vous pouvez aussi le faire en ligne de commande :
+Fichiers d'initialisation :
+@file{scm/midi.scm}.
-@example
-lilypond … -dmidi-extension=midi fichierLily.ly
-@end example
+@knownissues
+Le standard MIDI dispose de 15 canaux plus un (le numéro 10) affecté aux
+percussions. Les portées sont assignées l'une après l'autre à un canal.
+Dans la mesure où une partition comporte plus de 15 portées, les portées
+au-delà de la quinzième partageront un même canal MIDI, sans toutefois
+l'écraser. Ceci peut entraîner des conflits au niveau des canaux en
+raison des propriétés MIDI, notamment l'instrument utilisé.
+@node Gestion des nuances en MIDI
+@subsection Gestion des nuances en MIDI
+@translationof Controlling MIDI dynamics
-@unnumberedsubsubsec Noms d'instrument
-@translationof Instrument names
+@cindex MIDI, gestion des nuances
-@cindex instrument, nom d'
-@funindex Staff.midiInstrument
+Le volume général de la sortie MIDI peut se définir, ainsi que ses
+modulations, en fonction des indications de nuance et les volumes
+relatifs entre les différents instruments.
-L'instrument MIDI affecté à un canal particulier est déterminé par la
-propriété @code{Staff.midiInstrument}. Vous pouvez choisir l'un des
-instruments répertoriés à l'annexe @ref{Instruments MIDI}.
+Les indications de nuance se traduisent automatiquement en niveau de
+volume dans l'amplitude disponible en MIDI alors que crescendos et
+diminuendos auront une progression linéaire entre les extrêmes.
-@example
-\new Staff @{
- \set Staff.midiInstrument = #"glockenspiel"
- @var{...notes...}
-@}
-@end example
+@menu
+* Indication des nuances en MIDI::
+* Réglage du volume en MIDI::
+* Réglage de propriétés dans le bloc MIDI::
+@end menu
-@example
-\new Staff \with @{midiInstrument = #"cello"@} @{
- @var{...notes...}
-@}
-@end example
-Lorsque l'instrument choisi ne correspond pas exactement à l'une des
-dénominations consacrées, LilyPond le replacera par un piano de concert
-(@code{"acoustic grand"}).
+@node Indication des nuances en MIDI
+@unnumberedsubsubsec Indication des nuances en MIDI
+@translationof Dynamic marks in MIDI
+
+@cindex MIDI, indications de nuance
+
+Les indications de nuance, de @code{ppppp} à @code{fffff} -- y compris
+@code{mp}, @code{mf} et @code{sf} -- ont des valeurs prédéfinies. Ce
+coefficient est alors appliqué pour corriger le volume général de façon
+à obtenir le niveau sonore qui sera retranscrit dans le fichier de
+sortie pour la nuance considérée. Nous allons, par défaut, de 0,25 pour
+un @notation{ppppp} à 0,95 pour un @notation{fffff}. Les
+correspondances entre nuance et fraction de volume sont répertoriées
+dans le fichier @file{scm/midi.scm}.
@snippets
@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
-{changing-midi-output-to-one-channel-per-voice.ly}
-
-@knownissues
-@c In 2.11 the following no longer seems to be a problem -td
-@ignore
-Un (de)crescendo non terminé ne sera pas correctement rendu en MIDI --
-il y a nécessairement du silence. Il vous faut donc lui donner une fin
-explicite. Par exemple,
+{creating-custom-dynamics-in-midi-output.ly}
-@example
-@{ a4\< b c d\f @}
-@end example
+@seealso
+Fichiers d'initialisation :
+@file{ly/script-init.ly},
+@file{scm/midi.scm}.
-@noindent
-ne fonctionnera pas correctement, contrairement à
+Morceaux choisis :
+@rlsr{MIDI}.
-@example
-@{ a4\< b c d\!\f @}
-@end example
-@end ignore
+Référence des propriétés internes :
+@rinternals{Dynamic_performer}.
-Un changement de volume ne peut intervenir que sur le démarrage d'une
-note. C'est la raison pour laquelle la succession d'un crescendo et
-d'un diminuendo ne peut se produire sur une même note.
+@node Réglage du volume en MIDI
+@unnumberedsubsubsec Réglage du volume en MIDI
+@translationof Setting MIDI volume
-Certains lecteurs MIDI ne rendent pas correctement les changements de
-tempo. MS Windows Media Player et
-@uref{http://@/timidity@/.sourceforge@/.net/,timidity} le font sans
-problème.
+@cindex MIDI, réglage du volume
+Les valeurs extrêmes du volume MIDI des nuances se contrôlent à l'aide
+des propriétés @code{midiMinimumVolume} et @code{midiMaximumVolume} qui
+agissent au niveau @code{Score}. Ces propriétés sont effectives dès
+lors qu'une nuance est indiquée ; une nuance de départ explicite est donc
+requise pour que le volume soit ajusté dès le début de la partition.
+Vous pouvez alors modifier la fraction correspondant à chaque nuance à
+l'aide de la formule
-@node Le bloc MIDI
-@subsection Le bloc MIDI
-@translationof MIDI block
+@example
+midiMinimumVolume + (midiMaximumVolume - midiMinimumVolume) * fraction
+@end example
-Dès lors que vous désirez obtenir une sortie MIDI, vous devrez inscrire
-un bloc @code{\midi} au sein du bloc @code{\score}. Son fonctionnement
-est comparable à ce lui du bloc @code{\layout}, voire plus simple. Si
-le bloc @code{\midi} est la plupart du temps laissé vide, il peut
-contenir des aménagements pour certains contextes, la définition de
-contextes particuliers ou du code permettant de déterminer la valeur de
-certaines propriétés. L'exemple suivant détermine le tempo initial du
-fichier MIDI tout en se passant de son indication sur la partition
-imprimée.
+Voici comment ajuster les nuances tout en limitant l'amplitude du volume
+entre 0,2 et 0,5 :
@example
\score @{
- @var{...musique...}
+ <<
+ \new Staff @{
+ \set Staff.midiInstrument = #"flute"
+ @var{@dots{} music @dots{}}
+ @}
+ \new Staff @{
+ \set Staff.midiInstrument = #"clarinet"
+ @var{@dots{} music @dots{}}
+ @}
+ >>
\midi @{
- \tempo 4 = 72
+ \context @{
+ \Score
+ midiMinimumVolume = #0.2
+ midiMaximumVolume = #0.5
+ @}
@}
@}
@end example
-Ici, le tempo est fixé à 72 noires à la minute. Spécifier un tempo de
-la sorte ne permet pas de donner une valeur pour une note pointée. Vous
-devrez, en pareil cas, subdiviser la note pointée en durée plus courte.
-Par exemple, indiquer 90 à la noire pointée est équivalent à spécifier
-270 croches à la minute :
-
-@example
-tempoWholesPerMinute = #(ly:make-moment 270 8)
-@end example
-
-@cindex MIDI et définition de contexte
-@cindex contexte, définition en MIDI
-
-La syntaxe permettant de définir un contexte pour le @code{\midi} est en
-tout point identique à celle que vous utilisez dans le bloc
-@code{\layout}, à ceci près que le @qq{graveur} est remplacé par un
-@qq{interprète}. Les différents contextes disponibles en matière de
-MIDI sont répertoriés dans le fichier d'initialisation
-@file{../ly/performer-init.ly} -- pour plus de détail, voir
-@rlearning{Autres sources de documentation}.
-Si vous voulez vous passer des nuances dans votre fichier MIDI, il vous
-suffit d'insérer les lignes suivantes dans votre bloc
-@code{\midi@{ @}}.
+La définition de l'amplitude du volume MIDI au niveau d'un contexte
+@code{Staff} -- grace aux propriétés @code{midiMinimumVolume} et
+@code{midiMaximumVolume} -- permet en quelque sorte d'égaliser un
+instrument MIDI.
@example
-\midi @{
- ...
- \context @{
- \Voice
- \remove "Dynamic_performer"
+\score @{
+ \new Staff @{
+ \set Staff.midiInstrument = #"flute"
+ \set Staff.midiMinimumVolume = #0.7
+ \set Staff.midiMaximumVolume = #0.9
+ @var{@dots{} musique @dots{}}
@}
+ \midi @{ @}
@}
@end example
-LilyPond ne générera de sortie MIDI que si vous incluez un bloc
-@code{\midi} dans la structure de la partition, initialisée par la
-commande @code{\score}.
+Dans le cas d'une partition à plusieurs portées et différents
+instruments, les volumes relatifs entre les différents instruments se
+gèrent individuellement :
@example
\score @{
- @{ @dots{}notes@dots{} @}
+ <<
+ \new Staff @{
+ \set Staff.midiInstrument = #"flute"
+ \set Staff.midiMinimumVolume = #0.7
+ \set Staff.midiMaximumVolume = #0.9
+ @var{@dots{} music @dots{}}
+ @}
+ \new Staff @{
+ \set Staff.midiInstrument = #"clarinet"
+ \set Staff.midiMinimumVolume = #0.3
+ \set Staff.midiMaximumVolume = #0.6
+ @var{@dots{} music @dots{}}
+ @}
+ >>
\midi @{ @}
@}
@end example
+La clarinette de cet exemple jouera relativement moins fort que la
+flûte.
-@node Contenu de la sortie MIDI
-@subsection Contenu de la sortie MIDI
-@translationof What goes into the MIDI output?
+En l'absence de tout réglage des propriétés de volume, LilyPond
+appliquera cependant un léger degré d'égalisation pour certains
+instruments -- voir @file{scm/midi.scm}.
-@c TODO Check grace notes - timing is suspect?
+@snippets
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
+{replacing-default-midi-instrument-equalization.ly}
+@seealso
+Fichiers d'initialisation :
+@file{scm/midi.scm}.
-@unnumberedsubsubsec Éléments pris en compte dans le MIDI
-@translationof Supported in MIDI
+Manuel de notation :
+@ref{Mise en forme de la partition}.
-@cindex hauteurs en MIDI
-@cindex MIDI, hauteurs
-@cindex quart de ton en MIDI
-@cindex MIDI, quart de ton
-@cindex microtonalité en MIDI
-@cindex MIDI, microtonalité
-@cindex accords nommés en MIDI
-@cindex MIDI, accords nommés
-@cindex Rythme en MIDI
-@cindex MIDI, Rythme
-@cindex articulations et MIDI
-@cindex MIDI et articulations
-@cindex trilles et MIDI
-@cindex MIDI et trilles
-@c TODO etc
+Référence des propriétés internes :
+@rinternals{Dynamic_performer}.
-Un fichier MIDI généré par LilyPond comprendra les éléments de notation
-suivants :
+@knownissues
+Les modifications apportées au volume MIDI n'interviennent que sur
+l'attaque d'une note, en conséquence de quoi crescendos et decrescendos
+n'affecteront pas le volume s'ils se produisent sur une même et unique
+note.
-@itemize
-@item
-les hauteurs ;
-@item
-les microtonalités -- voir @ref{Altérations}. Leur rendu nécessite
-cependant un lecteur qui prenne en charge la modulation ;
+@node Réglage de propriétés dans le bloc MIDI
+@unnumberedsubsubsec Réglage de propriétés dans le bloc MIDI
+@translationof Setting MIDI block properties
-@item
-les accords nommés ;
+Le bloc @code{\midi} peut contenir des aménagements pour certains
+contextes, la définition de contextes particuliers ou du code permettant
+de déterminer la valeur de certaines propriétés.
-@item
-le rythme en tant que durée de note, y compris les nolets ;
+@example
+\score @{
+ @var{@dots{} music @dots{}}
+ \midi @{
+ \tempo 4 = 72
+ @}
+@}
+@end example
-@item
-les trémolos, exceptés ceux utilisant la syntaxe
-@qq{@code{:}[@var{nombre}]} ;
+Le tempo est ici réglé à 72 noires par minute. Une indication de tempo
+inscrite dans le bloc @code{\midi} ne sera pas reportée sur la partition
+imprimable. Cependant, tout @code{\tempo} mentionné dans le bloc
+@code{\score} sera répercuté dans la sortie MIDI.
-@item
-les liaisons de prolongation ;
+Placée au sein d'un bloc @code{\midi}, la commande @code{\tempo}
+détermine des propriétés lors de la phase d'interprétation de la musique
+et dans le contexte de définition des sorties. Elle est alors
+considérée comme une modification de contexte.
-@item
-les indications de nuance ;
+@cindex MIDI, définition de contexte
+@cindex contexte, définition en MIDI
-@item
-les crescendos et decrescendos s'étalant sur plusieurs notes ;
+La syntaxe permettant de définir un contexte pour le @code{\midi} est en
+tout point identique à celle que vous utilisez dans le bloc
+@code{\layout} :
-@item
-les changements de tempo indiqués par un @code{\tempo} ;
+@example
+\score @{
+ @var{@dots{} musique @dots{}}
+ \midi @{
+ \context @{
+ \Voice
+ \remove "Dynamic_performer"
+ @}
+ @}
+@}
+@end example
-@item
-les paroles.
-@end itemize
+Ces quelques lignes ont pour effet de supprimer l'application des
+nuances à la sortie MIDI. Vous aurez noté que les modules de traduction
+de LilyPond en matière de son s'appelent @emph{performers} -- des
+« interprètes ».
-Si vous utilisez @ref{Le script Articulate}, d'autres éléments seront
-alors inclus :
+@seealso
+Manuel d'initiation :
+@rlearning{Autres sources de documentation}.
-@itemize
-@item articulations (lié, staccato, etc.),
-@item trilles et groupettos,
-@item rallentando et accelerando.
-@end itemize
+Manuel de notation :
+@ref{Mise en forme de la partition},
+@ref{Signes d'interprétation}.
+Fichiers d'initialisation :
+@file{ly/performer-init.ly}.
-@unnumberedsubsubsec Éléments non pris en compte dans le MIDI
-@translationof Unsupported in MIDI
+Morceaux choisis :
+@rlsr{MIDI}.
-@c TODO index as above
+Référence des propriétés internes :
+@rinternals{Dynamic_performer}.
-LilyPond ne peut générer d'événement MIDI pour les éléments
-suivant, sauf à utiliser @ref{Le script Articulate} :
+@knownissues
+Certains lecteurs MIDI ne rendent pas correctement les changements de
+tempo.
-@itemize
-@item
-le rythme indiqué sous forme d'annotation (par ex. @emph{swing}) ;
+Les modifications de @code{midiInstrument} ou autres options MIDI en
+début de portée peuvent se retrouver dédoublées dans la sortie MIDI.
-@item
-les changements de tempo indiqués sous forme d'annotation (sans
-@code{\tempo}) ;
+@node Gestion des instruments MIDI
+@subsection Gestion des instruments MIDI
+@translationof Using MIDI Instruments
-@item
-les staccatos et autres articulations ou ornementations ;
+@cindex instrument, nom d'
+@cindex MIDI, instruments
+@funindex Staff.midiInstrument
-@item
-les liaisons d'articulation et de phrasé ;
+L'instrument MIDI est déterminé par la propriété @code{midiInstrument},
+au sein d'un contexte @code{Staff}.
-@item
-les crescendos ou decrescendos sur une seule note ;
+@example
+\score @{
+ \new Staff @{
+ \set Staff.midiInstrument = #"glockenspiel"
+ @var{@dots{} music @dots{}}
+ @}
+ \midi @{ @}
+@}
+@end example
-@item
-les trémolos indiqués par la syntaxe @qq{@code{:}[@var{nombre}]} ;
+ou
-@item
-la basse chiffrée ;
+@example
+\score @{
+ \new Staff \with @{midiInstrument = #"cello"@} @{
+ @var{@dots{} music @dots{}}
+ @}
+ \midi @{ @}
+@}
+@end example
-@item
-les accords en microtonalité.
-@end itemize
+Lorsque l'instrument choisi ne correspond pas exactement à l'une des
+dénominations consacrées, LilyPond le remplacera par un piano de concert
+(@code{"acoustic grand"}) -- voir @ref{Instruments MIDI}.
+@seealso
+Manuel d'initiation :
+@rlearning{Autres sources de documentation}.
-@node Répétitions et MIDI
-@subsection Répétitions et MIDI
-@translationof Repeats in MIDI
+Manuel de notation :
+@ref{Instruments MIDI},
+@ref{Mise en forme de la partition}.
+
+Référence des propriétés internes :
+@rinternals{Dynamic_performer}.
+
+Fichiers d'initialisation :
+@file{scm/midi.scm}.
+
+@knownissues
+Les percussions gérées par un contexte @code{DrumStaff} sont affectées
+directement au canal 10 qui leur est réservé. Certains instruments, tels
+le xylophone, le marimba, le vibraphone ou les timbales, se traitent
+cependant comme des instruments « classiques » puisqu'ils sont capables
+d'émettre des hauteurs différentes ; leur notation relève donc d'un
+contexte @code{Staff} standard, et non d'un @code{DrumStaff} pour
+pouvoir être rendus correctement en MIDI. Une liste complète des
+percussions affectées au canal 10 (@code{channel 10 drum-kits}) est
+disponible dans le fichier @file{scm/midi.scm} -- voir
+@rlearning{Autres sources de documentation}.
+
+
+@node Gestion des répétitions en MIDI
+@subsection Gestion des répétitions en MIDI
+@translationof Using repeats with MIDI
@cindex reprises développées
@cindex MIDI et reprises
@funindex \unfoldRepeats
-Au prix de quelques réglages, les reprises de toutes sortes peuvent être
-rendues dans le fichier MIDI. Il suffit pour cela de recourir à la
-fonction @code{\unfoldRepeats}, qui développe toutes les reprises. En
-d'autre termes, @code{\unfoldRepeats} transforme toutes les reprises
-en reprises de type @code{unfold}.
-
+Les reprises de toutes sortes peuvent être rendues dans le fichier MIDI.
+Il suffit pour cela de recourir à la fonction @code{\unfoldRepeats}, qui
+développe toutes les reprises.
-@lilypond[quote,verbatim]
-\unfoldRepeats {
- \repeat tremolo 8 {c'32 e' }
- \repeat percent 2 { c''8 d'' }
- \repeat volta 2 {c'4 d' e' f'}
- \alternative {
- { g' a' a' g' }
- {f' e' d' c' }
- }
-}
-\bar "|."
-@end lilypond
-
-Dans une partition comportant plusieurs voix, le développement des
-reprises ne sera effectif en MIDI qu'à la condition que ces reprises
-soient mentionnée correctement dans @strong{toutes} les voix.
+@example
+\score @{
+ \unfoldRepeats @{
+ \repeat tremolo 8 @{ c'32 e' @}
+ \repeat percent 2 @{ c''8 d'' @}
+ \repeat volta 2 @{ c'4 d' e' f' @}
+ \alternative @{
+ @{ g' a' a' g' @}
+ @{ f' e' d' c' @}
+ @}
+ @}
+ \midi @{ @}
+@}
+@end example
Lorsque l'on veut utiliser @code{\unfoldRepeats} seulement pour le rendu
-MIDI, il faut établir deux blocs @code{\score} : un pour le MIDI,
+MIDI, il faut établir @b{deux} blocs @code{\score} : un pour le MIDI,
avec des reprises explicites, et l'autre pour la partition, avec des
reprises notées sous forme de barres de reprise, de trémolo ou de
-symboles de pourcentage. Par exemple
+symboles de pourcentage. Par exemple
@example
\score @{
- @var{..musique..}
- \layout @{ .. @}
+ @var{@dots{} musique @dots{}}
+ \layout @{ @}
@}
\score @{
- \unfoldRepeats @var{..musique..}
- \midi @{ .. @}
+ \unfoldRepeats @var{@dots{} musique @dots{}}
+ \midi @{ @}
@}
@end example
+Dans une partition comportant plusieurs voix, le développement des
+reprises ne sera effectif en MIDI qu'à la condition que ces reprises
+soient mentionnée correctement dans @strong{toutes} les voix.
-@node Gestion des nuances en MIDI
-@subsection Gestion des nuances en MIDI
-@translationof Controlling MIDI dynamics
-
-Les nuances MIDI sont générées par le @code{Dynamic_performer}, affecté
-par défaut au contexte @code{Voice}. Vous pouvez contrôler à la fois le
-volume général, celui des indications de nuance ainsi que celui des
-différents instruments.
-
-
-@unnumberedsubsubsec Indications de nuance
-@translationof Dynamic marks
-
-Les indications de nuances sont transcrites en fraction du volume MIDI.
-Nous allons, par défaut, de 0,25 pour un @notation{ppppp} à 0,95 pour un
-@notation{fffff}. Les correspondances entre nuance et fraction de
-volume sont répertoriées dans le fichier @file{../scm/midi.scm} --
-consultez la rubrique @rlearning{Autres sources de documentation} si
-vous ne savez comment le localiser. Vous pouvez modifier ou étendre ce
-jeu grâce à une fonction qui prendra en argument une indication de
-nuance et renverra la fraction désirée, puis en affectant cette fonction
-à @code{Score.dynamicAbsoluteVolumeFunction}.
-
-Prenons un exemple. Votre partition comporte un @notation{rinforzando}
-que vous avez indiqué par @code{\rfz}. Cette indication de nuance
-n'étant pas répertoriée dans le jeu par défaut, elle ne produira aucun
-effet en MIDI. Il en sera d'ailleurs de même pour toute indication
-créée de toute pièce à l'aide de l'instruction
-@w{@code{make-dynamic-script}}. Voici comment procéder pour ajuster le
-volume MIDI de ce @notation{rinforzando} que le compositeur a indiqué.
-La fonction Scheme définit une fraction de 0,9 en cas de @notation{rfz},
-et demande d'utiliser la fonction par défaut dans les autre cas.
-
-@lilypond[verbatim,quote]
-#(define (myDynamics dynamic)
- (if (equal? dynamic "rfz")
- 0.9
- (default-dynamic-absolute-volume dynamic)))
-
-\score {
- \new Staff {
- \set Staff.midiInstrument = #"cello"
- \set Score.dynamicAbsoluteVolumeFunction = #myDynamics
- \new Voice {
- \relative c'' {
- a4\pp b c-\rfz
- }
- }
- }
- \layout {}
- \midi {}
-}
-@end lilypond
+@seealso
+Manuel de notation :
+@ref{Répétitions et reprises}.
-Si vous étiez amené à devoir modifier l'intégralité du jeu des
-correspondances, nous vous conseillons d'utiliser la procédure
-@command{default-dynamic-absolute-volume} contenue dans le fichier
-@file{../scm/midi.scm} ainsi que la table d'association comme base.
-Le dernier exemple de cette partie illustre la manière de procéder.
-@unnumberedsubsubsec Amplitude du volume en MIDI
-@translationof Overall MIDI volume
+@node Affectation des canaux MIDI
+@subsection Affectation des canaux MIDI
+@translationof MIDI channel mapping
-Les valeurs extrêmes du volume MIDI des nuances se contrôlent à l'aide
-des propriétés @code{midiMinimumVolume} et @code{midiMaximumVolume} qui
-agissent au niveau @code{Score}. Ces propriétés sont effectives dès
-lors qu'une nuance est indiquée ; une nuance de départ est donc
-requise pour que le volume soit ajusté dès le début de la partition.
-Vous pouvez alors modifier la fraction correspondant à chaque nuance à
-l'aide de la formule
+@cindex MIDI, canaux
+@cindex MIDI, pistes
+@funindex midiChannelMapping
-@example
-midiMinimumVolume + (midiMaximumVolume - midiMinimumVolume) * fraction
-@end example
+Lorsque LilyPond génère un fichier MIDI à partir d'une partition, chaque
+note contenue dans cette partition sera automatiquement assignée à un
+canal MIDI, celui sur lequel elle devrait être jouée quand elle est
+transmise à un périphérique MIDI. Chaque canal MIDI dispose d'un
+certain nombre de contrôles pour, par exemple, sélectionner l'instrument
++qui jouera les notes de ce canal ou bien demander au périphérique MIDI
+d'appliquer différents effets au son produit sur ce canal. En tout état
+de cause, chaque contrôle d'un canal MIDI ne peut se voir affecté que
+d'une seule valeur à la fois -- celle-ci peut toutefois être modifiée
+pour, par exemple, changer d'instrument au milieu du morceau.
-Voici comment ajuster les nuances tout en limitant l'amplitude du volume
-entre 0,2 et 0,5 :
+Le standard MIDI ne dispose que de 16 canaux par périphérique MIDI.
+Cette limite du nombre de canaux entraîne une limitation du nombre
+d'instruments pouvant jouer de concert.
-@lilypond[verbatim,quote]
-\score {
- <<
- \new Staff {
- \key g \major
- \time 2/2
- \set Staff.midiInstrument = #"flute"
- \new Voice \relative c''' {
- r2 g\mp g fis~
- fis4 g8 fis e2~
- e4 d8 cis d2
- }
- }
- \new Staff {
- \key g \major
- \set Staff.midiInstrument = #"clarinet"
- \new Voice \relative c'' {
- b1\p a2. b8 a
- g2. fis8 e
- fis2 r
- }
- }
- >>
- \layout {}
- \midi {
- \context {
- \Score
- tempoWholesPerMinute = #(ly:make-moment 72 2)
- midiMinimumVolume = #0.2
- midiMaximumVolume = #0.5
- }
- }
-}
-@end lilypond
+LilyPond crée une piste MIDI séparée pour chaque portée (ou chaque
+instrument ou voix selon la valeur de @code{Score.midiChannelMapping})
+ainsi que pour chaque contexte de paroles. Il n'y a pas de limite au
+nombre de pistes.
+Afin de contourner la limitation du nombre de canaux MIDI, LilyPond
+dispose de différents modes d'allocation d'un canal MIDI grâce à la
+propriété de contexte @code{Score.midiChannelMapping}. Dans tous les
+cas, lorsque la limite au nombre de canaux est atteinte, LilyPond repart
+du canal 0, ce qui peut affecter des notes au mauvais instrument. Cette
+propriété de contexte peut prendre les valeurs suivantes :
-@unnumberedsubsubsec Égalisation de plusieurs instruments (i)
-@translationof Equalizing different instruments (i)
+@table @var
-La définition de l'amplitude du volume MIDI au niveau d'un contexte
-@code{Staff} permet de gérer les volumes relatifs entre les différents
-instruments. Ceci constitue en quelque sorte un égaliseur, ce qui
-permet d'améliorer notablement la qualité de la sortie MIDI.
+@item @code{'staff}
+
+Allocation d'un canal MIDI particulier à chacune des portées de la
+partition (option par défaut). Toutes les notes de toutes les voix
+d'une même portée partageront le canal MIDI affecté à la portée qui les
+englobe, et toutes seront encodées dans la même piste.
+
+La limite des 16 canaux s'applique au nombre total de portées augmenté
+des contextes de paroles même si les paroles MIDI n'occupent pas de
+canal MIDI.
+
+@item @code{'instrument}
+
+Allocation d'un canal MIDI particulier à chaque instrument MIDI tel que
+spécifié dans la partition. En d'autre termes, des notes jouées par un
+même instrument MIDI partageront le même canal MIDI (et la même piste),
+même si elles proviennent de voix ou portées différentes.
+
+Dans ce cas particulier, les contextes de paroles ne sont pas pris en
+compte dans la limite des 16 canaux, puisqu'ils ne sont pas assignés à
+un instrument MIDI, ce qui permet une meilleure allocation des canaux
+MIDI lorsque le nombre de portées et de contextes de paroles dépasse 16.
+
+@item @code{'voice}
+
+Allocation d'un canal MIDI particulier à chaque voix de la partition
+portant un nom unique parmi les voix de la portée considérée. Des voix
+appartenant à des portées différentes seront toujours affectées à des
+canaux MIDI différents, mais deux voix partageant la même portée
+partageront le même canal MIDI dès lors qu'elles porteront le même nom.
+Dans la mesure où @code{midiInstrument} et les différents contrôles
+d'effets MIDI sont des propriétés affectant le contexte de portée, ils
+ne peuvent se déterminer individuellement pour une voix. La première
+voix adoptera l'instrument et les effets spécifiés pour cette portée, et
+les voix dénommées différemment de la première se verront attribué
+l'instrument et le effets par défaut.
+
+Note : l'affectation d'instruments ou d'effets différents aux
+differentes voix d'une même portée s'obtient dès lors que le
+@code{Staff_performer} est déplacé du contexte @code{Staff} au contexte
+@code{Voice} tout en maintenant le @code{midiChannelMapping} dans le
+contexte @code{'staff} ou en le réglant sur @code{'instrument}.
-La clarinette de l'exemple suivant jouera relativement moins fort que la
-flûte. Rappelez-vous que pour que cela fonctionne correctement, la
-première note de chacun des instruments doit être affublée d'une
-indication de nuance.
+@end table
-@lilypond[verbatim,quote]
-\score {
- <<
- \new Staff {
- \key g \major
- \time 2/2
- \set Staff.midiInstrument = #"flute"
- \set Staff.midiMinimumVolume = #0.7
- \set Staff.midiMaximumVolume = #0.9
- \new Voice \relative c''' {
- r2 g\mp g fis~
- fis4 g8 fis e2~
- e4 d8 cis d2
- }
- }
- \new Staff {
- \key g \major
- \set Staff.midiInstrument = #"clarinet"
- \set Staff.midiMinimumVolume = #0.3
- \set Staff.midiMaximumVolume = #0.6
- \new Voice \relative c'' {
- b1\p a2. b8 a
- g2. fis8 e
- fis2 r
- }
- }
- >>
- \layout {}
- \midi {
- \tempo 2 = 72
- }
-}
-@end lilypond
+Par exemple, l'affectation par défaut des canaux MIDI d'une partition
+peut être réglée sur @code{'instrument} comme ceci :
+@example
+\score @{
+ ...musique...
+ \midi @{
+ \context @{
+ \Score
+ midiChannelMapping = #'instrument
+ @}
+ @}
+@}
+@end example
-@unnumberedsubsubsec Égalisation de plusieurs instruments (ii)
-@translationof Equalizing different instruments (ii)
+@snippets
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
+{changing-midi-output-to-one-channel-per-voice.ly}
-Lorsque les propriétés volume minimum et maximum n'ont pas été définies,
-LilyPond appliquera par défaut une légère égalisation pour quelques
-instruments. Les instrument concernés ainsi que le niveau d'égalisation
-sont répertoriés dans une table @notation{instrument-equalizer-alist}
-du fichier @file{../scm/midi.scm}.
-Vous pouvez remplacer l'égaliseur basique en définissant une nouvelle
-procédure Scheme @code{instrumentEqualizer} au sein du contexte
-@code{Score}. Cette procédure prend en unique argument le nom d'un
-instrument MIDI et renverra une paire de fractions correspondant au
-minimum et maximum de volume alloué à cet instrument. Cette
-substitution fonctionne selon le même principe que celui que nous avons
-vu en début de chapitre avec @code{dynamicAbsoluteVolumeFunction}.
-L'égaliseur par défaut, @notation{default-instrument-equalizer}, est
-défini dans le fichier @file{../scm/midi.scm} ; son analyse vous
-aidera à construire votre propre procédure.
+@node Propriétés de contextes et effets MIDI
+@subsection Propriétés de contextes et effets MIDI
+@translationof Context properties for MIDI effects
+
+@cindex effets MIDI
+@cindex pan, MIDI
+@cindex spatialisation (pan), MIDI
+@cindex stéréo MIDI, balance
+@cindex balance MIDI
+@cindex expression MIDI
+@cindex reverb MIDI
+@cindex chorus MIDI
+@funindex midiPanPosition
+@funindex midiBalance
+@funindex midiExpression
+@funindex midiReverbLevel
+@funindex midiChorusLevel
+
+Les différentes propriétés de contexte qui suivent permettnt d'appliquer
+différents effets MIDI aux notes contenues dans le canal MIDI associé à
+la portée courante, à l'instrument ou à la voix, selon la valeur
+affectée à la propriété de contexte @code{Score.midiChannelMapping} et
+le contexte dans lequel le @code{Staff_performer} réside -- voir
+@ref{Affectation des canaux MIDI}.
+
+Une adaptation de ces propriétés de contexte affectera toutes les notes
+jouées sur ce canal dès leur modification. Certains effets pourront
+même s'appliquer sur des notes déjà en cours, selon l'implémentation du
+périphérique de sortie MIDI.
+
+LilyPond dispose des propriétés de contexte suivantes :
-Nous allons, dans l'exemple suivant, régler le volume relatif de la
-flûte et de la clarinette -- au même niveau que dans le précédent.
+@table @var
-@lilypond[verbatim,quote]
-#(define my-instrument-equalizer-alist '())
+@item @code{Staff.midiPanPosition}
-#(set! my-instrument-equalizer-alist
- (append
- '(
- ("flute" . (0.7 . 0.9))
- ("clarinet" . (0.3 . 0.6)))
- my-instrument-equalizer-alist))
+La spatialisation (@emph{pan position}) contrôle le positionnement d'un
+canal MIDI entre les sorties stéréo droite et gauche. Cette propriété
+de contexte prend en argument une valeur entre -1.0 (@code{#LEFT})
+et 1.0 (@code{#RIGHT}). Une valeur de -1.0 enverra toute la puissance
+sonore sur le haut-parleur gauche (le droit sera silencieux), une
+vaaleur de 0.0 (@code{#CENTER}) distribuera équitablement le son entre
+les jaut-parleurs de gauche et de droite, et une valeur de 1.0 enverra
+tout le son sur le haut-parleur de droite. Des valeurs entre -1.0 et
+1.0 permettent d'obtenir une répartition du son entre les sorties
+gauche et droite d'un équipement stéréophonique.
-#(define (my-instrument-equalizer s)
- (let ((entry (assoc s my-instrument-equalizer-alist)))
- (if entry
- (cdr entry))))
-\score {
- <<
- \new Staff {
- \key g \major
- \time 2/2
- \set Score.instrumentEqualizer = #my-instrument-equalizer
- \set Staff.midiInstrument = #"flute"
- \new Voice \relative c''' {
- r2 g\mp g fis~
- fis4 g8 fis e2~
- e4 d8 cis d2
- }
- }
- \new Staff {
- \key g \major
- \set Staff.midiInstrument = #"clarinet"
- \new Voice \relative c'' {
- b1\p a2. b8 a
- g2. fis8 e
- fis2 r
- }
- }
- >>
- \layout { }
- \midi {
- \tempo 2 = 72
- }
-}
-@end lilypond
+@item @code{Staff.midiBalance}
-@ignore
-@c Delete when satisfied this is adequately covered elsewhere -td
+La balance stéréo d'un canal MIDI. Tout comme la spatialisation, cette
+propriété de contexte prend en argument une valeur comprise entre -1.0
+(@code{#LEFT}) et 1.0 (@code{#RIGHT}). Elle permet de faire varier le
+volume relatif envoyé aux deux haut-parleurs stéréo sans pour autant
+affecter la distribution des signaux stéréo.
-@n ode Microtones in MIDI
-@s ubsection Microtones in MIDI
+@item @code{Staff.midiExpression}
-@cindex microtones in MIDI
+Le niveau d'expression, en tant que fraction du niveau maximum de volume
+disponible, à appliquer à un canal MIDI. Un périphérique MIDI combine
+le niveau d'expression des canaux MIDI et le niveau de nuance de la voix
+en cours (tel que défini par @code{\p} ou @code{\ff}) afin d'obtenir le
+volume total de chacune des notes de la voix. Un contrôle de
+l'expression permet, par exemple, d'implémenter des effets de crescendo
+ou decrescendo sur une note tenue, ce que LilyPond ne sait pas faire
+automatiquement.
-Microtones consisting of half sharps and half flats are exported
-to the MIDI file and render correctly in MIDI players which support
-pitch bending. See @ref{Note names in other languages}. Here is
-an example showing all the half sharps and half flats. It can be
-copied out and compiled to test microtones in your MIDI player.
+@c Issue 4059 contains an attached snippet which shows how this might
+@c be done, but this is too large and complex for the NR, even as a
+@c referenced snippet. It could be added to the LSR.
-@lilypond[verbatim,quote]
-\score {
- \relative c' {
- c4 cih cis cisih
- d4 dih ees eeh
- e4 eih f fih
- fis4 fisih g gih
- gis4 gisih a aih
- bes4 beh b bih
- }
- \layout {}
- \midi {}
-}
-@end lilypond
-@end ignore
+Le niveau d'expression varie entre 0.0 (sans expression, autrement dit
+volume à zéro) et 1.0 (volume au maximum).
+@item @code{Staff.midiReverbLevel}
-@node MIDI et percussions
-@subsection MIDI et percussions
-@translationof Percussion in MIDI
+Le niveau de réverbération, en tant que fraction du niveau maximum
+disponible, à appliquer à un canal MIDI. Cette propriété prend en
+argument une valeur entre 0.0 (pas d'écho) et 1.0 (effet maximal).
-La notation pour percussions recourt généralement à un contexte
-particulier -- le @code{DrumStaff} -- qui permet d'affecter directement
-les instruments concernés au canal 10 qui leur est réservé.
+@item @code{Staff.midiChorusLevel}
-Certains instruments, tels le xylophone, le marimba, le vibraphone ou
-les timbales, se traitent cependant comme des instruments
-@qq{classiques} puisqu'ils sont capables d'émettre des hauteurs
-différentes ; leurs notation relève donc d'un contexte @code{Staff}
-standard, et non d'un @code{DrumStaff} pour pouvoir être rendus
-correctement en MIDI.
+Le niveau de chœur, en tant que fraction du niveau maximum disponible, à
+appliquer à un canal MIDI. Cette propriété prend en argument une valeur
+entre 0.0 (pas de chorus) et 1.0 (effet maximal).
-D'autres percussions, bien que n'émettant qu'un seul son et inclus dans
-le standard @emph{general MIDI}, comme le tom mélodique ou le tambour
-taiko, ne sont pas attachés au canal 10. Ces instruments doivent
-donc être saisi dans un contexte @code{Staff}, en utilisant la hauteur
-appropriée.
+@end table
-De nombreux instruments de la famille des percussions, les castagnettes
-par exemple, n'existent pas dans le standard @emph{general MIDI}.
-L'alternative, bien que peu satisfaisante, consiste à leur attribuer le
-son le plus proche dans la banque standard.
+@knownissues
-@c TODO Expand with examples, and any other issues
+Dans la mesure où les fichiers MIDI ne comportent effectivement aucune
+donnée audio, les modifications des propriétés de contexte ne se
+traduisent qu'en requêtes de changement des contrôles du canal MIDI
+lorsque ces fichiers MIDI sont joués. La manière dont un périphérique
+MIDI particulier, tel un synthétiseur MIDI logiciel, gérera ces
+requêtes incluses dans un fichier MIDI dépend complètement de
+l'implémentation du périphérique : certains d'entre eux pourront
+simplement ignorer plusieurs, voire toutes ces requêtes. Par ailleurs,
+la manière dont un périphérique MIDI interprète les différentes valeurs
+de ces contrôles (en règle générale, le standard MIDI ne fixe le
+comportement qu'aux valeurs extrêmes de l'amplitude disponible pour
+chacun des contrôles) et leur modification alors qu'une note sur un
+canal est tenue, dépend de l'implémentation particulière à ce
+périphérique.
+
+Lors de la génération d'un fichier MIDI, LilyPond transforme simplement
+les valeurs fractionnaires dans l'amplitude linéaire en valeurs entières
+correspondantes (de 0 à 127 et sur 7 octets, ou de 0 à 32767 et sur 14
+octets pour les contrôles MIDI supportant une résolution fine). Ces
+valeurs entières converties sont stockées telles quelles dans le
+fichier MIDI généré. Pour plus d'information sur la manière dont un
+périphérique MIDI interprète ces valeurs, se reporter à sa
+documentation.
+
+
+@node Amélioration du rendu MIDI
+@subsection Amélioration du rendu MIDI
+@translationof Enhancing MIDI output
+
+Le fichier MIDI généré par LilyPond est relativement brut. Il peut
+toutefois être amélioré en affectant des instruments MIDI, en réglant
+des propriétés au sein du bloc @code{\midi} ou en utilisant le script
+@file{articulate}.
-@knownissues
-Le standard @emph{general MIDI} ne dispose pas du @emph{rim shot} ;
-LilyPond lui substitue un @emph{sidestick}.
+@menu
+* Le script articulate::
+@end menu
-@node Le script Articulate
-@subsection Le script Articulate
-@translationof The Articulate script
+@node Le script articulate
+@unnumberedsubsubsec Le script @file{articulate}
+@translationof The articulate script
-Vous obtiendrez un rendu MIDI plus @qq{réaliste} grâce au script
-@code{articulate}. Celui-ci va tout faire pour d'une part prendre en
-compte les articulations (liaisons, staccato etc.) -- en ajoutant un
-blanc aux notes raccourcies -- et, d'autre part, développer les trilles
-ou groupettos ainsi que tenir compte des éventuels rallentando et
-accelerando.
+@cindex MIDI, instruments
+@cindex articulate, script
+@funindex Staff.midiInstrument
-L'utilisation du script @code{articulate} se fait en deux temps. Vous
-devez dans un premier temps inclure son fichier d'initialisation en
-ajoutant en tête de votre fichier la ligne
+L'utilisation du script @file{articulate} se fait après avoir ajouté en
+tête de fichier la commande @code{\include} appropriée :
@example
\include "articulate.ly"
@end example
-puis, dans le bloc @code{\score}, indiquer que toutes les répétitions
-seront développées et appliquer la commande à votre musique :
+Le script créera une sortie MIDI dont les notes seront échelonées de
+sorte à tenir compte de toute articulation ou changement de tempo. La
+sortie imprimable sera toutefois modifiée en profondeur, pour refléter
+littéralement la sortie MIDI.
@example
-\unfoldRepeats \articulate <<
- tout le reste du bloc contenant la partition...
->>
+\score @{
+ \articulate <<
+ @var{@dots{} musique @dots{}}
+ >>
+ \midi @{ @}
+@}
@end example
-Une fois votre fichier modifié de la sorte, vous constaterez que la
-version imprimable aura été modifiée en profondeur. Le bloc
-@code{\midi} produira par contre un fichier MIDI de bien meilleure
-qualité.
+Le script @file{articulate} tient compte des abréviations telles que les
+trilles ou groupettos. L'intégralité des éléments traités est
+répertoriée dans le script lui-même -- voir @file{ly/articulate.ly}.
-Bien que cela ne gène en rien le fonctionnement du script
-@code{articulate}, lui adjoindre la commande @code{\unfoldRepeats} comme
-illustré ci-dessus permettra le rendu d'un certain nombre
-d'articulations tels les trilles.
+@seealso
+Manuel d'initiation :
+@rlearning{Autres sources de documentation}.
-@knownissues
-Dans la mesure où le script @code{articulate} tend à raccourcir les
-accords, certaines musiques, notamment pour l'orgue, paraîtront de moins
-bonne qualité.
+Manuel de notation :
+@ref{Mise en forme de la partition}.
+
+Fichiers d'initialisation :
+@file{ly/articulate.ly}.
+
+@warning{Dans la mesure où le script @file{articulate} tend à raccourcir
+les accords, certaines musiques, notamment pour l'orgue, paraîtront de
+moins bonne qualité. Les notes dépourvues d'articulation peuvent aussi
+se voir raccourcies ; pour pallier cet inconvénient, le recours à la
+fonction @code{@bs{}articulate} devrait ne concerner que de courts
+fragments, sauf à modifier les valeurs des variables contenues dans le
+script @file{articulate}.}
@node Extraction d'informations musicales
affichera
@example
-@{ a,4 cis e fis g @}
+@{ a,4 cis4 e4 fis4 g4 @}
@end example
LilyPond affichera le résultat sous forme de message en console, au
milieu de toutes les informations de compilation. Afin d'isoler ces
messages et enregistrer le résultat de la fonction
-@code{\display@{MATÉRIAU@}}, pensez à rediriger la sortie vers un
-fichier.
+@code{\displayLilyMusic}, pensez à rediriger la sortie vers un fichier.
@example
lilypond fichier.ly > affichage.txt
Vous noterez que LilyPond ne se contente pas de simplement afficher
l'expression musicale, mais procède aussi à son interprétation -- du
fait que @code{\displayLilyMusic} renvoie l'expression tout en
-l'affichant. S'il est bien pratique d'insérer un
-@code{\displayLilyMusic} dans une expression musicale pour en obtenir
-des informations, l'interprétation de cette expression peut toutefois
-être évitée en ajoutant un @code{\void} avant l'instruction :
+l'affichant. La simple insertion d'un @code{\displayLilyMusic} dans une
+expression musicale permet d'obtenir l'information la concernant.
+
+Si l'instruction @code{\displayLilyMusic} interprète et affiche des
+informations sur un fragment, la faire précéder d'un @code{\void} aura
+pour effet de l'exclure du fichier résultant.
@example
@{
\void \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
+ c1
@}
@end example
nombre de paramètres optionnels.
@example
-@var{temps} @var{type} @var{...paramètres...}
+@var{temps} @var{type} @var{@dots{}paramètres@dots{}}
@end example
Ces informations peuvent faire l'objet d'un retraitement par d'autres
projects / lilypond.git / blobdiff