1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
4 Translation of GIT committish: 3b8f430efd506ccd6ae8235be0f08468c0da937d
6 When revising a translation, copy the HEAD committish of the
7 version that you are working on. For details, see the Contributors'
8 Guide, node Updating translation committishes..
13 @c Translators: Jean-Charles Malahieude, Valentin Villenave
15 @node Généralités en matière d'entrée et sortie
16 @chapter Généralités en matière d'entrée et sortie
17 @translationof General input and output
19 Nous n'allons pas, dans ce chapitre, parler directement de notation,
20 mais plutôt du contenu des fichiers source et du résultat produit par
25 * Agencement du code::
27 * Travail sur des fichiers texte::
28 * Contrôle des sorties::
30 * Extraction d'informations musicales::
33 @node Agencement du code
34 @section Agencement du code
35 @translationof Input structure
37 LilyPond traite des fichiers textuels. Ces fichiers portent par
38 convention une extension @code{.ly}.
41 * Structure d'une partition::
42 * Plusieurs partitions dans un même ouvrage::
43 * Plusieurs éditions pour une même source::
44 * Nom des fichiers de sortie::
45 * Structure de fichier::
49 @node Structure d'une partition
50 @subsection Structure d'une partition
51 @translationof Structure of a score
55 Un bloc @code{\score} contient obligatoirement une seule expression
56 musicale délimitée par des accolades@tie{}:
64 @warning{Il ne doit y avoir qu'@strong{une seule} expression musicale
65 globale dans un bloc @code{@bs{}score}, et elle @strong{doit} être
66 bornée par une paire d'accolades.}
68 Cette unique expression musicale peut être de n'importe quelle taille et
69 contenir d'autres expressions musicales aussi complexes soient elles.
70 Voici quelques exemples d'expression musicale@tie{}:
76 @lilypond[verbatim,quote]
83 @lilypond[verbatim,quote]
85 \new Staff { c'4 c' c' c' }
86 \new Staff { d'4 d' d' d' }
94 \new Staff @{ \flute @}
95 \new Staff @{ \hautbois @}
98 \new Staff @{ \violonI @}
99 \new Staff @{ \violonII @}
105 Les commentaires constituent l'une des rares exceptions à cette règle
106 immuable -- voir @ref{Structure de fichier} pour les autres. Qu'il
107 s'agisse d'une seule ligne ou de tout un bloc -- délimité par @code{%@{
108 .. %@}} -- un commentaire peut se placer n'importe où dans le fichier
109 source, aussi bien à l'intérieur qu'à l'extérieur du bloc @code{\score},
110 ou encore à l'intérieur ou à l'extérieur de l'expression musicale
111 contenue dans un bloc @code{\score}.
113 Lorsqu'un fichier ne comprend qu'un bloc @code{\score}, celui-ci est
114 implicitement inclus dans un bloc @code{\book}. Le bloc @code{\book}
115 d'un fichier source permet la production d'au moins un fichier dont le
116 nom sera, par défaut, déduit du fichier source@tie{}: le traitement de
117 @file{fandangopourelephants.ly} produira donc
118 @file{fandangopourelephants.pdf}.
120 Pour de plus amples informations à propos du bloc @code{\book}, lisez
121 @ref{Plusieurs partitions dans un même ouvrage},
122 @ref{Plusieurs éditions pour une même source} et
123 @ref{Structure de fichier}.
126 Manuel d'initiation :
127 @rlearning{Travail sur les fichiers d'entrée},
128 @rlearning{Les expressions musicales en clair},
129 @rlearning{La partition est une (unique) expression musicale composée}.
132 @node Plusieurs partitions dans un même ouvrage
133 @subsection Plusieurs partitions dans un même ouvrage
134 @translationof Multiple scores in a book
136 @cindex mouvements, plusieurs
137 @cindex plusieurs mouvements
141 Un ouvrage peut se composer de plusieurs morceaux et de texte. C'est le
142 cas des cahiers d'exercices ou d'une partie d'orchestre avec ses
143 différents mouvements. Chaque mouvement fait l'objet d'un bloc
152 et le texte est contenu dans un bloc @code{\markup},
162 Les différents mouvements et textes qui apparaissent dans un même
163 fichier @file{.ly} ne composeront en principe qu'un seul fichier
178 Attention cependant si vous travaillez avec lilypond-book@tie{}: il vous
179 faudra explicitement mentionner le bloc @code{\book}, en l'absence de
180 quoi seul le premier @code{\score} ou @code{\markup} apparaîtra après
183 L'entête de chaque pièce peut se placer au sein du bloc
184 @code{\score}@tie{}; le contenu du champ @code{piece} viendra s'imprimer
185 avant chaque mouvement. De même, le titre de l'ouvrage peut se placer
186 au sein du bloc @code{\book}. Dans le cas contraire, le contenu du bloc
187 @code{\header} placé en début de fichier sera utilisé.
191 title = "Huit miniatures"
192 composer = "Igor Stravinsky"
196 \header @{ piece = "Romance" @}
199 ..texte du second couplet..
202 ..texte du troisième couplet..
206 \header @{ piece = "Menuet" @}
212 Plusieurs pièces seront regroupées dans un même @qq{chapitre} à l'aide
213 d'un bloc @code{\bookpart}. Ces différents @qq{chapitres} sont séparés
214 par un saut de page et peuvent comporter un titre à l'instar de
215 l'ouvrage dès lors que vous y insérez un bloc @code{\header}.
220 title = "Titre de l'ouvrage"
221 subtitle = "Première partie"
228 subtitle = "Deuxième partie"
236 @node Plusieurs éditions pour une même source
237 @subsection Plusieurs éditions pour une même source
238 @translationof Multiple output files from one input file
240 Dès lors que vous inscrivez plusieurs blocs @code{\book} dans un même
241 fichier @file{.ly}, chacun d'eux donnera lieu à un résultat indépendant.
242 Lorsqu'aucun bloc @code{\book} n'est spécifié dans le fichier source,
243 LilyPond considère que l'intégralité du fichier constitue un bloc
244 @code{\book} unique, comme indiqué à la rubrique
245 @ref{Structure de fichier}.
247 LilyPond fait en sorte, lorsque plusieurs fichiers sont produits à
248 partir d'une même source, qu'aucun résultat d'un bloc @code{\book}
249 n'écrase celui qui a été généré pour un bloc @code{\book} précédent.
251 Dans les faits, et si le nom du fichier produit est repris de sa source
252 -- comportement par défaut --, un suffixe lui sera ajouté pour chaque
253 @code{\book}. Il s'agit en principe d'un pseudo numéro de version.
254 Ainsi, le fichier @file{huitminiatures.ly} qui contiendrait
259 \layout @{ @dots{} @}
263 \layout @{ @dots{} @}
267 \layout @{ @dots{} @}
275 @file{huitminiatures.pdf},
277 @file{huitminiatures-1.pdf} et
279 @file{huitminiatures-2.pdf}.
283 @node Nom des fichiers de sortie
284 @subsection Nom des fichiers de sortie
285 @translationof Output file names
287 LilyPond vous permet de prendre le contrôle dans la dénomination des
288 fichiers que vous voulez générer, quel que soit le moteur de rendu
291 Nous avons vu dans la rubrique précédente que LilyPond évite les
292 conflits de nom des fichiers qu'il génère à partir d'une même source.
293 Vous pouvez même définir vous-même le suffixe qui sera appliqué à chacun
294 des blocs @code{\book}. Ainsi, en reprenant l'exemple ci-avant, vous
295 obtiendrez les fichiers @file{huitminiatures-Romance.pdf},
296 @file{huitminiatures-Menuet.pdf} et @file{huitminiatures-Nocturne.pdf}
297 en ajoutant simplement une déclaration @code{\bookOutputSuffix} au sein
298 de chaque bloc @code{\book}.
302 \bookOutputSuffix "Romance"
304 \layout @{ @dots{} @}
307 \bookOutputSuffix "Menuet"
309 \layout @{ @dots{} @}
312 \bookOutputSuffix "Nocturne"
314 \layout @{ @dots{} @}
318 La déclaration @code{\bookOutputName} vous permet de définir vous-même
319 le nom du fichier généré pour un bloc @code{\book}@tie{}:
323 \bookOutputName "Romance"
325 \layout @{ @dots{} @}
328 \bookOutputName "Menuet"
330 \layout @{ @dots{} @}
333 \bookOutputName "Nocturne"
335 \layout @{ @dots{} @}
339 Le traitement de ce fichier produira@tie{}:
351 @node Structure de fichier
352 @subsection Structure de fichier
353 @translationof File structure
363 Un fichier @code{.ly} peut contenir un certain nombre d'expression de
364 haut niveau. Les expressions de haut niveau sont les suivantes@tie{}:
368 Une définition de sortie, comme @code{\paper}, @code{\midi} et
369 @code{\layout}. Ces définitions, lorsqu'elles se trouvent à un niveau
370 supérieur, s'appliqueront à l'intégralité de l'ouvrage. Si l'une de ces
371 expression apparaît à plusieurs reprises, la dernière aura préséance.
374 Une expression scheme pure, telle que
375 @w{@code{#(set-default-paper-size@tie{}"a7"@tie{}'landscape)}} ou
376 @w{@code{#(ly:set-option@tie{}'point-and-click@tie{}#f)}}.
379 Un bloc @code{\header}, dont le contenu sera de portée globale -- ce qui
380 est le cas en général pour le titre ou l'auteur entre autres.
383 Un bloc @code{\score} pour la partition. Cette partition sera assemblée
384 avec les autres partitions se trouvant au même niveau pour composer le
385 @code{\book}. Vous pouvez modifier ce comportement à l'aide de la
386 variable @code{toplevel-score-handler} placée en tête.
388 @c FIXME - I cannot read "toplevel-score-handler" in scm/lily.scm -jcm
389 The default handler is defined in the init file @file{../scm/lily.scm}.
393 Un bloc @code{\book} permet de regrouper naturellement plusieurs
394 mouvements -- autrement dit plusieurs blocs @code{\score} -- dans un
395 même document. Lorsqu'il y a plusieurs @code{\score}s, LilyPond génère
396 un seul fichier dans lequel les mouvements sont mis les uns à la suite
397 des autres, ce pour chacun des blocs @code{\book} rencontrés. La seule
398 raison qui peut vous demander d'expliciter plusieurs blocs @code{\book}
399 dans un fichier @file{.ly} est lorsque vous avez besoin de générer
400 différents documents à partir d'une même source. La présence explicite
401 d'un bloc @code{\book} est aussi nécessaire lorsque vous travaillez sur
402 un document lilypond-book qui reprendrait plusieurs @code{\score}s ou
403 @code{\markup}s dans un même extrait. Vous pouvez modifier ce
404 comportement à l'aide de la variable @code{toplevel-book-handler}
407 @c FIXME - I cannot read "toplevel-book-handler" in scm/lily.scm -jcm
408 The default handler is defined in the init file @file{../scm/lily.scm}.
412 Un bloc @code{\bookpart}. Un ouvrage peut se découper en plusieurs
413 parties à l'aide de blocs @code{\bookpart}, aussi bien pour alléger le
414 travail de l'algorithme de calcul des sauts de page, que si les réglages
415 du bloc @code{\paper} diffèrent d'une partie à l'autre.
418 Une expression musicale telle que
423 Ce bout de code sera placé dans un @code{\score} et intégré à l'ouvrage
424 en même temps que tous les autres @code{\score}s ou expressions
425 musicales. En d'autres termes, un fichier qui ne contiendrait que cette
426 simple expression musicale sera traduit en
443 Vous pouvez modifier ce comportement à l'aide de la variable
444 @code{toplevel-music-handler} placée en tête.
446 @c FIXME - I cannot read "toplevel-music-handler" in scm/lily.scm -jcm
447 The default handler is defined in the init file @file{../scm/lily.scm}.
451 Du texte sous forme de @emph{markup} comme les paroles d'un couplet
454 2. Le première ligne du deuxième couplet.
458 De tels @emph{markups} seront imprimés là où ils apparaissent,
459 avant, après ou entre les expressions musicales.
462 @cindex identificateurs
465 Une variable, ou identificateur, telle que
467 toto = @{ c4 d e d @}
470 Vous pourrez la réutiliser plus loin dans votre fichier en saisissant
471 simplement @code{\toto}. Le nom des indentificateurs ne doit être
472 formés que de caractères alphabétiques -- sans chiffre ni caractère
477 Voici trois éléments que vous pouvez placer à un niveau supérieur@tie{}:
481 % pas en pleine largeur
492 Vous pouvez placer, n'importe où dans votre fichier, les instructions
496 @item @code{\version}
497 @item @code{\include}
498 @item @code{\sourcefilename}
499 @item @code{\sourcefileline}
501 Une ligne de commentaire, introduite par le signe @code{%}.
504 Un bloc de commentaire, délimité par @code{%@{ .. %@}}.
511 Vous pouvez insérer des espaces dans votre fichier source afin de lui
512 apporter une meilleure lisibilité. Les espaces superflus sont
513 normalement ignorés. Notez cependant qu'il est des cas où l'espace est
514 requis pour éviter tout risque d'erreur@tie{}:
518 Autour d'une accolade, qu'elle soit ouvrant ou fermante ;
521 Après chaque commande ou variable, autrement dit tout élément qui
522 commence par un @code{\}@tie{};
525 Après tout élément qui sera interprété comme une expression Scheme,
526 autrement dit tout élément qui commence par un @code{#}@tie{};
529 Pour séparer les éléments d'une expression Scheme ;
532 En mode parole -- @code{lyricmode} -- pour séparer les termes des
533 commandes @code{\override} et @code{\set}. Précisons à ce sujet qu'en
534 plus d'ajouter une espace avant et après l'intégralité de la commande,
535 vous devrez encadrer d'espaces le point et le signe égal qu'elle peut
537 @w{@code{\override Score . LyricText #'font-size = #5}}.
543 Manuel d'initiation :
544 @rlearning{Organisation des fichiers LilyPond}.
547 @node Titres et entêtes
548 @section Titres et entêtes
549 @translationof Titles and headers
551 La plupart de la musique qui est éditée comporte un titre et le nom de
552 son compositeur@tie{}; certains ouvrages divulguent beaucoup plus
556 * Création de titres et entête ou pied de page::
557 * Titrages personnalisés::
558 * Référencement des numéros de page::
559 * Table des matières::
563 @node Création de titres et entête ou pied de page
564 @subsection Création de titres et entête ou pied de page
565 @translationof Creating titles headers and footers
568 * Contenu des blocs de titrage::
569 * Mise en forme par défaut des titrages::
570 * Mise en forme par défaut des entête et pied de page::
574 @node Contenu des blocs de titrage
575 @unnumberedsubsubsec Contenu des blocs de titrage
576 @translationof Title blocks explained
578 @c TODO: figure out how \bookpart titles work
580 Il existe en fait deux types de blocs de titrage@tie{}: un bloc pour
581 contenir le titre principal qui doit apparaître avant le tout premier
582 @code{\score} d'un ouvrage, et un autre attaché à chacun des blocs
583 @code{\score} qui le composent. Dans les deux cas, les champs qui
584 composent un bloc de titrage se saisissent dans un bloc @code{\header}.
586 Lorsque l'ouvrage ne comporte qu'un seul morceau, le bloc @code{\header}
587 peut se placer en dehors ou au sein même du bloc @code{\score}.
589 Dans le cas où le bloc @code{\header} est défini à l'intérieur du bloc
590 @code{\score}, seuls les champs @code{piece} et @code{opus} seront
593 @lilypond[papersize=a5,quote,verbatim,noragged-right]
597 title = "title" % not printed
604 @funindex print-all-headers
606 Vous pouvez modifer ce comportement et imprimer tous les champs d'un
607 bloc @code{\header} défini dans un bloc @code{\score} en ajoutant
611 print-all-headers = ##t
615 @warning{N'oubliez pas que lorsqu'il est placé à l'intérieur d'un bloc
616 @code{@bs{}score}, le bloc @code{@bs{}header} doit impérativement se
617 trouver @strong{à la suite} de l'expression musicale.}
619 @lilypond[papersize=a5,quote,verbatim,noragged-right]
622 composer = "J. S. Bach."
626 \new Staff \relative g, {
629 \repeat unfold 2 { g16( d' b') a b d, b' d, } |
630 \repeat unfold 2 { g,16( e' c') b c e, c' e, } |
638 \new Staff \relative b {
642 <g, d' b'~>4 b'16 a( g fis) g( d e fis) g( a b c) |
643 d16( b g fis) g( e d c) b(c d e) fis( g a b) |
651 Tous les champs appartenant au titrage principal d'un ouvrage peuvent se
652 reporter dans chaque bloc @code{\score} ou être supprimés
656 @lilypond[papersize=a5,quote,verbatim,noragged-right]
659 print-all-headers = ##t
662 title = "DAS WOHLTEMPERIRTE CLAVIER"
664 % Pas de pied en dernière page pour ce livret
667 \markup { \vspace #1 }
671 \new Staff { \clef "bass" s1 }
674 title = "PRAELUDIUM I"
676 % Pas de sous-titre pour ce morceau
683 \new Staff { \clef "bass" s1 }
687 subsubtitle = "A 4 VOCI"
689 % Pas de sous-titre pour ce morceau
698 @ref{Structure de fichier},
699 @ref{Mise en forme personnalisée des blocs de titrage}.
702 @node Mise en forme par défaut des titrages
703 @unnumberedsubsubsec Mise en forme par défaut des titrages
704 @translationof Default layout of book and score title blocks
706 La mise en forme des blocs de titrage est contrôlée par deux variables
707 attachées au bloc @code{\paper}@tie{}: @code{bookTitleMarkup} pour le
708 bloc @code{\header} principal, et @code{scoreTitleMarkup} pour les blocs
709 @code{\header} relevant des blocs @code{\score}.
712 @lilypond[papersize=a6,quote,verbatim,noragged-right]
714 % Les champs suivants sont centrés
715 dedication = "Dédice"
717 subtitle = "Sous-titre"
718 subsubtitle = "Sous-sous-titre"
719 instrument = "Instrument"
721 % Les champs suivants sont alignés sur le bord gauche
725 % Les champs suivants sont alignés sur le bord droit
726 composer = "Compositeur"
727 arranger = "Arrangeur"
733 % Les champs suivants sont en opposition sur la même ligne
740 @c Is the bit about \null markups true? -mp
742 Les champs d'un bloc @code{\header} qui n'auront pas été alimentés
743 seront remplacés par un @emph{markup} @code{\null} de façon à ne pas
746 Par défaut, @code{scoreTitleMarkup} place les champs @code{piece} et
747 @code{opus} de part et d'autre sur une même ligne.
751 La variable @code{breakbefore} activée dans un bloc @code{\header} situé
752 dans un bloc @code{\score} force le saut de page avant le morceau
753 contenu dans ce @code{\score}. Vous pourrez ainsi séparer le titre
754 principal de la musique.
756 @lilypond[papersize=a8landscape,verbatim,noragged-right]
759 title = "This is my Title"
760 subtitle = "This is my Subtitle"
761 copyright = "This is the bottom of the first page"
764 \repeat unfold 4 { e'' e'' e'' e'' }
766 piece = "This is the Music"
774 Manuel d'initiation :
775 @rlearning{Organisation des fichiers LilyPond}.
778 @ref{Structure de fichier}.
780 Fichiers d'initialisation :
781 @file{ly/titling-init.ly}.
784 @node Mise en forme par défaut des entête et pied de page
785 @unnumberedsubsubsec Mise en forme par défaut des entête et pied de page
786 @translationof Default layout of headers and footers
788 Les entête et pied -- @emph{headers} et @emph{footers} -- sont des
789 lignes de textes qui apparaîssent en haut et en bas de chaque page,
790 indépendamment du texte de l'ouvrage. Ils sont contrôlés par les
791 variables suivantes, attachées au bloc @code{\paper}@tie{}:
794 @item @code{oddHeaderMarkup} -- entête de page impaire
795 @item @code{evenHeaderMarkup} -- entête de page paire
796 @item @code{oddFooterMarkup} -- pied de page impaire
797 @item @code{evenFooterMarkup} -- pied de page paire
800 Ces variables @emph{markup} n'accèdent qu'au contenu des champs du bloc
801 @code{\header} principal, celui qui s'appliquera à tous les blocs
802 @code{\score} du document. Ces variables sont définies dans le fichier
803 @file{ly/titling-init.ly}, et sont par défaut@tie{}:
808 les numéros sont placés en haut à gauche (si pair) ou à droite (si
809 impair) de chaque page à compter de la deuxième@tie{};
812 le contenu du champ @code{instrument} est centré en haut de chaque page
813 à compter de la deuxième@tie{};
816 le texte du @code{copyright} est centré au bas de la première
820 le @code{tagline} -- mention spéciale -- se place au bas de la dernière
821 page, ou bien sous le @code{copyright} s'il n'y a qu'une seule page.
825 @lilypond[papersize=a8landscape]
835 La mention spéciale se modifie en alimentant le champ @code{tagline} au
836 niveau du bloc @code{\header} principal.
838 @lilypond[papersize=a8landscape,verbatim]
841 tagline = "... music notation for Everyone"
851 Pour supprimer le @code{tagline}, il suffit de lui assigner la valeur
855 @node Titrages personnalisés
856 @subsection Titrages personnalisés
857 @translationof Custom headers footers and titles
859 @c TODO: somewhere put a link to header spacing info
860 @c (you'll have to explain it more in NR 4).
863 * Mise en forme personnalisée des champs de titrage::
864 * Mise en forme personnalisée des blocs de titrage::
865 * Mise en forme personnalisée des entête et pied de page::
869 @node Mise en forme personnalisée des champs de titrage
870 @unnumberedsubsubsec Mise en forme personnalisée des champs de titrage
871 @translationof Custom text formatting for title blocks
873 Toutes les commandes de mise en forme d'un @code{\markup} permettent de
874 personnaliser le texte des entête, pied de page et éléments de titre
875 contenus dans un bloc @code{\header}.
877 @lilypond[quote,verbatim,noragged-right]
881 piece = \markup { \fontsize #4 \bold "PRAELUDIUM I" }
882 opus = \markup { \italic "(Excerpt)" }
889 @ref{Mise en forme du texte}.
892 @node Mise en forme personnalisée des blocs de titrage
893 @unnumberedsubsubsec Mise en forme personnalisée des blocs de titrage
894 @translationof Custom layout for title blocks
896 L'utilisation de commandes @code{\markup} au sein d'un bloc
897 @code{\header} permet de modifier aisément l'apparence du texte,
898 mais n'influence en rien le positionnement précis des éléments de
899 titrage. L'accès au positionnement des champs de titrage est géré par
900 les deux variables suivantes, attachées au bloc @code{\paper}@tie{}:
903 @item @code{bookTitleMarkup}
904 @item @code{scoreTitleMarkup}
907 Ces variables sont abordées à la rubrique
908 @ref{Mise en forme par défaut des titrages}.
910 Voici les réglages par défaut de @code{scoreTitleMarkup}, tels que
911 définis dans le fichier @file{ly/titling-init.ly}@tie{}:
914 scoreTitleMarkup = \markup @{ \column @{
915 \on-the-fly #print-all-headers @{ \bookTitleMarkup \hspace #1 @}
917 \fromproperty #'header:piece
918 \fromproperty #'header:opus
924 Ceci aura donc pour effet de positionner les champs @code{piece} et
925 @code{opus} sur la même ligne, en opposition@tie{}:
927 @lilypond[quote,verbatim,noragged-right]
931 piece = "PRAELUDIUM I"
937 Voici comment positionner le champ @code{piece}, dont nous modifions
938 la taille et la graisse, au centre de cette ligne@tie{}:
940 @lilypond[papersize=a5,quote,verbatim,noragged-right]
944 scoreTitleMarkup = \markup {
947 \fontsize #4 \bold \fromproperty #'header:piece
948 \fromproperty #'header:opus
952 \header { tagline = ##f }
956 piece = "PRAELUDIUM I"
963 Les champs normalement réservés au bloc de titrage principal seront
964 reportés au niveau au niveau inférieur dès lors que vous aurez activé
965 l'instruction @code{print-all-headers} au sein du bloc @code{\paper}.
966 Le principal inconvénient de cette fonction réside dans le fait que les
967 champs réservés au bloc @code{\header} principal devront être supprimés
968 dans chacun des blocs @code{\score} de votre fichier source -- voir
969 @ref{Contenu des blocs de titrage}.
971 Afin d'éviter ce désagrément, ajoutez le champ que vous désirez voir
972 apparaître à la définition de @code{scoreTitleMarkup}. Nous allons,
973 dans l'exemple suivant, ajouter au @code{scoreTitleMarkup} le champ
974 @code{composer}, normalement associé au @code{bookTitleMarkup}@tie{};
975 chaque @code{\score} pourra mentionner un compositeur différent.
977 @lilypond[papersize=a5,quote,verbatim,noragged-right]
981 scoreTitleMarkup = \markup {
984 \fontsize #4 \bold \fromproperty #'header:piece
985 \fromproperty #'header:composer
989 \header { tagline = ##f }
994 composer = "Christian Petzold"
1001 composer = "François Couperin"
1007 Rien ne vous empêche de créer votre propre champ personnalisé, puis d'y
1008 faire référence dans la définition du @emph{markup}.
1010 @lilypond[papersize=a5,quote,verbatim,noragged-right]
1014 scoreTitleMarkup = \markup {
1017 \override #`(direction . ,UP) {
1019 \center-align \fontsize #-1 \bold
1020 \fromproperty #'header:mycustomtext %% User-defined field
1021 \center-align \fontsize #4 \bold
1022 \fromproperty #'header:piece
1025 \fromproperty #'header:opus
1029 \header { tagline = ##f }
1034 mycustomtext = "A 4 VOCI" %% User-defined field
1042 Manuel de notation :
1043 @ref{Contenu des blocs de titrage}.
1046 @node Mise en forme personnalisée des entête et pied de page
1047 @unnumberedsubsubsec Mise en forme personnalisée des entête et pied de page
1048 @translationof Custom layout for headers and footers
1050 @c can make-header and make-footer be removed from
1051 @c paper-defaults-init.ly? -mp
1053 L'utilisation de commandes @code{\markup} au sein d'un bloc
1054 @code{\header} permet de modifier aisément l'apparence du texte,
1055 mais n'influence en rien le positionnement précis des entête et pied
1056 de page. L'accès au positionnement des champs concernés est géré par
1057 les quatre variables suivantes, attachées au bloc @code{\paper}@tie{}:
1060 @item @code{oddHeaderMarkup}
1061 @item @code{evenHeaderMarkup}
1062 @item @code{oddFooterMarkup}
1063 @item @code{evenFooterMarkup}
1066 L'exemple suivant illustre la manière de centrer son numéro au bas de
1067 chaque page. Il nous faut tout d'abord annuler la définition de
1068 @code{oddHeaderMarkup} et @code{evenHeaderMarkup} à l'aide d'un
1069 @emph{markup} @code{\null}. Nous redéfinissons ensuite
1070 @code{oddFooterMarkup} pour qu'il contienne le numéro de page, centré.
1071 Enfin, nous appliquons le même paramétrage au @code{\oddFooterMarkup}.
1073 @lilypond[papersize=a8,quote,verbatim,noragged-right]
1076 print-page-number = ##t
1077 print-first-page-number = ##t
1078 oddHeaderMarkup = \markup \null
1079 evenHeaderMarkup = \markup \null
1080 oddFooterMarkup = \markup {
1082 \on-the-fly #print-page-number-check-first
1083 \fromproperty #'page:page-number-string
1086 evenFooterMarkup = \oddFooterMarkup
1089 \new Staff { s1 \break s1 \break s1 }
1095 Manuel de notation :
1096 @ref{Contenu des blocs de titrage},
1097 @ref{Mise en forme par défaut des titrages}.
1100 @node Référencement des numéros de page
1101 @subsection Référencement des numéros de page
1102 @translationof Reference to page numbers
1104 LilyPond vous permet, à l'aide de la commande @code{\label}, d'insérer
1105 des points de référence dans un ouvrage, aussi bien en dehors qu'au fil
1106 de la musique. Ce point de référence pourra être ensuite repris à
1107 l'intérieur d'un @emph{markup}@tie{}; vous pourrez même y ajouter le
1108 numéro de page grâce à la commande de @emph{markup} @code{\page-ref}.
1112 \header { tagline = ##f }
1118 \pageBreak \mark A \label #'markA
1123 \markup { Le premier mouvement débute à la page \page-ref #'firstScore "0" "?" }
1124 \markup { Le repère A est à la page \page-ref #'markA "0" "?" }
1128 L'instruction @code{\page-ref} prend trois arguments@tie{}:
1131 le point de référence, sous la forme d'un symbole scheme, comme par
1132 exemple @code{#'firstScore},
1135 un @qq{emporte-pièce} afin d'estimer la longueur totale du
1139 un texte de remplacement au cas où la référence ne serait pas retrouvée.
1142 La présence de l'emporte-pièce est rendue nécessaire par le fait que les
1143 @emph{markups} sont générés avant que les sauts de page ne soient
1144 positionnés. Bien que le numéro de page en question ne soit pas encore
1145 déterminé, LilyPond doit connaître les dimensions de ce @emph{markup}.
1146 Vous pouvez, lorsque l'ouvrage contiendra plus de dix pages, stipuler un
1147 emporte-pièce sur deux caractères -- soit @code{"00"}.
1158 @node Table des matières
1159 @subsection Table des matières
1160 @translationof Table of contents
1162 La commande @code{\markuplist \table-of-contents} vous permettra de
1163 générer une table des matières. Les éléments qui la composeront sont
1164 créés par la commande @code{\tocItem}, insérée indépendamment ou au sein
1165 d'une expression musicale.
1168 \markuplist \table-of-contents
1171 \tocItem \markup "Premier mouvement"
1175 \tocItem \markup "Passage spécifique du premier mouvement"
1180 \tocItem \markup "Second mouvement"
1188 Les @emph{markups} dévolus à la mise en forme de la table des matières
1189 se définissent dans le bloc @code{\paper}. Il s'agit par défaut de
1190 @code{tocTitleMarkup} pour le titre de la table, et de
1191 @code{tocItemMarkup} pour ses éléments -- composés de leur libellé et
1192 numéro de page. Vous pouvez bien entendu personnaliser ces
1197 %% Translate the toc title into French:
1198 tocTitleMarkup = \markup \huge \column {
1199 \fill-line { \null "Table des matières" \null }
1202 %% use larger font size
1203 tocItemMarkup = \markup \large \fill-line {
1204 \fromproperty #'toc:text \fromproperty #'toc:page
1209 Notez bien la manière de référencer le libellé et le numéro de page dans
1210 la définition de @code{tocItemMarkup}.
1212 N'hésitez pas à définir vous-même d'autres commandes et @emph{markups}
1213 afin de construire une table plus élaborée@tie{}:
1216 commencez par définir une nouvelle variable de type @code{markup} au
1217 sein du bloc @code{\paper},
1220 puis définissez une fonction musicale chargée d'insérer un élément de la
1221 table à partir de cette variable.
1224 Dans l'exemple qui suit, nous avons créé un nouveau style d'élément dans
1225 le but de mentionner les actes dans la table des matières d'un
1230 tocActMarkup = \markup \large \column {
1232 \fill-line { \null \italic \fromproperty #'toc:text \null }
1238 #(define-music-function (parser location text) (markup?)
1239 (add-toc-item! 'tocActMarkup text))
1242 @lilypond[line-width=11.0\cm]
1243 \header { tagline = ##f }
1245 tocActMarkup = \markup \large \column {
1247 \fill-line { \null \italic \fromproperty #'toc:text \null }
1253 #(define-music-function (parser location text) (markup?)
1254 (add-toc-item! 'tocActMarkup text))
1257 \markuplist \table-of-contents
1258 \tocAct \markup { Atto Primo }
1259 \tocItem \markup { Coro. Viva il nostro Alcide }
1260 \tocItem \markup { Cesare. Presti omai l'Egizzia terra }
1261 \tocAct \markup { Atto Secondo }
1262 \tocItem \markup { Sinfonia }
1263 \tocItem \markup { Cleopatra. V'adoro, pupille, saette d'Amore }
1268 L'élément et son numéro de page peuvent se rejoindre par une ligne
1271 @lilypond[verbatim,quote]
1272 \header { tagline = ##f }
1274 tocItemMarkup = \tocItemWithDotsMarkup
1278 \markuplist \table-of-contents
1279 \tocItem \markup { Allegro }
1280 \tocItem \markup { Largo }
1287 Fichiers d'initialisation :
1288 @file{../ly/toc-init.ly}.
1292 @funindex \table-of-contents
1293 @code{\table-of-contents},
1299 @node Travail sur des fichiers texte
1300 @section Travail sur des fichiers texte
1301 @translationof Working with input files
1304 * Insertion de fichiers LilyPond::
1305 * Différentes éditions à partir d'une même source::
1306 * Caractères spéciaux::
1309 @node Insertion de fichiers LilyPond
1310 @subsection Insertion de fichiers LilyPond
1311 @translationof Including LilyPond files
1314 @cindex inclusion de fichiers
1316 Lorsqu'un projet prend de l'importance en volume, il est judicieux de le
1317 scinder en plusieurs fichiers, auxquels vous fereez référence avec un
1321 \include "autrefichier.ly"
1324 Une ligne @code{\include "autrefichier.ly"} dans un fichier revient à
1325 recopier intégralement le contenu de @file{autrefichier.ly} à l'endroit
1326 même ou est placée l'instruction @code{\include}. Vous pouvez par
1327 exemple écrire un fichier individuel par instrument, puis les regrouper
1328 pour former le fichier @qq{conducteur}. Les différentes variables
1329 définies dans les fichiers séparés seront normalement reprises et
1330 utilisables dans le fichier formant le conducteur. Les sections
1331 balisées dans les fichiers individuels peuvent être réutilisées en
1332 différents endroit de la partition , comme expliqué à la rubrique
1333 @ref{Différentes éditions à partir d'une même source}.
1335 Lorsque le fichier auquel il est fait référence se trouve dans le même
1336 répertoire, donner seulement son nom en argument à la commande
1337 @code{\include} suffit. S'il se trouve ailleurs, vous devrez indiquer
1338 le chemin d'accès, absolu ou relatif, en respectant toutefois la syntaxe
1339 UNIX -- autrement dit, le séparateur de répertoire est une oblique
1340 normale @code{/} et non l'oblique inverse @code{\} de DOS ou Windows.
1341 Par exemple, si le fichier @file{truc.ly} se trouve dans le répertoire
1342 supérieur au répertoire de travail, la ligne devra être
1345 \include "../truc.ly"
1349 ou bien, si les fichiers correspondant aux parties d'orchestre se
1350 trouvent dans le sous-répertoire @file{parties} relativement au
1351 répertoire courant, vous devrez mentionner
1354 \include "parties/VI.ly"
1355 \include "parties/VII.ly"
1359 Les fichiers à inclure peuvent eux-même contenir des instructions
1360 @code{\include}. Ces instructions @code{\include} de second niveau ne
1361 pourront, par défaut, être interprétées qu'une fois intégrées dans le
1362 fichier principal@tie{}; leur argument doit donc comporter le chemin
1363 relativement au fichier principal et non par rapport au fichier dans
1364 lequel cette inclusion est mentionnée. Vous pouvez toutefois influer
1365 sur ce comportement à l'aide de l'option @w{@code{-drelative-includes}}
1366 en ligne de commande ou en ajoutant une clause
1367 @code{@w{#(ly:set-option 'relative-includes #t)}} en tête du fichier
1368 principal. Une fois @code{relative-include} activé, le chemin à suivre
1369 pour chacune des commandes @code{\include} sera pris relativement au
1370 fichier qui la contient. Cette option est vouée à être activée par
1371 défaut dans une future version de LilyPond.
1373 Vous pouvez inclure des fichiers dont vous spécifierez le chemin d'accès
1374 sur la ligne de commande au moment de lancer la compilation. L'appel à
1375 ces fichiers ne mentionnerra alors que leur nom. Par exemple, si vous
1376 voulez compiler avec cette méthode le fichier @file{principal.ly} qui
1377 inclut des fichiers situés dans le sous-répertoire @file{parties},
1378 placez vous dans le répertoire contenant @file{principal.ly}, puis tapez
1381 lilypond --include=parties principal.ly
1384 tout en ayant bien dans @file{principal.ly}
1392 Lorsqu'un fichier est voué à être inclus dans nombre de partitions, vous
1393 pouvez le placer dans le répertoire de LilyPond @file{../ly}.
1394 Attention@tie{}: ce répertoire varie selon votre installation, comme
1395 indiqué au chapitre @rlearning{Autres sources de documentation}. Ce
1396 fichier sera inclus dès lors que vous fournirez uniquement son nom en
1397 argument à la fonction @code{\include}. C'est par exemple le cas du
1398 fichier de définition particulier @file{gregorian.ly}.
1400 Au moment où vous lancez LilyPond, un certain nombre de fichiers se
1401 retrouvent inclus par défaut@tie{}; il suffit d'activer le mode verbeux
1402 en faisant @w{@code{lilypond --verbose}} pour s'en rendre compte. Vous
1403 verrez ainsi défiler, en plus de nombreuses informations, le nom d'un
1404 certain nombre de fichiers et de chemins d'accès. Les fichiers les plus
1405 important sont mentionnés au chapitre
1406 @rlearning{Autres sources de documentation}. Si vous venez à les
1407 modifier, rappelez-vous qu'ils seront écrasés à l'installation d'une
1408 nouvelle version de LilyPond.
1410 Vous trouverez quelques exemples simples d'utilisation de la commande
1411 @code{\include} au chapitre @rlearning{Conducteurs et parties}.
1415 Manuel d'initiation :
1416 @rlearning{Autres sources de documentation},
1417 @rlearning{Conducteurs et parties}.
1421 Lorsque vous incluez un fichier qui porte le même nom que l'un des
1422 fichiers d'initialisation de LilyPond, le fichier de la distribution de
1423 LilyPond aura préséance.
1426 @node Différentes éditions à partir d'une même source
1427 @subsection Différentes éditions à partir d'une même source
1428 @translationof Different editions from one source
1430 Plusieurs méthodes permettent de générer différentes versions d'une
1431 partition à partir d'une même source. Les variables -- ou
1432 idendificateurs -- sont sûrement le moyen le plus simple de combiner de
1433 différente manière des passages relativement longs, alors que les
1434 balises permettront de sélectionner de courts fragments selon leur
1437 Quelle que soit la méthode utilisée, séparer la notation de la structure
1438 de la partition vous donnera plus de liberté dans l'agencement de
1439 l'ouvrage final, puisque vous ne reviendrez pas sur la musique qui le
1443 * Utilisation de variables::
1444 * Utilisation de balises::
1445 * Globalisation des réglages::
1448 @node Utilisation de variables
1449 @unnumberedsubsubsec Utilisation de variables
1450 @translationof Using variables
1452 @cindex variables, utilisation de
1454 Un fragment musical identifié par une variable est réutilisable à divers
1455 endroits de la partition, comme nous l'avons vu à la rubrique
1456 @rlearning{Organisation du code source avec des variables}. Par
1457 exemple, une partition pour chœur @notation{a cappella} comporte souvent
1458 une réduction pour piano reprenant toutes les voix@tie{}; il s'agit de
1459 la même musique, et vous ne devrez donc la saisir qu'une seule fois.
1460 D'autre part, la musique issue de deux variables peut se combiner sur
1461 une seule portée, comme nous l'avons vu à la rubrique
1462 @ref{Regroupement automatique de parties}. Prenons l'exemple
1465 @lilypond[verbatim,quote]
1466 sopranoMusic = \relative c'' { a4 b c b8( a) }
1467 altoMusic = \relative g' { e4 e e f }
1468 tenorMusic = \relative c' { c4 b e d8( c) }
1469 bassMusic = \relative c' { a4 gis a d, }
1470 allLyrics = \lyricmode {King of glo -- ry }
1472 \new Staff = "Soprano" \sopranoMusic
1473 \new Lyrics \allLyrics
1474 \new Staff = "Alto" \altoMusic
1475 \new Lyrics \allLyrics
1476 \new Staff = "Tenor" {
1480 \new Lyrics \allLyrics
1481 \new Staff = "Bass" {
1485 \new Lyrics \allLyrics
1488 \set Staff.printPartCombineTexts = ##f
1494 \set Staff.printPartCombineTexts = ##f
1504 Générer une partition chorale ou la réduction pour piano ne requiert que
1505 de modifier la structure des éléments, sans aucunement toucher à la
1508 Dans le cas d'une partition relativement longue, vous pouvez isoler la
1509 définition des différentes variables dans des fichiers séparés que vous
1510 rappellerez ensuite, comme indiqué à la rubrique
1511 @ref{Insertion de fichiers LilyPond}.
1514 @node Utilisation de balises
1515 @unnumberedsubsubsec Utilisation de balises
1516 @translationof Using tags
1519 @funindex \keepWithTag
1520 @funindex \removeWithTag
1521 @funindex \pushToTag
1522 @funindex \appendToTag
1526 La commande @code{\tag #'@var{partieA}} affecte à une expression
1527 musicale le nom @var{partieA}. Les expressions ainsi balisées pourront
1528 être filtrées par la suite, à l'aide de
1529 @code{\keepWithTag@tie{}#'@var{nom}} ou
1530 @code{\removeWithTag@tie{}#'@var{nom}}. Ces filtres fonctionnent de la
1531 manière suivante@tie{}:
1533 @multitable @columnfractions .5 .5
1538 Musique balisée précédée de @code{\keepWithTag #'@var{nom}}
1539 @tab Musique non balisée et musique balisée par @var{nom} seront
1540 incluses@tie{}; la musique balisée autrement est exclue.
1543 Musique balisée précédée de @code{\removeWithTag #'@var{nom}}
1544 @tab Musique non balisée et fragments appelés autrement que @var{nom}
1545 seront inclus@tie{}; la musique balisée par @var{nom} est exclue.
1548 Musique balisée non précédée de @code{\keepWithTag} ou
1549 @code{\removeWithTag}
1550 @tab Musique balisée et non balisée seront incluses.
1554 Les arguments des commandes @code{\tag}, @code{\keepWithTag} et
1555 @code{\removeWithTag} doivent être un symbole (tel que
1556 @code{#'conducteur} ou @code{#'partie}), suivi d'une expression
1559 Dans l'exemple qui suit, nous obtenons deux versions du même extrait,
1560 l'une pour le conducteur, l'autre pour l'instrumentiste, et qui
1561 comportera les ornements développés.
1563 @lilypond[verbatim,quote]
1564 music = \relative g' {
1566 \tag #'trills { d8.\trill }
1567 \tag #'expand { \repeat unfold 3 { e32 d } }
1572 \keepWithTag #'trills \music
1575 \keepWithTag #'expand \music
1580 Il est parfois plus aisé d'exclure des fragments@tie{}:
1582 @lilypond[verbatim,quote]
1583 music = \relative g' {
1585 \tag #'trills { d8.\trill }
1586 \tag #'expand {\repeat unfold 3 { e32 d } }
1591 \removeWithTag #'expand
1595 \removeWithTag #'trills
1600 Ce principe de filtrage peut s'appliquer aux articulations, textes, etc.
1601 Il suffit de positionner
1604 -\tag #@var{ma-balise}
1608 avant l'articulation ou le texte, comme ici@tie{}:
1612 c1-\tag #'gaffe ^"Attention !"
1616 Ceci définira une note avec une indication conditionnelle de doigté ou
1619 Vous pouvez baliser différemment la même expression musicale en
1620 saisissant plusieurs @code{\tag}@tie{}:
1622 @lilypond[quote,verbatim]
1623 music = \relative c'' {
1624 \tag #'a \tag #'both { a4 a a a }
1625 \tag #'b \tag #'both { b4 b b b }
1628 \keepWithTag #'a \music
1629 \keepWithTag #'b \music
1630 \keepWithTag #'both \music
1634 L'application concomitante de plusieurs filtres @code{\removeWithTag} à
1635 la même expression musicale permet d'exclure plusieurs balisages@tie{}:
1637 @lilypond[verbatim,quote]
1638 music = \relative c'' {
1639 \tag #'A { a4 a a a }
1640 \tag #'B { b4 b b b }
1641 \tag #'C { c4 c c c }
1642 \tag #'D { d4 d d d }
1651 L'application de plus d'un filtre @code{\keepWithTag} à la même
1652 expression musicale aboutit à l'exclusion de @b{tous} les balisages.
1653 En effet, si le premier filtre exclut tous les autres balisages,
1654 l'application du second exclura les effets du premier.
1656 Il peut arriver que vous ayez besoin de raccorder quelque chose en un
1657 point particulier d'une expression musicale. Les commandes
1658 @code{\pushToTag} et @code{\appendToTag} permettent d'insérer du
1659 matériau, qu'il soit antérieur ou postérieur à des @code{éléments}
1660 d'une construction musicale existante. La musique séquentielle ou
1661 simultanée comporte assurément des @code{éléments}@tie{}:
1663 @lilypond[verbatim,quote]
1664 test = { \tag #'here { \tag #'here <<c''>> } }
1667 \pushToTag #'here c'
1668 \pushToTag #'here e'
1669 \pushToTag #'here g' \test
1670 \appendToTag #'here c'
1671 \appendToTag #'here e'
1672 \appendToTag #'here g' \test
1676 Ces deux instructions sont afféctées d'une balise, le matériau à
1677 raccorder à chaque instance de la balise, et l'expression balisée.
1678 Ces instructions prennent soin de recopier tout ce qui doit être
1679 modifié, de telle sorte que l'expression @code{\test} originale conserve
1684 Manuel d'initiation :
1685 @rlearning{Organisation du code source avec des variables}.
1687 Manuel de notation :
1688 @ref{Regroupement automatique de parties},
1689 @ref{Insertion de fichiers LilyPond}.
1693 @c This warning is more general than this placement implies.
1694 @c Rests are not merged whether or not they come from tagged sections.
1695 @c Should be deleted? -td
1699 Lorsqu'elles comportent des silences, ceux-ci ne seront pas fusionnés
1700 si vous imprimez une partition avec les deux sections balisées.
1705 @node Globalisation des réglages
1706 @unnumberedsubsubsec Globalisation des réglages
1707 @translationof Using global settings
1709 @cindex include-settings
1711 Vous pouvez regrouper dans un fichier indépendant vos réglages
1712 personnels que vous incluerez au besoin@tie{}:
1715 lilypond -dinclude-settings=MES_REGLAGES.ly MA_PARTITION.ly
1718 Vous pouvez ainsi stocker dans un fichier séparé vos réglages en matière
1719 de format de papier, de fontes utilisées ou vos définitions
1720 particulières. Selon le fichier de réglages que vous mentionnerez, vous
1721 obtiendrez facilement différentes éditions à partir d'une même source
1722 quelle qu'elle soit.
1724 Ceete technique peut s'utiliser en combinaison avec des feuilles de
1725 styles, comme indiqué au chapitre @rlearning{Feuilles de style}.
1728 Manuel d'initiation :
1729 @rlearning{Organisation du code source avec des variables},
1730 @rlearning{Feuilles de style}.
1732 Manuel de notation :
1733 @ref{Insertion de fichiers LilyPond}.
1736 @node Caractères spéciaux
1737 @subsection Caractères spéciaux
1738 @translationof Special characters
1740 @cindex caractères spéciaux
1741 @cindex non-ASCII, caractères
1746 * Équivalents ASCII::
1750 @node Codage du texte
1751 @unnumberedsubsubsec Codage du texte
1752 @translationof Text encoding
1756 LilyPond utilise le jeu de caractères défini par le consortium Unicode
1757 et la norme ISO/CEI@tie{}10646. Chaque caractère est identifié par un
1758 nom unique et associé à un point de code, ce qui permet dans l'absolu de
1759 couvrir tous les langages. Unicode permet de coder tous les caractères
1760 utilisés par toutes les langues écrites du monde. LilyPond utilise le
1761 codage UTF-8 (UTF pour @emph{Unicode Transformation Format}) qui permet
1762 de représenter les caractères latins sur un octet et les autres sur une
1763 longueur allant jusqu'à quatre octets.
1765 L'apparence réelle des caractères est déterminée par les glyphes ou
1766 graphèmes tels que définis dans les différentes polices disponibles.
1767 Une police, ou une fonte, définit la mise en correspondance d'un
1768 sous-ensemble de points de code unicode en glyphes. LilyPond recourt à
1769 la bibliothèque Pango pour assurer le rendu des textes multilingues.
1771 LilyPond n'effectue aucune conversion d'encodage que ce soit. Ceci
1772 implique donc que tout texte, qu'il s'agisse d'un titre, de paroles ou
1773 même d'instruction musicale, comportant des caractères non ASCII, soit
1774 codé en UTF-8. Le plus sûr moyen de saisir du texte de la sorte
1775 consiste à utiliser un éditeur supportant l'unicode et à enregistrer vos
1776 fichier en UTF-8. C'est le cas pour la plupart des éditeurs actuels,
1777 que ce soit vim, Emacs, jEdit et GEdit. Tous les systèmes Windows
1778 postérieurs à NT utilisent Unicode en natif@tie{}; même Notepad est
1779 capable d'éditer et sauvegarder un fichie en UTF-8 -- sans parler de
1780 l'excellente alternative qu'est BabelPad.
1782 La compilation d'un fichier LilyPond comportant des caractères non ASCII
1783 qui n'aurait pas été enregistré dans l'encodage UTF-8 vous renverra
1787 FT_Get_Glyph_Name () erreur : invalid argument
1790 Voici un exemple utilisant du texte en cyrilique, en hébreux et en
1794 %c No verbatim here as the code does not display correctly in PDF
1796 bulgarian = \lyricmode {
1797 Жълтата дюля беше щастлива, че пухът, който цъфна, замръзна като гьон.
1801 hebrew = \lyricmode {
1802 זה כיף סתם לשמוע איך תנצח קרפד עץ טוב בגן.
1806 portuguese = \lyricmode {
1807 à vo -- cê uma can -- ção legal
1813 \addlyrics { \bulgarian }
1814 \addlyrics { \hebrew }
1815 \addlyrics { \portuguese }
1820 @unnumberedsubsubsec Unicode
1821 @translationof Unicode
1825 Lorsque vous avez besoin d'un caractère dont vous connaissez le point de
1826 code mais que votre éditeur ne permet pas de saisir directement, vous
1827 pouvez utitliser les instructions @code{\char@tie{}##xhhhh} ou
1828 @code{\char@tie{}#dddd} au sein d'un bloc @code{\markup} -- @code{hhhh}
1829 et @code{dddd} correspondant respectivement à la valeur hexadécimale ou
1830 décimale. Même s'il est inutile de saisir les zéros superflus, il est
1831 de bon ton de stipuler les quatre caractères formant la représentation
1832 hexadécimale. Évitez cependant l'encodage UTF-8 d'un point de code
1833 après un @code{\char}@tie{}; les encodages UTF-8 comprennent un bit
1834 supplémentaire indiquant le nombre d'octets. Une table de
1835 correspondance entre les codes Unicode et le nom des caractères ainsi
1836 que leur code hexadécimal est disponible sur le site du consortium
1837 Unicode, @uref{http://www.unicode.org/}.
1839 Par exemple, @code{\char ##x03BE} et @code{\char #958} correspondent
1840 tous deux au caractère unicode U+03BE, dénommé @qq{Greek Small Letter
1843 Quel que soit le point de code spécifié de cette manière, il ne vous
1844 sera alors pas nécessaire d'enregistrer votre fichier en UTF-8. Vous
1845 devrez toutefois disposer d'une fonte contenant ce caractère qui soit
1846 accessible à LilyPond.
1848 L'exemple suivant illustre la manière d'insérer un caractère sous sa
1849 forme hexadécimale, à la fois dans un repère, dans une articulation,
1850 dans des paroles et dans du texte indépendant.
1852 @lilypond[quote,verbatim]
1855 c1 \mark \markup { \char ##x03EE }
1856 c1_\markup { \tiny { \char ##x03B1 " to " \char ##x03C9 } }
1858 \addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
1860 \markup { "Copyright 2008--2011" \char ##x00A9 }
1865 Le signe @emph{copyright} dans le champ de titrage consacré s'inscrit de
1866 la manière suivante@tie{}:
1870 copyright = \markup @{ \char ##x00A9 "2008" @}
1875 @node Équivalents ASCII
1876 @unnumberedsubsubsec Équivalents ASCII
1877 @translationof ASCII aliases
1879 Dès lors que vous aurez inclus la liste de leur équivalent ASCII,
1880 LilyPond reconnaitra un certain nombre de caractères spéciaux@tie{}:
1882 @lilypond[quote,verbatim]
1884 #(include-special-characters)
1887 \markup "&flqq; – &OE;uvre incomplète… &frqq;"
1890 \new Staff { \repeat unfold 9 a'4 }
1892 This is al -- so wor -- kin'~in ly -- rics: –_&OE;…
1897 "The replacement can be disabled:"
1898 "– &OE; …"
1899 \override #'(replacement-alist . ()) "– &OE; …"
1903 L'extension de cette liste est possible aussi bien de manière globale :
1905 @lilypond[quote,verbatim]
1907 #(add-text-replacements!
1908 '(("100" . "hundred")
1909 ("dpi" . "dots per inch")))
1911 \markup "A 100 dpi."
1914 qu'en un point particulier de votre source :
1916 @lilypond[quote,verbatim]
1917 \markup \replace #'(("100" . "hundred")
1918 ("dpi" . "dots per inch")) "A 100 dpi."
1922 Manuel de notation :
1923 @ref{Liste des caractères spéciaux}.
1925 Fichiers d'initialisation :
1926 @file{ly/text-replacements.ly}.
1929 @node Contrôle des sorties
1930 @section Contrôle des sorties
1931 @translationof Controlling output
1934 * Extraction de fragments musicaux::
1935 * Ignorer des passages de la partition::
1936 * Formats de sortie alternatifs::
1937 * Changement des fontes musicales::
1940 @node Extraction de fragments musicaux
1941 @subsection Extraction de fragments musicaux
1942 @translationof Extracting fragments of music
1944 LilyPond vous permet d'extraire des fragments d'une partition à l'instar
1945 du choriste amateur qui alimente son album avec des coupures de
1948 Vous devrez pour cela définir les mesures à découper. La définition
1949 suivante, incluse dans votre fichier source,
1956 (make-rhythmic-location 5 1 2)
1957 (make-rhythmic-location 7 3 4)))
1962 vous permettra d'extraire un fragment compris entre le milieu de la
1963 cinquième mesure et quelque part dans la septième. Le triplet
1964 @code{5@tie{}1@tie{}2} signifie@tie{}: après la durée d'une blanche dans
1965 la mesure 5@tie{}; le @code{7@tie{}3@tie{}4} signifie quant à lui que
1966 l'on s'arrête à la mesure 7, après la durée de trois noires.
1968 Rien ne vous empêche d'extraire plusieurs fragments, dès lors que vous
1969 définissez dans la liste d'autres paires d'emplacements ryhtmiques.
1971 Cette fonctionnalité n'est toutefois effective que lorsque vous lancez
1972 LilyPond avec l'option @w{@code{-dclip-systems}}. Les @qq{coupures}
1973 seront générées sous la forme de fichiers EPS, convertis en PDF ou PNG
1974 selon le format que vous aurez stipulé.
1976 Pour de plus amples informations quant au format des résultats,
1977 consultez le chapitre @rprogram{Lancement de lilypond}.
1980 @node Ignorer des passages de la partition
1981 @subsection Ignorer des passages de la partition
1982 @translationof Skipping corrected music
1984 @funindex skipTypesetting
1985 @funindex showFirstLength
1986 @funindex showLastLength
1988 Dans un travail de transcription ou de recopie de la musique, ce qui
1989 vous intéresse plus particulièrement se situe à la fin, là même où vous
1990 en êtes dans la notation. Dans le but de gagner du temps dans le
1991 processus de correction, vous pouvez @qq{escamoter} le reste et ne
1992 générer que les dernières mesures en insérant
1995 showLastLength = R1*5
2000 dans votre fichier source. Ceci aura pour effet de ne générer que les
2001 cinq dernières mesures -- si tant est que le morceau soit à 4/4 -- de
2002 tous les @code{\score} de votre fichier. Dans le cas d'un œuvre
2003 conséquente, cette pratique s'avère fort utile puisqu'elle évite de tout
2004 générer. Vous pourriez aussi être amené à retravailler le début d'une
2005 œuvre, pour y ajouter une partie par exemple, auquel cas c'est la
2006 propriété @code{showFirstLength} que vous utiliserez.
2008 Vous pouvez contrôler très finement les parties à escamoter, grâce au
2009 commutateur @code{Score.skipTypesetting}@tie{}: lorsqu'il est activé,
2010 aucune gravure n'est réalisée.
2012 Ce commutateur agit aussi sur la sortie MIDI. Notez bien que tous les
2013 événements seront escamotés, y compris les changements de tempo ou
2014 d'instrument -- vous voilà prévenu@tie{}!
2016 @lilypond[quote,relative=2,ragged-right,verbatim]
2018 \set Score.skipTypesetting = ##t
2020 \set Score.skipTypesetting = ##f
2024 Dans le cadre de musique polyphonique, @code{Score.skipTypesetting}
2025 s'applique à toutes les voix et portées. Vous gagnerez donc encore plus
2029 @node Formats de sortie alternatifs
2030 @subsection Formats de sortie alternatifs
2031 @translationof Alternative output formats
2033 @cindex scalable vector graphics
2034 @cindex SVG, format de sortie
2035 @cindex encapsulated postscript
2036 @cindex EPS, format de sortie
2038 En matière de partition imprimable, LilyPond génère par défaut des
2039 documents au format PostScript (PS) et Portable Document Format (PDF).
2040 Vous pouvez aussi obtenir des documents au format Scalable Vector
2041 Graphics (SVG), Encapsulated PostScript (EPS) ou Portable Network
2042 Graphics (PNG) dès lors que vous aurez lancé LilyPond en ligne de
2043 commande avec l'option @i{ad hoc} -- voir
2044 @rprogram{Options en ligne de commande pour lilypond} à ce sujet.
2047 @node Changement des fontes musicales
2048 @subsection Changement des fontes musicales
2049 @translationof Replacing the notation font
2051 Gonville est une alternative à la fonte Feta que LilyPond utilise par
2052 défaut. Vous pouvez la télécharger à partir de
2054 @uref{http://www.chiark.greenend.org.uk/~sgtatham/gonville/ ,http://www.chiark.greenend.org.uk/~sgtatham/gonville/}
2057 Voici quelques mesures utilisant la police Gonville@tie{}:
2059 @c NOTE: these images are a bit big, but that's important
2060 @c for the font comparison. -gp
2061 @sourceimage{Gonville_after,,,}
2063 Et ces même mesures avec la police de LilyPond, Feta@tie{}:
2065 @sourceimage{Gonville_before,,,}
2068 @subsubheading Instructions d'installation pour MacOS
2069 @translationof Installation Instructions for MacOS
2071 Téléchargez puis décompressez l'archive zip. Recopiez le répertoire
2072 @code{lilyfonts} dans @file{@var{SHARE_DIR}/lilypond/current} -- voir
2073 @rlearning{Autres sources de documentation} à ce sujet. Renommez le
2074 répertoire @code{fonts} qui s'y trouve en @code{fonts_orig}, puis le
2075 répertoire @code{lilyfonts} en @code{fonts}. Il vous suffira, pour
2076 retrouver la fonte Feta, de renommer @code{fonts_orig} en @code{fonts}.
2080 Manuel d'initiation :
2081 @rlearning{Autres sources de documentation}.
2085 Gonville ne permet pas de générer de la notation ancienne, et certains
2086 glyphes ajoutés depuis lors aux jeux de caractères en soient absent.
2087 Consultez le site de l'auteur pour de plus amples informations ainsi
2088 qu'à propos des conditions d'utilisation.
2092 @section Sortie MIDI
2093 @translationof MIDI output
2098 MIDI (Musical Instrument Digital Interface) constitue un standard en
2099 matière de connexion et de contrôle des instruments électroniques. Un
2100 fichier MIDI contient une série de notes réparties dans différentes
2101 pistes. Il ne s'agit en rien d'un fichier sonore@tie{}; il vous faudra
2102 un logiciel capable de traduire ces séries de notes en sons réels.
2104 Vous pouvez convertir vos partition en fichier MIDI de manière à
2105 entendre ce que vous avez saisi. Ceci vous permet de contrôler aisément
2106 ce que vous avez saisi@tie{}: octaves et altérations erronées heuteront
2107 votre oreille avertie grâce au MIDI.
2109 Le fichier MIDI généré par LilyPond est relativement brut. Vous pouvez
2110 cependant obtenir un meilleur rendu avec @ref{Le script Articulate}.
2112 Dans une sortie MIDI, LilyPond alloue un canal à chaque portée, tout en
2113 réservant le canal@tie{}10 aux percussions. Dans la mesure ou un
2114 périphérique MIDI ne comprend que 16 canaux, un fichier MIDI qui
2115 comportera plus de quinze portées verra le même canal réutilisé.
2118 * Création de fichiers MIDI::
2120 * Contenu de la sortie MIDI::
2121 * Répétitions et MIDI::
2122 * Gestion des nuances en MIDI::
2123 * MIDI et percussions::
2124 * Le script Articulate::
2128 @node Création de fichiers MIDI
2129 @subsection Création de fichiers MIDI
2130 @translationof Creating MIDI files
2132 LilyPond génèrera un fichier MIDI dès que vous ajouterez un bloc
2133 @code{\midi} à la structure de votre partition, comme ici@tie{}:
2142 Lorsque le bloc @code{\score} contient un bloc @code{\midi} mais pas de
2143 bloc @code{\layout}, LilyPond ne produira qu'une sortie MIDI. Si donc
2144 vous avez besoin aussi d'un support visuel, vous devrez aussi mentionner
2145 un bloc @code{\layout}.
2155 Hauteurs, durées, liaisons de prolongation, nuances et changements de
2156 tempo seront interprétés et traduits en événements MIDI. Les
2157 indications de nuances, crescendos et decrescendos sont traduits en
2158 niveau de volume@tie{}; les indications sous la forme d'une fraction
2159 déterminée du volume disponible, et crescendos et decrescendos sous la
2160 forme d'une progression linéaire entre les deux extrêmes. Le rendu des
2161 indications de nuance peut être désactivé pour le MIDI -- voir
2164 Le tempo initial ainsi que ses changements sont normalement indiqués au
2165 fil de la notation à l'aide de la commande @code{\tempo}@tie{}; ils
2166 seront retranscrits dans le fichier MIDI. La commande @code{\tempo}
2167 donne lieu à l'impression d'une indication métronomique que vous pouvez
2168 toutefois rendre invisible, comme indiqué à la rubrique
2169 @ref{Indication métronomique}. Une autre manière de spécifier le tempo
2170 initial pour un fichier MIDI est indiquée plus avant -- voir
2173 En raison de certaines limitations de Windows, les fichiers MIDI doivent
2174 y porter l'extension @code{.mid}. D'autres systèmes utilisent
2175 l'extension @code{.midi}. Si besoin est, placez la ligne suivante au
2176 début de votre fichier source, avant l'ouverture de tout bloc
2177 @code{\book}, @code{\bookpart} ou @code{\score}@tie{}:
2180 #(ly:set-option 'midi-extension "midi")
2183 Cette ligne déterminera @code{.midi} comme extension par défaut pour les
2186 Vous pouvez aussi le faire en ligne de commande@tie{}:
2189 lilypond … -dmidi-extension=midi fichierLily.ly
2193 @unnumberedsubsubsec Noms d'instrument
2194 @translationof Instrument names
2196 @cindex instrument, nom d'
2197 @funindex Staff.midiInstrument
2199 L'instrument MIDI affecté à un canal particulier est déterminé par la
2200 propiété @code{Staff.midiInstrument}. Vous pouvez choisr l'un des
2201 instruments répertoriés à l'annexe @ref{Instruments MIDI}.
2205 \set Staff.midiInstrument = #"glockenspiel"
2211 \new Staff \with @{midiInstrument = #"cello"@} @{
2216 Lorsque l'instrument choisi ne correspond pas exactement à l'une des
2217 dénominations consacrées, LilyPond le replacera par un piano de concert
2218 (@code{"acoustic grand"}).
2223 @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
2224 {changing-midi-output-to-one-channel-per-voice.ly}
2228 @c In 2.11 the following no longer seems to be a problem -td
2230 Un (de)crescendo non terminé ne sera pas correctement rendu en MIDI --
2231 il y a nécessairement du silence. Il vous faut donc lui donner une fin
2232 explicite. Par exemple,
2239 ne fonctionnera pas correctement, contrairement à
2242 @{ a4\< b c d\!\f @}
2246 Un changement de volume ne peut intervenir que sur le démarrage d'une
2247 note. C'est la raison pour laquelle la succession d'un crescendo et
2248 d'un diminuendo ne peut se produire sur une même note.
2250 Certains lecteurs MIDI ne rendent pas correctement les changements de
2251 tempo. MS Windows Media Player et
2252 @uref{http://@/timidity@/.sourceforge@/.net/,timidity} le font sans
2257 @subsection Le bloc MIDI
2258 @translationof MIDI block
2260 Dès lors que vous désirez obtenir une sortie MIDI, vous devrez inscrire
2261 un bloc @code{\midi} au sein du bloc @code{\score}. Son fonctionnement
2262 est comparable à ce lui du bloc @code{\layout}, voire plus simple. Si
2263 le bloc @code{\midi} est la plupart du temps laissé vide, il peut
2264 contenir des aménagements pour certains contextes, la définition de
2265 contextes particuliers ou du code permettant de déterminer la valeur de
2266 certaines propriétés. L'exemple suivant détermine le tempo initial du
2267 fichier MIDI tout en se passant de son indication sur la partition
2276 tempoWholesPerMinute = #(ly:make-moment 72 4)
2282 Ici, le tempo est fixé à 72 noires à la minute. Spécifier un tempo de
2283 la sorte ne permet pas de doner une valeur pour une note pointée. Vous
2284 devrez, en pareil cas, subdiviser la note pointée en durée plus courte.
2285 Par exemple, indiquer 90 à la noire pointée est équivalent à spécifier
2286 270 croches à la minute@tie{}:
2289 tempoWholesPerMinute = #(ly:make-moment 270 8)
2292 @cindex MIDI et définition de contexte
2293 @cindex contexte, définition en MIDI
2295 La syntaxe permettant de définir un contexte pour le @code{\midi} est en
2296 tout point identique à celle que vous utilisez dans le bloc
2297 @code{\layout}, à ceci près que le @qq{graveur} est remplacé par un
2298 @qq{interprète}. Les différents contextes disponibles en matière de
2299 MIDI sont répertoriés dans le fichier d'initialisation
2300 @file{../ly/performer-init.ly} -- pour plus de détail, voir
2301 @rlearning{Autres sources de documentation}.
2302 Si vous voulez vous passer des nuances dans votre fichier MIDI, il vous
2303 suffit d'insérer les lignes suivantes dans votre bloc
2311 \remove "Dynamic_performer"
2316 LilyPond ne génèrera de sortie MIDI que si vous incluez un bloc
2317 @code{\midi} dans la structure de la partition, initialisée par la
2318 commande @code{\score}.
2322 @{ @dots{}notes@dots{} @}
2328 @node Contenu de la sortie MIDI
2329 @subsection Contenu de la sortie MIDI
2330 @translationof What goes into the MIDI output?
2332 @c TODO Check grace notes - timing is suspect?
2335 @unnumberedsubsubsec Éléments pris en compte dans le MIDI
2336 @translationof Supported in MIDI
2338 @cindex hauteurs en MIDI
2339 @cindex MIDI, hauteurs
2340 @cindex quart de ton en MIDI
2341 @cindex MIDI, quart de ton
2342 @cindex microtonalité en MIDI
2343 @cindex MIDI, microtonalité
2344 @cindex accords nommés en MIDI
2345 @cindex MIDI, accords nommés
2346 @cindex Rythme en MIDI
2347 @cindex MIDI, Rythme
2348 @cindex articulations et MIDI
2349 @cindex MIDI et articulations
2350 @cindex trilles et MIDI
2351 @cindex MIDI et trilles
2354 Un fichier MIDI généré par LilyPond comprendra les éléments de notation
2362 les microtonalités -- voir @ref{Altérations}. Leur rendu nécessite
2363 cependant un lecteur qui prenne en charge la modulation@tie{};
2366 les accords nommés ;
2369 le rythme en tant que durée de note, y compris les nolets ;
2372 les tremolos, exceptés ceux utilisant la syntaxe
2373 @qq{@code{:}[@var{nombre}]}@tie{};
2376 les liaisons de prolongation ;
2379 les indications de nuance ;
2382 les crescendos et decrescendos s'étalant sur plusieurs notes@tie{};
2385 les changements de tempo indiqués par un @code{\tempo}@tie{};
2391 Si vous utilisez @ref{Le script Articulate}, d'autres éléments seront
2395 @item articulations (lié, staccato, etc.),
2396 @item trilles et groupettos,
2397 @item rallentando et accelerando.
2401 @unnumberedsubsubsec Éléments non pris en compte dans le MIDI
2402 @translationof Unsupported in MIDI
2404 @c TODO index as above
2406 LilyPond ne peut générer d'événement MIDI pour les éléments
2407 suivant, sauf à utiliser @ref{Le script Articulate}@tie{}:
2411 le rythme indiqué sous forme d'annotation (p.ex. @emph{swing})@tie{};
2414 les changements de tempo indiqués sous forme d'annotation (sans
2415 @code{\tempo})@tie{};
2418 les staccatos et autres articulations ou ornementations@tie{};
2421 les liaisons d'articulation et de prhasé@tie{};
2424 les crescendos ou decrescendos sur une sele note@tie{};
2427 les tremolos indiqués par la syntaxe @qq{@code{:}[@var{nombre}]}@tie{};
2433 les accords en microtonalité.
2437 @node Répétitions et MIDI
2438 @subsection Répétitions et MIDI
2439 @translationof Repeats in MIDI
2441 @cindex reprises développées
2442 @cindex MIDI et reprises
2443 @funindex \unfoldRepeats
2445 Au prix de quelques réglages, les reprises de toutes sortes peuvent être
2446 rendues dans le fichier MIDI. Il suffit pour cela de recourir à la
2447 fonction @code{\unfoldRepeats}, qui développe toutes les reprises. En
2448 d'autre termes, @code{\unfoldRepeats} transforme toutes les reprises
2449 en reprises de type @code{unfold}.
2452 @lilypond[quote,verbatim]
2454 \repeat tremolo 8 {c'32 e' }
2455 \repeat percent 2 { c''8 d'' }
2456 \repeat volta 2 {c'4 d' e' f'}
2465 Dans une partition comportant plusieurs voix, le développement des
2466 reprises ne sera effectif en MIDI qu'à la condition que ces reprises
2467 soient mentionnée correctement dans @strong{toutes} les voix.
2469 Lorsque l'on veut utiliser @code{\unfoldRepeats} seulement pour le rendu
2470 MIDI, il faut établir deux blocs @code{\score}@tie{}: un pour le MIDI,
2471 avec des reprises explicites, et l'autre pour la partition, avec des
2472 reprises notées sous forme de barres de reprise, de trémolo ou de
2473 symboles de pourcentage. Par exemple
2481 \unfoldRepeats @var{..musique..}
2487 @node Gestion des nuances en MIDI
2488 @subsection Gestion des nuances en MIDI
2489 @translationof Controlling MIDI dynamics
2491 Les nuances MIDI sont générées par le @code{Dynamic_performer}, affecté
2492 par défaut au contexte @code{Voice}. Vous pouvez contrôler à la fois le
2493 volume général, celui des indications de nuance ainsi que celui des
2494 différents instruments.
2497 @unnumberedsubsubsec Indications de nuance
2498 @translationof Dynamic marks
2500 Les indications de nuances sont transcrites en fraction du volume MIDI.
2501 Nous allons, par défaut, de 0,25 pour un @notation{ppppp} à 0,95 pour un
2502 @notation{fffff}. Les correspondances entre nuance et fraction de
2503 volume sont répertoriées dans le fichier @file{../scm/midi.scm} --
2504 consultez la rubrique @rlearning{Autres sources de documentation} si
2505 vous ne savez comment le localiser. Vous pouvez modifier ou étendre ce
2506 jeu grâce à une fonction qui prendra en argument une indication de
2507 nuance et renverra la fraction désirée, puis en affectant cette fonction
2508 à @code{Score.dynamicAbsoluteVolumeFunction}.
2510 Prenons un exemple. Votre partition comporte un @notation{rinforzando}
2511 que vous avez indiqué par @code{\rfz}. Cette indication de nuance
2512 n'étant pas répertoriée dans le jeu par défaut, elle ne produira aucun
2513 effet en MIDI. Il en sera d'ailleurs de même pour toute indication
2514 créée de toute pièce à l'aide de l'instruction
2515 @w{@code{make-dynamic-script}}. Voici comment procéder pour ajuster le
2516 volume MIDI de ce @notation{rinforzando} que le compositeur a indiqué.
2517 La fonction Scheme définit une fraction de 0,9 en cas de @notation{rfz},
2518 et demande d'utiliser la fonction par défaut dans les autre cas.
2520 @lilypond[verbatim,quote]
2521 #(define (myDynamics dynamic)
2522 (if (equal? dynamic "rfz")
2524 (default-dynamic-absolute-volume dynamic)))
2528 \set Staff.midiInstrument = #"cello"
2529 \set Score.dynamicAbsoluteVolumeFunction = #myDynamics
2541 Si vous étiez amené à devoir modifier l'intégralité du jeu des
2542 correspondances, nous vous conseillons d'utiliser la procédure
2543 @command{default-dynamic-absolute-volume} contenue dans le fichier
2544 @file{../scm/midi.scm} ansi que la table d'association comme base. Le
2545 dernier exemple de cette partie illustre la manière de procéder.
2548 @unnumberedsubsubsec Amplitude du volume en MIDI
2549 @translationof Overall MIDI volume
2551 Les valeurs extrêmes du volume MIDI des nuances se contrôlent à l'aide
2552 des propriétés @code{midiMinimumVolume} et @code{midiMaximumVolume} qui
2553 agissent au niveau @code{Score}. Ces propriétés sont effectives dès
2554 lors qu'une nuance est indiquée@tie{}; une nuance de départ est donc
2555 requise pour que le volume soit ajusté dès le début de la partition.
2556 Vous pouvez alors modifier la fraction correspondant à chaque nuance à
2557 l'aide de la formule
2560 midiMinimumVolume + (midiMaximumVolume - midiMinimumVolume) * fraction
2563 Voici comment ajuster les nuances tout en limitant l'amplitude du volume
2564 entre 0,2 et 0,5@tie{}:
2566 @lilypond[verbatim,quote]
2572 \set Staff.midiInstrument = #"flute"
2573 \new Voice \relative c''' {
2581 \set Staff.midiInstrument = #"clarinet"
2582 \new Voice \relative c'' {
2593 tempoWholesPerMinute = #(ly:make-moment 72 2)
2594 midiMinimumVolume = #0.2
2595 midiMaximumVolume = #0.5
2602 @unnumberedsubsubsec Égalisation de plusieurs instruments (i)
2603 @translationof Equalizing different instruments (i)
2605 La définition de l'amplitude du volume MIDI au niveau d'un contexte
2606 @code{Staff} permet de gérer les volumes relatifs entre les différents
2607 instruments. Ceci constitue en quelque sorte un égaliseur, ce qui
2608 permet d'améliorer notablement la qualité de la sortie MIDI.
2610 La clarinette de l'exemple suivant jouera relativement moins fort que la
2611 flûte. Rappelez-vous que pour que cela fonctionne correctement, la
2612 première note de chacun des instruments doit être affublée d'une
2613 indication de nuance.
2615 @lilypond[verbatim,quote]
2621 \set Staff.midiInstrument = #"flute"
2622 \set Staff.midiMinimumVolume = #0.7
2623 \set Staff.midiMaximumVolume = #0.9
2624 \new Voice \relative c''' {
2632 \set Staff.midiInstrument = #"clarinet"
2633 \set Staff.midiMinimumVolume = #0.3
2634 \set Staff.midiMaximumVolume = #0.6
2635 \new Voice \relative c'' {
2646 tempoWholesPerMinute = #(ly:make-moment 72 2)
2653 @unnumberedsubsubsec Égalisation de plusieurs instruments (ii)
2654 @translationof Equalizing different instruments (ii)
2656 Lorsque les propriétés volume minimum et maximum n'ont pas été définies,
2657 LilyPond appliquera par défaut une légère égalisation pour quelques
2658 instruments. Les instrument concernés ainsi que le niveau d'égalisation
2659 sont répertoriés dans une table @notation{instrument-equalizer-alist}
2660 du fichier @file{../scm/midi.scm}.
2662 Vous pouvez remplacer l'égaliseur basique en définissant une nouvelle
2663 procédure Scheme @code{instrumentEqualizer} au sein du contexte
2664 @code{Score}. Cette procédure prend en unique argument le nom d'un
2665 instrument MIDI et renverra une paire de fractions correspondant au
2666 minimum et maximum de volume alloué à cet instrument. Cette
2667 substitution fonctionne selon le même principe que celui que nous avons
2668 vu en dédut de chapitre avec @code{dynamicAbsoluteVolumeFunction}.
2669 L'égaliseur par défaut, @notation{default-instrument-equalizer}, est
2670 défini dans le fichier @file{../scm/midi.scm}@tie{}; son analyse vous
2671 aidera à construire votre propre procédure.
2673 Nous allons, dans l'exemple suivant, régler le volume relatif de la
2674 flûte et de la clarinette -- au même niveau que dans le précédent.
2676 @lilypond[verbatim,quote]
2677 #(define my-instrument-equalizer-alist '())
2679 #(set! my-instrument-equalizer-alist
2682 ("flute" . (0.7 . 0.9))
2683 ("clarinet" . (0.3 . 0.6)))
2684 my-instrument-equalizer-alist))
2686 #(define (my-instrument-equalizer s)
2687 (let ((entry (assoc s my-instrument-equalizer-alist)))
2696 \set Score.instrumentEqualizer = #my-instrument-equalizer
2697 \set Staff.midiInstrument = #"flute"
2698 \new Voice \relative c''' {
2706 \set Staff.midiInstrument = #"clarinet"
2707 \new Voice \relative c'' {
2718 tempoWholesPerMinute = #(ly:make-moment 72 2)
2725 @c Delete when satisfied this is adequately covered elsewhere -td
2727 @n ode Microtones in MIDI
2728 @s ubsection Microtones in MIDI
2730 @cindex microtones in MIDI
2732 Microtones consisting of half sharps and half flats are exported
2733 to the MIDI file and render correctly in MIDI players which support
2734 pitch bending. See @ref{Note names in other languages}. Here is
2735 an example showing all the half sharps and half flats. It can be
2736 copied out and compiled to test microtones in your MIDI player.
2738 @lilypond[verbatim,quote]
2755 @node MIDI et percussions
2756 @subsection MIDI et percussions
2757 @translationof Percussion in MIDI
2759 La notation pour percussions recourt généralement à un contexte
2760 particulier -- le @code{DrumStaff} -- qui permet d'affecter directement
2761 les instruments concernés au canal@tie{}10 qui leur est réservé.
2763 Certains instruments, tels le xylophone, le marimba, le vibraphone ou
2764 les timbales, se traitent cependant comme des instruments
2765 @qq{classiques} puisqu'ils sont capables d'émettre des hauteurs
2766 différentes@tie{}; leurs notation relève donc d'un contexte @code{Staff}
2767 standard, et non d'un @code{DrumStaff} pour pouvoir être rendus
2768 correctement en MIDI.
2770 D'autres percussions, bien que n'émettant qu'un seul son et inclus dans
2771 le standard @emph{general MIDI}, comme le tom mélodique ou le tambour
2772 taiko, ne sont pas attachés au canal@tie{}10. Ces instruments doivent
2773 donc être saisi dans un contexte @code{Staff}, en utilisant la hauteur
2776 De nombreux instruments de la famille des percussions, les castagnettes
2777 par exemple, n'existent pas dans le standard @emph{general MIDI}.
2778 L'alternative, bien que peu satisfaisante, consiste à leur attribuer le
2779 son le plus proche dans la banque standard.
2781 @c TODO Expand with examples, and any other issues
2785 Le standard @emph{general MIDI} ne dispose pas du @emph{rim shot}@tie{};
2786 LilyPond lui subtitue un @emph{sidestick}.
2789 @node Le script Articulate
2790 @subsection Le script Articulate
2791 @translationof The Articulate script
2793 Vous obtiendrez un rendu MIDI plus @qq{réaliste} grâce au script
2794 @code{articulate}. Celui-ci va tout faire pour d'une part prendre en
2795 compte les articulations (liaisons, staccato, etc.) -- en ajoutant un
2796 blanc aux notes raccourcies -- et, d'autre part, développer les trilles
2797 ou groupettos ainsi que tenir compte des éventuels rallentando et
2800 L'utilisation du script @code{articulate} se fait en deux temps. Vous
2801 devez dans un premier temps inclure son fichier d'initialisation en
2802 ajoutant en tête de votre fichier la ligne
2805 \include "articulate.ly"
2808 puis, dans le bloc @code{\score}, indiquer que toutes les répétitions
2809 seront développées et appliquer la commande à votre musique@tie{}:
2812 \unfoldRepeats \articulate <<
2813 tout le reste du bloc contenant la partition...
2817 Une fois votre fichier modifié de la sorte, vous constaterez que la
2818 version imprimable aura été modifiée en profondeur. Le bloc
2819 @code{\midi} produira par contre un fichier MIDI de bien meilleure
2822 Bien que cela ne gène en rien le fonctionnement du script
2823 @code{articulate}, lui adjoindre la commande @code{\unfoldRepeats} comme
2824 illustré ci-dessus permettra le rendu d'un certain nombre
2825 d'articulations tels les trilles.
2829 Dans la mesure où la script @code{articulate} tend à raccourcir les
2830 accords, certaines musiques, notamment pour l'orgue, paraîtront de moins
2834 @node Extraction d'informations musicales
2835 @section Extraction d'informations musicales
2836 @translationof Extracting musical information
2838 En plus de générer du graphisme et du MIDI, LilyPond peut présenter
2839 l'information musicale sous forme textuelle.
2842 * Affichage de notation au format LilyPond::
2843 * Affichage de la musique sous forme d'expression scheme::
2844 * Enregistrement d'événements musicaux dans un fichier::
2848 @node Affichage de notation au format LilyPond
2849 @subsection Affichage de notation au format LilyPond
2850 @translationof Displaying LilyPond notation
2852 @funindex \displayLilyMusic
2854 La fonction musicale @code{\displayLilyMusic} permet d'afficher en
2855 notation LilyPond une expression musicale. Le réultat défilera dans le
2856 terminal après avoir lancé LilyPond en ligne de commande. Par exemple,
2860 \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
2867 @{ a,4 cis e fis g @}
2870 LilyPond affichera le résultat sous forme de message en console, au
2871 milieu de toutes les informations de compilation. Afin d'isoler ces
2872 messages et enregistrer le résultat de la fonction
2873 @code{\display@{MATÉRIAU@}}, pensez à rediriger la sortie vers un
2877 lilypond fichier.ly >affichage.txt
2882 Vous noterez que LilyPond ne se contente pas de simplement afficher
2883 l'expression musicale, mais procède aussi à son interprétation -- du
2884 fait que @code{\displayLilyMusic} renvoie l'expression tout en
2885 l'affichant. S'il est bien pratique d'insérer un
2886 @code{\displayLilyMusic} dans une expression musicale pour en obtenir
2887 des informations, l'interprétation de cette expression peut toutefois
2888 être évitée en ajoutant un @code{\void} avant l'instruction@tie{}:
2892 \void \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
2897 @node Affichage de la musique sous forme d'expression scheme
2898 @subsection Affichage de la musique sous forme d'expression scheme
2899 @translationof Displaying scheme music expressions
2901 Voir @rextend{Displaying music expressions}.
2904 @node Enregistrement d'événements musicaux dans un fichier
2905 @subsection Enregistrement d'événements musicaux dans un fichier
2906 @translationof Saving music events to a file
2908 LilyPond vous permet de sauvegarder dans un fichier séparé, sur la base
2909 de la portée, les événements musicaux. Vous devrez pour ce faire
2910 inclure dans votre fichier maître un fichier d'initialisation
2914 \include "event-listener.ly"
2917 Pour chaque portée que comporte votre partition, vous obtiendrez un
2918 fichier @file{NOMFICHIER-PORTÉENOMMÉE.notes} ou
2919 @file{NOMFICHIER-unnamed-staff.notes}. Notez bien que si plusieurs
2920 portées ne sont pas explicitement nomées, tous leurs événements seront
2921 regroupés et mélangés dans le même fichier. Le résultat ressemblera à
2925 0.000 note 57 4 p-c 2 12
2927 0.250 note 62 4 p-c 7 12
2928 0.500 note 66 8 p-c 9 12
2929 0.625 note 69 8 p-c 14 12
2934 Il s'agit d'un tableau dont les colonnes sont délimitées par une
2935 tabulation. Chaque ligne comporte deux champs fixes suivis d'un certain
2936 nombre de paramètres optionnels.
2939 @var{temps} @var{type} @var{...paramètres...}
2942 Ces informations peuvent faire l'objet d'un retraîtement par d'autres
2943 programmes, comme des scripts python, aux fins de recherche en analyse
2944 musicologique ou des expériences à partir du rendu de LilyPond.
2949 Tous les événements ne sont pas pris en charge par
2950 @file{event-listener.ly}. Il s'agit en premier lieu d'une
2951 démonstration, un @qq{proof of concept} du potentiel de LilyPond. Si
2952 certains des éléments que vous cherchez à obtenir n'apparaîssent pas,
2953 recopiez le fichier @file{event-listener.ly} dans votre répoertoire et
2954 modifiez-le de telle sorte qu'il travaille selon vos attentes.