@c \version "2.14.0"
-@c Translators: Valentin Villenave
+@c Translators: Valentin Villenave,Jean-Charles Malahieude
@c Translation checkers: Jean-Charles Malahieude, John Mandereau
@node Notation des accords
@section Notation des accords
@translationof Chord notation
-@untranslated
+@lilypondfile[quote]{chords-headword.ly}
+
+Les accords se saisissent soit comme des notes normales, soit à l'aide
+d'un mode dédié, et seront rendus selon l'une des diverses nomenclatures
+occidentales. Les accords peuvent aussi se présenter sous forme
+nominale, ou bien en basse figurée.
@menu
* Mode accords::
* Basse chiffrée::
@end menu
+
@node Mode accords
@subsection Mode accords
@translationof Chord mode
-@untranslated
+@cindex chordmode
+@cindex accords, mode
+
+Le mode accords permet de saisir des accords en indiquant leur structure
+plutôt que les notes qui les composent.
@menu
* Généralités sur le mode accords::
* Accords courants::
-* Extensions et altération d'accords::
+* Extension et altération d'accords::
@end menu
-@c This material comes from 'Entering chord names' -FV
+
@node Généralités sur le mode accords
@unnumberedsubsubsec Généralités sur le mode accords
@translationof Chord mode overview
-@cindex accords, chiffrage jazz
+@cindex accords, noms
+@cindex accords, chiffrage
-LilyPond permet de désigner les accords par leur chiffrage jazz.
-S'il est possible d'entrer un accord sous sa forme musicale, avec
-@code{<@dots{}>}, on peut aussi le saisir par son nom. Le logiciel
-traite les accords comme des ensembles de hauteurs, donc les accords
-peuvent être transposés.
+Un accord peut se saisir en tant que musique simultanée, comme nous
+l'avons vu à la rubrique @ref{Notes en accords}.
-@lilypond[quote,ragged-right,verbatim]
-twoWays = \transpose c c' {
- \chordmode {
- c1 f:sus4 bes/f
- }
- <c e g>
- <f bes c'>
- <f bes d'>
-}
+LilyPond dispose aussi d'un @qq{mode accords} au sein duquel sera
+considérée la structure des accords, tels qu'ils se présentent dans les
+traditions occidentales, plutôt que les différentes hauteurs qui les
+composent. Ce mode est tout à fait adapté pour ceux qui sont plus
+habitués aux accords nommés. Pour plus d'information quant aux
+différentes façons de libeller votre code, voir @ref{Modes de saisie}.
+
+@lilypond[verbatim,quote,ragged-right]
+\chordmode { c1 g a g c }
+@end lilypond
+
+Tout accord saisi dans ce mode dédié constitue un élément musical à
+part entière@tie{}; il pourra donc par exemple être transposé comme
+n'importe quel ensemble de hauteurs simultanées. @code{\chordmode}
+travaille en absolu@tie{}; une instruction @code{\relative} restera sans
+effet au sein d'un bloc @code{chordmode}. Notez toutefois que les
+hauteurs absolues sont une octave plus haut en @code{\chordmode} qu'en
+mode notes traditionnel.
+
+Mode notes et mode accords peuvent tout à fait cohabiter dans une
+séquence musicale@tie{}:
+
+@lilypond[verbatim,quote,ragged-right,relative=1]
+<c e g>2 <g b d>
+\chordmode { c2 f }
+<c e g>2 <g' b d>
+\chordmode { f2 g }
+@end lilypond
+
+
+@seealso
+Glossaire musicologique :
+@rglosnamed{chord,Accord}.
+
+Manuel de notation :
+@ref{Notes en accords},
+@ref{Modes de saisie}.
+
+Morceaux choisis :
+@rlsrnamed{Chords,Accords}.
+
+
+@knownissues
+
+Les racourcis d'articulation ou d'ornementation ne sont pas disponibles
+en mode accord -- voir @ref{Articulations et ornements}.
+
+Lorsque vous mélangez mode accords et mode notes dans une séquence
+musicale qui démarre par le mode accords, le mode notes créera un
+nouveau contexte @code{Staff}@tie{}:
-<< \new ChordNames \twoWays
- \new Voice \twoWays >>
+@lilypond[verbatim,quote,ragged-right,relative=1]
+\chordmode { c2 f }
+<c e g>2 <g' b d>
@end lilypond
-Cet exemple montre également que les jeux d'instructions qui permettent
-à LilyPond d'imprimer des accords ne cherchent pas à se montrer
-intelligents. Ici, le dernier accord n'est pas interprété comme étant
-renversé.
+@noindent
+La solution consiste à créer explicitement le contexte @code{Staff} dès
+le départ@tie{}:
-Notez bien que la valeur rythmique des accords doit être indiquée
-@emph{à l'extérieur} des symboles @code{<>}.
+@lilypond[verbatim,quote,ragged-right,relative=1]
+\new Staff {
+ \chordmode { c2 f }
+ <c e g>2 <g' b d>
+}
+@end lilypond
-@example
-<c e g>2
-@end example
-@c This material comes from 'Chords mode' -FV
@node Accords courants
@unnumberedsubsubsec Accords courants
@translationof Common chords
+@cindex triton
+@cindex septième
+@cindex fondamentale
+@cindex accords, modificateur
+@cindex qualité d'accord
+
Dans le mode accords, introduit par la commande @code{\chordmode}, les
-accords ne sont indiqués que par leur note fondamentale.
+accords ne sont indiqués que par leur note fondamentale, à laquelle on
+peut adjoindre une durée.
+
+@lilypond[verbatim,quote,ragged-right]
+\chordmode { c2 f4 g }
+@end lilypond
+
+On peut cependant obtenir des accords différents -- mineur, augmenté ou
+diminué -- en utilisant le caractère deux points (@code{:}).
+
+@lilypond[verbatim,quote,ragged-right]
+\chordmode { c2:m f4:aug g:dim }
+@end lilypond
+
+Les accords de septième sont aisément stipulables@tie{}:
@lilypond[quote,ragged-right,verbatim]
-\chordmode { es4. d8 c2 }
+\chordmode { c1:7 c:m7 c:maj7 c:dim7 c:aug7 }
@end lilypond
-@cindex saisir des accords
-@cindex mode accords
+@funindex aug
+@funindex dim
+@funindex maj
+@funindex m
-On peut cependant obtenir des accords différents, en utilisant le
-caractère deux points (@code{:}).
+Voici les différents modificateurs d'accord de trois sons ou de
+septième. Par défaut, la septième ajoutée sera mineure@tie{}; la
+septième de dominante est donc l'accord de septième de base. Toutes les
+altérations sont relatives à la septième de dominante. Une table
+étendue des modificateurs et de leur utilisation est à l'annexe
+@ref{Modificateurs d'accord usuels}.
+
+@c @table @code
+@multitable @columnfractions .2 .4 .3
+
+@item
+@b{Modificateur}
+@tab
+@b{Action}
+@tab
+@b{Exemple}
+
+@item
+Néant
+@tab
+Action par défaut@tie{}; produit une triade majeure.
+@tab
+@lilypond[line-width=4\cm, noragged-right]
+\chordmode {
+ \override Staff.TimeSignature #'stencil = ##f
+ c1
+}
+@end lilypond
-@lilypond[quote,verbatim]
-\chordmode { e1:m e1:7 e1:m7 }
+@item
+m, m7
+@tab
+Accord mineur. Ce modificateur abaisse la tierce, et la septième s'il y
+en a une.
+@tab
+@lilypond[line-width=4\cm, noragged-right]
+\chordmode {
+ \override Staff.TimeSignature #'stencil = ##f
+ c1:m c:m7
+}
@end lilypond
-Le nombre accolé à la note fondamentale est considéré comme chiffrage
-jazz de l'accord, qui est de ce fait construit par un empilement de
-tierces. Notez l'exception que constitue @code{c:13} dans lequel la
-onzième est délibérément omise.
+@item
+dim, dim7
+@tab
+Accord diminué. Ce modificateur minorise la tierce, diminue la quinte et
+la septième s'il y en a.
+@tab
+@lilypond[line-width=4\cm, noragged-right]
+\chordmode {
+ \override Staff.TimeSignature #'stencil = ##f
+ c1:dim c:dim7
+}
+@end lilypond
-@lilypond[quote,verbatim]
-\chordmode { c:3 c:5 c:6 c:7 c:8 c:9 c:10 c:11 c:13 }
+@item
+aug
+@tab
+Accord augmenté. Ce modificateur augmente la quinte.
+@tab
+@lilypond[line-width=4\cm, noragged-right]
+\chordmode {
+ \override Staff.TimeSignature #'stencil = ##f
+ c1:aug
+}
@end lilypond
-@cindex note fondamentale
-@cindex notes ajoutées
-@cindex accords incomplets
+@item
+maj, maj7
+@tab
+Accord de septième majeure. Ce modificateur majorise la septième. Le
+@code{7} à la suite du est @code{maj} facultatif. Ce modificateur ne
+sert pas à créer une triade majeure.
+@tab
+@lilypond[line-width=4\cm, noragged-right]
+\chordmode {
+ \override Staff.TimeSignature #'stencil = ##f
+ c1:maj c:maj7
+}
+@end lilypond
-Des accords encore plus complexes peuvent être élaborés en plusieurs
-étapes séparées. Ainsi, on peut enrichir l'accord par des notes
-ajoutées, que l'on indique après le chiffrage principal et que l'on
-sépare par des points@tie{}:
+@end multitable
-@lilypond[quote,verbatim]
-\chordmode { c:5.6 c:3.7.8 c:3.6.13 }
+
+@seealso
+Manuel de notation :
+@ref{Extension et altération d'accords},
+@ref{Modificateurs d'accord usuels}.
+
+Morceaux choisis :
+@rlsrnamed{Chords,Accords}.
+
+
+@knownissues
+Un accord ne devrait comporter qu'un seul modificateur de qualité. La
+présence de plusieurs modificateurs ne déclenchera ni avertissement, ni
+erreur, mais le résultat pourrait être surprenant. Un accord qui n'est
+pas constructible à l'aide d'un unique modificateur devra faire l'objet
+d'une altération de ses composantes, comme indiqué à la rubrique
+@ref{Extension et altération d'accords}.
+
+
+@node Extension et altération d'accords
+@unnumberedsubsubsec Extension et altération d'accords
+@translationof Extended and altered chords
+
+Le mode accords permet d'élaborer des accords complexes. Ainsi, on peut
+enrichir l'accord par des notes ajoutées, enlever certaines notes,
+augmenter ou diminuer certains intervalles, ajouter la note de basse ou
+créer un renversement.
+
+Le premier nombre qui suit le caractère deux-points (@code{:}) permet de
+déterminer l'étendue d'un accord. L'accord sera construit par ajout à
+la fondamentale, d'autant de tierces consécutives que nécessaire pour
+atteindre le nombre spécifié. N'oubliez pas que la septième ajoutée à
+un accord est minorée par défaut. Lorsque le dernier degré ne
+correspond pas à une tierce -- la sixte par exemple -- les tierces
+seront empilées jusqu'à celle directement inférieure au degré mentionné,
+qui sera alors ajouté pour conclure l'accord. L'étendue maximale
+autorisée est la treizième@tie{}; toute étendue plus élevée sera
+interprétée comme un accord de treizième.
+
+@lilypond[quote,ragged-right,verbatim]
+\chordmode {
+ c1:2 c:3 c:4 c:5
+ c1:6 c:7 c:8 c:9
+ c1:10 c:11 c:12 c:13
+ c1:14
+}
@end lilypond
-On peut augmenter ou diminuer certains intervalles au moyen des
-signes @code{-} ou @code{+}@tie{}:
+@noindent
+Notez bien que @code{c:5} et @code{c} produisent tous deux une triade de
+do majeur.
+
+Dans la mesure où un accord de treizième majeure ne sonne pas très bien
+avec la onzième, la onzième est automatiquement enlevée, sauf à l'avoir
+explicitement spécifiée.
+
+@lilypond[quote,ragged-right,verbatim]
+\chordmode {
+ c1:13 c:13.11 c:m13
+}
+@end lilypond
+
+@cindex additions à un accord
+@cindex accord, additions
+
+On peut enrichir l'accord par des notes ajoutées, que l'on indique après
+le chiffrage principal et que l'on sépare par des points, sans oublier
+que si l'on y ajoute une septième, celle-ci sera minorée et non majeure.
@lilypond[quote,verbatim]
-\chordmode { c:7+ c:5+.3- c:3-.5-.7- }
+\chordmode {
+ c1:5.6 c:3.7.8 c:3.6.13
+}
@end lilypond
-On peut aussi enlever certaines notes de l'accord, en les spécifiant
-après un signe @code{^} -- les notes ajoutées doivent être indiquées
-@emph{avant} les notes à enlever.
+Les notes ajoutées peuvent monter aussi haut que de besoin.
@lilypond[quote,verbatim]
-\chordmode { c^3 c:7^5 c:9^3.5 }
+\chordmode {
+ c4:5.15 c:5.20 c:5.25 c:5.30
+}
@end lilypond
-Voici les différents chiffrages disponibles, en plus des nombres que
-nous venons de voir@tie{}:
+@cindex accord, altération d'un degré
-@table @code
-@item m
-Accord mineur. Ce chiffrage minorise la tierce, et la septième s'il y
-en a une.
+On peut augmenter ou diminuer certains intervalles au moyen des
+signes @code{-} ou @code{+} au degré considéré. L'altération de l'un
+des degrés automatiquement inclus dans la structure de base d'un accord
+s'effectue de la même manière.
-@item dim
-Accord diminué. Ce chiffrage minorise la tierce, diminue la quinte et
-la septième s'il y en a.
+@lilypond[quote,verbatim]
+\chordmode {
+ c1:7+ c:5+.3- c:3-.5-.7-
+}
+@end lilypond
-@item aug
-Accord augmenté. Ce chiffrage augmente la quinte.
+@cindex accord, suppression d'un degré
-@item maj
-Accord de septième majeure. Ce chiffrage majorise la septième s'il y
-en a une (dans le cas d'un accord parfait, ce chiffrage est facultatif).
+@funindex ^
-@item sus
-Accord de suspension. Ce chiffrage supprime la tierce, et y ajoute,
-suivant que vous spécifiez @code{2} ou @code{4}, la seconde ou la
-quarte.
-@end table
+Après avoir ajouté des notes à un accord, on peut aussi en enlever
+certaines, en les spécifiant derrière un signe @code{^} -- les séparer
+par un point lorsqu'il y en a plus d'une.
-Il est bien sûr possible de mélanger ces chiffrages avec des notes
-ajoutées.
@lilypond[quote,verbatim]
- \chordmode { c:sus4 c:7sus4 c:dim7 c:m6 }
+\chordmode {
+ c1^3 c:7^5 c:9^3 c:9^3.5 c:13.11^3.7
+}
@end lilypond
-@cindex chiffrages des accords
-@funindex aug
-@funindex dim
-@funindex maj
@funindex sus
-@funindex m
-Dans la mesure où un accord de treizième majeure ne sonne pas très bien
-avec la onzième, la onzième est enlevée automatiquement, à moins que
-vous ne le spécifiez explicitement.
+L'ajout du modificateur @code{sus} permet de créer un accord de
+suspension. Ceci aura pour effet de supprimer la tierce et y ajouter,
+suivant que vous spécifiez @code{2} ou @code{4}, la seconde ou la
+quarte. @code{sus} est équivalent à @code{^3}@tie{}; @code{sus4} est
+équivalent à @code{.4^3}.
@lilypond[quote,ragged-right,verbatim]
-\chordmode { c:13 c:13.11 c:m13 }
+\chordmode {
+ c1:sus c:sus2 c:sus4 c:5.4^3
+}
@end lilypond
@funindex /
+@cindex accord, inversion
+@cindex accord, spécifier la basse
+@cindex basse d'un accord
Les accords peuvent être renversés ou combinés avec une note étrangère à
-la basse, au moyen de @code{@var{accord}/}@var{note}
+la basse, au moyen de @code{@var{accord}/}@var{hauteur}.
+
@lilypond[quote,ragged-right,verbatim]
-\chordmode { c1 c/g c/f }
+\chordmode {
+ c1 c/g c/f
+}
@end lilypond
+
@funindex /+
Si la note de basse précisée appartient à l'accord, la doublure
supérieure sera supprimée. Pour l'éviter, utilisez la syntaxe
-@code{/+}@var{note}.
+@code{/+}@var{hauteur}.
@lilypond[quote,ragged-right,verbatim]
-\chordmode { c1 c/+g c/+f }
+\chordmode {
+ c1 c/g c/+g
+}
@end lilypond
-Le mode accords est semblable à @code{\lyricmode} ou autre, c'est-à-dire
-que la plupart des commandes sont encore disponibles@tie{}; ainsi,
-@code{r} ou @code{\skip} peuvent servir à insérer des silences ou des
-silences invisibles. De plus, les propriétés des objets peuvent être
-ajustées ou modifiées.
+Une table étendue des modificateurs et de leur utilisation est à
+l'annexe @ref{Modificateurs d'accord usuels}.
+
+
+@seealso
+Manuel de notation :
+@ref{Modificateurs d'accord usuels}.
+
+Morceaux choisis :
+@rlsrnamed{Chords,Accords}.
+
@knownissues
Aucun nom de note ne peut être indiqué deux fois dans un accord. Ainsi,
dans l'accord suivant, seule la quinte augmentée est prise en compte,
-car elle est indiquée en dernier@tie{}:
+parce qu'elle est indiquée en dernier@tie{}:
-@cindex agrégats
@lilypond[quote,ragged-right,verbatim]
-\chordmode { c:5.5-.5+ }
+\chordmode { c1:5.5-.5+ }
@end lilypond
-@node Extensions et altération d'accords
-@unnumberedsubsubsec Extensions et altération d'accords
-@translationof Extended and altered chords
+Seul le deuxième renversement peut être obtenu par adjonction de la
+basse. Le premier renversement requiert de changer la fondamentale de
+l'accord.
+
+@lilypond[quote,ragged-right,verbatim]
+\chordmode {
+ c'1: c':/g e:6-3-^5 e:m6-^5
+}
+@end lilypond
-@untranslated
@node Gravure des accords
@subsection Gravure des accords
@translationof Displaying chords
-@untranslated
+Les accords peuvent se présenter aussi bien sous forme nominative que
+ceomme un empliement de notes sur une portée.
@menu
* Impression des noms d'accord::
@cindex chiffrages d'accords
@cindex accords
-Les chiffrages d'accords sont liés au contexte
-@rinternals{ChordNames}. Les accords peuvent être saisis soit au
-moyen de la notation indiquée ci-dessus, soit directement avec les
-symboles @code{<} et @code{>}.
+Les chiffrages d'accords sont liés au contexte @code{ChordNames}@tie{}:
-@lilypond[quote,verbatim,ragged-right]
-harmonies = {
- \chordmode {a1 b c} <d' f' a'> <e' g' b'>
+@lilypond[verbatim,quote,ragged-right]
+\new ChordNames {
+ \chordmode {
+ c2 f4. g8
+ }
}
+@end lilypond
+
+Les accords peuvent être saisis soit en tant que hauteurs simultanées,
+soit au moyen du mode accords. Le chiffrage affiché sera identique quel
+que soit le mode de saisie, à moins qu'il n'y ait inversion ou ajout de
+la basse.
+
+@lilypond[verbatim,quote,relative=1]
<<
- \new ChordNames \harmonies
- \new Staff \harmonies
+ \new ChordNames {
+ <c e g>2 <f bes c>
+ <f c' e g>1
+ \chordmode {
+ c2 f:sus4 c1:/f
+ }
+ }
+ {
+ <c e g>2 <f bes c>
+ <f, c' e g>1
+ \chordmode {
+ c2 f:sus4 c1:/f
+ }
+ }
>>
@end lilypond
-Vous pouvez faire ressortir les chiffrages d'accords en assignant la
-valeur vrai à la propriété @code{chordChanges} dans le contexte
-@rinternals{ChordNames}. De cette façon, les chiffrages ne sont
-imprimés qu'aux changements d'accord ou en début de ligne.
+@cindex no chord, symbole
+@cindex N.C., symbole
+@cindex accords, No Chord
-@lilypond[quote,verbatim,ragged-right]
-harmonies = \chordmode {
- c1:m c:m \break c:m c:m d
-}
+L'apparition de silences dans un contexte @code{ChordNames} déclenchera
+l'impression d'un @emph{markup} @code{noChordSymbol}.
+
+@lilypond[verbatim, quote, relative=1]
<<
- \new ChordNames {
- \set chordChanges = ##t
- \harmonies }
- \new Staff \transpose c c' \harmonies
+ \new ChordNames \chordmode {
+ c1
+ r1
+ g1
+ c1
+ }
+ \chordmode {
+ c1
+ r1
+ g1
+ c1
+ }
>>
@end lilypond
-Les exemples précédents montrent des chiffrages placés au-dessus de la
-portée, mais ce n'est pas obligatoire@tie{}: les accords peuvent également
-être imprimés séparément -- auquel cas vous aurez peut-être besoin
-d'ajouter le @rinternals{Volta_engraver} et le
-@rinternals{Bar_engraver} afin que les éventuelles barres de reprises
-s'affichent correctement.
+@funindex \chords
-@lilypond[ragged-right,verbatim]
-\new ChordNames \with {
- \override BarLine #'bar-extent = #'(-2 . 2)
- \consists Bar_engraver
- \consists "Volta_engraver"
-}
-\chordmode { \repeat volta 2 {
- f1:maj7 f:7 bes:7
- c:maj7
-} \alternative {
- es e
+@code{\chords @{ ... @}} est un racourci de
+@code{\new ChordNames @{ \chordmode @{ ... @} @}}.
+
+@lilypond[verbatim,quote,ragged-right]
+\chords {
+ c2 f4.:m g8:maj7
}
+@end lilypond
+
+@lilypond[verbatim,quote,ragged-right]
+\new ChordNames {
+ \chordmode {
+ c2 f4.:m g8:maj7
+ }
}
@end lilypond
-Le modèle par défaut des chiffrages d'accord est celui de Klaus Ignatzek
-pour le jazz (cf. @ressay{Références bibliographiques}). Il s'agit
-d'une notation anglo-saxonne@tie{}; cependant vous pouvez indiquer vos
-chiffrages en notation française au moyen de la commande
-@code{\frenchChords} (voir plus bas).
+@snippets
-Il est possible de créer votre propre modèle de chiffrages en
-réglant les propriétés suivantes@tie{}:
+@c Keep index entries with following snippet
+@cindex accords, suppression des répétitions
+@funindex chordChanges
-@table @code
-@funindex chordNameExceptions
-@item chordNameExceptions
-C'est la liste des accords mis en forme de manière particulière.
-
-Cette liste d'exceptions s'indique de la façon suivante.
-On commence par créer une expression musicale telle que
-@example
-@code{chExceptionMusic} = @{ <c f g bes>1 \markup @{ \super "7" "wahh" @} @}
-@end example
-puis on la transforme en liste d'exceptions au moyen du code
-@example
-(sequential-music-to-chord-exceptions chExceptionMusic #t)
-@end example
-Pour qu'elles soient effectives, on ajoute ces exceptions aux exceptions
-par défaut définies dans @file{ly/chord-modifier-init.ly}@tie{}:
-@example
-(append
- (sequential-music-to-chord-exceptions chExceptionMusic #t)
- ignatzekExceptions)
-@end example
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
+{showing-chords-at-changes.ly}
+
+@c @lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
+@c {adding-bar-lines-to-chordnames-context.ly}
-@cindex exceptions, chiffrage d'accords
-@cindex chiffrage d'accords, exceptions
-@cindex accords chiffrés, exceptions
@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
-{chord-name-exceptions.ly}
+{simple-lead-sheet.ly}
-@funindex majorSevenSymbol
-@item majorSevenSymbol
-Cette propriété définit l'objet employé pour indiquer une septième
-majeure. Les options prédéfinies sont @code{whiteTriangleMarkup}
-(triangle blanc) et @code{blackTriangleMarkup} (triangle noir).
-@funindex chordNameSeparator
-@item chordNameSeparator
-Les différents termes d'un chiffrage jazz (par exemple les notes de
-l'accord et la basse) sont habituellement séparés par une barre oblique.
-La propriété @code{chordNameSeparator} permet d'indiquer un autre
-séparateur, par exemple
-@lilypond[quote,ragged-right,verbatim]
-\new ChordNames \chordmode {
- c:7sus4
- \set chordNameSeparator
- = \markup { \typewriter "|" }
- c:7sus4
+@seealso
+Glossaire musicologique :
+@rglosnamed{chord,Accord}.
+
+Manuel de notation :
+@ref{Saisie de musique en parallèle}.
+
+Morceaux choisis :
+@rlsrnamed{Chords,Accords}.
+
+Référence des propriétés internes :
+@rinternals{ChordNames},
+@rinternals{ChordName},
+@rinternals{Chord_name_engraver},
+@rinternals{Volta_engraver},
+@rinternals{Bar_engraver}.
+
+
+@knownissues
+Un accord contenant un renversement ou dont la basse est changée ne sera
+pas chiffré correctement s'il est saisi en tant que musique simultanée.
+
+
+@node Personnalisation des noms d'accord
+@unnumberedsubsubsec Personnalisation des noms d'accord
+@translationof Customizing chord names
+
+@cindex accord, personnalisation du chiffrage
+@cindex chiffrage d'accords, personnalisation
+
+Il existe plus d'un système de chiffrage d'accords. Le nom des accords
+varie selon les traditions musicales, et plusieurs symboles représentent
+un même accord. LilyPond vous permet de créer votre propre nomenclature
+d'accords, tant au niveau des noms que des symboles qui les
+représenteront.
+
+@cindex jazz, accords
+@cindex accords jazz
+
+Le modèle par défaut des chiffrages d'accord est celui de Klaus Ignatzek
+pour le jazz (cf. @ressay{Références bibliographiques}).Il est possible
+de créer votre propre modèle de chiffrages à l'aide des différentes
+propriétés mentionnées ci-dessous. LilyPond dispose d'un système
+alternatif de chiffrage jazz qui a été élaboré grâce à ces même
+propriétés. Les deux notations, Ignatzek et alternative, sont illustrés
+à l'annexe @ref{Table des noms d'accord}.
+
+
+@c TODO -- Change this so we don't have a non-verbatim example.
+@c Make short example in docs, then move longer example to
+@c appendix, where the length of the snippet won't matter.
+
+En plus des différents systèmes de nommage, le nom de la fondamentale
+varie selon la langue utilisée. Les instructions @code{\germanChords},
+@code{\semiGermanChords}, @code{\italianChords} et @code{\frenchChords}
+permettent de définir la langue, comme vous pouvez le constater@tie{}:
+
+@lilypondfile[ragged-right]
+{chord-names-languages.ly}
+
+
+@funindex chordNameLowercaseMinor
+Nombre de carnets de chant allemands indiquent un accord mineur par
+l'emploi de caractères en minuscule, sans le suffixe @code{m}. Cette
+fonctionnalité est gérée par la propriété
+@code{chordNameLowercaseMinor}@tie{}:
+
+@lilypond[verbatim,quote,ragged-right]
+\chords {
+ \set chordNameLowercaseMinor = ##t
+ c2 d:m e:m f
}
@end lilypond
+Lorsqu'aucun des systèmes prédéfinis ne vous permet de représenter
+l'accord voulu, les propriétés suivantes vous permettront de le
+construire.
+
+@table @code
+
@funindex chordRootNamer
+
@item chordRootNamer
Dans les chiffrages d'accord jazz, la note fondamentale de chaque accord
est exprimée par une lettre capitale, parfois suivie d'une altération,
correspondant à la notation anglo-saxonne de la musique. Cette
propriété a pour valeur la fonction qui transforme la hauteur de la note
-foncdamentale en nom de note@tie{}; c'est donc en assignant une nouvelle
+fondamentale en nom de note@tie{}; c'est donc en assignant une nouvelle
fonction à cette propriété que l'on peut produire des noms de note
spéciaux, adaptés par exemple aux systèmes de notation d'autres pays.
+@funindex majorSevenSymbol
+
+@item majorSevenSymbol
+Cette propriété définit l'objet ajouté au @code{chordRootNamer} pour
+indiquer une septième majeure. Les options prédéfinies sont
+@code{whiteTriangleMarkup} (triangle blanc) et
+@code{blackTriangleMarkup} (triangle noir).
+
+@funindex additionalPitchPrefix
+
+@item additionalPitchPrefix
+Lorsqu'un chiffrage contient des notes ajoutées, vous pouvez le préfixer
+d'une annotation. LilyPond n'en ajoute pas par défaut, dans le but de
+ne pas trop surcharger la partition@tie{}; vous pouvez cependant les
+faire apparaître si elles sont visuellement efficaces.
+
+@lilypond[verbatim,quote,ragged-right]
+\new ChordNames {
+ <c e g d'> % add9
+ \set additionalPitchPrefix = #"add"
+ <c e g d'> % add9
+}
+@end lilypond
+
@funindex chordNoteNamer
+
@item chordNoteNamer
Lorsqu'un chiffrage mentionne une note ajoutée (par exemple la basse),
les règles utilisées sont par défaut celles définies par la propriété
-@code{chordRootNamer} ci-dessus. Cependant, la propriété @code{chordNoteNamer}
-permet de régler cet élément indépendamment, par exemple pour imprimer la basse
-en caractères minuscules.
+@code{chordRootNamer} ci-dessus. Cependant, la propriété
+@code{chordNoteNamer} permet de régler cet élément indépendamment, par
+exemple pour imprimer la basse en caractères minuscules.
-@funindex chordPrefixSpacer
-@item chordPrefixSpacer
-Le petit @code{m} qui indique un accord mineur est, dans la notation
-anglo-saxonne, attaché à la lettre de l'accord. Cependant il est
-possible d'ajouter un espace en assignant la valeur vrai à la propriété
-@code{chordPrefixSpacer}. Cet espace sera omis si une altération est
-présente.
+@funindex chordNameSeparator
-@end table
+@item chordNameSeparator
+Les différents termes d'un chiffrage jazz (par exemple les notes de
+l'accord et la basse) sont habituellement légèrement espacés. La
+propriété @code{chordNameSeparator} permet d'indiquer un autre
+séparateur. Le séparateur entre un chiffrage et sa basse est géré par
+la propriété @code{slashChordSeparator}.
+
+@lilypond[verbatim,quote,ragged-right]
+\chords {
+ c4:7.9- c:7.9-/g
+ \set chordNameSeparator = \markup { "/" }
+ \break
+ c4:7.9- c:7.9-/g
+}
+@end lilypond
+
+@funindex slashChordSeparator
+
+@item slashChordSeparator
+La note basse d'un accord n'est pas forcément la fondamentale. L'accord
+est alors @qq{renversé} -- certains diront @qq{barré} parce que son
+chiffrage est habituellement flanqué d'une barre oblique entre l'accord
+de base et sa basse. La propriété @code{slashChordSeparator} permet de
+modifier ce séparateur -- par défaut la barre de fraction.
+
+@lilypond[verbatim,quote,ragged-right]
+\chords {
+ c4:7.9- c:7.9-/g
+ \set slashChordSeparator = \markup { " over " }
+ \break
+ c4:7.9- c:7.9-/g
+}
+@end lilypond
+
+@funindex chordNameExceptions
+
+@item chordNameExceptions
+Cette propriété recense, sous forme de paire, les accords mis en forme
+de manière particulière. Le premier élément de chacune des paires
+répertorie les différentes hauteurs qui constituent l'accord. Le second
+élément est un @emph{markup} qui sera ajouté au @code{chordRootNamer}
+lors de l'impression du chiffrage.
+
+@funindex minorChordModifier
+
+@item minorChordModifier
+Les accords mineurs sont habituellement identifiés par un @code{m} après
+leur fondamentale. Certaines nomenclatures ont cependant adopté un
+autre suffixe, comme le signe moins.
+
+@lilypond[verbatim,quote,ragged-right]
+\chords {
+ c4:min f:min7
+ \set minorChordModifier = \markup { "-" }
+ \break
+ c4:min f:min7
+}
+@end lilypond
-Les propriétés ci-dessus font l'objet de commandes prédéfinies
-adaptées aux notations de différents pays@tie{}: @code{\germanChords} et
-@code{\semiGermanChords} pour la notation allemande,
-@code{\italianChords} pour la notation italienne et enfin
-@code{\frenchChords} pour la notation française.
+@funindex chordPrefixSpacer
-@lilypondfile[ragged-right]{chord-names-languages.ly}
+@item chordPrefixSpacer
+Le modificateur pour accord mineur, géré par la propriété
+@code{minorChordModifier}, est en principe accolé la fondamentale. Vous
+pouvez cependant l'espacer de la fondamentale à l'aide de la propriété
+@code{chordPrefixSpacer}. Notez bien que cet espacement sera réduit à
+néant si la fondamentale est altérée.
-@cindex Banter
-@cindex jazz, chiffrages d'accords
-@cindex accords jazz, chiffrage
-LilyPond intègre également deux autres modèles de chiffrages@tie{}: une
-notation Jazz alternative, et un modèle systématique appelé système
-Banter. Pour la mise en œuvre de ces modèles, voir
-@ref{Table des noms d'accord}.
+@end table
@predefined
+@funindex symboles de septième majeure
+@code{\whiteTriangleMarkup},
+@code{\blackTriangleMarkup},
@funindex \germanChords
@code{\germanChords},
@funindex \semiGermanChords
@endpredefined
+
+@snippets
+
+@cindex exceptions, chiffrage d'accords
+@cindex chiffrage d'accords, exceptions
+@cindex accords chiffrés, exceptions
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{chord-name-exceptions.ly}
+
+@c TODO - tweak snippet to use \blackTriangleMarkup as well
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{chord-name-major7.ly}
+
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{adding-bar-lines-to-chordnames-context.ly}
+
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{volta-below-chords.ly}
+
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{changing-chord-separator.ly}
+
+
@seealso
+Manuel de notation :
+@ref{Table des noms d'accord},
+@ref{Modificateurs d'accord usuels}.
+
+Essai sur la gravure musicale automatisée :
+@ressay{Références bibliographiques}.
+
+Fichiers d'initialisation :
+@file{scm/chords-ignatzek.scm},
+@file{scm/chord-entry.scm},
+@file{ly/chord-modifier-init.ly}.
+
Morceaux choisis :
@rlsrnamed{Chords,Accords}.
-Fichiers internes :
-@file{scm/chords-ignatzek.scm},
-@file{scm/chord-entry.scm}.
+@c Référence des propriétés internes :
+@c @r internals{}.
@knownissues
saisis au moyen de la syntaxe @code{<@dots{}>} peuvent produire des
chiffrages étranges.
-@node Personnalisation des noms d'accord
-@unnumberedsubsubsec Personnalisation des noms d'accord
-@translationof Customizing chord names
+@lilypond[quote,ragged-right,verbatim]
+myChords = \relative c' {
+ \chordmode { c1 c/g c/f }
+ <c e g>1 <g c e> <f c' e g>
+}
+<<
+ \new ChordNames { \myChords }
+ \new Staff { \myChords }
+>>
+@end lilypond
-@untranslated
@node Basse chiffrée
@subsection Basse chiffrée
@translationof Figured bass
-@untranslated
+@lilypondfile[quote]{figured-bass-headword.ly}
+
+LilyPond permet de générer des parties de continuo.
@menu
* Introduction à la basse chiffrée::
* Gravure de la basse chiffrée::
@end menu
-@c This material comes from 'Figured bass', needs redistribution by translator --FV
+
@node Introduction à la basse chiffrée
@unnumberedsubsubsec Introduction à la basse chiffrée
@translationof Introduction to figured bass
@lilypond[quote,ragged-right,verbatim]
<<
\new Voice { \clef bass dis4 c d ais g fis}
- \new FiguredBass \figuremode {
- < 6 >4 < 7\+ >8 < 6+ [_!] >
- < 6 >4 <6 5 [3+] >
- < _ >4 < 6 5/>4
+ \new FiguredBass {
+ \figuremode {
+ < 6 >4 < 7\+ >8 < 6+ [_!] >
+ < 6 >4 <6 5 [3+] >
+ < _ >4 < 6 5/>4
+ }
}
>>
@end lilypond
La gestion de la basse chiffrée se décompose en deux parties. Dans un
premier temps, le mode @code{\figuremode} permet de saisir les accords
-sous forme chiffrée. Le contexte @rinternals{FiguredBass} s'occupera
-ensuite de gérer les objets @rinternals{BassFigure}.
+sous forme chiffrée. Le contexte @code{FiguredBass} s'occupera ensuite
+de gérer les objets @code{BassFigure}. La basse chiffrée pourra être
+attachée à un contexte @code{Staff}.
+
+L'expression @code{\figures@{ ... @}} constitue une racourci à
+@code{\new FiguredBass @{ \figuremode @{ ... @} @}}.
+
+Bien que la gestion de la basse chiffrée ressemble beaucoup à celle
+des accords, elle est beaucoup plus simpliste. Le mode
+@code{\figuremode} ne fait que stocker des chiffres que le contexte
+@code{FiguredBass} se chargera d'imprimer tels quels. En aucune manière
+ils ne sont transformés en son, et ils ne sont pas rendus dans un
+fichier MIDI.
+
+@ignore
+En interne, ce code produit des étiquettes de texte que vous
+pouvez formater à votre convenance grâce aux propriétés des
+étiquettes. Par exemple, l'espacement vertical des chiffrages est
+déterminé par la propriété @code{baseline-skip}.
+@end ignore
+
+
+@seealso
+Music Glossary:
+@rglosnamed{figured bass, basse chifrée}.
+
+Morceeaux choisis :
+@rlsrnamed{Chords,Accords}.
+
+
+@node Saisie de la basse chiffrée
+@unnumberedsubsubsec Saisie de la basse chiffrée
+@translationof Entering figured bass
+
+@code{\figuremode} permet de faire la relation entre ce qui est saisi et
+le mode de chiffrage. De plus amples informations quant aux différents
+modes sont regroupées à la rubrique @ref{Modes de saisie}.
En mode de saisie, un chiffrage est délimité par @code{<} et
@code{>}. La durée est indiquée après le @code{>}@tie{}:
-@example
-<4 6>
-@end example
-@lilypond[quote,ragged-right]
-\new FiguredBass
-\figuremode { <4 6> }
+@lilypond[verbatim,quote,ragged-right]
+\new FiguredBass {
+ \figuremode {
+ <6 4>2
+ }
+}
@end lilypond
-Les altérations s'obtiennent en ajoutant aux chiffres les caractères
-@code{-}, @code{!} ou @code{+}. Un signe plus s'obtient grâce à
-@code{\+}, et une quinte ou septième diminuée par @code{5/} ou
-@code{7/} respectivement.
+Une altération -- y compris un bécarre -- peut s'attacher à un
+chiffre@tie{}:
-@example
-<4- 6+ 7!> <5++> <3--> <7/> r <6\+ 5/>
-@end example
-@lilypond[quote,ragged-right]
-\figures { <4- 6+ 7!> <5++> <3--> <7/> r <6\+ 5/> }
+@lilypond[verbatim,quote,ragged-right]
+\figures {
+ <7! 6+ 4-> <5++> <3-->
+}
@end lilypond
-Le caractère @code{_} insère un espace, et l'on peut imprimer des
-crochets avec @code{[} et @code{]}. Vous pouvez aussi ajouter des
-chaînes de caractères ou des étiquettes --- cf. @ref{Text markup commands}.
+Vous pouvez stipuler un intervalle augmenté ou diminué@tie{}:
-@example
-<[4 6] 8 [_! 12] > <5 \markup @{ \number 6 \super (1) @} >
-@end example
-@lilypond[quote,ragged-right]
-\new FiguredBass
-\figuremode { < [4 6] 8 [_! 12] > < 5 \markup{ \tiny \number 6 \super (1)} > }
+@lilypond[verbatim,quote,ragged-right]
+\figures {
+ <6\+ 5/> <7/>
+}
@end lilypond
+Vous pouvez barrer un chiffre d'une oblique inversée, typiquement pour
+une @qq{petite sixte}@tie{}:
+
+@lilypond[verbatim,quote,ragged-right]
+\figures {
+ <6> <6\\>
+}
+@end lilypond
+
+Vous pouvez insérer un espace ou ajouter des crochets@tie{}:
+
+@lilypond[verbatim,quote,ragged-right]
+\figures {
+ <[12 _!] 8 [6 4]>
+}
+@end lilypond
+
+Vous pouvez aussi ajouter des chaînes de caractères ou des étiquettes --
+cf. @ref{Text markup commands}.
+
+@lilypond[verbatim,quote,ragged-right]
+\figures {
+ <\markup { \tiny \number 6 \super (1) } 5>
+}
+@end lilypond
+
+@c NOTE: We need to include notes any time we use extenders to
+@c avoid extraneous staff creation due to Staff.use... in
+@c \bassFigureExtendersOn
+
Lorsque des chiffrages se répètent, vous pouvez utiliser des lignes de
prolongation.
-@lilypond[verbatim,relative=1]
+@lilypond[verbatim,quote,ragged-right]
<<
- \new Staff {
+ {
\clef bass
- c4 c c
+ e4 d c b,
+ e4 d c b,
}
\figures {
- \set useBassFigureExtenders = ##t
- <4 6> <3 6> <3 7>
+ \bassFigureExtendersOn
+ <6 4>4 <6 3> <7 3> <7 3>
+ \bassFigureExtendersOff
+ <6 4>4 <6 3> <7 3> <7 3>
}
>>
@end lilypond
@noindent
En pareil cas, la ligne de prolongation masquera toujours le chiffre
-qu'elle rappelle dans le chiffrage suivant.
-
-Le contexte @code{FiguredBass} ne tient aucun compte de la ligne de
-basse. Par conséquent, il vous faudra peut être insérer des chiffrages
-supplémentaires pour imprimer les prolongations, ou utiliser des
-@code{\!} pour les éviter, comme dans l'exemple suivant@tie{}:
+qu'elle rappelle dans le chiffrage suivant à moins d'avoir été
+explicitement interrompue.
-@lilypond[relative=1]
+@lilypond[verbatim,quote,ragged-right]
<<
- \new Voice
\figures {
- \set useBassFigureExtenders = ##t
- <6 4->4. <6 4->16. <6 4->32 <5>8. r16 <6>8 <6\! 5->
+ \bassFigureExtendersOn
+ <6 4>4 <6 4> <6\! 4\!> <6 4>
}
{
\clef bass
- f16. g32 f16. g32 f16. g32 f16. g32 f8. es16 d8 es
+ d4 d c c
}
>>
@end lilypond
-Lorsque vous utilisez des lignes de prolongation, les chiffres communs
-seront verticalement alignés. Pour l'éviter, insérez un silence avec
-@code{r} afin de réinitialiser l'alignement. Par exemple, saisissez
-
-@example
- <4 6>8 r8
-@end example
+Voici, de manière synthétique, les différents modificateurs
+disponibles@tie{}:
+
+@multitable @columnfractions .1 .5 .4
+
+@item
+@b{Modificateur}
+@tab
+@b{Utilisation}
+@tab
+@b{Exemple}
+
+@item
++, -, !
+@tab
+Altérations
+@tab
+@lilypond[line-width=4\cm]
+\figures {
+ <7! 6+ 4-> <5++> <3-->
+}
+@end lilypond
-@noindent
-au lieu de
-@example
- <4 6>4
-@end example
+@item
+\+, /
+@tab
+Augmentation ou diminution d'un degré
+@tab
+@lilypond[line-width=4\cm]
+\figures {
+ <6\+ 5/> <7/>
+}
+@end lilypond
-On peut choisir d'impriemr les altérations et signes plus aussi bien
-avant qu'après les chiffres, en réglant les propriétés
-@code{figuredBassAlterationDirection} et
-@code{figuredBassPlusDirection}.
+@item
+\\
+@tab
+Petite sixte
+@tab
+@lilypond[line-width=4\cm]
+\figures {
+ <6\\>
+}
+@end lilypond
-@lilypond
+@item
+\!
+@tab
+Terminaison d'une prolongation
+@tab
+@lilypond[line-width=4\cm]
+<<
\figures {
- <6\+> <5+> <6 4-> r
- \set figuredBassAlterationDirection = #1
- <6\+> <5+> <6 4-> r
- \set figuredBassPlusDirection = #1
- <6\+> <5+> <6 4-> r
- \set figuredBassAlterationDirection = #-1
- <6\+> <5+> <6 4-> r
+ \bassFigureExtendersOn
+ <6 4> <6 4> <6\! 4\!> <6 4>
}
+ {
+ \clef bass
+ d d c c
+ }
+>>
@end lilypond
-Bien que la gestion de la basse chiffrée ressemble beaucoup à celle
-des accords, elle est beaucoup plus simpliste. Le mode
-@code{\figuremode} ne fait que stocker des chiffres que le contexte
-@rinternals{FiguredBass} se chargera d'imprimer tels quels. En
-aucune manière ils ne sont transformés en son, et ils ne sont pas
-rendus dans un fichier MIDI.
+@end multitable
-En interne, ce code produit des étiquettes de texte que vous
-pouvez formater à votre convenance grâce aux propriétés des
-étiquettes. Par exemple, l'espacement vertical des chiffrages est
-déterminé par la propriété @code{baseline-skip}.
-On peut également ajouter une basse chiffrée directement à un contexte
-@code{Staff}. L'alignement vertical est alors automatiquement ajusté.
+@predefined
+@cindex basse chiffrée, lignes d'extension
+@code{\bassFigureExtendersOn},
+@code{\bassFigureExtendersOff}.
+@endpredefined
+
+
+@snippets
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{changing-the-positions-of-figured-bass-alterations.ly}
+
+
+@seealso
+Morceaux choisis :
+@rlsrnamed{Chords,Accords}.
-@lilypond[ragged-right,quote]
+Référence des propriétés internes :
+@rinternals{BassFigure},
+@rinternals{BassFigureAlignment},
+@rinternals{BassFigureLine},
+@rinternals{BassFigureBracket},
+@rinternals{BassFigureContinuation},
+@rinternals{FiguredBass}.
+
+
+@node Gravure de la basse chiffrée
+@unnumberedsubsubsec Gravure de la basse chiffrée
+@translationof Displaying figured bass
+
+Une ligne de basse chiffrée s'imprime soit dans un contexte
+@code{FiguredBass}, soit dans la plupart des autres contextes du niveau
+de la portée.
+
+Le contexte @code{FiguredBass} ne tient aucun compte des notes qui
+apparaissent sur la portée.
+
+@lilypond[verbatim,ragged-right,quote]
<<
- \new Staff = someUniqueName
\relative c'' {
c4 c'8 r8 c,4 c'
}
+ \new FiguredBass {
+ \figuremode {
+ <4>4 <10 6>8 s8
+ <6 4>4 <6 4>
+ }
+ }
+>>
+@end lilypond
- %% send to existing Staff.
- \context Staff = someUniqueName
- \figuremode {
- <4>4 <6 10>8 s8
+@noindent
+Il est impératif, dans cet exemple, d'instancier explicitement le
+contexte @code{FiguredBass} pour éviter l'apparition d'une portée
+supplémentaire vide.
+
+On peut ajouter une basse chiffrée directement à un contexte
+@code{Staff}. L'alignement vertical est alors automatiquement ajusté.
- \set Staff.useBassFigureExtenders = ##t
- <4 6>4 <4 6>
+@lilypond[verbatim,ragged-right,quote]
+<<
+ \new Staff = myStaff
+ \figuremode {
+ <4>4 <10 6>8 s8
+ <6 4>4 <6 4>
+ }
+ %% Put notes on same Staff as figures
+ \context Staff = myStaff
+ {
+ \clef bass
+ c4 c'8 r8 c4 c'
}
>>
@end lilypond
-@commonprop
+La basse chiffrée attachée à un contexte @code{Staff} peut se
+positionner au-dessus ou en dessous de la portée.
-Par défaut, les chiffres sont imprimés au-dessus de la portée. Pour les
-imprimer dessous, ajoutez
-
-@example
-\override Staff.BassFigureAlignmentPositioning #'direction = #DOWN
-@end example
+@lilypond[verbatim,ragged-right,quote]
+<<
+ \new Staff = myStaff
+ \figuremode {
+ <4>4 <10 6>8 s8
+ \bassFigureStaffAlignmentDown
+ <6 4>4 <6 4>
+ }
+ %% Put notes on same Staff as figures
+ \context Staff = myStaff
+ {
+ \clef bass
+ c4 c'8 r8 c4 c'
+ }
+>>
+@end lilypond
-@knownissues
-Si vous positionnez la basse chiffrée au dessus de la portée en ayant
-recours aux lignes d'extension et @code{implicitBassFigures}, les lignes
-peuvent se mélanger. Préserver l'ordre des prolongateurs peut s'avérer
-impossible lorsque plusieurs chiffrages qui se chevauchent en possèdent.
-Ce problème peut être contourné en jouant sur l'empilement, avec la
-propriété @code{stacking-dir} de l'objet @code{BassFigureAlignment}.
+@predefined
+@cindex basse chiffrée, alignement
+@code{\bassFigureStaffAlignmentDown},
+@code{\bassFigureStaffAlignmentUp},
+@code{\bassFigureStaffAlignmentNeutral}.
+@endpredefined
@seealso
-Référence des pripriétés internes : les objets
+Morceaux choisis :
+@rlsrnamed{Chords,Accords}.
+
+Référence des propriétés internes :
@rinternals{BassFigure},
@rinternals{BassFigureAlignment},
@rinternals{BassFigureLine},
-@rinternals{BassFigureBracket} et
-@rinternals{BassFigureContinuation}, ainsi que le contexte
+@rinternals{BassFigureBracket},
+@rinternals{BassFigureContinuation},
@rinternals{FiguredBass}.
-@node Saisie de la basse chiffrée
-@unnumberedsubsubsec Saisie de la basse chiffrée
-@translationof Entering figured bass
+@knownissues
+Les lignes de prolongation seront correctes dès lors que notes et
+chiffrages adoptent des durées identiques.
-@untranslated
+@lilypond[verbatim,ragged-right,quote]
+<<
+ {
+ \clef bass
+ \repeat unfold 4 { f16. g32 } f8. es16 d8 es
+ }
+ \figures {
+ \bassFigureExtendersOn
+ % The extenders are correct here, with the same rhythm as the bass
+ \repeat unfold 4 { <6 4->16. <6 4->32 }
+ <5>8. r16 <6>8 <6\! 5->
+ }
+>>
+<<
+ {
+ \clef bass
+ \repeat unfold 4 { f16. g32 } f8. es16 d8 es
+ }
+ \figures {
+ \bassFigureExtendersOn
+ % The extenders are incorrect here, even though the timing is the same
+ <6 4->4 <6 4->4
+ <5>8. r16 <6>8 <6\! 5->
+ }
+>>
+@end lilypond
-@node Gravure de la basse chiffrée
-@unnumberedsubsubsec Gravure de la basse chiffrée
-@translationof Displaying figured bass
+Préserver l'ordre des prolongateurs peut s'avérer impossible lorsque
+plusieurs chiffrages qui se chevauchent en possèdent.
-@untranslated
+@lilypond[verbatim,ragged-right,quote,relative=1]
+<<
+ { fis4 g g, e' }
+ \figures {
+ \bassFigureExtendersOn
+ <6 5>4 <5\! 4> < 5 _!> <6>
+ }
+>>
+@end lilypond
+
+Ce problème peut être contourné en activant les prolongateurs derrière
+le chiffrage qui l'entame, puis en les désactivant derrière leur fin.
+
+@lilypond[verbatim,ragged-right,quote,relative=1]
+<<
+ { fis4 g g, e' }
+ \figures {
+ <6 5>4 <5 4>
+ \bassFigureExtendersOn
+ < 5 _!>4 <6>
+ \bassFigureExtendersOff
+ }
+>>
+@end lilypond
projects / lilypond.git / commitdiff