Dist documentation text file too.

[lilypond.git] / Documentation / fr / user / guitar.itely

@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
@c This file is part of lilypond.tely
@ignore
    Translation of GIT committish: dab80970d8e89571263d16433aff1e6f878a8f62

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


@node Guitar
@section Guitar

@cindex tablature
@cindex tablature de guitare

@menu 
* Guitar TODO::
@end menu

@node Guitar TODO
@subsection Guitar TODO

@menu 
* String number indications::
* Tablatures basic::
* Non-guitar tablatures::
* Banjo tablatures::
* Fret diagrams::
* Right hand fingerings::
* Other guitar issues::
@end menu

@node String number indications
@unnumberedsubsubsec String number indications

@cindex cordes numérotées
@cindex numéro de corde

On peut ajouter aux accords les numéros de cordes, en les indiquant avec
@code{\}@var{number} :

@lilypond[relative,relative=1,ragged-right,fragment]
<c\1 e\2 g\3>
@end lilypond


@seealso

Référence du programme : @internalsref{StringNumber},
@lsr{guitar/,string-number.ly}.


@node Tablatures basic
@unnumberedsubsubsec Tablatures basic
@cindex tablatures de base

La notation en tablature est utilisée pour certains instruments à cordes
pincées.  Les hauteurs n'y sont pas indisuées par des têtes de note,
mais par des chiffres qui indiquent sur quelle corde, et à quelle case
chaque note doit être jouée.  Dans certaines limites, LilyPond vous
permet d'écrire des tablatures.

Chaque numéro de corde associé à une note doit être précédé d'une barre
oblique inverse (ou @qq{antislash}). Ainsi, @code{c4\3} donnera un do
noire à jouer sur la troisième corde.  Par défaut, la première corde est
la plus aigüe, et les cordes suivent l'accord traditionnel d'une guitare
à six cordes.  Les notes sont imprimées sous forme de tablature, dans
les contextes @internalsref{TabStaff} et @internalsref{TabVoice}.

@lilypond[quote,ragged-right,fragment,verbatim]
\new TabStaff {
  a,4\5 c'\2 a\3 e'\1
  e\4 c'\2 a\3 e'\1
}
@end lilypond

@funindex minimumFret
@cindex cases

Quand aucune corde n'est précisée, LilyPond choisit automatiquement la
corde où la position est la moins élevée et qui donne un numéro de case
supérieur à la valeur de la propriété @code{minimumFret}.  On peut
régler cette propriété, selon qu'on désire une position plus ou moins
haute.  La valeur par défaut de cette propriété est fixée à 0, ce qui
correspond à la position la plus basse.


@example
e16 fis gis a b4
\set TabStaff.minimumFret = #8
e16 fis gis a b4
@end example
@lilypond[quote,ragged-right]
frag = {
  \key e \major
  e16 fis gis a b4
  \set TabStaff.minimumFret = #8
  e16 fis gis a b4
}
  \new StaffGroup <<
    \new Staff { \clef "G_8" \frag }
    \new TabStaff { \frag }
  >>
@end lilypond


@commonprop

Pour obtenir des tablatures où les hampes seront dirigées vers le bas et 
les ligatures horizontales, réglez le contexte @code{TabStaff}
comme suit :

@example
\stemDown
\override Beam #'damping = #100000
@end example

@seealso

Référence du programme : @internalsref{TabStaff}, @internalsref{TabVoice}.

@refbugs

Les accords ne subsissent ausun traitement particulier ; de ce fait, la
sélection automatique des cordes peut attribuer une même corde pour deux
notes différentes de l'accord.

Afin que @code{\partcombine} fonctionne avec des tablatures, on doit
ajouter au contexte @code{TabStaff} des voix fantômes :

@lilypond[quote,ragged-right,verbatim]
melodia = \partcombine { e4 g g g }{ e4 e e e }
<<
  \new TabStaff <<
    \new TabVoice = "one" s1
    \new TabVoice = "two" s1
    \new TabVoice = "shared" s1
    \new TabVoice = "solo" s1
    { \melodia }
  >>
>>
@end lilypond


@node Non-guitar tablatures
@unnumberedsubsubsec Non-guitar tablatures
@cindex tablatures, autres

Vous pouvez bien sûr accorder vos cordes différemment.  Cet accord est
enregistré dans la propriété @code{stringTunings}.  La valeur de cette
propriété doit être indiquée sous forme d'une liste en langage Scheme,
où chaque corde est représentée par un nombre entier qui indique sa
hauteur à vide, comptée en demi-tons à partir du do central.  Cette
propriété permet aussi à LilyPond de déterminer le nombre de cordes.

Dans l'exemple suivant, on a réglé @code{stringTunings} pour l'accord de
la guitare basse, c'est-à-dire mi la ré sol.

@lilypond[quote,ragged-right,fragment,verbatim]
\new TabStaff <<
  \set TabStaff.stringTunings = #'(-5 -10 -15 -20)
  {
    a,4 c' a e' e c' a e'
  }
>>
@end lilypond

Toutefois, LilyPond possède des jeux de cordes prédéfinis pour le banjo,
la mandoline, la guitare et la guitare basse ; ainsi, l'accord précédent
peut également s'indiquer par

@example
\set TabStaff.stringTunings = #bass-tuning
@end example

Le jeu par défaut est celui de la guitare : @code{guitar-tuning},
c'est-à-dire le célèbre mi la ré sol si mi. D'autres jeux prédéfinis
sont @code{guitar-open-g-tuning}, @code{mandolin-tuning} et
@code{banjo-open-g-tuning}.

@seealso

Vous trouverez une liste complète des jeux prédéfinis dans le fichier
@file{scm/@/output@/-lib@/.scm}.

Référence du programme : @internalsref{Tab_note_heads_engraver}.

@refbugs

Aucun effet spécial de guitare n'a été implémenté à ce jour.



@node Banjo tablatures
@unnumberedsubsubsec Banjo tablatures
@cindex Tablatures de banjo

LilyPond permet d'écrire des tablatures de base pour le banjo à cinq
cordes.  Pour ce faire, pensez à utiliser le format de tablature pour
banjo, afin d'avoir le bon nombre de cordes et le bon accord :

@lilypond[quote,ragged-right,fragment,verbatim]
\new TabStaff <<
  \set TabStaff.tablatureFormat = #fret-number-tablature-format-banjo
  \set TabStaff.stringTunings = #banjo-open-g-tuning
  {
    \stemDown
    g8 d' g'\5 a b g e d' |
    g4 d''8\5 b' a'\2 g'\5 e'\2 d' |
    g4
  }
>>
@end lilypond

LilyPond connaît un certain nombre de manières d'accorder un banjo :
@code{banjo-c-tuning} (sol do sol si ré),
@code{banjo-modal-tuning} (sol ré sol do ré),
@code{banjo-open-d-tuning} (la ré fa-dièse la ré)
et @code{banjo-open-dm-tuning} (la ré fa la ré).

Tous ces accords peuvent être convertis en accords pour banjo à quatre
cordes, si l'on utilise la fonction @code{four-string-banjo} :

@example
\set TabStaff.stringTunings = #(four-string-banjo banjo-c-tuning)
@end example

@seealso

Vous trouverez une liste complète des jeux de cordes prédéfinis pour le banjo
dans le fichier @file{scm/@/output@/-lib@/.scm}.


@node Fret diagrams
@unnumberedsubsubsec Fret diagrams
@cindex schémas d'accords
@cindex schémas de barrés

On peut ajouter des diagrammes d'accords au-dessus de n'importe quelle
note, en tant qu'objets @code{\markup}. Ces objets donnent toutes
les informations sur le doigté et les éventuels barrés :

@lilypond[verbatim, ragged-right, quote]
\new Voice {
  d'^\markup \fret-diagram #"6-x;5-x;4-o;3-2;2-3;1-2;"
  d' d' d'
  fis'^\markup \override #'(size . 0.75) {
    \override #'(finger-code . below-string) {
      \fret-diagram-verbose #'((place-fret 6 2 1) (barre 6 1 2)
                               (place-fret 5 4 3) (place-fret 4 4 4)
                               (place-fret 3 3 2) (place-fret 2 2 1)
                               (place-fret 1 2 1))
    }
  }
  fis' fis' fis'
  c'^\markup \override #'(dot-radius . 0.35) {
    \override #'(finger-code . in-dot) {
      \override #'(dot-color . white) {
        \fret-diagram-terse #"x;3-1-(;5-2;5-3;5-4;3-1-);"
      }
    }
  }
  c' c' c'
}
@end lilypond


Vous pouvez indiquer vos diagrammes de trois manières différentes :
@qq{standard}, @qq{terse} ou @qq{verbeux}. Ces trois interfaces
produisent des schémas similaires, mais demandent d'entrer plus ou moins
d'informations.  Vous trouverez tout les détails dans
@ref{Overview of text markup commands}.

Par ailleurs, plusieurs propriétés permettent d'ajuster le graphisme
à votre convenance. Vous en trouverez les détails dans
@internalsref{fret-diagram-interface}. 


@seealso

Exemples : @lsrdir{guitar}


@node Right hand fingerings
@unnumberedsubsubsec Right hand fingerings

Les doigtés de la main droite, dans les accords, peuvent être ajoutés au moyen
de @code{@var{note}-\rightHandFinger @var{doigté}}

@lilypond[verbatim,fragment,relative=2]
  <c-\rightHandFinger #1 e-\rightHandFinger #2 >
@end lilypond

Pour plus de clarté, vous pouvez traduire ou abréger la commande 
@code{\rightHandFinger}, par exemple en @code{\doigtMainDroite} ou
même @code{\MD} :

@example
#(define MD rightHandFinger)
@end example

@cindex doigtés, main droite, guitare
@cindex mains droite, doigtés guitare
 
@commonprop

Pour contrôler plus précisément les doigtés de main droite, réglez la
propriété @code{strokeFingerOrientations} :

@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
#(define RH rightHandFinger)
{
  \set strokeFingerOrientations = #'(up down)
  <c-\RH #1 es-\RH #2 g-\RH #4 > 4
  \set strokeFingerOrientations = #'(up right down)
  <c-\RH #1 es-\RH #2 g-\RH #4 > 4
}
@end lilypond

Les lettres utilisées dans ces doigtés sont définies par la propriété
@code{digit-names}, mais on peut bien sûr les changer en utilisant une
chaîne de caractères comme argument de @code{\rightHandFinger}.

@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
#(define RH rightHandFinger)
{
  \set strokeFingerOrientations = #'(right)
  \override StrokeFinger #'digit-names = ##("x" "y" "z" "!" "@") 
  <c-\RH #5 >4
  <c-\RH "@">4  
}
@end lilypond

@seealso

Référence du programme : @internalsref{StrokeFinger}



@node Other guitar issues
@unnumberedsubsubsec Other guitar issues


Voici comment insérer des indications de position.

@lilypond[quote,ragged-right,fragment,verbatim,relative=0]
\clef "G_8"
b16 d16 g16 b16 e16
\textSpannerDown
\override TextSpanner #'bound-details #'left #'text = #"XII "
  g16\startTextSpan
  b16 e16 g16 e16 b16 g16\stopTextSpan
e16 b16 g16 d16
@end lilypond


Lorsque des notes doivent être jouées détimbrées --- le doigt effleurant
la corde sans la presser, en un effet presque percussif, mais où la
hauteur est encore perceptible ---, on peut employer des têtes de notes
spéciales en forme de croix.
Vous trouverez plus de détails dans @ref{Special noteheads}.