1 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
4 Translation of GIT committish: f662ca41b36ba6f0bf4cf146b7e6e9bc04bd3756
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::
32 @node Agencement du code
33 @section Agencement du code
34 @translationof Input structure
36 LilyPond traite des fichiers textuels. Ces fichiers portent par
37 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::
48 @node Structure d'une partition
49 @subsection Structure d'une partition
50 @translationof Structure of a score
54 Un bloc @code{\score} contient obligatoirement une seule expression
55 musicale délimitée par des accolades@tie{}:
63 @warning{Il ne doit y avoir qu'@strong{une seule} expression musicale
64 globale dans un bloc @code{@bs{}score}, et elle @strong{doit} être
65 bornée par une paire d'accolades.}
67 Cette unique expression musicale peut être de n'importe quelle taille et
68 contenir d'autres expressions musicales aussi complexes soient elles.
69 Voici quelques exemples d'expression musicale@tie{}:
75 @lilypond[verbatim,quote]
82 @lilypond[verbatim,quote]
84 \new Staff { c'4 c' c' c' }
85 \new Staff { d'4 d' d' d' }
93 \new Staff @{ \flute @}
94 \new Staff @{ \hautbois @}
97 \new Staff @{ \violonI @}
98 \new Staff @{ \violonII @}
104 Les commentaires constituent l'une des rares exceptions à cette règle
105 immuable -- voir @ref{Structure de fichier} pour les autres. Qu'il
106 s'agisse d'une seule ligne ou de tout un bloc -- délimité par @code{%@{
107 .. %@}} -- un commentaire peut se placer n'importe où dans le fichier
108 source, aussi bien à l'intérieur qu'à l'extérieur du bloc @code{\score},
109 ou encore à l'intérieur ou à l'extérieur de l'expression musicale
110 contenue dans un bloc @code{\score}.
112 Lorsqu'un fichier ne comprend qu'un bloc @code{\score}, celui-ci est
113 implicitement inclus dans un bloc @code{\book}. Le bloc @code{\book}
114 d'un fichier source permet la production d'au moins un fichier dont le
115 nom sera, par défaut, déduit du fichier source@tie{}: le traitement de
116 @file{fandangopourelephants.ly} produira donc
117 @file{fandangopourelephants.pdf}. Pour de plus amples informations à
118 propos du bloc @code{\book}, lisez
119 @ref{Plusieurs partitions dans un même ouvrage},
120 @ref{Plusieurs éditions pour une même source} et
121 @ref{Structure de fichier}.
124 Manuel d'initiation :
125 @rlearning{Travail sur les fichiers d'entrée},
126 @rlearning{Les expressions musicales en clair},
127 @rlearning{La partition est une (unique) expression musicale composée}.
130 @node Plusieurs partitions dans un même ouvrage
131 @subsection Plusieurs partitions dans un même ouvrage
132 @translationof Multiple scores in a book
134 @cindex mouvements, plusieurs
135 @cindex plusieurs mouvements
139 Un ouvrage peut se composer de plusieurs morceaux et de texte. C'est le
140 cas des cahiers d'exercices ou d'une partie d'orchestre avec ses
141 différents mouvements. Chaque mouvement fait l'objet d'un bloc
150 et le texte est contenu dans un bloc @code{\markup},
160 Les différents mouvements et textes qui apparaissent dans un même
161 fichier @file{.ly} ne composeront en principe qu'un seul fichier
176 Attention cependant si vous travaillez avec lilypond-book@tie{}: il vous
177 faudra explicitement mentionner le bloc @code{\book}, en l'absence de
178 quoi seul le premier @code{\score} ou @code{\markup} apparaîtra après
181 L'entête de chaque pièce peut se placer au sein du bloc
182 @code{\score}@tie{}; le contenu du champ @code{piece} viendra s'imprimer
183 avant chaque mouvement. De même, le titre de l'ouvrage peut se placer
184 au sein du bloc @code{\book}. Dans le cas contraire, le contenu du bloc
185 @code{\header} placé en début de fichier sera utilisé.
189 title = "Huit miniatures"
190 composer = "Igor Stravinsky"
194 \header @{ piece = "Romance" @}
197 ..texte du second couplet..
200 ..texte du troisième couplet..
204 \header @{ piece = "Menuet" @}
210 Plusieurs pièces seront regroupées dans un même @qq{chapitre} à l'aide
211 d'un bloc @code{\bookpart}. Les différentes parties sont séparées par
212 un saut de page et peuvent comporter un titre à l'instar de l'ouvrage
213 dès lors que vous y insérez un bloc @code{\header}.
218 title = "Titre de l'ouvrage"
219 subtitle = "Première partie"
226 subtitle = "Deuxième partie"
234 @node Plusieurs éditions pour une même source
235 @subsection Plusieurs éditions pour une même source
236 @translationof Multiple output files from one input file
238 Dès lors que vous inscrivez plusieurs blocs @code{\book} dans un même
239 fichier @file{.ly}, chacun d'eux donnera lieu à un résultat indépendant.
240 Lorsqu'aucun bloc @code{\book} n'est spécifié dans le fichier source,
241 LilyPond considère que l'intégralité du fichier constitue un bloc
242 @code{\book} unique, comme indiqué à la rubrique
243 @ref{Structure de fichier}.
245 LilyPond fait en sorte, lorsque plusieurs fichiers sont produits à
246 partir d'une même source, qu'aucun résultat d'un bloc @code{\book}
247 n'écrase celui qui a été généré pour un bloc @code{\book} précédent.
249 Dans les faits, et si le nom du fichier produit est repris de sa source
250 -- comportement par défaut --, un suffixe lui sera ajouté pour chaque
251 @code{\book}. Il s'agit en principe d'un pseudo numéro de version.
252 Ainsi, le fichier @file{huitminiatures.ly} qui contiendrait
257 \layout @{ @dots{} @}
261 \layout @{ @dots{} @}
265 \layout @{ @dots{} @}
273 @file{huitminiatures.pdf},
275 @file{huitminiatures-1.pdf} et
277 @file{huitminiatures-2.pdf}.
281 @node Nom des fichiers de sortie
282 @subsection Nom des fichiers de sortie
283 @translationof Output file names
285 LilyPond vous permet de prendre le contrôle dans la dénomination des
286 fichiers que vous voulez générer, quel que soit le moteur de rendu
289 Nous avons vu dans la rubrique précédente que LilyPond évite les
290 conflits de nom des fichiers qu'il génère à partir d'une même source.
291 Vous pouvez même définir vous-même le suffixe qui sera appliqué à chacun
292 des blocs @code{\book}. Ainsi, en reprenant l'exemple ci-avant, vous
293 obtiendrez les fichiers @file{huitminiatures-Romance.pdf},
294 @file{huitminiatures-Menuet.pdf} et @file{huitminiatures-Nocturne.pdf}
295 en ajoutant simplement une déclaration @code{\bookOutputSuffix} au sein
296 de chaque bloc @code{\book}.
300 \bookOutputSuffix "Romance"
302 \layout @{ @dots{} @}
305 \bookOutputSuffix "Menuet"
307 \layout @{ @dots{} @}
310 \bookOutputSuffix "Nocturne"
312 \layout @{ @dots{} @}
316 La déclaration @code{\bookOutputName} vous permet de définir vous-même
317 le nom du fichier généré pour un bloc @code{\book}@tie{}:
321 \bookOutputName "Romance"
323 \layout @{ @dots{} @}
326 \bookOutputName "Menuet"
328 \layout @{ @dots{} @}
331 \bookOutputName "Nocturne"
333 \layout @{ @dots{} @}
337 Le traitement de ce fichier produira@tie{}:
349 @node Structure de fichier
350 @subsection Structure de fichier
351 @translationof File structure
361 Un fichier @code{.ly} peut contenir un certain nombre d'expression de
362 haut niveau. Les expressions de haut niveau sont les suivantes@tie{}:
366 Une définition de sortie, comme @code{\paper}, @code{\midi} et
367 @code{\layout}. Ces définitions, lorsqu'elles se trouvent à un niveau
368 supérieur, s'appliqueront à l'intégralité de l'ouvrage. Si l'une de ces
369 expression apparaît à plusieurs reprises, la dernière aura préséance.
372 Une expression scheme pure, telle que
373 @w{@code{#(set-default-paper-size@tie{}"a7"@tie{}'landscape)}} ou
374 @w{@code{#(ly:set-option@tie{}'point-and-click@tie{}#f)}}.
377 Un bloc @code{\header}, dont le contenu sera de portée globale -- ce qui
378 est le cas en général pour le titre ou l'auteur entre autres.
381 Un bloc @code{\score} pour la partition. Cette partition sera assemblée
382 avec les autres partitions se trouvant au même niveau pour composer le
383 @code{\book}. Vous pouvez modifier ce comportement à l'aide de la
384 variable @code{toplevel-score-handler} placée en tête.
386 @c FIXME - I cannot read "toplevel-score-handler" in scm/lily.scm -jcm
387 The default handler is defined in the init file @file{../scm/lily.scm}.
391 Un bloc @code{\book} permet de regrouper naturellement plusieurs
392 mouvements -- autrement dit plusieurs blocs @code{\score} -- dans un
393 même document. Lorsqu'il y a plusieurs @code{\score}s, LilyPond génère
394 un seul fichier dans lequel les mouvements sont mis les uns à la suite
395 des autres, ce pour chacun des blocs @code{\book} rencontrés. La seule
396 raison qui peut vous demander d'expliciter plusieurs blocs @code{\book}
397 dans un fichier @file{.ly} est lorsque vous avez besoin de générer
398 différents documents à partir d'une même source. La présence explicite
399 d'un bloc @code{\book} est aussi nécessaire lorsque vous travaillez sur
400 un document lilypond-book qui reprendrait plusieurs @code{\score}s ou
401 @code{\markup}s dans un même extrait. Vous pouvez modifier ce
402 comportement à l'aide de la variable @code{toplevel-score-handler}
405 @c FIXME - I cannot read "toplevel-book-handler" in scm/lily.scm -jcm
406 The default handler is defined in the init file @file{../scm/lily.scm}.
410 Un bloc @code{\bookpart}. Un ouvrage peut se découper en plusieurs
411 parties à l'aide de blocs @code{\bookpart}, aussi bien pour alléger le
412 travail de l'algorithme de calcul des sauts de page, que si les réglages
413 du bloc @code{\paper} diffèrent d'une partie à l'autre.
416 Une expression musicale telle que
421 Ce bout de code sera placé dans un @code{\score} et intégré à l'ouvrage
422 en même temps que tous les autres @code{\score}s ou expressions
423 musicales. En d'autres termes, un fichier qui ne contiendrait que cette
424 simple expression musicale sera traduit en
440 Vous pouvez modifier ce comportement à l'aide de la variable
441 @code{toplevel-music-handler} placée en tête.
443 @c FIXME - I cannot read "toplevel-music-handler" in scm/lily.scm -jcm
444 The default handler is defined in the init file @file{../scm/lily.scm}.
448 Du texte sous forme de @emph{markup} comme les paroles d'un couplet
451 2. Le première ligne du deuxième couplet.
455 De tels @emph{markups} seront imprimés là où ils apparaissent,
456 avant, après ou entre les expressions musicales.
459 @cindex identificateurs
462 Une variable, ou identificateur, telle que
464 toto = @{ c4 d e d @}
467 Vous pourrez la réutiliser plus loin dans votre fichier en saisissant
468 simplement @code{\toto}. Le nom des indentificateurs ne doit être
469 formés que de caractères alphabétiques -- sans chiffre ni caractère
474 Voici trois éléments que vous pouvez placer à un niveau supérieur@tie{}:
478 % pas en pleine largeur
489 Vous pouvez placer, n'importe où dans votre fichier, les instruction
493 @item @code{\version}
494 @item @code{\include}
495 @item @code{\sourcefilename}
496 @item @code{\sourcefileline}
498 Une ligne de commentaire, introduite par le signe @code{%}.
501 Un bloc de commentaire, délimité par @code{%@{ .. %@}}.
508 Vous pouvez insérer des espaces dans votre fichier source afin de lui
509 apporter une meilleure lisibilité. Les espaces superflus sont
510 normalement ignorés. Notez cependant qu'il est des cas où l'espace est
511 requis pour éviter tout risque d'erreur@tie{}:
515 Autour d'une accolade, qu'elle soit ouvrant ou fermante ;
518 Après chaque commande ou variable, autrement dit tout élément qui
519 commence par un @code{\}@tie{};
522 Après tout élément qui sera interprété comme une expression Scheme,
523 autrement dit tout élément qui commence par un @code{#}@tie{};
526 Pour séparer les éléments d'une expression Scheme ;
529 En mode parole -- @code{lyricmode} -- pour séparer les termes des
530 commandes @code{\override} et @code{\set}. Précisons à ce sujet qu'en
531 plus d'ajouter une espace avant et après l'intégralité de la commande,
532 vous devrez encadrer d'espace le point et le signe égal qu'elle peut
534 @w{@code{\override Score . LyricText #'font-size = #5}}.
540 Manuel d'initiation :
541 @rlearning{Organisation des fichiers LilyPond}.
544 @node Titres et entêtes
545 @section Titres et entêtes
546 @translationof Titles and headers
548 La plupart de la musique qui est éditée comporte un titre et le nom de
549 son compositeur@tie{}; certains ouvrages divulguent beaucoup plus
554 * Création de titres::
555 * Titrages personnalisés::
556 * Référencement des numéros de page::
557 * Table des matières::
560 @node Création de titres
561 @subsection Création de titres
562 @translationof Creating titles
564 Des éléments de titrage peuvent s'attacher à un bloc @code{\score}, une
565 partie -- créée par un bloc @code{\bookpart} -- ou bien un ouvrage
566 entier créé par un bloc @code{\book}.
568 Les différents éléments du titrage sont contenus dans un bloc
569 @code{\header}. Un ouvrage complet peut comporter@tie{}:
575 Le dédicataire de l'œuvre, centré en haut de la première page.
579 Le titre de l'œuvre, centré en dessous de la dédicace.
583 Le sous-titre, centré sous le titre.
585 @funindex subsubtitle
587 Un niveau supplémentaire de sous-titre, centré en dessous du sous-titre.
591 Le poète, parolier ou librétiste, aligné à gauche en dessous du
596 L'instrument, centré en dessous du deuxième sous-titre. Il sera rappelé
597 sur les pages suivant la première, centré sur la ligne d'entête.
601 Le compositeur, aligné à droite en dessous du deuxième sous-titre.
605 Le libellé du tempo, aligné à gauche sous le poète.
609 L'arrangeur, aligné à droite sous le compositeur.
613 La pièce ou le mouvement, aligné à gauche sous le tempo.
617 L'opus ou le numéro au catalogue, aligné à droite sous l'arrangeur.
619 @cindex page breaks, forcing
620 @funindex breakbefore
622 Ce commutateur (activé par ##t@tie{}; ##f pour le désactiver) permet de
623 forcer le saut de page avant d'afficher les titres.
627 La notice de droits d'auteur, centrée en pied de la première page. Pour
628 imprimer le symbole @emph{copyright}, consultez la rubrique
629 @ref{Codage du texte}.
633 Mention spéciale imprimée en pied de la dernière page.
637 Voici ce que cela peut donner lorsque tout ces champs sont utilisés.
638 Les différentes commandes mentionnées à la rubrique
639 @ref{Mise en forme du texte} sont opérationnelles pour tous ces
643 @lilypond[quote,verbatim,line-width=11.0\cm]
646 paper-height = 10.0\cm
651 dedication = "dédié à moi-même"
652 title = \markup \center-column { "Première ligne de titre" "Deuxième
653 ligne de titre, plus longue" }
654 subtitle = "un sous-titre,"
655 subsubtitle = #(string-append "sous-sous-titre LilyPond version "
658 composer = \markup \center-column { "compositeur" \small "(1847-1973)" }
659 texttranslator = "Traduit par"
660 meter = \markup { \teeny "m" \tiny "e" \normalsize "t" \large "e" \huge
662 arranger = \markup { \fontsize #8.5 "a" \fontsize #2.5 "r" \fontsize
663 #-2.5 "r" \fontsize #-5.3 "a" \fontsize #7.5 "ngeur" }
664 instrument = \markup \bold \italic "instrument"
688 Comme nous venons de la voir, vous pouvez multiplier les blocs
689 @code{\header}. Lorsqu'un même champ apparaît dans plusieurs blocs,
690 LilyPond utilisera le dernier mentionné@tie{}:
694 composer = "Compositeur"
702 piece = "Nouveau morceau" % remplace le précédent
707 Lorsque le bloc @code{\header} est défini à l'intérieur du bloc
708 @code{\score}, seul les champs @code{piece} et @code{opus} seront
709 imprimés. Attention cependant à toujours placer le bloc @code{\header}
710 après l'expression musicale.
712 @lilypond[quote,verbatim,line-width=11.0\cm]
716 title = "title" % not printed
723 @funindex print-all-headers
725 Vous pouvez modifer ce comportement et imprimer tous les champs d'un
726 bloc @code{\header} défini dans un bloc @code{\score} en ajoutant
730 print-all-headers = ##t
737 Les pieds de page sont vides, hormis pour la première page qui portera
738 la champ @code{copyright} du @code{\header}, et pour la dernière page où
739 apparaîtra le @code{tagline}. Celui-ci est par défaut @qq{Music
740 engraving by LilyPond (@var{version})}.@footnote{Afin que l'on sache qui
741 est capable d'une telle qualité, nous vous saurons gré de ne pas
742 suprimer cette mention spéciale, autant que faire se peut.}
744 Un champ de titrage peut être désactivé@tie{}:
754 @node Titrages personnalisés
755 @subsection Titrages personnalisés
756 @translationof Custom headers footers and titles
758 Vous pouvez personnaliser, dans le bloc @code{\paper}, la définition des
759 variables listées ci-dessous. Leur mise en forme par défaut est
760 inscrite dans le fichier d'initialisation @file{../ly/titling-init.ly}.
763 @funindex bookTitleMarkup
764 @item bookTitleMarkup
765 Ce titre est apposé au début du document final. Il comprend normalement
766 le compositeur et le titre de l'œuvre.
768 @funindex scoreTitleMarkup
769 @item scoreTitleMarkup
770 Ce titre est attaché à un bloc @code{\score}. Il comprend normalement
771 le nom du mouvement -- le champ @code{piece}.
773 @funindex oddHeaderMarkup
774 @item oddHeaderMarkup
775 L'entête des pages impaires.
777 @funindex evenHeaderMarkup
778 @item evenHeaderMarkup
779 L'entête des pages paires. Lorsqu'il n'est pas défini, LilyPond utilise
780 celui des pages impaires.
782 Les entêtes comportent par défaut le nom de l'instrument, au centre, et
783 le numéro de page, sur le bord extérieur de la page.
785 @funindex oddFooterMarkup
786 @item oddFooterMarkup
787 Le pied de page impaire.
789 @funindex evenFooterMarkup
790 @item evenFooterMarkup
791 Le pied de page paire. Lorsqu'il n'est pas défini, LilyPond utilise
792 celui des pages impaires.
794 Par défaut, le pied de la première page comporte la notice de droits
795 d'auteur, et celui de la dernière page la @qq{mention spéciale} -- le
808 La définition suivante permt d'obtenir, sur la même ligne, le titre
809 aligné à gauche et le compositeur aligné à droite.
813 bookTitleMarkup = \markup @{
815 \fromproperty #'header:title
816 \fromproperty #'header:composer
822 Les entêtes et pieds de page sont créés respectivement par les fonctions
823 @code{make-header} and @code{make-footer}, que vous pouvez définir au
824 sein du bloc @code{\paper}. Leur implémentation est contenue dans les
825 fichiers d'initialisation @file{ly/paper-defaults-init.ly} et
826 @file{ly/titling-init.ly}.
828 Voici comment centrer le numéro en pied de chaque page@tie{}:
832 print-page-number = ##t
833 print-first-page-number = ##t
834 oddHeaderMarkup = \markup \fill-line @{ " " @}
835 evenHeaderMarkup = \markup \fill-line @{ " " @}
836 oddFooterMarkup = \markup @{
839 \on-the-fly #print-page-number-check-first
840 \fromproperty #'page:page-number-string
843 evenFooterMarkup = \markup @{
846 \on-the-fly #print-page-number-check-first
847 \fromproperty #'page:page-number-string
854 @node Référencement des numéros de page
855 @subsection Référencement des numéros de page
856 @translationof Reference to page numbers
858 LilyPond vous permet, à l'aide de la commande @code{\label}, d'insérer
859 des points de référence dans un ouvrage, aussi bien en dehors qu'au fil
860 de la musique. Ce point de référence pourra être ensuite repris à
861 l'intérieur d'un @emph{markup}@tie{}; vous pourrez même y ajouter le
862 numéro de page grâce à la commande de @emph{markup} @code{\page-ref}.
865 @lilypond[verbatim,line-width=11.0\cm]
866 \header { tagline = ##f }
872 \pageBreak \mark A \label #'markA
877 \markup { Le premier mouvement débute à la page \page-ref #'firstScore "0" "?" }
878 \markup { Le repère A est à la page \page-ref #'markA "0" "?" }
882 L'instruction @code{\page-ref} prend trois arguments@tie{}:
885 le point de référence, sous la forme d'un symbole scheme, comme par
886 exemple @code{#'firstScore},
889 un @qq{emporte-pièce} afin d'estimer la longueur totale du
893 un texte de remplacement au cas où la référence ne serait pas retrouvée.
896 La présence de l'emporte-pièce est rendue nécessaire par le fait que les
897 @emph{markups} sont générés avant que les sauts de page ne soient
898 positionnés. Bien que le numéro de page en question ne soit pas encore
899 déterminé, LilyPond doit connaître les dimensions de ce @emph{markup}.
900 Vous pouvez, lorsque l'ouvrage contiendra plus de dix pages, stipuler un
901 emporte-pièce sur deux caractères -- soit @code{"00"}.
912 @node Table des matières
913 @subsection Table des matières
914 @translationof Table of contents
916 La commande @code{\markuplines \table-of-contents} vous permettra de
917 générer une table des matières. Les éléments qui la composeront sont
918 créés par la commande @code{\tocItem}, insérée indépendamment ou au sein
919 d'une expression musicale.
922 \markuplines \table-of-contents
925 \tocItem \markup "Premier mouvement"
929 \tocItem \markup "Passage spécifique du premier mouvement"
934 \tocItem \markup "Second mouvement"
942 Les @emph{markups} dévolus à la mise en forme de la table des matières
943 se définissent dans le bloc @code{\paper}. Il s'agit par défaut de
944 @code{tocTitleMarkup} pour le titre de la table, et de
945 @code{tocItemMarkup} pour ses éléments -- composés de leur libellé et
946 numéro de page. Vous pouvez bien entendu personnaliser ces
951 %% Translate the toc title into French:
952 tocTitleMarkup = \markup \huge \column {
953 \fill-line { \null "Table des matières" \null }
956 %% use larger font size
957 tocItemMarkup = \markup \large \fill-line {
958 \fromproperty #'toc:text \fromproperty #'toc:page
963 Notez bien la manière de référencer le libellé et le numéro de page dans
964 la définition de @code{tocItemMarkup}.
966 N'hésitez pas à définir vous-même d'autres commandes et @emph{markups}
967 afin de construire une table plus élaborée@tie{}:
970 commencez par définir une nouvelle variable de type @code{markup} au
971 sein du bloc @code{\paper},
974 puis définissez une fonction musicale chargée d'insérer un élément de la
975 table à partir de cette variable.
978 Dans l'exemple qui suit, nous avons créé un nouveau style d'élément dans
979 le but de mentionner les actes dans la table des matières d'un
984 tocActMarkup = \markup \large \column {
986 \fill-line { \null \italic \fromproperty #'toc:text \null }
992 #(define-music-function (parser location text) (markup?)
993 (add-toc-item! 'tocActMarkup text))
996 @lilypond[line-width=11.0\cm]
997 \header { tagline = ##f }
999 tocActMarkup = \markup \large \column {
1001 \fill-line { \null \italic \fromproperty #'toc:text \null }
1007 #(define-music-function (parser location text) (markup?)
1008 (add-toc-item! 'tocActMarkup text))
1011 \markuplines \table-of-contents
1012 \tocAct \markup { Atto Primo }
1013 \tocItem \markup { Coro. Viva il nostro Alcide }
1014 \tocItem \markup { Cesare. Presti omai l'Egizzia terra }
1015 \tocAct \markup { Atto Secondo }
1016 \tocItem \markup { Sinfonia }
1017 \tocItem \markup { Cleopatra. V'adoro, pupille, saette d'Amore }
1024 Fichiers d'initialisation :
1025 @file{../ly/toc-init.ly}.
1029 @funindex \table-of-contents
1030 @code{\table-of-contents},
1036 @node Travail sur des fichiers texte
1037 @section Travail sur des fichiers texte
1038 @translationof Working with input files
1041 * Insertion de fichiers LilyPond::
1042 * Différentes éditions à partir d'une même source::
1044 * Affichage de notation au format LilyPond::
1047 @node Insertion de fichiers LilyPond
1048 @subsection Insertion de fichiers LilyPond
1049 @translationof Including LilyPond files
1052 @cindex inclusion de fichiers
1054 Lorsqu'un projet prend de l'importance en volume, il est judicieux de le
1055 scinder en plusieurs fichiers, auxquels vous fereez référence avec un
1059 \include "autrefichier.ly"
1062 Une ligne @code{\include "autrefichier.ly"} dans un fichier revient à
1063 recopier intégralement le contenu de @file{autrefichier.ly} à l'endroit
1064 même ou est placée l'instruction @code{\include}. Vous pouvez par
1065 exemple écrire un fichier individuel par instrument, puis les regrouper
1066 pour former le fichier @qq{conducteur}. Les différentes variables
1067 définies dans les fichiers séparés seront normalement reprises et
1068 utilisables dans le fichier formant le conducteur. Les sections
1069 balisées dans les fichiers individuels peuvent être réutilisées en
1070 différents endroit de la partition , comme expliqué à la rubrique
1071 @ref{Différentes éditions à partir d'une même source}.
1073 Lorsque le fichier auquel il est fait référence se trouve dans le même
1074 répertoire, donner seulement son nom en argument à la commande
1075 @code{\include} suffit. S'il se trouve ailleurs, vous devrez indiquer
1076 le chemin d'accès, absolu ou relatif, en respectant toutefois la syntaxe
1077 UNIX -- autrement dit, le séparateur de répertoire est une oblique
1078 normale @code{/} et non l'oblique inverse @code{\} de DOS/Windows. Par
1079 exemple, si le fichier @file{truc.ly} se trouve dans le répertoire
1080 supérieur au répertoire de travail, la ligne devra être
1083 \include "../stuff.ly"
1087 ou bien, si les fichiers correspondant aux parties d'orchestre se
1088 trouvent dans le sous-répertoire @file{parties} relativement au
1089 répertoire courant, vous devrez mentionner
1092 \include "parties/VI.ly"
1093 \include "parties/VII.ly"
1097 Les fichiers à inclure peuvent eux-même contenir des instructions
1098 @code{\include}. Ces instructions @code{\include} de second niveau ne
1099 pourront, par défaut, être interprétées qu'une fois intégrées dans le
1100 fichier principal@tie{}; leur argument doit donc comporter le chemin
1101 relativement au fichier principal et non par rapport au fichier dan
1102 lesquel cette inclusion est mentionnée. Vous pouvez toutefois influer
1103 sur ce comportement à l'aide de l'option @code{-drelative-includes} en
1104 ligne de commande ou en ajoutant une clause
1105 @code{@w{#(ly:set-option 'relative-includes #t)}} en tête du fichier
1106 principal. Une fois @code{relative-include} activé, le chemin à suivre
1107 pour chacune des commandes @code{\include} sera pris relativement au
1108 fichier qui la contient.
1110 Vous pouvez inclure des fichiers dont vous spécifierez le chemin d'accès
1111 sur la ligne de commande au moment de lancer la compilation. L'appel à
1112 ces fichiers ne mentionnerra alors que leur nom. Par exemple, si vous
1113 voulez compiler avec cette méthode le fichier @file{principal.ly} qui
1114 inclut des fichiers situés dans le sous-répertoire @file{parties},
1115 placez vous dans le répertoire contenant @file{principal.ly}, puis tapez
1118 lilypond --include=parties principal.ly
1121 tout en ayant bien dans @file{principal.ly}
1129 Lorsqu'un fichier est voué à être inclus dans nombre de partitions, vous
1130 pouvez le placer dans le répertoire de LilyPond @file{../ly}.
1131 Attention@tie{}: ce répertoire varie selon votre installation, comme
1132 indiqué au chapitre @rlearning{Autres sources de documentation}. Ce
1133 fichier sera inclus dès lors que vous fournirez uniquement son nom en
1134 argument à la fonction @code{\include}. C'est par exemple le cas du
1135 fichier de définition particulier @file{gregorian.ly}.
1137 Au moment où vous lancez LilyPond, un certain nombre de fichiers se
1138 retrouvent inclus par défaut@tie{}; il suffit d'activer le mode verbeux
1139 en faisant @code{lilypond --verbose} pour s'en rendre compte. Vous
1140 verrez ainsi défiler, en plus de nombreuses informations, le nom d'un
1141 certain nombre de fichier et de chemins d'accès. Les fichiers les plus
1142 important sont mentionnés au chapitre
1143 @rlearning{Autres sources de documentation}. Si vous venez à les
1144 modifier, rappelez-vous qu'ils seront écrasés à l'installation d'une
1145 nouvelle version de LilyPond.
1147 Vous trouverez quelques exemples simples d'utilisation de la commande
1148 @code{\include} au chapitre @rlearning{Conducteurs et parties}.
1152 Manuel d'initiation :
1153 @rlearning{Autres sources de documentation},
1154 @rlearning{Conducteurs et parties}.
1159 Lorsque vous incluez un fichier qui porte le même nom que l'un des
1160 fichiers d'initialisation de LilyPond, le fichier de la distribution de
1161 LilyPond aura préséance.
1164 @node Différentes éditions à partir d'une même source
1165 @subsection Différentes éditions à partir d'une même source
1166 @translationof Different editions from one source
1168 Différents mécanismes permettent de générer plusieurs versions d'une
1169 partition à partir d'une même source. Les variables -- ou
1170 idendificateurs -- sont sûrement le moyen le plus simple de combiner de
1171 différente manière des passages relativement longs, alors que les
1172 balises permettront de sélectionner de courts fragments selon leur
1173 utilisation. Quelle que soit la méthode utilisée, séparer la notation
1174 de la structure de la partition vous donnera plus de liberté dans
1175 l'agencement de l'ouvrage final, puisque vous ne reviendrez pas sur la
1176 musique qui le compose.
1179 * Utilisation de variables::
1180 * Utilisation de balises::
1183 @node Utilisation de variables
1184 @unnumberedsubsubsec Utilisation de variables
1185 @translationof Using variables
1187 @cindex variables, utilisation de
1189 Un fragment musical identifié par une variable est réutilisable à divers
1190 endroits de la partition, comme nous l'avons vu à la rubrique
1191 @rlearning{Organisation du code source avec des variables}. Par
1192 exemple, une partition pour chœur @notation{a cappella} comporte souvent
1193 une réduction pour piano reprenant toutes les voix@tie{}; il s'agit de
1194 la même musique, et vous ne devrez donc la saisir qu'une seule fois.
1195 D'autre part, la musique issue de deux variables peut se combiner sur
1196 une seule portée, comme nous l'avons vu à la rubrique
1197 @ref{Regroupement automatique de parties}. Prenons l'exemple
1200 @lilypond[verbatim,quote]
1201 sopranoMusic = \relative c'' { a4 b c b8( a) }
1202 altoMusic = \relative g' { e4 e e f }
1203 tenorMusic = \relative c' { c4 b e d8( c) }
1204 bassMusic = \relative c' { a4 gis a d, }
1205 allLyrics = \lyricmode {King of glo -- ry }
1207 \new Staff = "Soprano" \sopranoMusic
1208 \new Lyrics \allLyrics
1209 \new Staff = "Alto" \altoMusic
1210 \new Lyrics \allLyrics
1211 \new Staff = "Tenor" {
1215 \new Lyrics \allLyrics
1216 \new Staff = "Bass" {
1220 \new Lyrics \allLyrics
1223 \set Staff.printPartCombineTexts = ##f
1229 \set Staff.printPartCombineTexts = ##f
1239 Générer une partition chorale ou la réduction pour piano ne requiert que
1240 de modifier la structure des éléments, sans aucunement toucher à la
1243 Dans le cas d'une partition relativement longue, vous pouvez isoler la
1244 définition des différentes variables dans des fichiers séparés que vous
1245 rappellerez ensuite, comme indiqué à la rubrique
1246 @ref{Insertion de fichiers LilyPond}.
1249 @node Utilisation de balises
1250 @unnumberedsubsubsec Utilisation de balises
1251 @translationof Using tags
1254 @funindex \keepWithTag
1255 @funindex \removeWithTag
1259 La commande @code{\tag #'@var{partieA}} affecte à une expression
1260 musicale le nom @var{partieA}. Les expressions ainsi balisées pourront
1261 être filtrées par la suite, à l'aide de
1262 @code{\keepWithTag@tie{}#'@var{nom}} ou
1263 @code{\removeWithTag@tie{}#'@var{nom}}. Ces filtres fonctionnent de la
1264 manière suivante@tie{}:
1266 @multitable @columnfractions .5 .5
1271 Musique balisée précédée de @code{\keepWithTag #'@var{nom}}
1272 @tab Musique non balisée et musique balisée par @var{nom} seront
1273 incluses@tie{}; la musique balisée autrement est exclue.
1276 Musique balisée précédée de @code{\removeWithTag #'@var{nom}}
1277 @tab Musique non balisée et fragments appelés autrement que @var{nom}
1278 seront inclus@tie{}; la musique balisée par @var{nom} est exclue.
1281 Musiqeu balisée non précédée de @code{\keepWithTag} ou
1282 @code{\removeWithTag}
1283 @tab Musique balisée et non balisée seront incluses.
1287 Les arguments des commandes @code{\tag}, @code{\keepWithTag} et
1288 @code{\removeWithTag} doivent être un symbole (tel que
1289 @code{#'conducteur} ou @code{#'partie}), suivi d'une expression
1292 Dans l'exemple qui suit, nous obtenons deux versions du même extrait,
1293 l'une pour le conducteur, l'autre pour l'instrumentiste, et qui
1294 comportera les ornements développés.
1296 @lilypond[verbatim,quote]
1297 music = \relative g' {
1299 \tag #'trills { d8.\trill }
1300 \tag #'expand { \repeat unfold 3 { e32 d } }
1305 \keepWithTag #'trills \music
1308 \keepWithTag #'expand \music
1313 Il est parfois plus aisé d'exclure des fragments@tie{}:
1315 @lilypond[verbatim,quote]
1316 music = \relative g' {
1318 \tag #'trills { d8.\trill }
1319 \tag #'expand {\repeat unfold 3 { e32 d } }
1324 \removeWithTag #'expand
1328 \removeWithTag #'trills
1333 Ce principe de filtrage peut s'appliquer aux articulations, textes, etc.
1334 Il suffit de positionner
1337 -\tag #@var{ma-balise}
1341 avant l'articulation ou le texte, comme ici :
1345 c1-\tag #'gaffe ^"Attention !"
1349 Ceci définira une note avec une indication conditionnelle de doigté ou
1352 Vous pouvez baliser différemment la même expression musicale en
1353 saisissant plusieurs @code{\tag}@tie{}:
1355 @lilypond[quote,verbatim]
1356 music = \relative c'' {
1357 \tag #'a \tag #'both { a4 a a a }
1358 \tag #'b \tag #'both { b4 b b b }
1361 \keepWithTag #'a \music
1362 \keepWithTag #'b \music
1363 \keepWithTag #'both \music
1367 L'application concomitante de plusieurs filtres @code{\removeWithTag} à
1368 la même expression musicale permet d'exclure plusieurs balisages@tie{}:
1370 @lilypond[verbatim,quote]
1371 music = \relative c'' {
1372 \tag #'A { a4 a a a }
1373 \tag #'B { b4 b b b }
1374 \tag #'C { c4 c c c }
1375 \tag #'D { d4 d d d }
1384 L'application de plus d'un filtre @code{\keepWithTag} à la même
1385 expression musicale aboutit à l'exclusion de @b{tous} les balisages.
1386 En effet, si le premier filtre exclut tous les autres balisages,
1387 l'application du second exclura les effets du premier.
1391 Manuel d'initiation :
1392 @rlearning{Organisation du code source avec des variables}.
1394 Manuel de notation :
1395 @ref{Regroupement automatique de parties},
1396 @ref{Insertion de fichiers LilyPond}.
1400 @c This warning is more general than this placement implies.
1401 @c Rests are not merged whether or not they come from tagged sections.
1402 @c Should be deleted? -td
1406 Lorsqu'elles comportent des silences, ceux-ci ne seront pas fusionnés
1407 si vous imprimez une partition avec les deux sections balisées.
1412 @node Codage du texte
1413 @subsection Codage du texte
1414 @translationof Text encoding
1418 @cindex non-ASCII characters
1420 LilyPond utilise le jeu de caractères défini par le consortium Unicode
1421 et la norme ISO/CEI@tie{}10646. Chaque caractère est identifié par un
1422 nom unique et associé à un point de code, ce qui permet dans l'absolu de
1423 couvrir tous les langages. Unicode permet de coder tous les caractères
1424 utilisés par toutes les langues écrites du monde. LilyPond utilise le
1425 codage UTF-8 (UTF pour @emph{Unicode Transformation Format}) qui permet
1426 de représenter les caractères latins sur un octet et les autres sur une
1427 longueur allant jusqu'à quatre octets.
1429 L'apparence réelle des caractères est déterminée par les glyphes ou
1430 graphèmes tels que définis dans les différentes polices disponibles.
1431 Une police, ou une fonte, définit la mise en correspondance d'un
1432 sous-ensemble de points de code unicode en glyphes. LilyPond recourt à
1433 la bibliothèque Pango pour assurer le rendu des textes multilingues.
1435 LilyPond n'effectue aucune conversion d'encodage que ce soit. Ceci
1436 implique donc que tout texte, qu'il s'agisse d'un titre, de paroles ou
1437 même d'instruction musicale, comportant des caractères non ASCII soit
1438 codé en UTF-8. Le plus sûr moyen de saisir du texte de la sorte
1439 consiste à utiliser un éditeur supportant l'unicode et à enregistrer vos
1440 fichier en UTF-8. C'est le cas pour la plupart des éditeurs actuels,
1441 que ce soit vim, Emacs, jEdit et GEdit. Tous les systèmes Windows
1442 postérieurs à NT utilisent Unicode en natif@tie{}; même Notepad est
1443 capable d'éditer et sauvegarder un fichie en UTF-8 -- sans parler de
1444 l'excellente alternative qu'est BabelPad.
1446 La compilation d'un fichier LilyPond comportant des caractères non ASCII
1447 qui n'aurait pas été enregistré dans l'encodage UTF-8 vous renverra
1451 FT_Get_Glyph_Name () erreur : invalid argument
1454 Voici un exemple utilisant du texte en cyrilique, en hébreux et en
1458 %c No verbatim here as the code does not display correctly in PDF
1460 bulgarian = \lyricmode {
1461 Жълтата дюля беше щастлива, че пухът, който цъфна, замръзна като гьон.
1465 hebrew = \lyricmode {
1466 זה כיף סתם לשמוע איך תנצח קרפד עץ טוב בגן.
1470 portuguese = \lyricmode {
1471 à vo -- cê uma can -- ção legal
1477 \addlyrics { \bulgarian }
1478 \addlyrics { \hebrew }
1479 \addlyrics { \portuguese }
1482 Lorsque vous avez besoin d'un caractère dont vous connaissez le point de
1483 code mais que votre éditeur ne permet pas de saisir directement, vous
1484 pouvez utitliser les instructions @code{\char@tie{}##xhhhh} ou
1485 @code{\char@tie{}#dddd} au sein d'un bloc @code{\markup} -- @code{hhhh}
1486 et @code{dddd} correspondant respectivement à la valeur hexadécimale ou
1487 décimale. Même s'il est inutile de saisir les zéros superflus, il est
1488 de bon ton de stipuler les quatre caractères formant la représentation
1489 hexadécimale. Évitez cependant l'encodage UTF-8 d'un point de code
1490 après un @code{\char}@tie{}; les encodages UTF-8 comprennent un bit
1491 supplémentaire indiquant le nombre d'octets. Une table de
1492 correspondance entre les codes Unicode et le nom des caractères ainsi
1493 que leur code hexadécimal est disponible sur le site du consortium
1494 Unicode, @uref{http://www.unicode.org/}.
1496 Par exemple, @code{\char ##x03BE} et @code{\char #958} correspondent
1497 tous deux au caractère unicode U+03BE, dénommé @qq{Greek Small Letter
1500 Quel que soit le point de code spécifié de cette manière, il ne vous
1501 sera alors pas nécessaire d'enregistrer votre fichier en UTF-8. Vous
1502 devrez toutefois disposer d'une fonte contenant ce caractère qui soit
1503 accessible à LilyPond.
1505 L'exemple suivant illustre la manière d'insérer un caractère sous sa
1506 forme hexadécimale, à la fois dans un repère, dans une articulation,
1507 dans des paroles et dans du texte indépendant.
1509 @lilypond[quote,verbatim]
1512 c1 \mark \markup { \char ##x03EE }
1513 c1_\markup { \tiny { \char ##x03B1 " to " \char ##x03C9 } }
1515 \addlyrics { O \markup { \concat { Ph \char ##x0153 be! } } }
1517 \markup { "Copyright 2008--2010" \char ##x00A9 }
1522 Le signe @emph{copyright} dans le champ de titrage consacré s'inscrit de
1523 la manière suivante@tie{}:
1527 copyright = \markup @{ \char ##x00A9 "2008" @}
1532 @node Affichage de notation au format LilyPond
1533 @subsection Affichage de notation au format LilyPond
1534 @translationof Displaying LilyPond notation
1536 @funindex \displayLilyMusic
1538 La fonction musicale @code{\displayLilyMusic}, disponible uniquement
1539 pour un traitement en ligne de commande, permet d'afficher en
1540 notation LilyPond une expression musicale. Par exemple,
1544 \displayLilyMusic \transpose c a, @{ c4 e g a bes @}
1551 @{ a,4 cis e fis g @}
1554 LilyPond affichera le résultat sous forme de message en console, au
1555 milieu de toutes les informations de compilation. Afin d'isoler ces
1556 messages et enregistrer le résultat de la fonction
1557 @code{\display@{STUFF@}}, pensez à rediriger la sortie vers un fichier.
1560 lilypond fichier.ly >display.txt
1564 @node Contrôle des sorties
1565 @section Contrôle des sorties
1566 @translationof Controlling output
1569 * Extraction de fragments musicaux::
1570 * Ignorer des passages de la partition::
1571 * Formats de sortie alternatifs::
1572 * Changement des fontes musicales::
1575 @node Extraction de fragments musicaux
1576 @subsection Extraction de fragments musicaux
1577 @translationof Extracting fragments of music
1579 LilyPond vous permet d'extraire des fragments d'une partition à l'instar
1580 du choriste amateur qui alimente son album avec des coupures de
1583 Vous devrez pour cela définir les mesures à découper. La définition
1584 suivante, incluse dans votre fichier source,
1591 (make-rhythmic-location 5 1 2)
1592 (make-rhythmic-location 7 3 4)))
1597 vous permettra d'extraire un fragment compris entre le milieu de la
1598 cinquième mesure et quelque part dans la septième. Le triplet
1599 @code{5@tie{}1@tie{}2} signifie@tie{}: après la durée d'une blanche dans
1600 la mesure 5@tie{}; le @code{7@tie{}3@tie{}4} signifie quant à lui que
1601 l'on s'arrête à la mesure 7, après la durée de trois noires.
1603 Rien ne vous empêche d'extraire plusieurs fragments, dès lors que vous
1604 définissez dans la liste d'autres paires d'emplacements ryhtmiques.
1606 Cette fonctionnalité n'est toutefois effective que lorsque vous lancez
1607 LilyPond avec l'option @code{-dclip-systems}. Les @qq{coupures} seront
1608 générées sous la forme de fichiers EPS, convertis en PDF ou PNG selon le
1609 format que vous aurez stipulé.
1611 Pour de plus amples informations quant au format des résultats,
1612 consultez le chapitre @rprogram{Lancement de lilypond}.
1615 @node Ignorer des passages de la partition
1616 @subsection Ignorer des passages de la partition
1617 @translationof Skipping corrected music
1619 @funindex skipTypesetting
1620 @funindex showFirstLength
1621 @funindex showLastLength
1623 Dans un travail de transcription ou de recopie de la musique, ce qui
1624 vous intéresse plus particulièrement se situe à la fin, là même où vous
1625 en êtes dans la notation. Dans le but de gagner du temps dans le
1626 processus de correction, vous pouvez @qq{escamoter} le reste et ne
1627 générer que les dernières mesures en insérant
1630 showLastLength = R1*5
1635 dans votre fichier source. Ceci aura pour effet de ne générer que les
1636 cinq dernières mesures -- si tant est que le morceau soit à 4/4 -- de
1637 tous les @code{\score} de votre fichier. Dans le cas d'un œuvre
1638 conséquente, cette pratique s'avère fort utile puisqu'elle évite de tout
1639 générer. Vous pourriez aussi être amené à retravailler le début d'une
1640 œuvre, pour y ajouter une partie par exemple, auquel cas c'est la
1641 propriété @code{showFirstLength} que vous utiliserez.
1643 Vous pouvez contrôler très finement les parties à escamoter, grâce u
1644 commutateur @code{Score.skipTypesetting}@tie{}: lorsqu'il est activé,
1645 aucune gravure n'est réalisée.
1647 Ce commutateur agit aussi sur la sortie MIDI. Notez bien que tous les
1648 événements seront escamotés, y compris les changements de tempo ou
1649 d'instrument -- vous voilà prévenu@tie{}!
1651 @lilypond[quote,relative=2,ragged-right,verbatim]
1653 \set Score.skipTypesetting = ##t
1655 \set Score.skipTypesetting = ##f
1659 Dans le cadre de musique polyphonique, @code{Score.skipTypesetting}
1660 s'applique à toutes les voix et portées. Vous gagnerez donc encore plus
1664 @node Formats de sortie alternatifs
1665 @subsection Formats de sortie alternatifs
1666 @translationof Alternative output formats
1668 @cindex scalable vector graphics
1669 @cindex SVG, format de sortie
1670 @cindex encapsulated postscript
1671 @cindex EPS, format de sortie
1673 En matière de partition imprimable, LilyPond génère par défaut des
1674 documents au format PstScript (PS) et Portable Document Format (PDF).
1675 Vous pouvez aussi obtenir des documents au format Scalable Vector
1676 Graphics (SVG), Encapsulated PostScript (EPS) ou Portable Network
1677 Graphics (PNG) dès lors que vous aurez lancé LilyPond en ligne de
1678 commande avec l'option @i{ad hoc} -- voir
1679 @rprogram{Options en ligne de commande pour lilypond} à ce sujet.
1682 @node Changement des fontes musicales
1683 @subsection Changement des fontes musicales
1684 @translationof Replacing the notation font
1686 Gonville est ube alternative à la fonte Feta que LilyPond utilise par
1687 défaut. Vous pouvez la télécharger à partir de
1689 @uref{http://www.chiark.greenend.org.uk/~sgtatham/gonville/ ,http://www.chiark.greenend.org.uk/~sgtatham/gonville/}
1692 Voici quelques mesures utilisant la police Gonville@tie{}:
1694 @c NOTE: these images are a bit big, but that's important
1695 @c for the font comparison. -gp
1696 @sourceimage{Gonville_after,,,}
1698 Et ces même mesures avec la police de LilyPond, Feta@tie{}:
1700 @sourceimage{Gonville_before,,,}
1703 @subsubheading Instructions d'installation pour MacOS
1704 @translationof Installation Instructions for MacOS
1706 Téléchargez puis décompressez l'archive zip. Recopiez le répertoire
1707 @code{lilyfonts} dans @file{@var{SHARE_DIR}/lilypond/current} -- voir
1708 @rlearning{Autres sources de documentation} à ce sujet. Renommez le
1709 répertoire @code{fonts} qui s'y trouve en @code{fonts_orig}, puis les
1710 répertoire @code{lilyfonts} en @code{fonts}. Il vous suffira, pour
1711 retrouver la fonte Feta, de renommer @code{fonts_orig} en @code{fonts}.
1715 Manuel d'initiation :
1716 @rlearning{Autres sources de documentation}.
1720 Gonville ne permet pas de générer de la notation ancienne. Consultez le
1721 site de l'auteur pour de plus amples informations ainsi qu'à propos des
1722 conditions d'utilisation.
1726 @section Sortie MIDI
1727 @translationof MIDI output
1729 MIDI (Musical Instrument Digital Interface) constitue un standard en
1730 matière de connexion et de contrôle des instruments électroniques. Un
1731 fichier MIDI contient une série de notes réparties dans différentes
1732 pistes. Il ne s'agit en rien d'un fichier sonore@tie{}; il vous faudra
1733 un logiciel capable de traduire ces séries de notes en sons.
1735 Vous pouvez convertir vos partition en fichier MIDI de manière à
1736 entendre ce que vous avez saisi. Ceci vous permet de contrôler aisément
1737 ce que vous avez saisi@tie{}: octaves et altérations erronées heuteront
1738 votre oreille avertie grâce au MIDI.
1741 Dans une sortie MIDI, LilyPond alloue un canal à chaque portée, plus un
1742 pour les réglages globaux. Par voie de conséquence, un fichier MIDI ne
1743 peut comporter au maximmum que quinze portées (quatorze en l'absence de
1744 percussions)@tie{}; les portées supplémentaires seront tout simplement
1748 * Création de fichiers MIDI::
1750 * Contenu de la sortie MIDI::
1751 * Répétitions et MIDI::
1752 * Gestion des nuances en MIDI::
1753 * MIDI et percussions::
1757 @node Création de fichiers MIDI
1758 @subsection Création de fichiers MIDI
1759 @translationof Creating MIDI files
1761 LilyPond génèrera un fichier MIDI dès que vous ajouterez un bloc
1762 @code{\midi} à la structure de votre partition, comme ici@tie{}:
1771 Lorsque le bloc @code{\score} contient un bloc @code{\midi} mais pas de
1772 bloc @code{\layout}, LilyPond ne produira qu'une sortie MIDI. Si donc
1773 vous avez besoin aussi d'un support visuel, vous devrez aussi mentionner
1774 un bloc @code{\layout}.
1784 Hauteurs, durées, liaisons de prolongation, nuances et changements de
1785 tempo seront interprétés et traduits en événements MIDI. Les
1786 indications de nuances, crescendos et decrescendos sont traduits en
1787 niveau de volume@tie{}; les indications sous la forme d'une fraction
1788 déterminée du volume disponible, et crescendos et decrescendos sous la
1789 forme d'une progression linéaire entre les deux extrêmes. Le rendu des
1790 indications de nuance peut être désactivé pour le MIDI -- voir
1793 Le tempo initial ainsi que ses changements sont normalement indiqués au
1794 fil de la notation à l'aide de la commande @code{\tempo}@tie{}; ils
1795 seront retranscrits dans le fichier MIDI. La commande @code{\tempo}
1796 donne lieu à l'impression d'une indication métronomique que vous pouvez
1797 toutefois rendre invisible, comme indiqué à la rubrique
1798 @ref{Indication métronomique}. Une autre manière de spécifier le tempo
1799 initial pour un fichier MIDI est indiquée plus avant -- voir
1802 En raison de certaines limitations de Windows, les fichiers MIDI doivent
1803 y porter l'extension @code{.mid}. D'autres systèmes utilisent
1804 l'extension @code{.midi}. Si besoin est, placez la ligne suivante au
1805 début de votre fichier source, avant l'ouverture de tout bloc
1806 @code{\book}, @code{\bookpart} ou @code{\score}@tie{}:
1809 #(ly:set-option 'midi-extension "midi")
1812 Cette ligne déterminera @code{.midi} comme extension par défaut pour les
1815 Vous pouvez aussi le faire en ligne de commande@tie{}:
1818 lilypond … -dmidi-extension=midi fichierLily.ly
1822 @unnumberedsubsubsec Noms d'instrument
1823 @translationof Instrument names
1825 @cindex instrument, nom d'
1826 @funindex Staff.midiInstrument
1828 L'instrument MIDI affecté à un canal particulier est déterminé par la
1829 propiété @code{Staff.midiInstrument}. Vous pouvez choisr l'un des
1830 instruments répertoriés à l'annexe @ref{Instruments MIDI}.
1834 \set Staff.midiInstrument = #"glockenspiel"
1840 \new Staff \with @{midiInstrument = #"cello"@} @{
1845 Lorsque l'instrument choisi ne correspond pas exactement à l'une des
1846 dénominations consacrées, LilyPond le replacera par un piano de concert
1847 (@code{"acoustic grand"}).
1852 @lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
1853 {changing-midi-output-to-one-channel-per-voice.ly}
1857 @c In 2.11 the following no longer seems to be a problem -td
1859 Un (de)crescendo non terminé ne sera pas correctement rendu en MIDI --
1860 il y a nécessairement du silence. Il vous faut donc lui donner une fin
1861 explicite. Par exemple,
1868 ne fonctionnera pas correctement, contrairement à
1871 @{ a4\< b c d\!\f @}
1875 Un changement de volume ne peut intervenir que sur le démarrage d'une
1876 note. C'est la raison pour laquelle la succession d'un crescendo et
1877 d'un diminuendo ne peut se produire sur une même note.
1879 Certains lecteurs MIDI ne rendent pas correctement les changements de
1880 tempo. MS Windows Media Player et
1881 @uref{http://@/timidity@/.sourceforge@/.net/,timidity} le font sans
1886 @subsection Le bloc MIDI
1887 @translationof MIDI block
1889 Dès lors que vous désirez obtenir une sortie MIDI, vous devrez inscrire
1890 un bloc @code{\midi} au sein du bloc @code{\score}. Son fonctionnement
1891 est comparable à ce lui du bloc @code{\layout}, voire plus simple. Si
1892 le bloc @code{\midi} est la plupart du temps laissé vide, il peut
1893 contenir des aménagements pour certains contextes, la définition de
1894 contextes particuliers ou du code permettant de déterminer la valeur de
1895 certianes propriétés. L'exemple suivant détermine le tempo initial du
1896 fichier MIDI tout en se passant de son indication sur la partition
1905 tempoWholesPerMinute = #(ly:make-moment 72 4)
1911 Ici, le tempo est fixé à 72 noires à la minute. Spécifier un tempo de
1912 la sorte ne permet pas de doner une valeur pour une note pointée. Vous
1913 devrez, en pareil cas, subdiviser la note pointée en durée plus courte.
1914 Par exemple, indiquer 90 à la noire pointée est équivalent à spécifier
1915 270 croches à la minute@tie{}:
1918 tempoWholesPerMinute = #(ly:make-moment 270 8)
1921 @cindex MIDI et définition de contexte
1922 @cindex contexte, définition en MIDI
1924 La syntaxe permettant de définir un contexte pour le @code{\midi} est en
1925 tout point identique à celle que vous utilisez dans le bloc
1926 @code{\layout}, à ceci près que le @qq{graveur} est remplacé par un
1927 @qq{interprète}. Les différents contextes disponibles en matière de
1928 MIDI sont répertoriés dans le fichier d'initialisation
1929 @file{../ly/performer-init.ly} -- pour plus de détail, voir
1930 @rlearning{Autres sources de documentation}.
1931 Si vous voulez vous passer des nuances dans votre fichier MIDI, il vous
1932 suffit d'insérer les lignes suivantes dans votre bloc
1940 \remove "Dynamic_performer"
1945 LilyPond ne génèrera de sortie MIDI que si vous incluez un bloc
1946 @code{\midi} dans la structure de la partition, initialisée par la
1947 commande @code{\score}.
1951 @{ @dots{}notes@dots{} @}
1957 @node Contenu de la sortie MIDI
1958 @subsection Contenu de la sortie MIDI
1959 @translationof What goes into the MIDI output?
1961 @c TODO Check grace notes - timing is suspect?
1964 @unnumberedsubsubsec Éléments pris en compte dans le MIDI
1965 @translationof Supported in MIDI
1967 @cindex hauteurs en MIDI
1968 @cindex MIDI, hauteurs
1969 @cindex quart de ton en MIDI
1970 @cindex MIDI, quart de ton
1971 @cindex microtonalité en MIDI
1972 @cindex MIDI, microtonalité
1973 @cindex accords nommés en MIDI
1974 @cindex MIDI, accords nommés
1975 @cindex Rythme en MIDI
1976 @cindex MIDI, Rythme
1979 Un fichier MIDI généré par LilyPond comprendra les éléments de notation
1987 les microtonalités -- voir @ref{Altérations}. Leur rendu nécessite
1988 cependant un lecteur qui prenne en charge la modulation@tie{};
1991 les accords nommés ;
1994 le rythme en tant que durée de note, y compris les nolets ;
1997 les tremolos, exceptés ceux utilisant la syntaxe
1998 @qq{@code{:}[@var{nombre}]}@tie{};
2001 les liaisons de prolongation ;
2004 les indications de nuance
2007 les crescendos et decrescendos s'étalant sur plusieurs notes@tie{};
2010 les changements de tempo indiqués par un @code{\tempo}@tie{};
2017 @unnumberedsubsubsec Éléments non pris en compte dans le MIDI
2018 @translationof Unsupported in MIDI
2020 @c TODO index as above
2022 LilyPond ne peut générer d'événement MIDI pour les éléments
2027 le rythme indiqué sous forme d'annotation (p.ex. @emph{swing})@tie{};
2030 les changements de tempo indiqués sous forme d'annotation (sans
2031 @code{\tempo})@tie{};
2034 les staccatos et autres articulations ou ornementations@tie{};
2037 les liaisons d'articulation et de prhasé@tie{};
2040 les crescendos ou decrescendos sur une sele note@tie{};
2043 les tremolos indiqués par la syntaxe @qq{@code{:}[@var{nombre}]}@tie{};
2049 les accords en microtonalité.
2053 @node Répétitions et MIDI
2054 @subsection Répétitions et MIDI
2055 @translationof Repeats in MIDI
2057 @cindex reprises développées
2058 @funindex \unfoldRepeats
2060 Au prix de quelques réglages, les reprises de toutes sortes peuvent être
2061 rendues dans le fichier MIDI. Il suffit pour cela de recourir à la
2062 fonction @code{\unfoldRepeats}, qui développe toutes les reprises. En
2063 d'autre termes, @code{\unfoldRepeats} transforme toutes les reprises
2064 en reprises de type @code{unfold}.
2067 @lilypond[quote,verbatim]
2069 \repeat tremolo 8 {c'32 e' }
2070 \repeat percent 2 { c''8 d'' }
2071 \repeat volta 2 {c'4 d' e' f'}
2080 Lorsque l'on veut utiliser @code{\unfoldRepeats} seulement pour le rendu
2081 MIDI, il faut établir deux blocs @code{\score}@tie{}: un pour le MIDI,
2082 avec des reprises explicites, et l'autre pour la partition, avec des
2083 reprises notées sous forme de barres de reprise, de trémolo ou de
2084 symboles de pourcentage. Par exemple
2092 \unfoldRepeats @var{..musique..}
2098 @node Gestion des nuances en MIDI
2099 @subsection Gestion des nuances en MIDI
2100 @translationof Controlling MIDI dynamics
2102 Les nuances MIDI sont générées par le @code{Dynamic_performer}, affecté
2103 par défaut au contexte @code{Voice}. Vous pouvez contrôler à la fois le
2104 volume général, celui des indications de nuance ainsi que celui des
2105 différents instruments.
2108 @unnumberedsubsubsec Indications de nuance
2109 @translationof Dynamic marks
2111 Les indications de nuances sont transcrites en fraction du volume MIDI.
2112 Nous allons, par défaut, de 0,25 pour un @notation{ppppp} à 0,95 pour un
2113 @notation{fffff}. Les correspondances entre nuance et fraction de
2114 volume sont répertoriées dans le fichier @file{../scm/midi.scm} --
2115 consultez la rubrique @rlearning{Autres sources de documentation} si
2116 vous ne savez comment le localiser. Vous pouvez modifier ou étendre ce
2117 jeu grâce à une fonction qui prendra en argument une indication de
2118 nuance et renverra la fraction désirée, puis en affectant cette fonction
2119 à @code{Score.dynamicAbsoluteVolumeFunction}.
2121 Prenons un exemple. Votre partition comporte un @notation{rinforzando}
2122 que vous avez indiqué par @code{\rfz}. Cette indication de nuance
2123 n'étant pas répertoriée dans le jeu par défaut, elle ne produira aucun
2124 effet en MIDI. Il en sera d'ailleurs de même pour toute indication
2125 créée de toute pièce à l'aide de l'instruction
2126 @code{make-dynamic-script}. Voici comment procéder pour ajuster le
2127 volume MIDI de ce @notation{rinforzando} que le compositeur a indiqué.
2128 La fonction Scheme définit une fraction de 0,9 en cas de @notation{rfz},
2129 et demande d'utiliser la fonction par défaut dans les autre cas.
2131 @lilypond[verbatim,quote]
2132 #(define (myDynamics dynamic)
2133 (if (equal? dynamic "rfz")
2135 (default-dynamic-absolute-volume dynamic)))
2139 \set Staff.midiInstrument = #"cello"
2140 \set Score.dynamicAbsoluteVolumeFunction = #myDynamics
2152 Si vous étiez amené à devoir modifier l'intégralité du jeu des
2153 correspondances, nous vous conseillons d'utiliser la procédure
2154 @command{default-dynamic-absolute-volume} contenue dans le fichier
2155 @file{../scm/midi.scm} ansi que la table d'association comme base. Le
2156 dernier exemple de cette partie illustre la manière de procéder.
2159 @unnumberedsubsubsec Amplitude du volume en MIDI
2160 @translationof Overall MIDI volume
2162 Les valeurs extrêmes du volume MIDI des nuances se contrôlent à l'aide
2163 des propriétés @code{midiMinimumVolume} et @code{midiMaximumVolume} qui
2164 agissent au niveau @code{Score}. Ces propriétés sont effectives dès
2165 lors qu'une nuance est indiquée@tie{}; une nuance de départ est donc
2166 requise pour que le volume soit ajusté dès le début de la partition.
2167 Vous pouvez alors modifier la fraction correspondant à chaque nuance à
2168 l'aide de la formule
2171 midiMinimumVolume + (midiMaximumVolume - midiMinimumVolume) * fraction
2174 Voici comment ajuster les nuances tout en limitant l'amplitude du volume
2175 entre 0,2 et 0,5@tie{}:
2177 @lilypond[verbatim,quote]
2183 \set Staff.midiInstrument = #"flute"
2184 \new Voice \relative c''' {
2192 \set Staff.midiInstrument = #"clarinet"
2193 \new Voice \relative c'' {
2204 tempoWholesPerMinute = #(ly:make-moment 72 2)
2205 midiMinimumVolume = #0.2
2206 midiMaximumVolume = #0.5
2213 @unnumberedsubsubsec Égalisation de plusieurs instruments (i)
2214 @translationof Equalizing different instruments (i)
2216 La définition de l'amplitude du volume MIDI au niveau d'un contexte
2217 @code{Staff} permet de gérer les volumes relatifs entre les différents
2218 instruments. Ceci constitue en quelque sorte un égaliseur, ce qui
2219 permet d'améliorer notablement la qualité de la sortie MIDI.
2221 La clarinette de l'exemple suivant jouera relativement moins fort que la
2222 flûte. Rappelez-vous que pour que cela fonctionne correctement, la
2223 première note de chacun des instruments doit être affublée d'une
2224 indication de nuance.
2226 @lilypond[verbatim,quote]
2232 \set Staff.midiInstrument = #"flute"
2233 \set Staff.midiMinimumVolume = #0.7
2234 \set Staff.midiMaximumVolume = #0.9
2235 \new Voice \relative c''' {
2243 \set Staff.midiInstrument = #"clarinet"
2244 \set Staff.midiMinimumVolume = #0.3
2245 \set Staff.midiMaximumVolume = #0.6
2246 \new Voice \relative c'' {
2257 tempoWholesPerMinute = #(ly:make-moment 72 2)
2264 @unnumberedsubsubsec Égalisation de plusieurs instruments (ii)
2265 @translationof Equalizing different instruments (ii)
2267 Lorsque les propriétés volume minimum et maximum n'ont pas été définies,
2268 LilyPond appliquera par défaut une légère égalisation pour quelques
2269 instruments. Les instrument concernés ainsi que le niveau d'égalisation
2270 sont répertoriés dans une table @notation{instrument-equalizer-alist}
2271 du fichier @file{../scm/midi.scm}.
2273 Vous pouvez remplacer l'égaliseur basique en définissant une nouvelle
2274 procédure Scheme @code{instrumentEqualizer} au sein du contexte
2275 @code{Score}. Cette procédure prend en unique argument le nom d'un
2276 instrument MIDI et renverra une paire de fractions correspondant au
2277 minimum et maximum de volume alloué à cet instrument. Cette
2278 substitution fonctionne selon le même principe que celui que nous avons
2279 vu en dédut de chapitre avec @code{dynamicAbsoluteVolumeFunction}.
2280 L'égaliseur par défaut, @notation{default-instrument-equalizer}, est
2281 défini dans le fichier @file{../scm/midi.scm}@tie{}; son analyse vous
2282 aidera à construire votre propre procédure.
2284 Nous allons, dans l'exemple suivant, régler le volume relatif de la
2285 flûte et de la clarinette -- au même niveau que dans le précédent.
2287 @lilypond[verbatim,quote]
2288 #(define my-instrument-equalizer-alist '())
2290 #(set! my-instrument-equalizer-alist
2293 ("flute" . (0.7 . 0.9))
2294 ("clarinet" . (0.3 . 0.6)))
2295 my-instrument-equalizer-alist))
2297 #(define (my-instrument-equalizer s)
2298 (let ((entry (assoc s my-instrument-equalizer-alist)))
2307 \set Score.instrumentEqualizer = #my-instrument-equalizer
2308 \set Staff.midiInstrument = #"flute"
2309 \new Voice \relative c''' {
2317 \set Staff.midiInstrument = #"clarinet"
2318 \new Voice \relative c'' {
2329 tempoWholesPerMinute = #(ly:make-moment 72 2)
2336 @c Delete when satisfied this is adequately covered elsewhere -td
2338 @n ode Microtones in MIDI
2339 @s ubsection Microtones in MIDI
2341 @cindex microtones in MIDI
2343 Microtones consisting of half sharps and half flats are exported
2344 to the MIDI file and render correctly in MIDI players which support
2345 pitch bending. See @ref{Note names in other languages}. Here is
2346 an example showing all the half sharps and half flats. It can be
2347 copied out and compiled to test microtones in your MIDI player.
2349 @lilypond[verbatim,quote]
2366 @node MIDI et percussions
2367 @subsection MIDI et percussions
2368 @translationof Percussion in MIDI
2370 La notation pour percussions recourt généralement à un contexte
2371 particulier -- le @code{DrumStaff} -- qui permet d'affecter directement
2372 les instruments concernés au canal@tie{}10 qui leur est réservé.
2374 Certains instruments, tels le xylophone, le marimba, le vibraphone ou
2375 les timbales, se traitent cependant comme des instruments
2376 @qq{classiques} puisqu'ils sont capables d'émettre des hauteurs
2377 différentes@tie{}; leurs notation relève donc d'un contexte @code{Staff}
2378 standard, et non d'un @code{DrumStaff} pour pouvoir être rendus
2379 correctement en MIDI.
2381 D'autres percussions, bien que n'émettant qu'un seul son et inclus dans
2382 le standard @emph{general MIDI}, comme le tom mélodique ou le tambour
2383 taiko, ne sont pas attachés au canal@tie{}10. Ces instruments doivent
2384 donc être saisi dans un contexte @code{Staff}, en utilisant la hauteur
2387 De nombreux instruments de la famille des percussions, les castagnettes
2388 par exemple, n'existent pas dans le standard @emph{general MIDI}.
2389 L'alternative, bien que peu satisfaisante, consiste à leur attribuer le
2390 son le plus proche dans la banque standard.
2392 @c TODO Expand with examples, and any other issues
2396 Le standard @emph{general MIDI} ne dispose pas du @emph{rim shot}@tie{};
2397 LilyPond lui subtitue un @emph{sidestick}.