-@c -*- coding: utf-8; mode: texinfo; -*-
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
+
@ignore
- Translation of GIT committish: d78027a94928ddcdd18fd6534cbe6d719f80b6e
+ Translation of GIT committish: d46572826e777ed3e9fa4656535a6e9000f2ed9e
When revising a translation, copy the HEAD committish of the
- version that you are working on. See TRANSLATION for details.
+ version that you are working on. For details, see the Contributors'
+ Guide, node Updating translation committishes..
@end ignore
-@c \version "2.12.0"
+@c \version "2.19.2"
@c Translators: Valentin Villenave, Jean-Charles Malahieude
@c Translation checkers: John Mandereau
@section Notation sur la portée
@translationof Staff notation
-@lilypondfile[quote]{staff-headword.ly}
+@c The line width is a bit of a hack to allow space for the
+@c instrument names.
+@lilypondfile[quote,ragged-right,line-width=14.5\cm,staffsize=16]
+{staff-headword.ly}
Cette section aborde les détails de gravure de la portée, la
réalisation de partitions comprenant plusieurs portées et l'ajout
seulement.
@menu
-* Gravure des portées::
-* Modification de portées individuelles::
-* Écriture de parties séparées::
+* Gravure des portées::
+* Modification de portées individuelles::
+* Écriture de parties séparées::
@end menu
Nous allons voir ici comment créer des portées et comment les regrouper.
@menu
-* Initialisation de nouvelles portées::
-* Regroupement de portées::
-* Imbrication de regroupements de portées::
+* Initialisation de nouvelles portées::
+* Regroupement de portées::
+* Imbrication de regroupements de portées::
+* Séparation des systèmes::
@end menu
@node Initialisation de nouvelles portées
@unnumberedsubsubsec Initialisation de nouvelles portées
-@translationof Instantiating new staves
+@translationof Instantiating new staves
@cindex nouvelle portée
@cindex portée, initialisation
@cindex batterie, portée
@cindex percussion, portée
@cindex portée, transcription de grégorien
-@cindex portée rhytmique
+@cindex portée rythmique
@cindex portée de tablature
@cindex tablature
@funindex VaticanaStaff
@funindex GregorianTranscriptionStaff
-Les @notation{portées} -- en anglais : @emph{staff} (@emph{staves} au
-pluriel) -- sont créées à l'aide des commandes @code{\new} ou
-@code{\context}. Pour de plus amples détails, consultez
-@ref{Création d'un contexte}.
+Les @notation{portées} -- en anglais @emph{staff} (@emph{staves}
+au pluriel) -- sont créées à l'aide des commandes @code{\new} ou
+@code{\context}. Pour de plus amples détails, consultez
+@ref{Création et référencement d'un contexte}.
-Le contexte de portée standard s'appelle @code{Staff} :
+Le contexte de portée standard s'appelle @code{Staff} :
@lilypond[verbatim,quote,relative=2]
\new Staff { c4 d e f }
à une batterie traditionnelle et chacun des instruments est représenté
par un symbole spécifique. Les éléments sont saisis en mode batterie,
initialisé par la commande @code{\drummode}, chaque composante étant
-spécifiée par son nom. Pour de plus amples détails, consultez
+spécifiée par son nom. Pour de plus amples détails, consultez
@ref{Portées de percussion}.
@lilypond[verbatim,quote]
Un @code{RhythmicStaff} est composé d'une portée à ligne unique chargée
de présenter les valeurs rythmiques saisies. Seules sont imprimées les
-durées. Pour de plus amples détails, consultez
-@ref{Gravure de lignes rythmiques}.
+durées. Pour de plus amples détails, consultez
+@ref{Gravure de lignes rythmiques}.
@lilypond[verbatim,quote,relative=2]
\new RhythmicStaff { c4 d e f }
@end lilypond
-Un @code{TabStaff} crée une portée de tablature correpondant aux six
-cordes d'une guitare standard. Pour de plus amples détails, consultez
+Un @code{TabStaff} crée une portée de tablature correspondant aux six
+cordes d'une guitare standard. Pour de plus amples détails, consultez
@ref{Tablatures par défaut}.
@lilypond[verbatim,quote,relative=2]
\new TabStaff { c4 d e f }
@end lilypond
-Lilypond dispose aussi de deux contextes dédiés à la musique ancienne :
-@code{MensuralStaff} et @code{VaticanaStaff}. Ils sont abordés plus en
-détails au chapitre @ref{Contextes prédéfinis}.
+LilyPond dispose aussi de deux contextes dédiés à la musique
+ancienne : @code{MensuralStaff} et @code{VaticanaStaff}. Ils sont
+abordés plus en détails au chapitre @ref{Contextes prédéfinis}.
Le contexte @code{GregorianTranscriptionStaff} permet d'obtenir des
éditions modernes du grégorien. Bien entendu, il est dépourvu de barres
-de mesure.
+de mesure.
@lilypond[verbatim,quote,relative=2]
\new GregorianTranscriptionStaff { c4 d e f e d }
besoins, en suivant les indications fournies au chapitre
@ref{Définition de nouveaux contextes}.
-
@seealso
Glossaire musicologique :
@rglos{staff},
-@rglos{staves}.
+@rglosnamed{staves,portées}.
Manuel de notation :
-@ref{Création d'un contexte},
+@ref{Création et référencement d'un contexte},
@ref{Portées de percussion},
@ref{Gravure de lignes rythmiques},
@ref{Tablatures par défaut},
@ref{Contextes prédéfinis},
@ref{Symbole de la portée},
@ref{Contextes du chant grégorien},
-@ref{Les contextes de la musique mensurale},
+@ref{Contextes de musique mensurale},
@ref{Définition de nouveaux contextes}.
Morceaux choisis :
-@rlsr{Staff notation}.
+@rlsrnamed{Staff notation, Notation sur la portée}.
Référence des propriétés internes :
@rinternals{Staff},
@cindex système
LilyPond dispose de différents contextes permettant de regrouper des
-portées individuelles et d'obtenir ainsi des @qq{systèmes}. Chacun de
-ces contextes définira le style de regoupement, avec son signe
+portées individuelles et d'obtenir ainsi des « systèmes ». Chacun de
+ces contextes définira le style de regroupement, avec son signe
particulier en début de portée et ses règles de gestion des barres de
-mesure.
+mesure.
Lorsqu'aucun contexte particulier n'est spécifié, les propriétés
-suivantes s'appliqueront par défaut : les portées du groupe ne sont pas
-reliées, hormis par une simple ligne verticale en début de ligne, et
-les barres de mesure sont indépendantes.
+suivantes s'appliqueront par défaut : les portées du groupe ne sont
+pas reliées, hormis par une simple ligne verticale en début de ligne, et
+les barres de mesure sont indépendantes.
@lilypond[verbatim,quote,relative=2]
<<
>>
@end lilypond
-Dan sun @code{GrandStaff}, le groupe de portées est signifié par une
-accolade sur la gauche, et les barres de mesure sont d'un seul tenant.
+Dans un @code{GrandStaff}, le groupe de portées est signifié par une
+accolade sur la gauche, et les barres de mesure sont d'un seul tenant.
@lilypond[verbatim,quote,relative=2]
\new GrandStaff <<
>>
@end lilypond
-Le contexte @code{PianoStaff} est indentique au @code{GrandStaff}, sauf
+Le contexte @code{PianoStaff} est identique au @code{GrandStaff}, sauf
qu'il gère automatiquement l'affichage du nom d'instrument -- voir
@ref{Noms d'instrument} pour plus de détails.
>>
@end lilypond
-Les barres de mesure au début de chaque système adoptent l'un des styles
+Les barres de mesure au début de chaque système adoptent l'un des styles
@code{SystemStartBar}, @code{SystemStartBrace} ou
-@code{SystemStartBracket}. Dans chaque contexte, seul l'un de
-ces styles est utilisé, et c'est la propriété
-@code{systemStartDelimiter} qui détermine lequel. Un quatrième style,
-@code{SystemStartSquare}, doît quant à lui être spécifié de manière
-explicite.
+@code{SystemStartBracket}. Dans chaque contexte, seul l'un de ces
+styles est utilisé, et c'est la propriété @code{systemStartDelimiter}
+qui détermine lequel. Un quatrième style, @code{SystemStartSquare},
+doit quant à lui être spécifié de manière explicite.
Vous pouvez aussi créer vos propres contextes de regroupement, comme
l'explique @ref{Définition de nouveaux contextes}.
-
@snippets
-
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
{use-square-bracket-at-the-start-of-a-staff-group.ly}
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
{display-bracket-with-only-one-staff-in-a-system.ly}
@cindex présentation mensurale
@cindex transcription de musique ancienne
@cindex musique ancienne, transcription
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
{mensurstriche-layout-bar-lines-between-the-staves.ly}
-
@seealso
Glossaire musicologique :
-@rglos{brace},
-@rglos{bracket},
-@rglos{grand staff}.
+@rglosnamed{brace,accolade},
+@rglosnamed{bracket,crochet},
+@rglosnamed{grand staff,système}.
Manuel de notation :
@ref{Noms d'instrument},
@ref{Définition de nouveaux contextes}.
Morceaux choisis :
-@rlsr{Staff notation}.
+@rlsrnamed{Staff notation, Notation sur la portée}.
Référence des propriétés internes :
@rinternals{Staff},
@rinternals{SystemStartBracket},
@rinternals{SystemStartSquare}.
+@knownissues
+Un @code{PianoStaff} ne peut contenir, par défaut, de @code{ChordNames}.
+
@node Imbrication de regroupements de portées
@unnumberedsubsubsec Imbrication de regroupements de portées
-@translationof Nested staff groups
+@translationof Nested staff groups
@cindex portées, regroupement et imbrication
@cindex systèmes imbriqués
Vous pouvez aussi créer vos propres contextes d'imbrication, comme
l'explique @ref{Définition de nouveaux contextes}.
-
@snippets
-
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
{nesting-staves.ly}
-
@seealso
Manuel de notation :
@ref{Regroupement de portées},
@ref{Définition de nouveaux contextes}.
Morceaux choisis :
-@rlsr{Staff notation}.
+@rlsrnamed{Staff notation,Notation sur la portée}.
Référence des propriétés internes :
@rinternals{StaffGroup},
@rinternals{SystemStartSquare}.
+@node Séparation des systèmes
+@unnumberedsubsubsec Séparation des systèmes
+@translationof Separating systems
+
+@cindex système, indicateur de séparation
+
+Le nombre de systèmes peut varier d'une page à l'autre ; vous
+pouvez, en pareil cas, rendre plus évidente la séparation entre les
+systèmes en l'indiquant visuellement. Ce « séparateur » est absent par
+défaut, mais vous pouvez l'activer par une option au sein du bloc
+@code{\paper}.
+
+@c \book is required here to display the system separator
+@c ragged-right is required as there are two systems
+@lilypond[verbatim,quote,ragged-right]
+\book {
+ \score {
+ \new StaffGroup <<
+ \new Staff {
+ \relative c'' {
+ c4 c c c
+ \break
+ c4 c c c
+ }
+ }
+ \new Staff {
+ \relative c'' {
+ c4 c c c
+ \break
+ c4 c c c
+ }
+ }
+ >>
+ }
+ \paper {
+ system-separator-markup = \slashSeparator
+ % following commands are needed only to format this documentation
+ paper-width = 100\mm
+ paper-height = 100\mm
+ tagline = ##f
+ }
+}
+@end lilypond
+
+@seealso
+Manuel de notation :
+@ref{Mise en forme de la page}.
+
+Morceaux choisis :
+@rlsrnamed{Staff notation,Notation sur la portée}.
+
+
@node Modification de portées individuelles
@subsection Modification de portées individuelles
@translationof Modifying single staves
Cette section explique le réglage de la gravure de chaque portée,
-comme la taille de portée ou le nombre de lignes ; sont aussi décrits
-la suspension et la reprise de portées et les portées d'@emph{ossia}.
-
+comme la taille de portée ou le nombre de lignes ; sont aussi
+décrits la suspension et la reprise de portées, ainsi que les portées
+d'@emph{ossia}.
@menu
-* Symbole de la portée::
-* Portées d'ossia::
-* Masquage de portées::
+* Symbole de la portée::
+* Portées d'ossia::
+* Masquage de portées::
@end menu
+
@node Symbole de la portée
@unnumberedsubsubsec Symbole de la portée
@translationof Staff symbol
@cindex lignes de portée, épaisseur
@cindex ligne supplémentaire
+@funindex \startStaff
+@funindex startStaff
+@funindex \stopStaff
+@funindex stopStaff
+
+Les commandes @code{\stopStaff} et @code{\startStaff} permettent
+respectivement de clôturer et (re)démarrer une portée n'importe où dans
+une partition.
+
+@lilypond[verbatim,quote,relative=2]
+\stopStaff f4 d \startStaff g, e
+f'4 d \stopStaff g, e
+f'4 d \startStaff g, e
+@end lilypond
+
+@predefined
+@code{\startStaff},
+@code{\stopStaff}.
+@endpredefined
-Les notes, nuances, etc. sont regroupées dans un assemblage de lignes
+Les notes, nuances, etc. sont regroupées dans un assemblage de lignes
horizontales, que l'on nomme la portée (en anglais @emph{staff}, et
@emph{staves} au pluriel). Dans LilyPond, ces lignes sont dessinées au
-moyen d'un objet de mise en forme (@emph{grob}) à part entière, nommé
+moyen d'un objet graphique (@emph{grob}) à part entière, nommé
@code{StaffSymbol} -- symbole de portée. Modifier les propriétés d'un
@code{StaffSymbol} changera l'apparence de la portée, dès lors qu'elles
auront été définies avant de créer la portée en question.
-Vous pouvez modifier le nombre de lignes d'une portée. Néanmoins, la
-position de la clef et celle du do médium demanderont parfois un
-ajustement afin d'être en phase avec cette nouvelle portée. Pour plus
-d'explications, reportez-vous aux exemples du chapitre @ref{Clefs}.
+Vous pouvez modifier le nombre de lignes d'une portée :
@lilypond[verbatim,quote,relative=2]
-\new Staff \with {
- \override StaffSymbol #'line-count = #3
-}
-{ d4 d d d }
+f4 d \stopStaff
+\override Staff.StaffSymbol.line-count = #2
+\startStaff g, e |
+
+f'4 d \stopStaff
+\revert Staff.StaffSymbol.line-count
+\startStaff g, e |
+@end lilypond
+
+Le positionnement de chacune des lignes de la portée est modifiable.
+Une liste de nombres détermine le positionnement de chaque ligne.
+Le @code{0} correspond à la ligne médiane d'une portée habituelle, pour
+laquelle la liste est donc @code{(-4@tie{}-2@tie{}0@tie{}2@tie{}4)}.
+Une ligne sera donc imprimée pour chaque valeur exprimée ; le nombre de
+lignes, ainsi que leur position dans la portée, peut donc se modifier à
+l'aide d'une seule commande.
+
+@lilypond[verbatim,quote,relative=2]
+f4 d \stopStaff
+\override Staff.StaffSymbol.line-positions = #'(1 3 5 -1 -3)
+\startStaff g, e |
+f'4 d \stopStaff
+\override Staff.StaffSymbol.line-positions = #'(8 6.5 -6 -8 -0.5)
+\startStaff g, e
@end lilypond
+Afin de préserver l'orientation habituelle des hampes -- ascendantes
+dans la partie inférieure de la portée, descendantes dans la partie
+supérieure -- la ligne (ou l'interligne) centrale de la portée
+personnalisée devra être en phase avec avec la ligne médiane d'une
+portée classique (0). La position de la clef et celle du do médium
+demanderont parfois un ajustement afin d'être en phase avec cette
+nouvelle portée. Pour plus d'explications, reportez-vous aux exemples
+du chapitre @ref{Clefs}.
+
Lorsque vous modifierez l'épaisseur des lignes, gardez à l'esprit que
-les lignes supplémentaires et les hampes seront aussi modifiées. En
-effet, elles dépendent directement de l'épaisseur des lignes de la portée.
+les lignes supplémentaires et les hampes seront aussi modifiées.
@lilypond[verbatim,quote,relative=1]
\new Staff \with {
- \override StaffSymbol #'thickness = #3
+ \override StaffSymbol.thickness = #3
}
{ e4 d c b }
@end lilypond
L'épaisseur des lignes supplémentaires (@emph{ledger lines}) peut être
-déterminée indépendamment des lignes de la portée. Dans l'exemple
-suivant, les deux nombres constituent des coefficients multiplicateurs
-de l'épaisseur de la ligne. Ils sont fournis en argument pour
-déterminer l'épaisseur des lignes supplémentaires.
+déterminée indépendamment des lignes de la portée.
-@lilypond[verbatim,quote,relative=1]
+@lilypond[verbatim,quote,relative=2]
\new Staff \with {
- \override StaffSymbol #'ledger-line-thickness = #'(1 . 0.2)
+ \override StaffSymbol.thickness = #2
+ \override StaffSymbol.ledger-line-thickness = #'(0.5 . 0.4)
}
-{ e4 d c b }
+{ f'4 a, a,, f }
@end lilypond
-Modifier l'équidistance des lignes de la portée affectera aussi les
-lignes supplémentaires.
+@noindent
+La première valeur est multipliée par l'épaisseur de ligne de portée, la
+seconde par l'espace d'interligne ; ces deux valeurs sont alors
+combinées pour donner la nouvelle épaisseur des lignes supplémentaires.
-@lilypond[verbatim,quote,relative=1]
+L'emplacement des lignes supplémentaires est réglable :
+
+@lilypond[verbatim,quote,relative=2]
\new Staff \with {
- \override StaffSymbol #'staff-space = #1.5
+ \override StaffSymbol.ledger-positions = #'(-3 -2 -1 2 5 6)
}
-{ a4 b c d }
+{ f'4 a, a,, f }
@end lilypond
-Vous trouverez de plus amples détails sur les propriétés du
-@code{StaffSymbol} au chapitre @rinternals{staff-symbol-interface}.
-
-@cindex fin de portée
-@cindex début de portée
-@cindex portée, début
-@cindex portée, fin
-
-@funindex \startStaff
-@funindex startStaff
-@funindex \stopStaff
-@funindex stopStaff
-
-Les propriétés d'une portée peuvent être modifiées en cours de partition
-à l'aide des commandes @code{\stopStaff} et @code{\startStaff} :
+Vous pouvez faire apparaître des lignes supplémentaires additionnelles
+au-dessus ou en dessous des têtes de note selon leur positionnement
+relatif aux autres notes, qu'elles aient ou non elles-mêmes des lignes
+supplémentaires.
@lilypond[verbatim,quote,relative=2]
-c2 c
-\stopStaff
-\override Staff.StaffSymbol #'line-count = #2
-\startStaff
-b2 b
-\stopStaff
-\revert Staff.StaffSymbol #'line-count
-\startStaff
-a2 a
+\new Staff \with {
+ \override StaffSymbol.ledger-extra = #4
+}
+{ f'4 a, d, f, }
@end lilypond
-@noindent
-En règle générale, @code{\startStaff} et @code{\stopStaff} permettent
-d'entamer puis clôturer une portée n'importe où dans une partition.
+Des lignes supplémentaires peuvent apparaître y compris au sein d'une
+portée, notamment lorsque vous l'avez personnalisée. L'exemple suivant
+illustre deux cas de figure quant au positionnement des lignes
+supplémentaires selon que la propriété @code{legder-position} est
+définie explicitement ou non. La présence du @code{\stopStaff} est ici
+rendue nécessaire pour annuler les effets de la commande
+@code{\override} qui s'applique à l'intégralité du @code{StaffSymbol}.
-@lilypond[verbatim,quote,relative=2]
-c4 b a2
+@lilypond[verbatim,quote,relative=1]
+\override Staff.StaffSymbol.line-positions = #'(-8 0 2 4)
+d4 e f g
\stopStaff
-b4 c d2
\startStaff
-e4 d c2
+\override Staff.StaffSymbol.ledger-positions = #'(-8 -6 (-4 -2) 0)
+d4 e f g
@end lilypond
+Modifier l'équidistance des lignes de la portée affectera aussi les
+lignes supplémentaires.
-@predefined
-@code{\startStaff},
-@code{\stopStaff}.
-@endpredefined
-
+@lilypond[verbatim,quote,relative=2]
+\new Staff \with {
+ \override StaffSymbol.staff-space = #1.5
+}
+{ f'4 d, g, e, }
+@end lilypond
@snippets
-
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
{making-some-staff-lines-thicker-than-the-others.ly}
-
@seealso
Glossaire musicologique :
-@rglos{line},
-@rglos{ledger line},
-@rglos{staff}.
+@rglosnamed{line,ligne},
+@rglosnamed{ledger line,ligne supplémentaire},
+@rglosnamed{staff,portée}.
Manuel de notation :
@ref{Clefs}.
Morceaux choisis :
-@rlsr{Staff notation}.
+@rlsrnamed{Staff notation,Notation sur la portée}.
Référence des propriétés internes :
@rinternals{StaffSymbol},
@node Portées d'ossia
@unnumberedsubsubsec Portées d'ossia
-@translationof Ossia staves
+@translationof Ossia staves
@cindex portée à la française
@cindex ossia
@funindex stopStaff
Une portée d'@notation{ossia} -- ou de variante -- s'obtient en créant,
-à l'endroit approprié, une nouvelle portée simultanée :
+à l'endroit approprié, une nouvelle portée simultanée :
@lilypond[verbatim,quote]
\new Staff \relative c'' {
elle se réfère, étant par ailleurs dépourvue de métrique et de clef, et
d'une taille légèrement inférieure, vous devrez avoir recours à quelques
retouches. Le manuel d'initiation aborde une technique particulière
-pour obternir ce résultat au chapitre
+pour obtenir ce résultat, au chapitre
@rlearning{Expressions musicales imbriquées}.
L'exemple qui suit utilise, pour aligner la portée d'ossia, la propriété
lorsqu'il y a un nombre restreint d'ossias.
@lilypond[verbatim,quote]
-\new Staff = main \relative c'' {
+\new Staff = "main" \relative c'' {
c4 b d c
<<
{ c4 b d c }
\remove "Time_signature_engraver"
alignAboveContext = #"main"
fontSize = #-3
- \override StaffSymbol #'staff-space = #(magstep -3)
- \override StaffSymbol #'thickness = #(magstep -3)
+ \override StaffSymbol.staff-space = #(magstep -3)
+ \override StaffSymbol.thickness = #(magstep -3)
firstClef = ##f
}
{ e4 d f e }
Dans le cas où de nombreux et courts fragments d'ossia affecteraient
une même portée, il est judicieux de créer un contexte @code{Staff} vide
-auquel sera attribué un @emph{identificateur}. Il suffira alors, pour
-entamer un fragment d'ossia, de @emph{faire appel} à ce contexte grâce
+auquel sera attribué un @emph{identifiant}. Il suffira alors, pour
+entamer un fragment d'ossia, de « faire appel » à ce contexte grâce
aux commandes @code{\startStaff} et @code{\stopStaff}. Vous vous
rendrez compte à l'utilisation des avantages que procure cette façon de
procéder, bien plus que dans l'exemple suivant.
@lilypond[verbatim,quote,ragged-right]
<<
- \new Staff = ossia \with {
+ \new Staff = "ossia" \with {
\remove "Time_signature_engraver"
- \override Clef #'transparent = ##t
+ \hide Clef
fontSize = #-3
- \override StaffSymbol #'staff-space = #(magstep -3)
- \override StaffSymbol #'thickness = #(magstep -3)
+ \override StaffSymbol.staff-space = #(magstep -3)
+ \override StaffSymbol.thickness = #(magstep -3)
}
{ \stopStaff s1*6 }
c4 b c2
<<
{ e4 f e2 }
- \context Staff = ossia {
+ \context Staff = "ossia" {
\startStaff e4 g8 f e2 \stopStaff
}
>>
c4 b c2
<<
{ g4 a g2 }
- \context Staff = ossia {
+ \context Staff = "ossia" {
\startStaff g4 e8 f g2 \stopStaff
}
>>
>>
@end lilypond
-
Vous pourriez aussi recourir à la commande
-@code{\RemoveEmptyStaffContext} pour créer votre portée d'ossia.
+@code{\Staff \RemoveEmptyStaves} pour créer votre portée d'ossia.
Cependant, cette méthode reste limitée à l'apparition de ces ossias en
début de ligne. Pour plus d'information au sujet de la commande
-@code{\RemoveEmptyStaffContext}, reportez-vous au chapitre
-@ref{Masquage de portées}.
+@code{\Staff \RemoveEmptyStaves}, reportez-vous au chapitre
+@ref{Masquage de portées}.
@lilypond[verbatim,quote,ragged-right]
<<
- \new Staff = ossia \with {
+ \new Staff = "ossia" \with {
\remove "Time_signature_engraver"
- \override Clef #'transparent = ##t
+ \hide Clef
fontSize = #-3
- \override StaffSymbol #'staff-space = #(magstep -3)
- \override StaffSymbol #'thickness = #(magstep -3)
+ \override StaffSymbol.staff-space = #(magstep -3)
+ \override StaffSymbol.thickness = #(magstep -3)
} \relative c'' {
R1*3
c4 e8 d c2
\layout {
\context {
- \RemoveEmptyStaffContext
- \override VerticalAxisGroup #'remove-first = ##t
+ \Staff \RemoveEmptyStaves
+ \override VerticalAxisGroup.remove-first = ##t
}
}
@end lilypond
-
@snippets
-
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
{vertically-aligning-ossias-and-lyrics.ly}
-
@seealso
Glossaire musicologique :
@rglos{ossia},
-@rglos{staff},
+@rglosnamed{staff,portée},
@rglos{Frenched staff}.
Manuel d'initiation :
@ref{Masquage de portées}.
Morceaux choisis :
-@rlsr{Staff notation}.
+@rlsrnamed{Staff notation,Notation sur la portée}.
Référence des propriétés internes :
@rinternals{StaffSymbol}.
@translationof Hiding staves
@cindex Frenched scores
-@cindex Masquage de portée
+@cindex masquage de portée
@cindex portée vide
-@funindex \RemoveEmptyStaffContext
-@funindex RemoveEmptyStaffContext
+@funindex \RemoveEmptyStaves
@funindex Staff_symbol_engraver
@funindex \stopStaff
@funindex stopStaff
-
Désactiver le graveur @code{Staff_symbol_engraver} dans un contexte
@code{Staff} permet de masquer des lignes. La commande
@code{\stopStaff} aura le même effet.
\relative c''' { a8 f e16 d c b a2 }
@end lilypond
-L'instruction @code{\RemoveEmptyStaffContext} placée dans un bloc
+L'instruction @code{\Staff \RemoveEmptyStaves} placée dans un bloc
@code{\layout} aura pour effet de masquer toute portée qui ne contient
rien. Dans les partitions d'orchestre, les portées qui n'ont que des
silences sont habituellement masquées afin de gagner de la place. Ce
-style d'édition s'appelle en anglais @qq{French Score}.
+style d'édition s'appelle en anglais « French Score ».
Cette fonctionnalité masque et supprime toutes les portées vides d'une
-partition, hormis celles du premièr système.
+partition, hormis celles du premier système.
@warning{Une portée est considérée comme vide dès lors qu'elle ne
-contient que des silences multi-mesure, des silences invisibles ou
-d'espacement (les @emph{\skip}) ou bien une combinaison de ces
-éléments.}
+contient que des silences multimesures, des silences visibles ou
+invisibles (ou d'espacement -- les @emph{@bs{}skip}) ou bien une
+combinaison de ces éléments.}
@lilypond[verbatim,quote,ragged-right]
\layout {
\context {
- \RemoveEmptyStaffContext
+ \Staff \RemoveEmptyStaves
}
}
@cindex ossia
@noindent
-@code{\RemoveEmptyStaffContext} permet aussi de gérer des fragments
-d'ossia attachés à une portée. Pour plus de détails, voir
+@code{\Staff \RemoveEmptyStaves} permet aussi de gérer des fragments
+d'ossia attachés à une portée. Pour plus de détails, voir
@ref{Portées d'ossia}.
@cindex musique ancienne, masquage de portée
@cindex portées rythmiques, masquage
-@funindex \RemoveEmptyStaffContext
-@funindex RemoveEmptyStaffContext
-@funindex \AncientRemoveEmptyStaffContext
-@funindex AncientRemoveEmptyStaffContext
-@funindex \RemoveEmptyRhythmicStaffContext
-@funindex RemoveEmptyRhythmicStaffContext
+@funindex \RemoveEmptyStaves
-La commande @code{\AncientRemoveEmptyStaffContext} permet de masquer des
+La commande @code{\VaticanaStaff \RemoveEmptyStaves} permet de masquer des
portées vides dans les contextes de musique ancienne. Pour des
contextes @code{RhythmicStaff}, il faudra utiliser
-@code{\RemoveEmptyRhythmicStaffContext}.
-
+@code{\RhythmicStaff \RemoveEmptyStaves}.
@predefined
-@code{\RemoveEmptyStaffContext},
-@code{\AncientRemoveEmptyStaffContext},
-@code{\RemoveEmptyRhythmicStaffContext}.
+@code{\Staff \RemoveEmptyStaves},
+@code{\VaticanaStaff \RemoveEmptyStaves},
+@code{\RhythmicStaff \RemoveEmptyStaves}.
@endpredefined
-
@snippets
-
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
{removing-the-first-empty-line.ly}
-
@seealso
Glossaire musicologique :
@rglos{Frenched staff}.
@rlearning{Visibilité et couleur des objets}.
Manuel de notation :
+@ref{Modification des réglages par défaut d'un contexte},
@ref{Symbole de la portée},
@ref{Portées d'ossia},
@ref{Dictée à trous},
@ref{Visibilité des objets}.
Morceaux choisis :
-@rlsr{Staff notation}.
+@rlsrnamed{Staff notation,Notation sur la portée}.
Référence des propriétés internes :
@rinternals{ChordNames},
@rinternals{VerticalAxisGroup},
@rinternals{Staff_symbol_engraver}.
-
@knownissues
-
Supprimer le @code{Staff_symbol_engraver} aura pour effet de masquer les
barres de mesure. Forcer leur visibilité peut entraîner des problèmes
-de formattage. En pareil cas il vaut mieux, au lieu de supprimer le
-graveur, recourrir aux dérogations suivantes :
+de formatage. En pareil cas il vaut mieux, au lieu de supprimer le
+graveur, recourir aux dérogations suivantes :
@example
-\override StaffSymbol #'stencil = ##f
-\override NoteHead #'no-ledgers = ##t
+\omit StaffSymbol
+\override NoteHead.no-ledgers = ##t
@end example
+En ce qui concerne les désagréments et messages liés à l'utilisation de
+l'instruction @code{\Staff \RemoveEmptyStaves}, consultez
+@ref{Modification des réglages par défaut d'un contexte}.
+
@node Écriture de parties séparées
@subsection Écriture de parties séparées
@translationof Writing parts
-Nous allons voir au fil des lignes qui suivent, comment insérer des
+Nous allons voir, au fil des lignes qui suivent, comment insérer des
indications de tempo ou des noms d'instrument dans une partition. Nous
aborderons aussi la citation d'autres voix, et comment la mettre en
forme.
@menu
-* Indications métronomiques::
-* Noms d'instrument::
-* Citation d'autres voix::
-* Mise en forme d'une citation::
+* Noms d'instrument::
+* Citation d'autres voix::
+* Mise en forme d'une citation::
@end menu
-@node Indications métronomiques
-@unnumberedsubsubsec Indications métronomiques
-@translationof Metronome marks
-
-@cindex Tempo
-@cindex battements par minute
-@cindex indication métronomique
-
-@funindex \tempo
-@funindex tempo
-
-Le métronome se règle de la manière suivante :
-
-@lilypond[verbatim,quote,relative=1]
-\tempo 4 = 120
-c2 d
-e4. d8 c2
-@end lilypond
-
-On peut cependant lui préférer du texte :
-
-@lilypond[verbatim,quote,relative=2]
-\tempo "Allegretto"
-c4 e d c
-b4. a16 b c4 r4
-@end lilypond
-
-Lorsque l'on indique à la fois le tempo et le métronome, ce dernier sera
-indiqué entre parenthèses :
-
-@lilypond[verbatim,quote,relative=2]
-\tempo "Allegro" 4 = 160
-g4 c d e
-d4 b g2
-@end lilypond
-
-En règle générale, le texte peut être constitué de n'importe quel objet
-de type @code{markup} :
-
-@lilypond[verbatim,quote,relative=2]
-\tempo \markup { \italic Faster } 4 = 132
-a8-. r8 b-. r gis-. r a-. r
-@end lilypond
-
-Une simple indication métronomique entre parenthèses s'obtient en
-fournissant une chaîne vide à l'instruction :
-
-@lilypond[verbatim,quote,relative=2]
-\tempo "" 8 = 96
-d4 g e c
-@end lilypond
-
-
-@snippets
-
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
-{printing-metronome-and-rehearsal-marks-below-the-staff.ly}
-
-@c perhaps also an example of how to move it horizontally?
-
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
-{changing-the-tempo-without-a-metronome-mark.ly}
-
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
-{creating-metronome-marks-in-markup-mode.ly}
-
-Pour plus de détails, voir @ref{Mise en forme du texte}.
-
-
-@seealso
-Glossaire musicologique :
-@rglos{metronome},
-@rglos{metronomic indication},
-@rglos{tempo indication},
-@rglos{metronome mark}.
-
-Manuel de notation :
-@ref{Mise en forme du texte},
-@ref{Sortie MIDI}.
-
-Morceaux choisis :
-@rlsr{Staff notation}.
-
-Référence des propriétés internes :
-@rinternals{MetronomeMark}.
-
-
@node Noms d'instrument
@unnumberedsubsubsec Noms d'instrument
@translationof Instrument names
@cindex instrument, noms abrégés
Dans un conducteur, les noms d'instrument sont portés en regard de
-chacune des portées, qu'il s'agisse d'un contexte @code{Staff} ou
-d'un @code{PianoStaff}. La première ligne affichera la valeur de
+chacune des portées, qu'il s'agisse d'un contexte @code{Staff},
+@code{PianoStaff}, @code{StaffGroup}, @code{GrandStaff} ou
+@code{ChoirStaff} . La première ligne affichera la valeur de
@code{instrumentName}, et les suivantes celle de
@code{shortInstrumentName}.
@lilypond[verbatim,quote,ragged-right,relative=1]
-\set Staff.instrumentName = #"Violin "
-\set Staff.shortInstrumentName = #"Vln "
-c4.. g'16 c4.. g'16
-\break
-c1
+\new Staff \with {
+ instrumentName = #"Violin "
+ shortInstrumentName = #"Vln. "
+}
+{ c4.. g'16 c4.. g'16 \break | c1 }
@end lilypond
Le recours à la commande @code{\markup} permet de construire des noms
-d'instruments particuliers, tels que
+d'instrument particuliers, tels que
@lilypond[verbatim,quote,relative=2]
-\set Staff.instrumentName = \markup {
- \column { "Clarinetti"
- \line { "in B" \smaller \flat } } }
-c4 c,16 d e f g2
+\new Staff \with {
+ instrumentName = \markup {
+ \column { "Clarinetti"
+ \line { "in B" \smaller \flat }
+ }
+ }
+}
+{ c4 c,16 d e f g2 }
@end lilypond
@cindex noms d'instrument, centrés
Lorsque plusieurs contextes de portée sont regroupés, les noms
d'instrument, que ce soit sous leur forme développée ou abrégée, sont
par défaut centrés. Si l'un d'entre eux est libellé sur plusieurs
-lignes, il faudra recourrir à l'instruction @code{\center-column} :
+lignes, il faudra recourir à l'instruction @code{\center-column} :
@lilypond[verbatim,quote,indent=1.5\cm,relative=2]
<<
- \new Staff {
- \set Staff.instrumentName = #"Flute"
- f2 g4 f
+ \new Staff \with {
+ instrumentName = #"Flute"
}
- \new Staff {
- \set Staff.instrumentName = \markup \center-column {
- Clarinet
+ { f2 g4 f }
+ \new Staff \with {
+ instrumentName = \markup {
+ \center-column { "Clarinet"
\line { "in B" \smaller \flat }
+ }
}
- c4 b c2
}
+ { c4 b c2 }
>>
@end lilypond
@funindex indent
@funindex short-indent
-Losque le nom d'un instrument est relativement long, il est judicieux
+Lorsque le nom d'un instrument est relativement long, il est judicieux
d'augmenter les retraits -- @emph{indent} -- au sein du bloc
@code{\layout} à l'aide des commandes @code{indent} et
@code{short-indent}. Pour plus de plus amples détails sur ces réglages,
-reportez-vous au chapitre @ref{Dimensionnement horizontal}.
+reportez-vous au chapitre @ref{Variables d'indentation et de décalage}.
@lilypond[verbatim,quote,ragged-right]
+\relative c'' {
+ <<
+ \new Staff \with {
+ instrumentName = #"Alto Flute in G"
+ shortInstrumentName = #"Flt."
+ }
+ {
+ f2 g4 f \break
+ g4 f g2
+ }
+ \new Staff \with {
+ instrumentName = #"Clarinet"
+ shortInstrumentName = #"Clar."
+ }
+ {
+ c,4 b c2 \break
+ c2 b4 c
+ }
+ >>
+}
+
\layout {
indent = 3.0\cm
short-indent = 1.5\cm
}
-
-\relative c'' <<
- \new Staff {
- \set Staff.instrumentName = #"Alto Flute in G"
- \set Staff.shortInstrumentName = #"Fl."
- f2 g4 f \break
- g4 f g2
- }
- \new Staff {
- \set Staff.instrumentName = #"Clarinet"
- \set Staff.shortInstrumentName = #"Clar."
- c,4 b c2 \break
- c2 b4 c
- }
->>
@end lilypond
@cindex noms d'instrument, autres contextes
-Des noms d'instruments peuvent s'utiliser dans d'autres contextes, tels
-que @code{GrandStaff}, @code{ChoirStaff}, ou @code{StaffGroup}, dès lors
-qu'on leur adjoint le graveur @code{Instrument_name_engraver}. Pour de
-plus amples informations sur la manière d'activer ou
-désactiver un graveur, voir @ref{Modification des greffons de contexte}.
+Des noms d'instrument peuvent s'utiliser dans d'autres contextes, tels
+que @code{ChordNames} ou @code{FiguredBass}, dès lors qu'on leur adjoint
+le graveur @code{Instrument_name_engraver}. Pour de plus amples
+informations sur la manière d'activer ou désactiver un graveur, voir
+@ref{Modification des greffons de contexte}.
@cindex instrument, changement de nom
@cindex changement de nom d'instrument
-Vous pouvez changer le nom d'un instrument en cours de morceau :
+Vous pouvez changer le nom d'un instrument en cours de morceau. Notez
+cependant que la valeur de @code{instrumentName} ne s'affichera que sur
+la première portée :
@lilypond[verbatim,quote,ragged-right,relative=1]
-\set Staff.instrumentName = #"First"
-\set Staff.shortInstrumentName = #"one"
-c1 c c c \break
-c1 c c c \break
-\set Staff.instrumentName = #"Second"
-\set Staff.shortInstrumentName = #"two"
-c1 c c c \break
-c1 c c c \break
+\new Staff \with {
+ instrumentName = #"Flute"
+ shortInstrumentName = #"Flt."
+}
+{
+ c1 c c c \break
+ c1 c c c \break
+ \set Staff.instrumentName = #"Clarinet"
+ \set Staff.shortInstrumentName = #"Clt."
+ c1 c c c \break
+ c1 c c c \break
+}
@end lilypond
@cindex instrument, changement
@funindex \instrumentSwitch
@funindex instrumentSwitch
-Lorsqu'un musicien doît changer d'instrument -- piccolo et flûte, basson
+Lorsqu'un musicien doit changer d'instrument -- piccolo et flûte, basson
et contrebasson --, la commande @code{\addInstrumentDefinition},
couplée à l'instruction @code{\instrumentSwitch} permet de spécifier en
-détail les modifications intervenant lors du changement. La commande
-@code{\addInstrumentDefinition} prend deux arguments : une chaîne de
-caractères qui servira d'identificateur, et une liste d'associations
+détail les modifications intervenant lors du changement. La commande
+@code{\addInstrumentDefinition} prend deux arguments : une chaîne
+de caractères qui servira d'identifiant, et une liste d'association
de valeurs aux propriétés de ce nouvel instrument. Ces définitions
devront être déclarées avant tout autre élément musical. L'instruction
@code{\instrumentSwitch} se placera dans la musique au moment de la
-subtitution :
+substitution :
@lilypond[verbatim,quote,ragged-right]
\addInstrumentDefinition #"contrabassoon"
R1*16
\instrumentSwitch "contrabassoon"
c,,2 g \break
- c,1 ~ | c1
+ c,1 ~ | 1
}
@end lilypond
-
@seealso
Manuel de notation :
-@ref{Dimensionnement horizontal},
+@ref{Variables d'indentation et de décalage},
@ref{Modification des greffons de contexte}.
Morceaux choisis :
-@rlsr{Staff notation}.
+@rlsrnamed{Staff notation,Notation sur la portée}.
Référence des propriétés internes :
@rinternals{InstrumentName},
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.
+voix est la @emph{réplique} d'une autre, sans devoir 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 :
-
-@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 la 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 : le nom de la voix reproduite, tel que défini par
+arguments : 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 multi-mesures. Viendra alors
-s'insérer dans l'expression musicale le fragment correspondant de la
-voix originelle.
+cette citation.
@lilypond[verbatim,quote]
-flute = \relative c'' {
- a4 gis g gis
+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
Si l'expression musicale utilisée pour @code{\quoteDuring} contenait
autre chose que du silence, il en résulterait une situation
-polyphonique, ce qui n'est pas le but recherché :
+polyphonique, ce qui n'est pas le but recherché :
@lilypond[verbatim,quote]
-flute = \relative c'' {
- a4 gis g gis
+fluteNotes = \relative c'' {
+ a4 gis g gis | b4^"quoted" r8 ais\p a4( f)
+ }
+
+oboeNotes = \relative c'' {
+ c4 cis c b \quoteDuring #"flute" { e4 r8 ais b4 a }
}
-\addQuote "flute" { \flute }
-\relative c' {
- c4 cis \quoteDuring #"flute" { c4 b }
+\addQuote "flute" { \fluteNotes }
+
+\score {
+ <<
+ \new Staff \with { instrumentName = "Flute" } \fluteNotes
+ \new Staff \with { instrumentName = "Oboe" } \oboeNotes
+ >>
}
@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.
+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'' {
+clarinetNotes = \relative c'' {
\transposition bes
- a4 gis g gis
+ \key d \major
+ b4 ais a ais | cis4^"quoted" r8 bis\p b4( f)
}
-\addQuote "clarinet" { \clarinet }
-\relative c' {
- 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
-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}.
-
-
-@snippets
-
-@lilypondfile[verbatim,lilyquote,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
+
+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 }
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
-{quoting-another-voice.ly}
+\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 « 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
-Manuel de notation :
+Manuel de notation :
@ref{Instruments transpositeurs},
@ref{Utilisation de balises}.
-Morceaux choisis :
-@rlsr{Staff notation}.
+Fichiers d'initialisation :
+@file{scm/define-event-classes.scm}.
+
+Morceaux choisis :
+@rlsrnamed{Staff notation, Notation sur la portée}.
-Référence des propriétés internes :
+Référence des propriétés internes :
+@rinternals{Music classes},
@rinternals{QuoteMusic},
@rinternals{Voice}.
-
@knownissues
-
Seul le contenu de la première @code{Voice} rencontrée dans la
-partie marquée d'une commande @code{\addQuote} pourra être retenu. Par
-voie de conséquence, @var{musique} ne saurait comprendre de @code{\new}
-ou une instance @code{\context Voice} qui la ferait passer à une autre
-voix.
+partie marquée d'une commande @code{\addQuote} pourra être retenu. Par
+voie de conséquence, @code{@var{musique}} ne saurait comprendre de
+@code{\new} ou une instance @code{\context Voice} qui la ferait
+passer à une autre voix.
Citer des notes d'ornement ne fonctionne pas, et peut même entraîner
un blocage de LilyPond.
-Citer des triolets imbriqués peut entraîner un résultat de médiocre
-qualité.
-
-Dans les versions précédentes de LilyPond (avant 2.11), @code{addQuote}
-était écrit entièremeent en minuscules : @code{\addquote}.
+Citer des triolets imbriqués peut entraîner un résultat de piètre
+qualité.
@node Mise en forme d'une citation
@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.
-Sa syntaxe est :
+@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{\cueClef}, 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}.
+
+@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écessaire 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{voix} @var{musique}
+\cueDuring #@var{origine} #@var{position} #@var{musique}
@end example
-Des mesures issues de la partie d'@var{origine} seront recopiées dans un
-contexte de @code{CueVoice}, créé implicitement, et synchronisées avec
-@var{musique} -- habituellement un silence. L'apparition des petites
-notes initialise une polyphonie temporaire pour la portée concernée.
-L'argument @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.
+et
+@example
+\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} 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
+ \new CueVoice { \set instrumentCueName = "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}.
-
-Le nom de l'instrument qui est répliqué sera imprimé dès lors que vous
-définirez la propriété @code{instrumentCueName} du 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 @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''' {
- g4 r8 e16 f e4 d
+oboeNotes = \relative c'' {
+ r2 r8 d16(\f f e g f a)
+ g8 g16 g g2.
}
-\addQuote "oboe" { \oboe }
+\addQuote "oboe" { \oboeNotes }
-\new Staff \relative c'' <<
- \new CueVoice \with {
- instrumentCueName = "ob."
- }
- \new Voice {
- \cueDuring #"oboe" #UP { R1 }
- g4. b8 d2
- }
->>
+\new Voice \relative c'' {
+ \set Score.quotedCueEventTypes = #'(note-event rest-event tie-event
+ beam-event tuplet-span-event
+ dynamic-event slur-event)
+ \cueDuring #"oboe" #UP { R1 }
+ g2 c,
+}
@end lilypond
-@cindex citation, fin
-@cindex fin de citation
-@cindex réplique, fin
-@cindex fin de réplique
+Le nom de l'instrument qui est répliqué sera imprimé dès lors qu'aura
+été définie la propriété @code{instrumentCueName} d'un contexte
+@code{CueVoice} temporaire. Le positionnement et le style adopté par
+@code{instrumentCueName} dépendent de l'objet @code{InstrumentSwitch}
+-- voir @ref{Noms d'instrument}. Par ailleurs, si la citation nécessite
+l'apparition d'une clef différente, celle-ci devra être introduite
+manuellement, tout comme l'originale qui devra être rappelée en fin de
+citation.
-@funindex \killCues
-@funindex killCues
-@funindex \transposedCueDuring
-@funindex transposedCueDuring
+@lilypond[verbatim,quote]
+fluteNotes = \relative c'' {
+ r2. c4 d8 c d e fis2 g2 d2
+}
-Lorsque la citation comporte une étiquette indiquant l'instrument qui
-joue, il est judicieux, au moment où la partie originale reprend sa
-place, de rappeler l'instrument et d'annuler toute autre modification
-introduite par cette citation. D'où l'utilité des commandes
-@code{\addInstrumentDefinition} et @code{\instrumentSwitch}. Pour plus
-d'information, reportez-vous au chapitre @ref{Noms d'instrument}.
+bassoonNotes = \relative c {
+ \clef bass
+ R1
+ \clef treble
+ \new CueVoice { \set instrumentCueName = "flute" }
+ \cueDuring #"flute" #UP { R1 }
+ \clef bass
+ g4. b8 d2
+}
-La commande @code{killCues} permet de supprimer les notes d'une
-citation. Ceci est utile lorsque cette citation n'est pas imprimée dans
-un premier temps.
+\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]
-flute = \relative c''' {
- r2 cis2 r2 dis2
+fluteNotes = \relative c'' {
+ r2. c4 d8 c d e fis2 g2 d2
}
-\addQuote "flute" { \flute }
-\new Voice \relative c'' {
- \killCues {
- \cueDuring #"flute" #UP { R1 }
- g4. b8 d2
- }
+bassoonNotes = \relative c {
+ \clef bass
+ R1
+ \new CueVoice { \set instrumentCueName = "flute" }
+ \cueDuringWithClef #"flute" #UP #"treble" { R1 }
+ g4. b8 d2
+}
+
+\addQuote "flute" { \fluteNotes }
+
+\new Staff {
+ \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'instrument 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 contrebasson. 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}.
+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]
-piccolo = \relative c''' {
+piccoloNotes = \relative c''' {
\clef "treble^8"
R1
c8 c c e g2
- a4 g g2
+ c4 g g2
}
-\addQuote "piccolo" { \piccolo }
-cbassoon = \relative c, {
- \clef "bass_8"
- c4 r g r
- \transposedCueDuring #"piccolo" #UP c,, { R1 }
- c4 r g r
+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 = "piccolo" \piccolo
- \new Staff = "cbassoon" \cbassoon
+ \new Staff \piccoloNotes
+ \new Staff \bassClarinetNotes
>>
@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}.
+@cindex citation, fin
+@cindex fin de citation
+@cindex réplique, fin
+@cindex fin de réplique
-@cindex notes, petites
-@cindex petites notes
+@funindex \killCues
+@funindex killCues
+@funindex \addInstrumentDefinition
+@funindex addInstrumentDefinition
-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.
+La commande @code{killCues} permet de supprimer les notes d'une
+citation. Ceci est utile lorsque cette citation n'est pas imprimée dans
+le conducteur entre autres. @code{killCues} supprimera les notes et
+autres événements pris en charge par @code{\cueDuring}. Pour les
+autres annotations telles que changement de clef ou instrument concerné,
+faites appel à des balises -- voir @ref{Utilisation de balises} à ce
+sujet.
-@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 }
+@lilypond[verbatim,quote]
+fluteNotes = \relative c'' {
+ r2. c4 d8 c d e fis2 g2 d2
+}
+
+bassoonNotes = \relative c {
+ \clef bass
+ R1
+ \tag #'part {
+ \clef treble
+ \new CueVoice { \set instrumentCueName = "flute" }
+ }
+ \cueDuring #"flute" #UP { R1 }
+ \tag #'part \clef bass
+ g4. b8 d2
+}
+
+\addQuote "flute" { \fluteNotes }
+
+\new Staff {
+ \bassoonNotes
+}
+
+\new StaffGroup <<
+ \new Staff {
+ \fluteNotes
+ }
+ \new Staff {
+ \removeWithTag #'part { \killCues { \bassoonNotes } }
+ }
>>
-\stemUp
-d2. d2.
@end lilypond
+Lorsque la citation comporte une étiquette indiquant l'instrument qui
+joue et un changement de clef, ces éléments peuvent se regrouper à
+l'aide de la commande @code{\addInstrumentDefinition}. Pour plus
+d'information, reportez-vous au chapitre @ref{Noms d'instrument}.
@seealso
Manuel de notation :
+@ref{Citation d'autres voix},
@ref{Instruments transpositeurs},
@ref{Noms d'instrument},
+@ref{Clefs},
+@ref{Citation-repère},
@ref{Utilisation de balises}.
Morceaux choisis :
-@rlsr{Staff notation}.
+@rlsrnamed{Staff notation, Notation sur la portée}.
Référence des propriétés internes :
@rinternals{CueVoice},
@rinternals{Voice}.
-
@knownissues
-
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.
projects / lilypond.git / blobdiff