]> git.donarmstrong.com Git - lilypond.git/commitdiff
Doc-fr: NR staff
authorJean-Charles Malahieude <lilyfan@orange.fr>
Sun, 6 Nov 2011 15:01:54 +0000 (16:01 +0100)
committerJean-Charles Malahieude <lilyfan@orange.fr>
Sun, 6 Nov 2011 20:25:31 +0000 (21:25 +0100)
quoting and cueing

Documentation/fr/notation/staff.itely

index 03ec247c8d5e18a1f7515463a276140a00bdadc4..178b93c2fbe1c2bbb90667a373bf89d7ac0028f7 100644 (file)
@@ -1,6 +1,6 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 @ignore
-    Translation of GIT committish: 1dac524e3d3c5a6ee2aef6d11d4b18e014a53e4f
+    Translation of GIT committish: 899558989ee7c52ef549396ef2e33a49d106e0b3
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  For details, see the Contributors'
@@ -146,7 +146,7 @@ Manuel de notation :
 @ref{Définition de nouveaux contextes}.
 
 Morceaux choisis :
-@rlsrnamed{Staff notation,Notation sur la portée}.
+@rlsrnamed{Staff notation, Notation sur la portée}.
 
 Référence des propriétés internes :
 @rinternals{Staff},
@@ -275,7 +275,7 @@ Manuel de notation :
 @ref{Définition de nouveaux contextes}.
 
 Morceaux choisis :
-@rlsrnamed{Staff notation,Notation sur la portée}.
+@rlsrnamed{Staff notation, Notation sur la portée}.
 
 Référence des propriétés internes :
 @rinternals{Staff},
@@ -1064,39 +1064,35 @@ Référence des propriétés internes :
 Il est assez courant qu'une voix soit doublée par une autre.  Par
 exemple, les premiers et seconds violons peuvent jouer les mêmes notes
 durant un moment.  LilyPond gère parfaitement ces situations où une
-voix est la réplique d'une autre, et vous évite de ressaisir la musique
-en question.
-
-Avant qu'une partie ne puisse être mentionnée ailleurs, elle doit être
-considérée comme reproductible.  C'est le but de l'instruction
-@code{\addQuote} qui prend en argument une chaîne d'identification et
-une expression musicale.  Elle se place au niveau le plus haut, c'est à
-dire en dehors de tout bloc de musique@tie{}:
+voix est la @emph{réplique} d'une autre, sans devoir ressaisir la
+musique en question.
 
-@example
-flute = \relative c'' @{
-  a4 gis g gis
-@}
-\addQuote "flute" @{ \flute @}
-@end example
+L'instruction @code{\addQuote}, placée au niveau le plus haut -- c'est à
+dire en dehors de tout bloc de musique -- définit le musique dont il
+sera possible de répliquer des fragments.
 
 Au cours d'une partie, des extraits de répliques peuvent être cités en
 utilisant la commande @code{\quoteDuring}.  Cette commande prend deux
 arguments@tie{}: le nom de la voix reproduite, tel que défini par
 @code{\addQuote}, et une expression musicale qui indique la durée de
-cette citation -- silences invisibles ou multimesures.  Viendra alors
-s'insérer dans l'expression musicale le fragment correspondant de la
-voix originelle, avec tous ses attributs (articulations, nuances,
-annotations, etc.).
+cette citation.
 
 @lilypond[verbatim,quote]
-flute = \relative c'' {
-  a4 gis g->\f gis^\markup{quoted}
+fluteNotes = \relative c'' {
+  a4 gis g gis | b4^"quoted" r8 ais\p a4( f)
 }
-\addQuote "flute" { \flute }
 
-\relative c' {
-  c4 cis \quoteDuring #"flute" { s2 }
+oboeNotes = \relative c'' {
+  c4 cis c b \quoteDuring #"flute" { s1 }
+}
+
+\addQuote "flute" { \fluteNotes }
+
+\score {
+  <<
+    \new Staff \with { instrumentName = "Flute" } \fluteNotes
+    \new Staff \with { instrumentName = "Oboe" } \oboeNotes
+  >>
 }
 @end lilypond
 
@@ -1105,73 +1101,91 @@ autre chose que du silence, il en résulterait une situation
 polyphonique, ce qui n'est pas le but recherché@tie{}:
 
 @lilypond[verbatim,quote]
-flute = \relative c'' {
-  a4 gis g gis
-}
-\addQuote "flute" { \flute }
+fluteNotes = \relative c'' {
+  a4 gis g gis | b4^"quoted" r8 ais\p a4( f)
+ }
 
-\relative c' {
-  c4 cis \quoteDuring #"flute" { c4 b }
+oboeNotes = \relative c'' {
+  c4 cis c b \quoteDuring #"flute" { e4 r8 ais b4 a }
 }
-@end lilypond
 
-Les citations tiennent compte des transpositions, aussi bien celle de
-l'instrument d'origine que celle de la partie où elle intervient, dans
-la mesure où elles sont spécifiées par la commande
-@code{\transposition}.  Voir @ref{Instruments transpositeurs} pour plus
-de détails.
+\addQuote "flute" { \fluteNotes }
 
-@lilypond[verbatim,quote]
-clarinet = \relative c'' {
-  \transposition bes
-  a4 gis g gis
-}
-\addQuote "clarinet" { \clarinet }
-
-\relative c' {
-  c4 cis \quoteDuring #"clarinet" { s2 }
+\score {
+  <<
+    \new Staff \with { instrumentName = "Flute" } \fluteNotes
+    \new Staff \with { instrumentName = "Oboe" } \oboeNotes
+  >>
 }
 @end lilypond
 
-Les citations peuvent être @qq{balisées} par un nom particulier afin de
-les utiliser de différentes manières.  Pour de plus amples détails à ce
-propos, consultez le chapitre @ref{Utilisation de balises}.
-
-La propriété @code{quotedEventTypes} permet de définir précisément quels
-éléments de la voix originelle seront reproduits.  Sa valeur par défaut
-est @code{#'(StreamEvent)}@tie{}; autrement dit, tout sera recopié.  Lui
-affecter la valeur @code{#'(note-event@tie{}rest-event@tie{}tie-event)}
-fera que LilyPond reproduira les notes, silences et liaisons de
-prolongation, mais pas les articulations, annotations ni nuances.
+L'instruction @code{\quoteDuring} prendra en compte les réglages d'une
+commande @code{\transposition}, qu'elle apparaisse au niveau de la voix
+répliquée ou dans celle qui réplique.
 
 @lilypond[verbatim,quote]
-clarinet = \relative c'' {
-  a4 gis g->\f gis^\markup{quoted}
+clarinetNotes = \relative c'' {
+  \transposition bes
+  \key d \major
+  b4 ais a ais | cis4^"quoted" r8 bis\p b4( f)
 }
-\addQuote "clarinet" { \clarinet }
 
-\relative c' {
-  \set Score.quotedEventTypes = #'(note-event rest-event tie-event)
-  c4 cis \quoteDuring #"clarinet" { s2 }
+oboeNotes = \relative c'' {
+  c4 cis c b \quoteDuring #"clarinet" { s1 }
+ }
+\addQuote "clarinet" { \clarinetNotes }
+\score {
+  <<
+    \new Staff \with { instrumentName = "Clarinet" } \clarinetNotes
+    \new Staff \with { instrumentName = "Oboe" } \oboeNotes
+  >>
 }
 @end lilypond
 
-
-@snippets
-
-@lilypondfile[verbatim,quote,texidoc,doctitle]
-{quoting-another-voice-with-transposition.ly}
-
 @cindex note-event
 @cindex articulation-event
 @cindex dynamic-event
 @cindex rest-event
+@cindex slur-event
+@cindex crescendo-event
 
 @funindex quotedEventTypes
 @funindex quotedCueEventTypes
 
-@lilypondfile[verbatim,quote,texidoc,doctitle]
-{quoting-another-voice.ly}
+LilyPond répliquera, par défaut, tous les éléments -- articulations,
+nuances, @emph{markups}, etc. La propriété @code{quotedEventTypes}
+permet de définir plus précisément quels éléments de la voix originelle
+seront reproduits.
+
+@lilypond[verbatim,quote]
+fluteNotes = \relative c'' {
+  a2 g2 |
+  b4\<^"quoted" r8 ais a4\f( c->)
+ }
+
+oboeNotes = \relative c'' {
+  c2. b4 |
+  \quoteDuring #"flute" { s1 }
+}
+
+\addQuote "flute" { \fluteNotes }
+
+\score {
+  <<
+    \set Score.quotedEventTypes = #'(note-event articulation-event
+                                     crescendo-event rest-event
+                                     slur-event dynamic-event)
+    \new Staff \with { instrumentName = "Flute" } \fluteNotes
+    \new Staff \with { instrumentName = "Oboe" } \oboeNotes
+  >>
+ }
+@end lilypond
+
+Les citations peuvent être @qq{balisées} par un nom particulier afin de
+les utiliser de différentes manières.  Pour de plus amples détails à ce
+propos, consultez le chapitre @ref{Utilisation de balises}.
+
 
 
 @seealso
@@ -1180,12 +1194,16 @@ Manuel de notation :
 @ref{Utilisation de balises}.
 
 Morceaux choisis :
-@rlsrnamed{Staff notation,Notation sur la portée}.
+@rlsrnamed{Staff notation, Notation sur la portée}.
 
 Référence des propriétés internes :
+@rinternals{Music classes},
 @rinternals{QuoteMusic},
 @rinternals{Voice}.
 
+Fichiers d'initiallisation :
+@file{scm/define-event-classes.scm}.
+
 
 @knownissues
 
@@ -1201,9 +1219,6 @@ un blocage de LilyPond.
 Citer des triolets imbriqués peut entraîner un résultat de piètre
 qualité.
 
-Dans les versions précédentes de LilyPond (avant 2.11), @code{addQuote}
-était écrit entièrement en minuscules@tie{}: @code{\addquote}.
-
 
 @node Mise en forme d'une citation
 @unnumberedsubsubsec Mise en forme d'une citation
@@ -1211,62 +1226,128 @@ Dans les versions précédentes de LilyPond (avant 2.11), @code{addQuote}
 
 @cindex petites notes, formater des
 @cindex répliques, formatage
+@cindex voix, citation
+@cindex voix, réplication
+@cindex CueVoice
 
 @funindex \cueDuring
 @funindex cueDuring
+@funindex \cueClef
+@funindex cueClef
+@funindex \cueDuringWithClef
+@funindex cueDuringWithClef
 @funindex \quoteDuring
 @funindex quoteDuring
 
-La section précédente indiquait comment insérer des notes d'une autre
-voix.  Nous allons maintenant voir une fonction musicale avancée,
-@code{\cueDuring}, qui facilite le formatage des petites notes.
+Le moyen le plus simple pour mettre en forme des notes provenant d'une
+autre voix consiste à déclarer explicitement un contexte @code{CueVoice}
+au sein de la voix où elle apparaît.
+
+@lilypond[verbatim,relative=1]
+R1
+<<
+  { e2\rest r4. e8 }
+  \new CueVoice {
+    \stemUp d'8^"flute" c d e fis2
+  }
+>>
+d,4 r a r
+@end lilypond
+
+L'instruction @code{\cuecClef}, utilisée conjointement à un contexte
+@code{CueVoice} explicite permet d'indiquer la clef, dans une taille
+réduite, propre à la voix citée.  Le retour à la clef d'origine
+s'effectue à l'aide de l'instruction @code{\cueClefUnset}.
 
-Sa syntaxe est@tie{}:
+@lilypond[verbatim,noragged-right,relative=1]
+\clef "bass"
+R1
+<<
+  { e2\rest r4. \cueClefUnset e,8 }
+  \new CueVoice {
+    \cueClef "treble" \stemUp d''8^"flute" c d e fis2
+  }
+>>
+d,,4 r a r
+@end lilypond
+
+Notez que les deux instructions @code{\cueClef} et @code{\cueClefUnset}
+sont disponibles si nécessaiare en dehors d'un @code{CueVoice}.
+
+@lilypond[verbatim,noragged-right,relative=1]
+\clef "bass"
+R1
+\cueClef "treble"
+d'8^"flute" c d e fis2
+\cueClefUnset
+d,,4 r a r
+@end lilypond
+
+Lorsque la situation est plus complexe, instrument transpositeur ou
+citations de plusieurs sources, vous disposez des instructions 
+@code{\cueDuring} et @code{\cueDuringWithClef}, versions spécifiques de
+la commande @code{\quoteDuring} -- voir la rubrique précédente
+(@ref{Citation d'autres voix}).
+
+Leur syntaxe est :
+
+@example
+\cueDuring #@var{origine} #@var{position} #@var{musique}
+@end example
+
+et
 
 @example
-\cueDuring #@var{origine} #@var{voix} @var{musique}
+\cueDuringWithClef #@var{origine} #@var{position} #@var{clef} #@var{musique}
 @end example
 
 Des mesures issues de la partie d'@code{@var{origine}} seront recopiées
-dans un contexte de @code{CueVoice}, créé implicitement, et
-synchronisées avec @code{@var{musique}} -- habituellement un silence.
-L'apparition des petites notes initialise une polyphonie temporaire pour
-la portée concernée.  L'argument @code{@var{voix}} détermine si ces
-petites notes seront attachées à la première ou à la seconde voix --
-@code{UP} pour la première ou @code{DOWN} pour la seconde.
+dans un contexte de @code{CueVoice} et synchronisées avec
+@code{@var{musique}} -- habituellement un silence.  L'apparition des
+petites notes initialise une polyphonie temporaire pour la portée
+concernée.  L'argument @code{@var{position}} détermine si ces petites
+notes seront attachées à la première ou à la seconde voix -- @code{UP}
+pour la première, @code{DOWN} pour la seconde.
 
 
 @lilypond[verbatim,quote]
-oboe = \relative c'' {
-  r2 r8 d16 f e g f a
-  g8 g16 g g2.
+fluteNotes = \relative c'' {
+  r2. c4 | d8 c d e fis2 | g2 d |
 }
-\addQuote "oboe" { \oboe }
 
-\new Voice \relative c'' {
-  \cueDuring #"oboe" #UP { R1 }
+oboeNotes = \relative c'' {
+  R1
+  s1*0^\markup { \tiny "flute" }
+  \cueDuring #"flute" #UP { R1 }
   g2 c,
 }
+
+\addQuote "flute" { \fluteNotes }
+
+\new Staff {
+  \oboeNotes
+}
 @end lilypond
 
 @noindent
-Dans cet exemple, il était nécessaire de déclarer explicitement le
-contexte @code{Voice}, sinon l'intégralité de l'expression musicale se
-serait retrouvée dans le contexte @code{CueVoice}.
-
 La propriété @code{quotedCueEventTypes} permet de définir précisément
 quels éléments de la voix originelle seront reproduits.  Sa valeur par
-défaut est @w{@code{#'(note-event rest-event tie-event beam-event
-tuplet-span-event)}}.  LilyPond reproduira donc les notes, silences,
+défaut est @code{'(note-event rest-event tie-event beam-event
+tuplet-span-event)}.  LilyPond reproduira donc les notes, silences,
 liaisons de prolongation, ligatures et nolets, mais pas les
 articulations, annotations ni nuances.
 
+@warning{Dans l'exemple précédent, il était nécessaire de déclarer
+explicitement le contexte @code{Voice}, sinon l'intégralité de
+l'expression musicale se serait retrouvée dans le contexte
+@code{CueVoice}.}
+
 @lilypond[verbatim,quote]
-oboe = \relative c'' {
+oboeNotes = \relative c'' {
   r2 r8 d16(\f f e g f a)
   g8 g16 g g2.
 }
-\addQuote "oboe" { \oboe }
+\addQuote "oboe" { \oboeNotes }
 
 \new Voice \relative c'' {
   \set Score.quotedCueEventTypes = #'(note-event rest-event tie-event
@@ -1279,14 +1360,15 @@ oboe = \relative c'' {
 
 Le nom de l'instrument qui est répliqué sera imprimé à l'aide d'une
 annotation (un @emph{markup}).  Par ailleurs, si la citation nécessite
-l'apparition d'une clef différente, l'originale devrait être rappelée en
+l'apparition d'une clef différente, l'originale devra être rappelée en
 fin de citation.
 
 @lilypond[verbatim,quote]
-flute = \relative c'' {
+fluteNotes = \relative c'' {
   r2. c4 d8 c d e fis2 g2 d2
 }
-bassoon = \relative c {
+
+bassoonNotes = \relative c {
   \clef bass
   R1
   \clef treble
@@ -1295,12 +1377,77 @@ bassoon = \relative c {
   \clef bass
   g4. b8 d2
 }
-\addQuote "flute" { \flute }
+
+\addQuote "flute" { \fluteNotes }
+
+\new Staff {
+  \bassoonNotes
+}
+@end lilypond
+
+L'instruction @code{\cueDuringWithClef} se chargera quant à elle, et
+grâce à un argument supplémentaire, de gérer le changement de clef
+nécessaire à la citation et le retour à la clef originelle.
+
+@lilypond[verbatim,quote]
+fluteNotes = \relative c'' {
+  r2. c4 d8 c d e fis2 g2 d2
+}
+
+bassoonNotes = \relative c {
+  \clef bass
+  R1
+  s1*0^\markup { \tiny "flute" }
+  \cueDuringWithClef #"flute" #UP #"treble" { R1 }
+  g4. b8 d2
+}
+
+\addQuote "flute" { \fluteNotes }
+
 \new Staff {
-  \bassoon
+  \bassoonNotes
 }
 @end lilypond
 
+@funindex \transposedCueDuring
+@funindex transposedCueDuring
+
+L'instruction @code{\cueDuring}, à l'instar de la commande
+@code{\quoteDuring}, tient compte des instruments transpositeurs.  La
+citation s'effectue aux hauteurs correspondant à l'intrument où elles
+apparaissent.  
+
+L'instruction @code{\transposedCueDuring} est particulièrement adaptée
+pour des instrument ayant une tessiture éloignée, comme dans le cas d'un
+piccolo cité dans une partie de clarinette basse.  Sa syntaxe  est
+identique à celle de @code{\cueDuring}, à ceci près qu'elle nécessite un
+argument supplémentaire afin de spécifier la transposition à effectuer
+en hauteur absolue.
+
+@lilypond[verbatim,quote]
+piccoloNotes = \relative c''' {
+  \clef "treble^8"
+  R1
+  c8 c c e g2
+  c4 g g2
+}
+
+bassClarinetNotes = \relative c' {
+  \key d \major
+  \transposition bes,
+  d4 r a r
+  \transposedCueDuring #"piccolo" #UP d { R1 }
+  d4 r a r
+}
+
+\addQuote "piccolo" { \piccoloNotes }
+
+<<
+  \new Staff \piccoloNotes
+  \new Staff \bassClarinetNotes
+>>
+@end lilypond
+
 @cindex citation, fin
 @cindex fin de citation
 @cindex réplique, fin
@@ -1308,6 +1455,8 @@ bassoon = \relative c {
 
 @funindex \killCues
 @funindex killCues
+@funindex \addInstrumentDefinition
+@funindex addInstrumentDefinition
 
 La commande @code{killCues} permet de supprimer les notes d'une
 citation.  Ceci est utile lorsque cette citation n'est pas imprimée dans
@@ -1318,10 +1467,11 @@ faites appel à des balises -- voir @ref{Utilisation de balises} à ce
 sujet.
 
 @lilypond[verbatim,quote]
-flute = \relative c'' {
+fluteNotes = \relative c'' {
   r2. c4 d8 c d e fis2 g2 d2
 }
-bassoon = \relative c {
+
+bassoonNotes = \relative c {
   \clef bass
   R1
   \tag #'part {
@@ -1332,17 +1482,19 @@ bassoon = \relative c {
   \tag #'part \clef bass
   g4. b8 d2
 }
-\addQuote "flute" { \flute }
+
+\addQuote "flute" { \fluteNotes }
 
 \new Staff {
-  \bassoon
+  \bassoonNotes
 }
+
 \new StaffGroup <<
   \new Staff {
-    \flute
+    \fluteNotes
   }
   \new Staff {
-    \removeWithTag #'part { \killCues { \bassoon } }
+    \removeWithTag #'part { \killCues { \bassoonNotes } }
   }
 >>
 @end lilypond
@@ -1353,71 +1505,17 @@ l'aide de la commande @code{\addInstrumentDefinition}.  Pour plus
 d'information, reportez-vous au chapitre @ref{Noms d'instrument}.
 
 
-@funindex \transposedCueDuring
-@funindex transposedCueDuring
-
-L'instruction @code{\transposedCueDuring} est particulièrement adaptée
-pour des instrument ayant une tessiture éloignée, comme dans le cas d'un
-piccolo cité dans une partie de clarinette basse.  Sa syntaxe  est
-identique à celle de @code{\cueDuring}, à ceci près qu'elle nécessite un
-argument supplémentaire afin de spécifier la transposition à effectuer.
-Pour de plus amples informations sur la transposition, reportez-vous au
-chapitre @ref{Instruments transpositeurs}.
-
-@lilypond[verbatim,quote]
-piccolo = \relative c''' {
-  \clef "treble^8"
-  R1
-  c8 c c e g2
-  c4 g g2
-}
-bassClarinet = \relative c' {
-  \key d \major
-  \transposition bes,
-  d4 r a r
-  \transposedCueDuring #"piccolo" #UP d { R1 }
-  d4 r a r
-}
-
-\addQuote "piccolo" { \piccolo }
-
-<<
-  \new Staff \piccolo
-  \new Staff \bassClarinet
->>
-@end lilypond
-
-@cindex notes, petites
-@cindex petites notes
-
-Un contexte @code{CueVoice} créé explicitement permet d'afficher des
-notes dans une taille plus petite dans le but, par exemple, d'indiquer
-des notes alternatives pour une voix un peu plus haute ou basse.
-
-@lilypond[verbatim,quote,relative=2]
-\time 12/8
-\key ees \major
-g4 ees8 f4 g8
-\stemDown
-<<
-  { d4. bes4 c8 }
-  \new CueVoice
-  { g'4. f4 ees8 }
->>
-\stemUp
-d2. d2.
-@end lilypond
-
-
 @seealso
 Manuel de notation :
+@ref{Citation d'autres voix},
 @ref{Instruments transpositeurs},
 @ref{Noms d'instrument},
-@ref{Musical cues},
+@ref{Clef},
+@ref{Citation-repère},
 @ref{Utilisation de balises}.
 
 Morceaux choisis :
-@rlsrnamed{Staff notation,Notation sur la portée}.
+@rlsrnamed{Staff notation, Notation sur la portée}.
 
 Référence des propriétés internes :
 @rinternals{CueVoice},
@@ -1429,3 +1527,7 @@ Référence des propriétés internes :
 La commande @code{\cueDuring} ne sait pas gérer les collisions de
 silence entre les contextes @code{Voice} et @code{CueVoice}.
 
+Dans le cadre d'un @code{\cueDuringWithClef} ou d'un
+@code{\transposedCueDuring}, l'argument supplémentaire doit intervenir
+après l'origine et la position.
+