]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/fr/notation/input.itely
Doc-fr: fix bad commitishes
[lilypond.git] / Documentation / fr / notation / input.itely
index 73bed790755396f731b606b42ceaab6492a3e3be..98c30930ec0b230016c77ae63ea136ca6837f5b5 100644 (file)
@@ -1,11 +1,11 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 
 @ignore
-    Translation of GIT committish: 53cff5245f682708a6c77d580f418ece2923c2e4
+   Translation of GIT committish: 88a5dbc589b0d0434f8e640467b5ab57d14dc461
 
-    When revising a translation, copy the HEAD committish of the
-    version that you are working on.  For details, see the Contributors'
-    Guide, node Updating translation committishes..
+   When revising a translation, copy the HEAD committish of the
+   version that you are working on.  For details, see the Contributors'
+   Guide, node Updating translation committishes..
 @end ignore
 
 @c \version "2.19.22"
@@ -550,6 +550,10 @@ Manuel de notation :
 @section Titres et entêtes
 @translationof Titles and headers
 
+@cindex titre
+@cindex entête
+@cindex pied de page
+
 La plupart de la musique qui est éditée comporte un titre et le nom de
 son compositeur ; certains ouvrages dispensent beaucoup plus
 d'informations.
@@ -557,6 +561,7 @@ d'informations.
 @menu
 * Création de titres et entête ou pied de page::
 * Titrages personnalisés::
+* Création de métadonnées PDF::
 * Notes de bas de page::
 * Référencement des numéros de page::
 * Table des matières::
@@ -718,7 +723,7 @@ supprimés manuellement :
   \header {
     title = "DAS WOHLTEMPERIRTE CLAVIER"
     subtitle = "TEIL I"
-    % Pas de mention spéciale pour cet ouvrage
+    % Pas de mention spéciale par défaut pour cet ouvrage
     tagline = ##f
   }
   \markup { \vspace #1 }
@@ -752,16 +757,17 @@ supprimés manuellement :
 
 @seealso
 Manuel de notation :
-@ref{Structure de fichier},
 @ref{Mise en forme par défaut des titrages subalternes},
-@ref{Mise en forme personnalisée des titrages}.
+@ref{Mise en forme personnalisée des titrages},
+@ref{Structure de fichier}.
 
 
 @node Mise en forme par défaut des titrages subalternes
 @unnumberedsubsubsec Mise en forme par défaut des titrages subalternes
 @translationof Default layout of bookpart and score titles
 
-Voici les différentes variables attachées au bloc @code{\header} :
+Voici les différentes variables imprimables attachées au bloc
+@code{\header} :
 
 @c KEEP LY
 @lilypond[papersize=a6landscape,quote,verbatim,noragged-right]
@@ -781,8 +787,8 @@ Voici les différentes variables attachées au bloc @code{\header} :
     meter = "Tempo"
     arranger = "Arrangeur"
       % Les champs suivants sont centrés en bas de page
-    tagline = "« tagline » ou mention spéciale en pied de dernière page"
-    copyright = "copyright en pied de première page"
+    tagline = "Le « tagline » ou mention spéciale va en pied de dernière page"
+    copyright = "Le copyright va en pied de première page"
   }
   \score {
     { s1 }
@@ -920,13 +926,13 @@ page, ou bien sous le @code{copyright} s'il n'y a qu'une seule page.
 
 @end itemize
 
-La mention spéciale se modifie en alimentant le champ @code{tagline} au
-niveau du bloc @code{\header} principal.
+Le texte de la mention spéciale par défaut se modifie en alimentant le
+champ @code{tagline} au niveau du bloc @code{\header} principal.
 
 @lilypond[papersize=a8landscape,verbatim]
 \book {
   \header {
-    tagline = "... music notation for Everyone"
+    tagline = "... la notation musicale pour Tous"
   }
   \score {
     \relative {
@@ -936,8 +942,8 @@ niveau du bloc @code{\header} principal.
 }
 @end lilypond
 
-Pour supprimer le @code{tagline}, il suffit de lui assigner la valeur
-@code{##f}.
+Pour supprimer le @code{tagline} par défaut, il suffit de lui assigner
+la valeur @code{##f}.
 
 
 @node Titrages personnalisés
@@ -1252,6 +1258,49 @@ fichiers d'initialisation :
 @file{../ly/titling-init.ly}.
 
 
+@node Création de métadonnées PDF
+@subsection Création de métadonnées PDF
+@translationof Creating PDF metadata
+
+@cindex PDF metadata
+@cindex métadonnées PDF
+
+En plus de s'imprimer sur la partition, les variables du bloc
+@code{\header} permettent de générer les métadonnées PDF (informations
+par les lecteurs de PDF en tant que @code{propriétés} du fichier PDF).
+Par exemple, affecter « Symphony I » à la propriété @code{title} dans le
+bloc @code{\header} donnera aussi ce titre au document PDF.
+
+@example
+  @code{\header@{}
+    @code{title = "Symphony I"}
+  @code{@}}
+@end example
+
+Lorsque le titre imprimé diffère de celui affiché en tant que propriété
+du PDF, devra être renseignée la propriété @code{pdftitle}.
+
+@example
+  @code{\header@{}
+    @code{title = "Symphony I"}
+    @code{pdftitle = "Symphony I by Beethoven"}
+  @code{@}}
+@end example
+
+Les variables @code{title}, @code{subject}, @code{keywords},
+@code{subtitle}, @code{composer}, @code{arranger}, @code{poet},
+@code{author} et @code{copyright} initialisent toutes les propriétés
+PDF, qu'il suffit de préfixer d'un « pdf » pour affecter aux propriétés
+PDF une valeur divergente de la sortie imprimable.
+
+La propriété PDF @code{Creator} prend automatiquement la valeur
+« LilyPond » additionnée deu numéro de version ; les valeurs de
+@code{CreationDate} et @code{ModDate} sont définies à la date et l'heure
+courantes -- @code{ModDate} peut être écrasé par la variable de
+@code{\header} @code{moddate} (ou @code{pdfmoddate}) pour un horodatage
+PDF valide.
+
+
 @node Notes de bas de page
 @subsection Notes de bas de page
 @translationof Creating footnotes
@@ -1776,8 +1825,8 @@ le point de référence, sous la forme d'un symbole Scheme, comme par
 exemple @code{#'firstScore},
 
 @item
-un @qq{emporte-pièce} afin d'estimer la longueur totale du
-@emph{markup}, et
+un « emporte-pièce » afin d'estimer la longueur totale du @emph{markup},
+et
 
 @item
 un texte de remplacement au cas où la référence ne serait pas retrouvée.
@@ -1829,42 +1878,89 @@ d'une expression musicale.
 @end verbatim
 
 Les @emph{markups} dévolus à la mise en forme de la table des matières
-se définissent dans le bloc @code{\paper}.  Il s'agit par défaut de
-@code{tocTitleMarkup} pour le titre de la table, et de
-@code{tocItemMarkup} pour ses éléments -- composés de leur libellé et
-numéro de page.  Vous pouvez bien entendu personnaliser ces variables :
+se définissent dans le bloc @code{\paper}. LilyPond dispose de deux
+@emph{markups} prédéfinis :
+
+@itemize
+
+@item
+@code{tocTitleMarkup}
+
+@noindent
+Utilisé pour mettre en forme le titre de la table des matières.
+
+@verbatim
+tocTitleMarkup = \markup \huge \column {
+  \fill-line { \null "Table of Contents" \null }
+  \null
+}
+@end verbatim
+
+@item
+@code{tocItemMarkup}
+
+@noindent
+Utilisé pour mettre en forme les éléments au sein de la table des
+matières.
+
+@verbatim
+tocItemMarkup = \markup \fill-line {
+  \fromproperty #'toc:text \fromproperty #'toc:page
+}
+@end verbatim
+
+@end itemize
+
+@noindent
+Ces variables sont adaptables.
+
+Voici comment, par exemple, franciser le titre :
 
 @verbatim
 \paper {
-  %% Traduit le titre de la table des matières en français :
   tocTitleMarkup = \markup \huge \column {
     \fill-line { \null "Table des matières" \null }
     \hspace #1
   }
-  %% des fontes un peu plus grandes
-  tocItemMarkup = \markup \large \fill-line {
-    \fromproperty #'toc:text \fromproperty #'toc:page
-  }
+@end verbatim
+
+L'exemple suivant illustre la manière de modifier la taille des éléments
+de la table des matières :
+
+@verbatim
+tocItemMarkup = \markup \large \fill-line {
+  \fromproperty #'toc:text \fromproperty #'toc:page
 }
 @end verbatim
 
 Notez bien la manière de référencer le libellé et le numéro de page dans
 la définition de @code{tocItemMarkup}.
 
-N'hésitez pas à définir vous-même d'autres commandes et @emph{markups}
-afin de construire une table plus élaborée :
-@itemize
-@item
-commencez par définir une nouvelle variable de type @code{markup} au
-sein du bloc @code{\paper},
+L'élément et son numéro de page peuvent se rejoindre par une ligne
+pointillée :
 
-@item
-puis définissez une fonction musicale chargée d'insérer un élément de la
-table à partir de cette variable.
-@end itemize
+@lilypond[verbatim,line-width=10.0\cm]
+\header { tagline = ##f }
+\paper {
+  tocItemMarkup = \tocItemWithDotsMarkup
+}
+
+\book {
+  \markuplist \table-of-contents
+  \tocItem \markup { Allegro }
+  \tocItem \markup { Largo }
+  \markup \null
+}
+@end lilypond
 
-Dans l'exemple qui suit, nous avons créé un nouveau style d'élément dans
-le but de mentionner les actes dans la table des matières d'un opéra :
+N'hésitez pas à définir vous-même d'autres commandes et @emph{markups}
+afin de construire une table plus élaborée.  Dans l'exemple qui suit,
+nous créons un nouveau style d'élément dans le but de mentionner les
+actes dans la table des matières d'un opéra :
+
+@noindent
+Commençons par définir une nouvelle variable de type @code{markup} --
+appelée @code{tocActMarkup} -- au sein du bloc @code{\paper}.
 
 @verbatim
 \paper {
@@ -1874,12 +1970,22 @@ le but de mentionner les actes dans la table des matières d'un opéra :
     \hspace #1
   }
 }
+@end verbatim
 
+@noindent
+Créons ensuite une fonction musicale (@code{tocAct}) utilisant la
+nouvelle définition de @emph{markup} @code{tocActMarkup}.
+
+@verbatim
 tocAct =
-#(define-music-function (text) (markup?)
-   (add-toc-item! 'tocActMarkup text))
+  #(define-music-function (text) (markup?)
+     (add-toc-item! 'tocActMarkup text))
 @end verbatim
 
+@noindent
+Dans un fichier LilyPond, l'utilisation de cette définition
+personnalisée pourrait ressembler à ceci :
+
 @lilypond[line-width=10.0\cm]
 \header { tagline = ##f }
 \paper {
@@ -1891,8 +1997,8 @@ tocAct =
 }
 
 tocAct =
-#(define-music-function (text) (markup?)
-   (add-toc-item! 'tocActMarkup text))
+  #(define-music-function (text) (markup?)
+     (add-toc-item! 'tocActMarkup text))
 
 \book {
   \markuplist \table-of-contents
@@ -1906,22 +2012,16 @@ tocAct =
 }
 @end lilypond
 
-L'élément et son numéro de page peuvent se rejoindre par une ligne
-pointillée :
-
-@lilypond[verbatim,line-width=10.0\cm]
-\header { tagline = ##f }
-\paper {
-  tocItemMarkup = \tocItemWithDotsMarkup
-}
+Voici comment utiliser la commande @code{\fill-with-pattern} dans le
+cadre d'une table des matières :
 
-\book {
-  \markuplist \table-of-contents
-  \tocItem \markup { Allegro }
-  \tocItem \markup { Largo }
-  \markup \null
-}
-@end lilypond
+@verbatim
+  tocItemMarkup = \markup { \fill-line {
+    \override #'(line-width . 70)
+    \fill-with-pattern #1.5 #CENTER . \fromproperty #'toc:text \fromproperty #'toc:page
+    }
+  }
+@end verbatim
 
 @predefined
 @funindex \table-of-contents
@@ -2148,7 +2248,7 @@ sopranoMusic = \relative { a'4 b c b8( a) }
 altoMusic = \relative { e'4 e e f }
 tenorMusic = \relative { c'4 b e d8( c) }
 bassMusic = \relative { a4 gis a d, }
-allLyrics = \lyricmode {King of glo -- ry }
+allLyrics = \lyricmode { King of glo -- ry }
 <<
   \new Staff = "Soprano" \sopranoMusic
   \new Lyrics \allLyrics
@@ -2167,16 +2267,12 @@ allLyrics = \lyricmode {King of glo -- ry }
   \new PianoStaff <<
     \new Staff = "RH" {
       \set Staff.printPartCombineTexts = ##f
-      \partcombine
-      \sopranoMusic
-      \altoMusic
+      \partcombine \sopranoMusic \altoMusic
     }
     \new Staff = "LH" {
       \set Staff.printPartCombineTexts = ##f
       \clef "bass"
-      \partcombine
-      \tenorMusic
-      \bassMusic
+      \partcombine \tenorMusic \bassMusic
     }
   >>
 >>
@@ -2414,8 +2510,8 @@ Manuel d'initiation :
 @rlearning{Organisation du code source avec des variables}.
 
 Manuel de notation :
-@ref{Regroupement automatique de parties},
-@ref{Insertion de fichiers LilyPond}.
+@ref{Insertion de fichiers LilyPond},
+@ref{Regroupement automatique de parties}.
 
 @knownissues
 L'application d'un @code{\relative} à une expression musicale
@@ -2452,8 +2548,8 @@ styles, comme indiqué au chapitre @rlearning{Feuilles de style}.
 
 @seealso
 Manuel d'initiation :
-@rlearning{Organisation du code source avec des variables},
-@rlearning{Feuilles de style}.
+@rlearning{Feuilles de style},
+@rlearning{Organisation du code source avec des variables}.
 
 Manuel de notation :
 @ref{Insertion de fichiers LilyPond}.
@@ -2518,6 +2614,17 @@ portugais.
 
 @lilypond[quote]
 %c No verbatim here as the code does not display correctly in PDF
+% Font settings for Cyrillic and Hebrew
+% Linux Libertine fonts contain Cyrillic and Hebrew glyphs.
+\paper {
+  #(define fonts
+    (set-global-fonts
+     #:roman "Linux Libertine O,serif"
+     #:sans "Linux Biolinum O,sans-serif"
+     #:typewriter "Linux Libertine Mono O,monospace"
+   ))
+}
+
 % Cyrillic
 bulgarian = \lyricmode {
   Жълтата дюля беше щастлива, че пухът, който цъфна, замръзна като гьон.
@@ -2749,12 +2856,15 @@ Ce commutateur agit aussi sur la sortie MIDI.  Notez bien que tous les
 événements seront escamotés, y compris les changements de tempo ou
 d'instrument -- vous voilà prévenu !
 
-@lilypond[quote,relative=2,ragged-right,verbatim]
-c8 d
-\set Score.skipTypesetting = ##t
-e8 e e e e e e e
-\set Score.skipTypesetting = ##f
-c8 d b bes a g c2
+@lilypond[quote,ragged-right,verbatim]
+\relative c' {
+  c1
+  \set Score.skipTypesetting = ##t
+  \tempo 4 = 80
+  c4 c c c
+  \set Score.skipTypesetting = ##f
+  d4 d d d
+}
 @end lilypond
 
 Dans le cadre de musique polyphonique, @code{Score.skipTypesetting}
@@ -2847,6 +2957,8 @@ supplémentaire pour les écouter.
 * Gestion des nuances en MIDI::
 * Gestion des instruments MIDI::
 * Gestion des répétitions en MIDI::
+* Affectation des canaux MIDI::
+* Propriétés de contextes et effets MIDI::
 * Amélioration du rendu MIDI::
 @end menu
 
@@ -2880,6 +2992,10 @@ accent, marcato et portato,
 « @code{:}[@var{nombre}] ».
 @end itemize
 
+Spatialisation, balance, expression, réverbération et chorus peuvent se
+contrôler à l'aide de propriétés de contexte -- voir
+@ref{Propriétés de contextes et effets MIDI}.
+
 En combinaison avec le script @file{articulate}, d'autres éléments
 seront aussi reportés en MIDI :
 
@@ -2910,7 +3026,7 @@ Voir @ref{Amélioration du rendu MIDI}.
 
 @cindex MIDI, éléments non pris en comte
 
-Certains éléments de notation ne peuvent être retranscits dans un
+Certains éléments de notation ne peuvent être retranscrits dans un
 fichier MIDI :
 
 @itemize
@@ -2952,7 +3068,7 @@ LilyPond produira uniquement la sortie MIDI -- aucun support visuel ne
 sera généré.}
 
 L'extension par défaut des fichiers MIDI générés (@code{.midi}) peut se
-modifier en ligne de commadne :
+modifier en ligne de commande :
 
 @example
 lilypond -dmidi-extension=mid MonFichier.ly
@@ -3196,17 +3312,13 @@ nuances à la sortie MIDI.  Vous aurez noté que les modules de traduction
 de LilyPond en matière de son s'appelent @emph{performers} -- des
 « interprètes ».
 
-@snippets
-@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
-{changing-midi-output-to-one-channel-per-voice.ly}
-
 @seealso
 Manuel d'initiation :
 @rlearning{Autres sources de documentation}.
 
 Manuel de notation :
-@ref{Signes d'interprétation},
-@ref{Mise en forme de la partition}.
+@ref{Mise en forme de la partition},
+@ref{Signes d'interprétation}.
 
 Fichiers d'initialisation :
 @file{ly/performer-init.ly}.
@@ -3222,7 +3334,7 @@ Certains lecteurs MIDI ne rendent pas correctement les changements de
 tempo.
 
 Les modifications de @code{midiInstrument} ou autres options MIDI en
-début de portée pevuent se retrouver dédoublées dans la sortie MIDI.
+début de portée peuvent se retrouver dédoublées dans la sortie MIDI.
 
 @node Gestion des instruments MIDI
 @subsection Gestion des instruments MIDI
@@ -3257,7 +3369,7 @@ ou
 @end example
 
 Lorsque l'instrument choisi ne correspond pas exactement à l'une des
-dénominations consacrées, LilyPond le replacera par un piano de concert
+dénominations consacrées, LilyPond le remplacera par un piano de concert
 (@code{"acoustic grand"}) -- voir @ref{Instruments MIDI}.
 
 @seealso
@@ -3275,11 +3387,11 @@ Fichiers d'initialisation :
 @file{scm/midi.scm}.
 
 @knownissues
-Les percussions gérées par un contexte @code{DrumStaff} sont d'affectées
+Les percussions gérées par un contexte @code{DrumStaff} sont affectées
 directement au canal 10 qui leur est réservé. Certains instruments, tels
 le xylophone, le marimba, le vibraphone ou les timbales, se traitent
 cependant comme des instruments « classiques » puisqu'ils sont capables
-d'émettre des hauteurs différentes ; leurs notation relève donc d'un
+d'émettre des hauteurs différentes ; leur notation relève donc d'un
 contexte @code{Staff} standard, et non d'un @code{DrumStaff} pour
 pouvoir être rendus correctement en MIDI.  Une liste complète des
 percussions affectées au canal 10 (@code{channel 10 drum-kits}) est
@@ -3340,6 +3452,224 @@ Manuel de notation :
 @ref{Répétitions et reprises}.
 
 
+
+@node Affectation des canaux MIDI
+@subsection Affectation des canaux MIDI
+@translationof MIDI channel mapping
+
+@cindex MIDI, canaux
+@cindex MIDI, pistes
+@funindex midiChannelMapping
+
+Lorsque LilyPond génère un fichier MIDI à partir d'une partition, chaque
+note contenue dans cette partition sera automatiquement assignée à un
+canal MIDI, celui sur lequel elle devrait être jouée quand elle est
+transmise à un périphérique MIDI.  Chaque canal MIDI dispose d'un
+certain nombre de contrôles pour, par exemple, sélectionner l'instrument
++qui jouera les notes de ce canal ou bien demander au périphérique MIDI
+d'appliquer différents effets au son produit sur ce canal.  En tout état
+de cause, chaque contrôle d'un canal MIDI ne peut se voir affecté que
+d'une seule valeur à la fois -- celle-ci peut toutefois être modifiée
+pour, par exemple, changer d'instrument au milieu du morceau.
+
+Le standard MIDI ne dispose que de 16 canaux par périphérique MIDI.
+Cette limite du nombre de canaux entraîne une limitation du nombre
+d'instruments pouvant jouer de concert.
+
+LilyPond crée une piste MIDI séparée pour chaque portée (ou chaque
+instrument ou voix selon la valeur de @code{Score.midiChannelMapping})
+ainsi que pour chaque contexte de paroles.  Il n'y a pas de limite au
+nombre de pistes.
+
+Afin de contourner la limitation du nombre de canaux MIDI, LilyPond
+dispose de différents modes d'allocation d'un canal MIDI grâce à la
+propriété de contexte @code{Score.midiChannelMapping}.  Dans tous les
+cas, lorsque la limite au nombre de canaux est atteinte, LilyPond repart
+du canal 0, ce qui peut affecter des notes au mauvais instrument.  Cette
+propriété de contexte peut prendre les valeurs suivantes :
+
+@table @var
+
+@item @code{'staff}
+
+Allocation d'un canal MIDI particulier à chacune des portées de la
+partition (option par défaut).  Toutes les notes de toutes les voix
+d'une même portée partageront le canal MIDI affecté à la portée qui les
+englobe, et toutes seront encodées dans la même piste.
+
+La limite des 16 canaux s'applique au nombre total de portées augmenté
+des contextes de paroles même si les paroles MIDI n'occupent pas de
+canal MIDI.
+
+@item @code{'instrument}
+
+Allocation d'un canal MIDI particulier à chaque instrument MIDI tel que
+spécifié dans la partition.  En d'autre termes, des notes jouées par un
+même instrument MIDI partageront le même canal MIDI (et la même piste),
+même si elles proviennent de voix ou portées différentes.
+
+Dans ce cas particulier, les contextes de paroles ne sont pas pris en
+compte dans la limite des 16 canaux, puisqu'ils ne sont pas assignés à
+un instrument MIDI, ce qui permet une meilleure allocation des canaux
+MIDI lorsque le nombre de portées et de contextes de paroles dépasse 16.
+
+@item @code{'voice}
+
+Allocation d'un canal MIDI particulier à chaque voix de la partition
+portant un nom unique parmi les voix de la portée considérée.  Des voix
+appartenant à des portées différentes seront toujours affectées à des
+canaux MIDI différents, mais deux voix partageant la même portée
+partageront le même canal MIDI dès lors qu'elles porteront le même nom.
+Dans la mesure où @code{midiInstrument} et les différents contrôles
+d'effets MIDI sont des propriétés affectant le contexte de portée, ils
+ne peuvent se déterminer individuellement pour une voix.  La première
+voix adoptera l'instrument et les effets spécifiés pour cette portée, et
+les voix dénommées différemment de la première se verront attribué
+l'instrument et le effets par défaut.
+
+Note : l'affectation d'instruments ou d'effets différents aux
+differentes voix d'une même portée s'obtient dès lors que le
+@code{Staff_performer} est déplacé du contexte @code{Staff} au contexte
+@code{Voice} tout en maintenant le @code{midiChannelMapping} dans le
+contexte @code{'staff} ou en le réglant sur @code{'instrument}.
+
+@end table
+
+Par exemple, l'affectation par défaut des canaux MIDI d'une partition
+peut être réglée sur @code{'instrument} comme ceci :
+
+@example
+\score @{
+  ...musique...
+  \midi @{
+    \context @{
+      \Score
+      midiChannelMapping = #'instrument
+    @}
+  @}
+@}
+@end example
+
+@snippets
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
+{changing-midi-output-to-one-channel-per-voice.ly}
+
+
+@node Propriétés de contextes et effets MIDI
+@subsection Propriétés de contextes et effets MIDI
+@translationof Context properties for MIDI effects
+
+@cindex effets MIDI
+@cindex pan, MIDI
+@cindex spatialisation (pan), MIDI
+@cindex stéréo MIDI, balance
+@cindex balance MIDI
+@cindex expression MIDI
+@cindex reverb MIDI
+@cindex chorus MIDI
+@funindex midiPanPosition
+@funindex midiBalance
+@funindex midiExpression
+@funindex midiReverbLevel
+@funindex midiChorusLevel
+
+Les différentes propriétés de contexte qui suivent permettnt d'appliquer
+différents effets MIDI aux notes contenues dans le canal MIDI associé à
+la portée courante, à l'instrument ou à la voix, selon la valeur
+affectée à la propriété de contexte @code{Score.midiChannelMapping} et
+le contexte dans lequel le @code{Staff_performer} réside -- voir
+@ref{Affectation des canaux MIDI}.
+
+Une adaptation de ces propriétés de contexte affectera toutes les notes
+jouées sur ce canal dès leur modification.  Certains effets pourront
+même s'appliquer sur des notes déjà en cours, selon l'implémentation du
+périphérique de sortie MIDI.
+
+LilyPond dispose des propriétés de contexte suivantes :
+
+@table @var
+
+@item @code{Staff.midiPanPosition}
+
+La spatialisation (@emph{pan position}) contrôle le positionnement d'un
+canal MIDI entre les sorties stéréo droite et gauche.  Cette propriété
+de contexte prend en argument une valeur entre -1.0 (@code{#LEFT})
+et 1.0 (@code{#RIGHT}). Une valeur de -1.0 enverra toute la puissance
+sonore sur le haut-parleur gauche (le droit sera silencieux), une
+vaaleur de 0.0 (@code{#CENTER}) distribuera équitablement le son entre
+les jaut-parleurs de gauche et de droite, et une valeur de 1.0 enverra
+tout le son sur le haut-parleur de droite.  Des valeurs entre -1.0 et
+1.0 permettent d'obtenir une répartition du son entre les sorties
+gauche et droite d'un équipement stéréophonique.
+
+
+@item @code{Staff.midiBalance}
+
+La balance stéréo d'un canal MIDI.  Tout comme la spatialisation, cette
+propriété de contexte prend en argument une valeur comprise entre -1.0
+(@code{#LEFT}) et 1.0 (@code{#RIGHT}).  Elle permet de faire varier le
+volume relatif envoyé aux deux haut-parleurs stéréo sans pour autant
+affecter la distribution des signaux stéréo.
+
+@item @code{Staff.midiExpression}
+
+Le niveau d'expression, en tant que fraction du niveau maximum de volume
+disponible, à appliquer à un canal MIDI.  Un périphérique MIDI combine
+le niveau d'expression des canaux MIDI et le niveau de nuance de la voix
+en cours (tel que défini par @code{\p} ou @code{\ff}) afin d'obtenir le
+volume total de chacune des notes de la voix.  Un contrôle de
+l'expression permet, par exemple, d'implémenter des effets de crescendo
+ou decrescendo sur une note tenue, ce que LilyPond ne sait pas faire
+automatiquement.
+
+@c Issue 4059 contains an attached snippet which shows how this might
+@c be done, but this is too large and complex for the NR, even as a
+@c referenced snippet.  It could be added to the LSR.
+
+Le niveau d'expression varie entre 0.0 (sans expression, autrement dit
+volume à zéro) et 1.0 (volume au maximum).
+
+@item @code{Staff.midiReverbLevel}
+
+Le niveau de réverbération, en tant que fraction du niveau maximum
+disponible, à appliquer à un canal MIDI.  Cette propriété prend en
+argument une valeur entre 0.0 (pas d'écho) et 1.0 (effet maximal).
+
+@item @code{Staff.midiChorusLevel}
+
+Le niveau de chœur, en tant que fraction du niveau maximum disponible, à
+appliquer à un canal MIDI.  Cette propriété prend en argument une valeur
+entre 0.0 (pas de chorus) et 1.0 (effet maximal).
+
+@end table
+
+@knownissues
+
+Dans la mesure où les fichiers MIDI ne comportent effectivement aucune
+donnée audio, les modifications des propriétés de contexte ne se
+traduisent qu'en requêtes de changement des contrôles du canal MIDI
+lorsque ces fichiers MIDI sont joués.  La manière dont un périphérique
+MIDI particulier, tel un synthétiseur MIDI logiciel, gérera ces
+requêtes incluses dans un fichier MIDI dépend complètement de
+l'implémentation du périphérique : certains d'entre eux pourront
+simplement ignorer plusieurs, voire toutes ces requêtes.  Par ailleurs,
+la manière dont un périphérique MIDI interprète les différentes valeurs
+de ces contrôles (en règle générale, le standard MIDI ne fixe le
+comportement qu'aux valeurs extrêmes de l'amplitude disponible pour
+chacun des contrôles) et leur modification alors qu'une note sur un
+canal est tenue, dépend de l'implémentation particulière à ce
+périphérique.
+
+Lors de la génération d'un fichier MIDI, LilyPond transforme simplement
+les valeurs fractionnaires dans l'amplitude linéaire en valeurs entières
+correspondantes (de 0 à 127 et sur 7 octets, ou de 0 à 32767 et sur 14
+octets pour les contrôles MIDI supportant une résolution fine). Ces
+valeurs entières converties sont  stockées telles quelles dans le
+fichier MIDI généré.  Pour plus d'information sur la manière dont un
+périphérique MIDI interprète ces valeurs, se reporter à sa
+documentation.
+
+
 @node Amélioration du rendu MIDI
 @subsection Amélioration du rendu MIDI
 @translationof Enhancing MIDI output