@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-

@ignore
    Translation of GIT committish: 15ef26d4cde4d2d170e88a13867169d4e75026ae

    When revising a translation, copy the HEAD committish of the
    version that you are working on.  See TRANSLATION for details.
@end ignore

@c \version "2.12.0"

@c Translators: Valentin Villenave, Jean-Charles Malahieude
@c Translation checkers: Jean-Charles Malahieude, John Mandereau

@node Instruments utilisant des portées multiples
@section Instruments utilisant des portées multiples
@translationof Keyboard and other multi-staff instruments

@lilypondfile[quote]{keyboard-headword.ly}

Ce chapitre traite des différents aspects de la notation que l'on
rencontre particulièrement avec les instruments qui ont recours à
plusieurs portées, tels que ceux disposant de claviers, la harpe ou
le vibraphone.  Pour les besoins du discours, et pour simplifier, nous
parlerons ici de @qq{clavier} bien que le recours à des portées multiples
concerne aussi des instruments qui en sont dépourvus.

@menu
* Vue d'ensemble des claviers::  
* Piano::                       
* Accordéon::                   
* Harpe::                        
@end menu

@node Vue d'ensemble des claviers
@subsection Vue d'ensemble des claviers
@translationof Common notation for keyboards

Nous allons examiner ici les problèmes qui peuvent survenir en matière
de notation pour la plupart des instrument à cordes multiples.

@menu
* Généralités sur les instruments à clavier::    
* Changement de portée manuel::     
* Changement de portée automatique::  
* Lignes de changement de portée::          
* Hampes et changements de portée::           
@end menu

@node Généralités sur les instruments à clavier
@unnumberedsubsubsec Généralités sur les instruments à clavier
@translationof References for keyboards

@c untranslated
@c ifnothtml
@c englishref
@c end ifnothtml
@cindex piano, système pour
@cindex portées pour piano
@cindex portées pour instrument à clavier
@cindex portées pour instrument à clés
@cindex clavier, portées pour instrument à
@cindex clés, portées pour instrument à

@funindex PianoStaff

La notation pour instrument à clavier est en règle générale présentée
sous la forme d'un système pour piano, autrement dit deux portées
normales ou plus réunies par une accolade. Cette notation sert également
à la harpe ou à d'autres instruments à clés.  L'organiste, quant à lui,
lira une partition composée de deux portées au sein d'un système
pianistique auquel vient s'adjoindre une portée normale pour le pédalier. 

Les portées sont largement autonomes, mais il arrive que des voix
passent de l'une à l'autre.  Le contexte @code{PianoStaff} est
précisément conçu pour gérer la notation spécifique au piano et autres
instruments à clavier, notamment ces croisements.

Certaines particularités de la notation pour claviers sont abordées dans
d'autres chapitres :

@itemize

@item Les claviers ont régulièrement recours à plusieurs voix dont le
nombre peut varier. voir à ce sujet @ref{Résolution des collisions}.

@item On peut écrire la musique pour claviers de façon parallèle, comme
l'explique @ref{Saisie de musique en parallèle}.

@item Les indications de doigté sont abrodées dans 
@ref{Doigtés}. 

@item Les indications en matière de pédalier d'orgue sont traitées comme
des articulations. Voir à ce sujet @ref{List of articulations}.

@item Pour générer des repères verticaux, voir @ref{Quadrillage temporel}.

@item En plus des @notation{Laissez vibrer}, les liaisons en matière de
clavier peuvent intervenir sur des accords arpégés ou des trémolos.
Reportez-vous au chapitre @ref{Liaisons de prolongation}.

@item Le traitement des arpèges couvrant plusieurs voix ou portées est
abordé au chapitre @ref{Arpèges}.

@item Une description des indications de tremolo est disponible au
chapitre @ref{Répétitions en trémolo}.

@item Certaines retouches particulières au monde des claviers sont
abordées au chapitre @rlearning{Exemple concret}.

@item Des notes fantômes permettent d'introduire des liaisons de tenue
qui passent d'une voix à l'autre, comme le montre 
@rlearning{Autres utilisations des retouches}.

@end itemize


@seealso
Manuel d'initiation :
@rlearning{Exemple concret},
@rlearning{Autres utilisations des retouches}.

Manuel de notation :
@ref{Regroupement de portées},
@ref{Noms d'instrument},
@ref{Résolution des collisions},
@ref{Saisie de musique en parallèle},
@ref{Doigtés},
@ref{List of articulations},
@ref{Quadrillage temporel},
@ref{Liaisons de prolongation},
@ref{Arpèges},
@ref{Répétitions en trémolo}.

Référence des propriétés internes :
@rinternals{PianoStaff}.

Exemples de code :
@rlsr{Keyboards}.



@knownissues

@cindex claviers, centrage des nuances
@cindex nuances entre les portées d'un système pianistique
@cindex piano, nuances entre les portées
@cindex centrage des nuances entre deux portées de piano
@funindex staff-padding

Les nuances ne sont pas automatiquement centrées verticalement, mais il
existe des astuces.  Voir à ce sujet le modèle @qq{alignement des
nuances au piano} au chapitre @rlearning{Modèles pour claviers} ; une autre
solution consiste à augmenter le décalage des nuances par rapport à la
portée (@code{staff-pagging}) comme l'indique 
@rlearning{Déplacement d'objets}.


@node Changement de portée manuel
@unnumberedsubsubsec Changement de portée manuel
@translationof Changing staff manually

@cindex changements de portée manuels
@cindex changement de portée forcé
@cindex inter-portée, notes
@cindex notes inter-portée
@cindex inter-portée, ligatures
@cindex ligature inter-portée

@funindex \change
@funindex change

Il est possible de passer d'une portée à l'autre de façon manuelle, au
moyen de la commande

@example
\change Staff = @var{nomDeLaPortee}
@end example

@noindent
La valeur @var{nomDeLaPortee} est le nom de la portée sur laquelle va se
déplacer la voix courante.  Pour des raisons pratiques, on nomme la portée
supérieure @code{"haut"} et la portée inférieure @code{"bas"}, donc
@var{nomDeLaPortee} désigne habituellement @code{"haut"}, @code{"bas"},
@code{"MD"} ou @code{"MG"}.  Dans tous les cas, le contexte de
portée ainsi utilisé doit exister au préalable. 

Pour ligaturer automatiquement des notes entre deux portées, procédez
ainsi : 

@lilypond[verbatim,quote]
\new PianoStaff <<
  \new Staff = "up" {
    <e' c'>8
    \change Staff = "down"
    g8 fis g
    \change Staff = "up"
    <g'' c''>8
    \change Staff = "down"
    e8 dis e
    \change Staff = "up"
  }
  \new Staff = "down" {
    \clef bass
    % keep staff alive
    s1
  }
>>
@end lilypond

Si les ligatures demandaient à être retouchées, commencez par
modifier la direction des hampes.  L'emplacement des ligatures sera
alors calculé à partir du centre de la portée la plus proche -- voir
@rlearning{Correction des collisions d'objets} pour un exemple de retouche sur
des ligatures. 


@seealso
Manuel d'initiation :
@rlearning{Correction des collisions d'objets}.

Manuel de notation :
@ref{Hampes},
@ref{Barres de ligature automatiques}.

Exemples de code :
@rlsr{Keyboards}.

Référence des propriétés internes :
@rinternals{Beam},
@rinternals{ContextChange}.


@node Changement de portée automatique
@unnumberedsubsubsec Changement de portée automatique
@translationof Changing staff automatically

@cindex Changement de portée automatique
@cindex Automatique, changement de portée

@funindex \autochange
@funindex autochange
@funindex PianoStaff

Les voix peuvent passer automatiquement d'une portée à l'autre, au moyen
de la syntaxe suivante :

@example
\autochange @dots{}@var{musique}@dots{}
@end example

@noindent
Deux portées seront alors créées au sein du contexte @code{PianoStaff},
nommées respectivement @code{"up"} et @code{"down"}.  La portée du bas 
sera par défaut en clé de fa.  La commande @code{\autochange} bascule
les notes d'une portée à l'autre en fonction de leur hauteur (le do du
milieu servant de pivot), et place les silences en fonction des notes
qui les suivront. Ainsi : 

@lilypond[quote,verbatim]
\new PianoStaff {
  \autochange {
    g4 a b c'
    d'4 r a g
  }
}
@end lilypond

@cindex mode relatif et autochange
@cindex autochange et mode relatif

@funindex \relative
@funindex relative

Une section en mode @code{\relative} se situant en dehors de la commande
@code{\autochange} n'aura pas d'effet sur les hauteurs de l'expression
@var{musique}.  Il est donc préférable d'introduire la directive
@code{\relative} @strong{après} @code{\autochange}.

Lorsque des contrôles particuliers doivent s'appliquer aux portées,
mieux vaut les nommer explicitement -- attention : sous peine
d'effet indésirable quant au résultat, la portée supérieure doit
s'appeler @code{"up"} et l'inférieure @code{"down"} ; @emph{ceci est à
notre connaissance le seul cas où ces noms de variable sont figés}.
Cette procédure sert, entre autres, à indiquer l'armure sur la portée
inférieure :

@c Keep Ly needed, otherwise 'up' and 'down' get
@c incorrectly translated in verbatim output
@c KEEP LY
@lilypond[quote,verbatim,nogettext]
\new PianoStaff <<
  \new Staff = "up" {
    \new Voice = "melodieUn" {
      \key g \major
      \autochange \relative c' {
        g8 b a c b d c e
        d8 r fis, g a2
      }
    }
  }
  \new Staff = "down" {
    \key g \major
    \clef bass
  }
>>
@end lilypond


@seealso
Dans ce même manuel : 
@ref{Changement de portée manuel}.

Exemples de code :
@rlsr{Keyboards}.

Référence des propriétés internes : 
@rinternals{AutoChangeMusic}.


@knownissues

@cindex accords, répartition sur plusieurs portées avec \autochange

Les changements de portée automatiques n'interviennent pas toujours à
l'endroit le plus opportun.  Pour un résultat de meilleure qualité, il
vaut mieux indiquer soi-même ces changements.

Un accord ne peut se répartir sur plusieurs portées ; sa portée
d'affectation sera déterminée par la première hauteur mentionnée dans la
construction de cet accord.  

@code{\autochange} ne peut intervenir à l'intérieur d'une commande
@code{\times}.


@node Lignes de changement de portée
@unnumberedsubsubsec Lignes de changement de portée
@translationof Staff-change lines

@cindex voix entre deux portées
@cindex changements de portée
@cindex mélodie d'une portée à une autre

@funindex followVoice
@funindex \showStaffSwitch
@funindex showStaffSwitch
@funindex \hideStaffSwitch
@funindex hideStaffSwitch

Lorsqu'une voix change de portée, il est possible d'imprimer
automatiquement une ligne reliant les notes, en faisant appel à la
commande @code{\showStaffSwitch} :

@lilypond[quote,verbatim,relative=1]
\new PianoStaff <<
  \new Staff = "one" {
    \showStaffSwitch
    c1
    \change Staff = "two"
    b2 a
  }
  \new Staff = "two" {
    \clef bass
    s1*2
  }
>>
@end lilypond


@predefined
@code{\showStaffSwitch},
@code{\hideStaffSwitch}.
@endpredefined


@seealso
Extraits de code :
@rlsr{Keyboards}.

Référence des propriétés internes : 
@rinternals{Note_head_line_engraver},
@rinternals{VoiceFollower}.


@node Hampes et changements de portée
@unnumberedsubsubsec Hampes et changements de portée
@translationof Cross-staff stems

@cindex hampe, enjambement portées
@cindex distance entre deux portées de piano

@funindex Stem
@funindex cross-staff
@funindex length
@funindex flag-style

Pour écrire des accords qui enjambent deux portées, on allonge la hampe
de l'accord de l'une des deux portées de façon à ce qu'elle rejoigne celle de
l'autre portée.

@lilypond[verbatim,quote]
\new PianoStaff <<
  \new Staff {
    \relative c' {
      f8 e4 d8 d f e4
    }
  }
  \new Staff {
    \relative c' {
      << {
        \clef bass
        % stems may overlap the other staff
        \override Stem #'cross-staff = ##t
        % extend the stems to reach other other staff
        \override Stem #'length = #12
        % do not print extra flags
        \override Stem #'flag-style = #'no-flag
        % prevent beaming as needed
        a8 g4 f8 f bes\noBeam g4
      }
      \\
      {
        f,2 bes4 c
      } >>
    }
  }
>>
@end lilypond

@snippets
@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{indicating-cross-staff-chords-with-arpeggio-bracket.ly}


@seealso
Extraits de code :
@rlsr{Keyboards}.

Référence des propriétés internes :
@rinternals{Stem}.


@node Piano
@subsection Piano
@translationof Piano

Ce chapitre traîte des aspects de la notation directement liés au piano.  

@menu
* Pédales de piano::                
@end menu

@node Pédales de piano
@unnumberedsubsubsec Pédales de piano
@translationof Piano pedals

@cindex piano et pédales
@cindex pédales de piano
@cindex sustain, pédale
@cindex pédale sustain
@cindex sostenuto, pédale
@cindex pédale sostenuto
@cindex una corda
@cindex tre corde
@cindex sos.
@cindex U.C.

@funindex \sustainOn
@funindex sustainOn
@funindex \sustainOff
@funindex sustainOff
@funindex \sostenutoOn
@funindex sostenutoOn
@funindex \sostenutoOff
@funindex sostenutoOff
@funindex \unaCorda
@funindex unaCorda
@funindex \treCorde
@funindex treCorde


Le piano possède deux pédales, parfois trois, permettant de modifier
l'émission du son : une pédale de @notation{tenue} (@emph{sustain}),
une pédale de @notation{sourdine} (@emph{una corda} ou @emph{U.C.}) et
une pédale @notation{tonale} (@emph{sostenuto} ou @emph{sos.}).  La
pédale @emph{sustain} se rencontre aussi sur les vibraphones et
celestas.  

@lilypond[quote,verbatim,relative=2]
c4\sustainOn d e g
<c, f a>1\sustainOff
c4\sostenutoOn e g c,
<bes d f>1\sostenutoOff
c4\unaCorda d e g
<d fis a>1\treCorde
@end lilypond

@cindex pédale, styles d'indications de
@cindex pédale, indication textuelle de
@cindex pédale, indication graphique de
@cindex pédale, indication combinée de
@cindex pédale sustain, style
@cindex sustain, style de pédale

@funindex pedalSustainStyle
@funindex mixed
@funindex bracket
@funindex text

Trois styles sont à votre disposition pour imprimer les indications de
pédale : sous forme de texte, de crochet, ou une combinaison des deux.  
@code{text} est le style de notation par défaut pour les pédales de
tenue ou de sourdine --- le traditionnel @q{*Ped.}.  La pédale tonale,
en revanche, utilise @code{mixed} par défaut.

@lilypond[quote,verbatim,relative=2]
c4\sustainOn g c2\sustainOff
\set Staff.pedalSustainStyle = #'mixed
c4\sustainOn g c d
d\sustainOff\sustainOn g, c2\sustainOff
\set Staff.pedalSustainStyle = #'bracket
c4\sustainOn g c d
d\sustainOff\sustainOn g, c2
\bar "|."
@end lilypond

Le placement des commandes de pédale correspond au mouvement de la
pédale de tenue pendant le jeu.  Garder une pédale enclanchée jusqu'à la
barre finale s'obtient tout simplement en omettant la commande de
relacher. 


@seealso
Manuel de notation :
@ref{Liaisons de prolongation}.

Extraits de code :
@rlsr{Keyboards}.

Référence des propriétés internes :
@rinternals{SustainPedal},
@rinternals{SustainPedalLineSpanner},
@rinternals{SustainEvent},
@rinternals{SostenutoPedal},
@rinternals{SostenutoPedalLineSpanner},
@rinternals{SostenutoEvent},
@rinternals{UnaCordaPedal},
@rinternals{UnaCordaPedalLineSpanner},
@rinternals{UnaCordaEvent},
@rinternals{PianoPedalBracket},
@rinternals{Piano_pedal_engraver}.


@node Accordéon
@subsection Accordéon
@translationof Accordion

@menu
* Symboles de jeux::             
@end menu

@node Symboles de jeux
@unnumberedsubsubsec Symboles de jeux
@translationof Discant symbols

@cindex accordéon, symboles de registre
@cindex registres, symboles pour accordéon
@cindex accordéon, tirettes
@cindex tirettes d'accordéon, symboles

De nombreux accordéons possèdent plusieurs jeux d'anches capables de
jouer à l'unisson ou bien à l'octave inférieure ou supérieure par
rapport aux notes écrites.  Chaque facteur d'accordéon donne des noms
différents aux @notation{tirettes} (@emph{shifts}) qui permettent de
sélectionner les différents jeux d'anches tels que @notation{hautbois},
@notation{musette} ou @notation{bandonéon}, de telle sorte qu'un système
de symbole a fini par voir le jour afin de faciliter les instructions
pour exécuter un morceau.

@snippets

@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
{accordion-discant-symbols.ly}


@seealso
Morceaux choisis :
@rlsr{Keyboards}.


@node Harpe
@subsection Harpe
@translationof Harp

This section discusses notation issues that are unique to the harp.

@menu
* Généralités sur la harpe::
* Pédales de harpe::
@end menu

@node Généralités sur la harpe
@unnumberedsubsubsec Généralités sur la harpe
@translationof References for harps
@cindex harpes
@cindex bisbigliando

Certaines caractéritiques de la musique pour harpes sont abordées dans
d'autres chapitres, telles que :

@itemize

@item Les glissandos, l'une des techniques spécifique à la harpe,
@ref{Glissando}.

@item Le @notation{bisbigliando}, qui s'écrit comme un trémolo, 
@ref{Répétitions en trémolo}

@item Les harmoniques naturelles sont présentées dans @ref{Harmoniques}.

@item For directional arpeggios and non-arpeggios, see @ref{Arpèges}.

@end itemize

@seealso
Manuel de notation :
@ref{Répétitions en trémolo}
@ref{Glissando}
@ref{Arpèges}
@ref{Harmoniques}

@node Pédales de harpe
@unnumberedsubsubsec Pédales de harpe
@translationof Harp pedals

@cindex harpe, pédales
@cindex harpe, diagrammes de pédales
@cindex pédales de harpe
@cindex pédales, diagrammes pour harpe

Les harpes comportent sept cordes par octave qui peuvent sonner
naturel, dièse ou bémol.  Si chacune des cordes de la harpe celtique
(@emph{lever harp}) est accordée individuellement, celles d'une harpe à
pédalier ayant la même note de base sont contrôlées par une seule
pédale.  De gauche à droite, elles correspondent aux notes ré, do, si, 
et mi, fa, sol, la pour la grande harpe. Les trois premières pédales sont
réservées au pied gauche, les quatre dernières au pied droit.  Leur
position peut être indiquée par une marque textuelle : 

@lilypond[quote,verbatim,relative=2]
\textLengthOn
cis1_\markup \concat \vcenter { [D \flat C \sharp B|E \sharp F \sharp G A \flat] }
c!1_\markup \concat \vcenter {[ C \natural ]}
@end lilypond

ou bien sous forme de diagrammes :

@lilypond[quote,verbatim,relative=2]
\textLengthOn
cis1_\markup { \harp-pedal #"^v-|vv-^" }
c!1_\markup { \harp-pedal #"^o--|vv-^" }
@end lilypond
bémol si la pédale est relâchée (ou en haut), bécarre si elle est
bloquée sur le cran du milieu, et dièse si elle est tout à fait
enfoncée.  La commande @code{\harp-pedal} prend en argument une chaîne de
caractères, où @code{^} indique que la pédale est relâchée ou en haut (bémol),
@code{-} qu'elle est bloquée sur le cran du milieu (bécarre), @code{v}
qu'elle est tout à fait enfoncée (dièse) et @code{|} représente le
séparateur (entre gauche et droite de l'instrumentiste). Faire précéder
un symbole par un @code{o} permet de l'inscrire dans un cercle.

@seealso
Manuel de notation :
@ref{Commentaires textuels}
@ref{Instrument Specific Markup}

