-@c -*- coding: utf-8; mode: texinfo; -*-
+@c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
+
@ignore
- Translation of GIT committish: 33ba8d40c3493011a4b39ab8b1369701f8013bd6
+ Translation of GIT committish: 53cff5245f682708a6c77d580f418ece2923c2e4
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.21"
@c Translators: Jean-Charles Malahieude
-@node Editorial annotations
-@section Editorial annotations
+@node Annotations éditoriales
+@section Annotations éditoriales
+@translationof Editorial annotations
@lilypondfile[quote]{editorial-headword.ly}
+Ce chapitre traite de la manière de modifier l'apparence des notes dans
+un but pédagogique ou d'analyse.
+
@menu
-* Inside the staff::
-* Outside the staff::
+* Dans la portée::
+* Hors de la portée::
@end menu
-@node Inside the staff
-@subsection Inside the staff
+@node Dans la portée
+@subsection Dans la portée
+@translationof Inside the staff
+Nous allons voir ici comment mettre en exergue certains éléments à
+l'intérieur même de la portée.
@menu
-* Selecting notation font size::
-* Fingering instructions::
-* Hidden notes::
-* Coloring objects::
-* Parentheses::
-* Stems::
+* Indication de la taille de fonte musicale::
+* Doigtés::
+* Dictée à trous::
+* Coloration d'objets::
+* Parenthèses::
+* Hampes::
@end menu
-@node Selecting notation font size
-@unnumberedsubsubsec Selecting notation font size
-Le plus sûr moyen de régler la taille de la police, quelque soit le
-contexte, consiste à définir la propriété @code{fontSize}.
+@node Indication de la taille de fonte musicale
+@unnumberedsubsubsec Indication de la taille de fonte musicale
+@translationof Selecting notation font size
+
+@cindex sélection de la taille (notation)
+@cindex notes, taille
+@cindex taille des notes
+@cindex têtes de note
+
+@funindex fontSize
+@funindex font-size
+@funindex magnification->font-size
+@funindex magstep
+@funindex magnifyMusic
+@funindex \teeny
+@funindex \tiny
+@funindex \small
+@funindex \normalsize
+@funindex \large
+@funindex \huge
+@funindex teeny
+@funindex tiny
+@funindex small
+@funindex normalsize
+@funindex large
+@funindex huge
+
+@warning{@*
+Pour les tailles de police textuelle, voir
+@ref{Sélection de la fonte et de la taille}.@*
+Pour la taille des portées, voir
+@ref{Définition de la taille de portée}.@*
+Pour les petites notes, voir
+@ref{Mise en forme d'une citation}.@*
+Pour les variantes, voir @ref{Portées d'ossia}.}
+
+Le plus sûr moyen de régler la taille des éléments de notation sans
+modifier la taille de la portée consiste à utiliser la commande
+@code{\magnifyMusic} :
+
+@c Grieg Piano Concerto (mvt.1 cadenza)
+@lilypond[verbatim,quote]
+\new Staff <<
+ \new Voice \relative {
+ \voiceOne
+ <e' e'>4 <f f'>8. <g g'>16 <f f'>8 <e e'>4 r8
+ }
+ \new Voice \relative {
+ \voiceTwo
+ \magnifyMusic 0.63 {
+ \override Score.SpacingSpanner.spacing-increment = #(* 1.2 0.63)
+ r32 c'' a c a c a c r c a c a c a c
+ r c a c a c a c a c a c a c a c
+ }
+ }
+>>
+@end lilypond
+
+La présence d'un @code{\override} dans cet exemple permet de
+contourner une bogue -- voir « Problèmes connus et avertissements » en
+fin de section.
+
+Dans le cas de fusion d'une tête de note normale avec une autre de
+taille inférieure, la taille de la petite note peut nécessiter une
+réinitialisation -- à l'aide d'un @w{@samp{\once@tie{}\normalsize}} --
+de telle sorte que les hampes et altérations s'alignent correctement :
+
+@c Chopin Prelude op.28 no.8
+@lilypond[verbatim,quote]
+\new Staff <<
+ \key fis \minor
+ \mergeDifferentlyDottedOn
+ \new Voice \relative {
+ \voiceOne
+ \magnifyMusic 0.63 {
+ \override Score.SpacingSpanner.spacing-increment = #(* 1.2 0.63)
+ \once \normalsize cis'32( cis' gis b a fis \once \normalsize d d'
+ \once \normalsize cis, cis' gis b a gis \once \normalsize fis fis'
+ \once \normalsize fis, fis' ais, cis b gis \once \normalsize eis eis'
+ \once \normalsize a, a' bis, d cis b \once \normalsize gis gis')
+ }
+ }
+ \new Voice \relative {
+ \voiceTwo
+ cis'8. d16 cis8. fis16 fis8. eis16 a8. gis16
+ }
+>>
+@end lilypond
+
+La commande @code{\magnifyMusic} n'est pas conçue pour gérer les
+citations, notes d'ornement ou portées d'ossia -- des moyens
+spécifiques sont déjà disponibles en la matière. Elle est par contre
+tout à fait adaptée dans le cas d'un instrument particulier disposant de
+sa propre portée là où des notes d'ornement seraient inappropriées,
+comme pour une pseudo-cadence ou les exemples ci-dessus. L'attribution
+d'une valeur de 0,63 à @code{\magnifyMusic} duplique les dimensions d'un
+contexte @code{CueVoice}.
+
+@warning{La commande @code{@bs{}magnifyMusic} n'est pas censée
+intervenir en complément d'une modification de la taille de portée --
+voir @ref{Définition de la taille de portée}.}
+
+
+@subsubsubheading Redimmensionnement individuel d'objets de rendu
+@c VO Resizing individual layout objects
+
+L'ajustement de la propriété @code{font-size} à l'aide des commandes
+@code{\tweak} ou @code{\override} permet de retailler un objet de rendu
+particulier :
+
+@lilypond[quote,verbatim,relative=1]
+% resize a note head
+<f \tweak font-size -4 b e>-5
+% resize a fingering
+bes-\tweak font-size 0 -3
+% resize an accidental
+\once \override Accidental.font-size = -4 bes!-^
+% resize an articulation
+\once \override Script.font-size = 4 bes!-^
+@end lilypond
+
+@lilypond[verbatim,quote,relative=2]
+\huge
+c4.-> d8---3
+\large
+c4.-> d8---3
+\normalsize
+c4.-> d8---3
+\small
+c4.-> d8---3
+\tiny
+c4.-> d8---3
+\teeny
+c4.-> d8---3
+@end lilypond
+
+La valeur par défaut de @code{font-size} est mentionnée, pour chaque
+objet de rendu, dans la référence des propriétés internes. La propriété
+@code{font-size} ne peut intervenir que pour les objets qui utilisent
+des polices, autrement dit ceux qui disposent de l'interface de rendu
+@code{font-interface}. L'abence de @code{font-size} dans la liste des
+« réglages par défaut » d'un objet signifie qu'elle est de 0 -- voir
+@rinternals{All layout objects} @emph{(Tous les objets de rendu)}.
+
+
+@subsubsubheading La propriété @code{fontSize}
+@c VO Understanding the @code{fontSize} property
+
+La propriété @code{fontSize} d'un contexte a pour effet de définir la
+taille proportionnelle de tout élément de notation basé sur un
+glyphe dans ce contexte :
+
+@lilypond[verbatim,quote,relative=2]
+\time 3/4
+d4---5 c8( b a g) |
+\set fontSize = -6
+e'4-- c!8-4( b a g) |
+\set fontSize = 0
+fis4---3 e8( d) fis4 |
+g2.
+@end lilypond
+
+La valeur de @code{fontSize} est un nombre indiquant la taille
+relative par rapport à la hauteur standard de la portée en cours.
+La valeur par défaut de @code{fontSize} est de 0. Un pas de six
+aboutit exactement au doublement de la taille ; un pas de moins
+six la réduit de moitié. Chaque incrément correspond à une
+augmentation d'environ 12 % de la taille de la police.
-@lilypond[quote,fragment,relative=1,verbatim]
-c8
-\set fontSize = #-4
-c f
-\set fontSize = #3
-g
+La fonction Scheme @code{magnification->font-size} permet de
+s'affranchir de l'échelle logarithmique peu intuitive des unités
+de la propriété @code{font-size}. Ainsi, l'ajustement à 75 % de
+la notation musicale par rapport à la taille de la portée peut se
+libeller :
+
+@example
+\set fontSize = #(magnification->font-size 0.75)
+@end example
+
+La fonction Scheme @code{magstep} quant à elle effectue
+l'inverse : elle convertit le nombre affecté à @code{font-size} en
+facteur d'échelle.
+
+La propriété @code{fontSize} affecte uniquement les éléments de
+notation reposant sur des glyphes, tels les têtes de note,
+altérations, scripts, etc. Elle n'aura aucun effet sur la taille
+de la portée, la hauteur des hampes ou la longueur des ligatures
+ni sur l'espacement horizontal. L'échelonnement des hampes,
+ligature et espacement horizontal, couplé à la taille de la
+notation (sans modification de la taille de la portée), s'obtient
+à l'aide de la commande @code{\magnifyMusic} comme nous venons de
+le voir. La modification de l'ensemble, y compris la taille de
+portée, est abordé dans @ref{Définition de la taille de portée}.
+
+Dès lors que la @strong{propriété de contexte} @code{fontSize} est
+définie, sa valeur est ajoutée individuellement à la valeur de la
+@strong{propriété de @emph{grob}} @code{font-size} des objets de
+rendu. Ceci peut être source de confusion lorsque des propriétés
+@code{font-size} individuelles sont réglées alors que
+@code{fontSize} est déjà fixé :
+
+@lilypond[verbatim,quote,relative=2]
+% the default font-size for NoteHead is 0
+% the default font-size for Fingering is -5
+c4-3
+
+\set fontSize = -3
+% the effective font size for NoteHead is now -3
+% the effective font size for Fingering is now -8
+c4-3
+
+\override Fingering.font-size = 0
+% the effective font size for Fingering is now -3
+c4-3
@end lilypond
-@noindent
-Ceci ne modifiera en rien la taille des différents symboles tels que
-ligatures ou liaisons.
-
-En interne, la propriété @code{fontSize} d'un contexte aura pour effet
-de définir la propriété @code{font-size} pour tous les objets de
-rendu. La valeur de @code{font-size} est un entier représentant la
-taille proportionnellement à la hauteur standard de la portée en
-cours. Chaque incrément correspond à une augmentation d'environ
-12@tie{}% de la taille de la police. Un pas de six aboutit exactement
-au doublement de la taille. La fonction Scheme @code{magstep}
-convertit le nombre affecté à @code{font-size} en facteur d'échelle.
-Vous pouvez aussi définir directement la propriété @code{font-size} de
-manière à n'affecter seulement que certains objets de rendu.
-
-@lilypond[quote,fragment,relative=1,verbatim]
-c8
-\override NoteHead #'font-size = #-4
-c f
-\override NoteHead #'font-size = #3
-g
+LilyPond dispose d'un certain nombre de raccourcis :
+
+@multitable @columnfractions .2 .4 .4
+@item @b{Commande} @tab @b{Équivalent} @tab @b{Taille relative}
+@item @code{\teeny} @tab @code{\set fontSize = -3} @tab 71 %
+@item @code{\tiny} @tab @code{\set fontSize = -2} @tab 79 %
+@item @code{\small} @tab @code{\set fontSize = -1} @tab 89 %
+@item @code{\normalsize} @tab @code{\set fontSize = 0} @tab 100 %
+@item @code{\large} @tab @code{\set fontSize = 1} @tab 112 %
+@item @code{\huge} @tab @code{\set fontSize = 2} @tab 126 %
+@end multitable
+
+@lilypond[verbatim,quote,relative=2]
+\teeny
+c4.-> d8---3
+\tiny
+c4.-> d8---3
+\small
+c4.-> d8---3
+\normalsize
+c4.-> d8---3
+\large
+c4.-> d8---3
+\huge
+c4.-> d8---3
@end lilypond
-Pour changer la taille des symboles musicaux (police Feta), LilyPond met
-à l'échelle la fonte dont la taille est la plus proche de la taille voulue ---
-cf. @ref{Setting the staff size}. La taille standard, pour laquelle
-@code{font-size} vaut 0, dépend de la hauteur de la portée. À une
-portée de 20 points correspond une police de 10 points.
+@cindex standard, taille des notes
+@cindex notes, taille standard
+
+@funindex font-interface
+@funindex font-size
-La propriété @code{font-size} ne peut intervenir que pour les objets
-qui utilisent des polices, autrement dit ceux qui disposent de
-l'interface de rendu @rinternals{font-interface}.
+Pour changer la taille des caractères, LilyPond met à l'échelle la fonte
+dont la taille est la plus proche de la taille voulue. La taille
+standard (pour laquelle @code{font-size = 0}) dépend de la hauteur
+de la portée. À une portée de 20 points correspond une police de
+11 points.
@predefined
-Les commandes suivantes définissent @code{fontSize} pour la voix en
-cours :
-@funindex \tiny
+@code{\magnifyMusic},
+@code{\teeny},
@code{\tiny},
-@funindex \small
@code{\small},
-@funindex \normalsize
-@code{\normalsize}.
+@code{\normalsize},
+@code{\large},
+@code{\huge}.
@endpredefined
+@seealso
+Manuel de notation :
+@ref{Sélection de la fonte et de la taille},
+@ref{Définition de la taille de portée},
+@ref{Mise en forme d'une citation},
+@ref{Portées d'ossia}.
+
+Fichiers d'initialisation :
+@file{ly/music-functions-init.ly},
+@file{ly/property-init.ly}.
+
+Morceaux choisis :
+@rlsrnamed{Editorial annotations,Annotations éditoriales}.
-@node Fingering instructions
-@unnumberedsubsubsec Fingering instructions
+Référence des propriétés internes :
+@rinternals{font-interface}.
+
+@c The two issues mentioned below:
+@c http://code.google.com/p/lilypond/issues/detail?id=3987
+@c http://code.google.com/p/lilypond/issues/detail?id=3990
+@knownissues
+Deux bogues actuellement répertoriés font obstacle à un espacement
+horizontal correct avec @code{\magnifyMusic}. La seule façon de les
+contourner n'est cependant pas garantie dans toutes les situations.
+Dans l'exemple suivant, il vous faudra adapter la valeur de la variable
+@var{mag}. Vous pourriez aussi tenter de supprimer une ou les deux
+commandes @code{\newSpacingSection}, ou les commandes @code{\override}
+et @code{\revert} :
+
+@example
+\magnifyMusic @var{mag} @{
+ \newSpacingSection
+ \override Score.SpacingSpanner.spacing-increment = #(* 1.2 @var{mag})
+ @var{[musique]}
+ \newSpacingSection
+ \revert Score.SpacingSpanner.spacing-increment
+@}
+@end example
+
+
+@node Doigtés
+@unnumberedsubsubsec Doigtés
+@translationof Fingering instructions
@cindex doigté
@cindex substitution de doigt
+@funindex \finger
+@funindex finger
-Les doigtés peuvent être indiqués comme suit :
-@example
+Les doigtés peuvent être indiqués comme suit :
@var{note}-@var{chiffre_du_doigt}
-@end example
+
+@lilypond[verbatim,quote,relative=2]
+c4-1 d-2 f-4 e-3
+@end lilypond
+
Pour les substitutions de doigts, on a recours à une indication
textuelle (commande @code{\markup}) de doigté
(commande @code{\finger}).
-@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
-c4-1 c-2 c-3 c-4
-c^\markup { \finger "2 - 3" }
+@lilypond[verbatim,quote,relative=2]
+c4-1 d-2 f\finger \markup \tied-lyric #"4~3" c\finger "2 - 3"
@end lilypond
+@cindex pouce, doigté
+
+@funindex \thumb
+@funindex thumb
La commande @code{\thumb} peut être utilisée pour indiquer, par exemple
dans une partition de violoncelle, si une note doit être jouée avec le
-pouce (@q{thumb} en anglais).
+pouce (@emph{thumb} en anglais).
-@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
-<a_\thumb a'-3>8 <b_\thumb b'-3>
+@lilypond[verbatim,quote,relative=2]
+<a_\thumb a'-3>2 <b_\thumb b'-3>
@end lilypond
+@cindex doigtés des accords
+@cindex accords, doigtés
Les doigtés des accords peuvent être saisis note par note,
en les indiquant après chaque hauteur de note.
-@lilypond[quote,verbatim,ragged-right,fragment,relative=2]
-< c-1 e-2 g-3 b-5 >4
+@lilypond[verbatim,quote,relative=2]
+<c-1 e-2 g-3 b-5>2 <d-1 f-2 a-3 c-5>
@end lilypond
+Les indications de doigtés peuvent se placer au-dessus ou en dessous de
+la portée -- voir @ref{Direction et positionnement} à ce sujet.
-@commonprop
-
-On peut contrôler précisément les doigtés des accords en réglant
-la propriété @code{fingeringOrientations}.
-
-@lilypond[quote,verbatim,ragged-right,fragment,relative=1]
-\set fingeringOrientations = #'(left down)
-<c-1 es-2 g-4 bes-5 > 4
-\set fingeringOrientations = #'(up right down)
-<c-1 es-2 g-4 bes-5 > 4
-@end lilypond
-
-
-Cette propriété permet également, dans de la musique monophonique,
-d'indiquer des doigtés très proches des têtes de notes.
+@snippets
-@lilypond[verbatim,ragged-right,quote,fragment]
-\set fingeringOrientations = #'(right)
-<es'-2>4
-@end lilypond
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
+{controlling-the-placement-of-chord-fingerings.ly}
-@snippets
+@lilypondfile[verbatim,quote,texidoc,doctitle]
+{allowing-fingerings-to-be-printed-inside-the-staff.ly}
-@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+@lilypondfile[verbatim,quote,texidoc,doctitle]
{avoiding-collisions-with-chord-fingerings.ly}
-
@seealso
-Référence du programme : @rinternals{Fingering}.
+Manuel de notation :
+@ref{Direction et positionnement}.
-Exemples : @rlsr{Editorial annotations}.
+Morceaux choisis :
+@rlsrnamed{Editorial annotations, Annotations éditoriales}.
+Référence des propriétés internes :
+@rinternals{FingeringEvent},
+@rinternals{fingering-event},
+@rinternals{Fingering_engraver},
+@rinternals{New_fingering_engraver},
+@rinternals{Fingering}.
-@node Hidden notes
-@unnumberedsubsubsec Hidden notes
-@cindex Masquées, notes
-@cindex Invisibles, notes
-@cindex Transparentes, notes
+@node Dictée à trous
+@unnumberedsubsubsec Dictée à trous
+@translationof Hidden notes
+
+@cindex masquées, notes
+@cindex invisibles, notes
+@cindex transparentes, notes
+@cindex note invisible
+@cindex note masquée
@funindex \hideNotes
+@funindex hideNotes
@funindex \unHideNotes
-Les notes masquées --- ou invisibles ou encore transparentes --- sont
+@funindex unHideNotes
+
+Les notes masquées -- ou invisibles ou encore transparentes -- sont
utiles dans le cadre d'exercices de théorie ou de composition.
-@lilypond[quote,ragged-right,verbatim,relative=2,fragment]
-c4 d4
+@lilypond[verbatim,quote,relative=2]
+c4 d
\hideNotes
-e4 f4
+e4 f
\unHideNotes
-g4 a
+g a
+\hideNotes
+b
+\unHideNotes
+c
@end lilypond
+Têtes de note, hampes, crochets et silences sont invisibles. Une
+ligature sera invisible si elle démarre sur une note invisible.
+Les objets de notation attachés à une note invisible ne seront pas
+masqués pour autant.
-@node Coloring objects
-@unnumberedsubsubsec Coloring objects
+@lilypond[verbatim,quote,relative=2]
+e8(\p f g a)--
+\hideNotes
+e8(\p f g a)--
+@end lilypond
+
+@predefined
+@code{\hideNotes},
+@code{\unHideNotes}.
+@endpredefined
+
+@seealso
+Manuel d'initiation :
+@rlearning{Visibilité et couleur des objets}.
+
+Manuel de notation :
+@ref{Silences invisibles},
+@ref{Visibilité des objets},
+@ref{Masquage de portées}.
+
+Morceaux choisis :
+@rlsrnamed{Editorial annotations,Annotations éditoriales}.
+
+Référence des propriétés internes :
+@rinternals{Note_spacing_engraver},
+@rinternals{NoteSpacing}.
+
+
+@node Coloration d'objets
+@unnumberedsubsubsec Coloration d'objets
+@translationof Coloring objects
+
+@cindex objets en couleur
+@cindex couleurs
+@cindex colorisation d'objets
+@cindex coloration d'objets
+@cindex coloration de notes
+@cindex colorisation de notes
+@cindex notes en couleur
+@cindex x11, couleurs
+@cindex couleurs x11
+
+@funindex color
+@funindex \with-color
+@funindex with-color
+@funindex x11-color
Des objets peuvent être colorisés individuellement. Une listes des
-noms des couleurs disponibles se trouvent à l'annexe @ref{List of colors}.
+noms des couleurs disponibles se trouvent à l'annexe
+@ref{Liste des couleurs}.
-@lilypond[quote,ragged-right,verbatim,fragment,relative=1]
-\override NoteHead #'color = #red
+@lilypond[verbatim,quote,relative=2]
+\override NoteHead.color = #red
c4 c
-\override NoteHead #'color = #(x11-color 'LimeGreen)
+\override NoteHead.color = #(x11-color 'LimeGreen)
d
-\override Stem #'color = #blue
+\override Stem.color = #blue
e
@end lilypond
L'intégralité de la palette des couleurs définies pour X11 est
-accessible par la fonction Scheme x11-color. Cette fonction prend
-en argument une expression symbolique
-
-@example
-\override Beam #'color = #(x11-color 'MediumTurquoise)
-@end example
-
-ou une chaîne de caractères
+accessible par la fonction Scheme @code{x11-color}. Cette fonction
+prend en argument une expression symbolique de la forme
+@code{@var{'TaraTata}} ou bien une chaîne de caractères comme
+@code{@var{"TaraTata"}}. La première formulation est à la fois plus
+rapide à écrire et aussi plus efficace. Néanmoins, la deuxième forme
+permet d'accéder aux noms composés des couleurs de X11.
+
+Lorsque la fonction @code{x11-color} ne trouve pas le paramètre fourni,
+elle revient à la couleur par défaut, le noir. Le problème ressort de
+façon évidente au vu de la partition finale.
-@example
-\override Beam #'color = #(x11-color "MediumTurquoise")
-@end example
+@lilypond[verbatim,quote,relative=2]
+\override Staff.StaffSymbol.color = #(x11-color 'SlateBlue2)
+\set Staff.instrumentName = \markup {
+ \with-color #(x11-color 'navy) "Clarinet"
+}
-La première formulation est à la fois plus rapide à écrire et aussi
-plus efficace. Néanmoins, la deuxième forme permet d'accéder aux noms
-composés des couleurs de X11.
+gis8 a
+\override Beam.color = #(x11-color "medium turquoise")
+gis a
+\override Accidental.color = #(x11-color 'DarkRed)
+gis a
+\override NoteHead.color = #(x11-color "LimeGreen")
+gis a
+% this is deliberate nonsense; note that the stems remain black
+\override Stem.color = #(x11-color 'Boggle)
+b2 cis
+@end lilypond
-@example
-\override Beam #'color = #(x11-color "medium turquoise")
-@end example
+@cindex rgb-color
+@cindex couleur rgb
+@cindex couleur rvb
+@cindex rgb, couleur
+@cindex rvb, couleur
-Lorsque la fonction x11-color ne trouve pas le paramètre fourni, elle
-revient à la couleur par défaut, le noir. Le problème ressort de
-façon évidente au vu de la partition finale.
+@funindex rgb-color
-L'exemple suivant illustre l'utilisation de la fonction
-@code{x11-color}. Notez que, après avoir été définie à (x11-color
-'Boggle), la couleur des hampes repasse au noir.
+Un autre moyen consiste à fournir à la fonction Scheme @code{rgb-color}
+les composantes de la couleur exacte au format rouge-vert-bleu
+(@emph{RGB}) -- chacune étant exprimée en en fraction de 256 (le 0.5 de
+l'exemple suivant correspond à 128).
-@lilypond[quote,ragged-right,verbatim]
-{
- \override Staff.StaffSymbol #'color = #(x11-color 'SlateBlue2)
- \set Staff.instrumentName = \markup {
- \with-color #(x11-color 'navy) "Clarinet"
- }
- \time 2/4
- gis''8 a''
- \override Beam #'color = #(x11-color "medium turquoise")
- gis'' a''
- \override NoteHead #'color = #(x11-color "LimeGreen")
- gis'' a''
- \override Stem #'color = #(x11-color 'Boggle)
- gis'' a''
+@lilypond[verbatim,quote,relative=2]
+\override Staff.StaffSymbol.color = #(x11-color 'SlateBlue2)
+\set Staff.instrumentName = \markup {
+ \with-color #(x11-color 'navy) "Clarinet"
}
-@end lilypond
+\override Stem.color = #(rgb-color 0 0 0)
+gis8 a
+\override Stem.color = #(rgb-color 1 1 1)
+gis8 a
+\override Stem.color = #(rgb-color 0 0 0.5)
+gis4 a
+@end lilypond
@seealso
-Annexes : @ref{List of colors}.
+Manuel de notation :
+@ref{Liste des couleurs},
+@ref{La commande d'affinage (tweak)}.
+Morceaux choisis :
+@rlsrnamed{Editorial annotations,Annotations éditoriales}.
-@knownissues
-Les couleurs de X11 ne sont pas toutes perceptibles dans un navigateur
-internet. Aussi nous vous recommandons, dans le cadre d'une
-présentation multimedia, d'utiliser des couleurs de base.
+@cindex x11, couleur
+@cindex couleur, notes d'un accord
+@cindex notes colorisées dans un accord
+@cindex accords et couleur
+
+@funindex x11-color
+@knownissues
Une couleur x11 n'aura pas forcément le même rendu qu'une couleur
normale ayant un nom similaire.
-Vous ne pouvez pas coloriser des notes à l'intérieur d'un accord avec
-@code{\override}. si besoin est, utilisez @code{\tweak}.
-Pour plus de détails, consultez @ref{The tweak command}.
+Les couleurs de X11 ne sont pas toutes perceptibles dans un navigateur
+internet. Aussi nous vous recommandons, dans le cadre d'une
+présentation multimédia, d'utiliser des couleurs de base @code{blue},
+@code{green}, @code{red} -- bleu, vert, rouge.
+
+Vous ne pouvez pas coloriser individuellement des notes à l'intérieur
+d'un accord avec @code{\override}. Si besoin est, utilisez
+@code{\tweak} ou @code{\single\override} devant la note en question.
+Pour plus de détails, consultez @ref{La commande d'affinage (tweak)}.
-@node Parentheses
-@unnumberedsubsubsec Parentheses
+@node Parenthèses
+@unnumberedsubsubsec Parenthèses
+@translationof Parentheses
@cindex fantômes, notes
@cindex notes fantômes
@cindex parenthèses, notes entre
+@cindex crochets, notes entre
+
+@funindex \parenthesize
+@funindex parenthesize
Des objets peuvent être mis entre parenthèses en saisissant
-@code{\parenthesize} juste avant l'événement musical.
-
-@lilypond[relative=2,fragment,verbatim,ragged-right]
-<
- c
- \parenthesize d
- g
->4-\parenthesize -.
+@code{\parenthesize} juste avant l'événement musical. Si l'instruction
+préfixe un accord, chaque note le composant se présentera entre
+parenthèses. Vous pouvez aussi mettre individuellement entre
+parenthèses les notes d'un accord.
+
+@lilypond[verbatim,quote,relative=2]
+c2 \parenthesize d
+c2 \parenthesize <c e g>
+c2 <c \parenthesize e g>
@end lilypond
-Ceci n'est opérationnel que dans le cadre d'un accord, qui peut ne
-comprendre qu'une seule note.
+Les objets autres que des notes peuvent aussi être entre parenthèses.
+En ce qui concerne les articulations, l'instruction @code{\parenthesize}
+doit cependant être précédée d'un tiret.
-@example
-< \parenthesize NOTE>
-@end example
+@lilypond[verbatim,quote,relative=2]
+c2-\parenthesize -. d
+c2 \parenthesize r
+@end lilypond
+
+@seealso
+Morceaux choisis :
+@rlsrnamed{Editorial annotations,Annotations éditoriales}.
+
+Référence des propriétés internes :
+@rinternals{Parenthesis_engraver},
+@rinternals{ParenthesesItem},
+@rinternals{parentheses-interface}.
+
+@knownissues
+Lorsqu'un accord est mis entre parenthèses, celles-ci s'appliquent
+individuellement à chacune des notes le composant, alors qu'on
+attendrait une seule paire de parenthèses encadrant tout l'accord.
-@node Stems
-@unnumberedsubsubsec Stems
+@node Hampes
+@unnumberedsubsubsec Hampes
+@translationof Stems
-Dès qu'une note est rencontrée, un objet @rinternals{Stem} se crée
+@cindex hampes
+@cindex hampes invisibles
+@cindex visibilité des hampes
+@cindex masquage des hampes
+@cindex hampe, orientation
+@cindex hampe montante
+@cindex hampe descendante
+@cindex hampe neutre
+
+@funindex \stemUp
+@funindex stemUp
+@funindex \stemDown
+@funindex stemDown
+@funindex \stemNeutral
+@funindex stemNeutral
+
+Dès qu'une note est rencontrée, un objet @code{Stem} se crée
automatiquement. Pour les rondes et les silences, ils sont aussi
créés, mais en mode invisible.
+L'orientation des hampes peut être définie manuellement -- voir
+@ref{Direction et positionnement} à ce sujet.
@predefined
-@funindex \stemUp
@code{\stemUp},
-@funindex \stemDown
@code{\stemDown},
-@funindex \stemNeutral
@code{\stemNeutral}.
@endpredefined
+@snippets
-@commonprop
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
+{default-direction-of-stems-on-the-center-line-of-the-staff.ly}
-Pour changer la direction des hampes au milieu de la portée, utilisez
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
+{automatically-changing-the-stem-direction-of-the-middle-note-based-on-the-melody.ly}
-@lilypond[quote,ragged-right,fragment,relative=2,verbatim]
-a4 b c b
-\override Stem #'neutral-direction = #up
-a4 b c b
-\override Stem #'neutral-direction = #down
-a4 b c b
-@end lilypond
+@seealso
+Manuel de notation :
+@ref{Direction et positionnement}.
+Morceaux choisis :
+@rlsrnamed{Editorial annotations,Annotations éditoriales}.
-@node Outside the staff
-@subsection Outside the staff
+Référence des propriétés internes :
+@rinternals{Stem_engraver},
+@rinternals{Stem},
+@rinternals{stem-interface}.
+@node Hors de la portée
+@subsection Hors de la portée
+@translationof Outside the staff
+
+Nous allons nous intéresser ici à souligner des éléments inscrits dans
+la portée par des éléments qui lui seront externes.
+
@menu
-* Balloon help::
-* Grid lines::
-* Analysis brackets::
-* Blank music sheet::
+* Info-bulle::
+* Quadrillage temporel::
+* Crochets d'analyse::
@end menu
-@node Balloon help
-@unnumberedsubsubsec Balloon help
+
+@node Info-bulle
+@unnumberedsubsubsec Info-bulle
+@translationof Balloon help
+
+@cindex bulle
+@cindex notation, explication
+@cindex info-bulle
+
+@funindex \balloonGrobText
+@funindex \balloonText
+@funindex Balloon_engraver
+@funindex balloonGrobText
+@funindex balloonText
+@funindex \balloonLengthOn
+@funindex balloonLengthOn
+@funindex \balloonLengthOff
+@funindex balloonLengthOff
Vous pouvez marquer et nommer des éléments de notation à l'aide de
bulles. L'objectif premier de cette fonctionnalité est d'expliquer la
-notation.
+notation.
En voici un exemple :
@c KEEP LY
-@lilypond[quote,verbatim,fragment,ragged-right,relative=2]
+@lilypond[verbatim,quote,relative=2]
\new Voice \with { \consists "Balloon_engraver" }
{
\balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
- <c-\balloonText #'(-2 . -2) \markup { Hello } >8
+ a8
+ \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
+ r
+ <c, g'-\balloonText #'(-2 . -2) \markup { "Je suis une tête de note" } c>2.
}
@end lilypond
-@noindent
-Vous disposez de deux fonctions musicales, @code{balloonText} et
-@code{balloonGrobText}. @code{balloonGrobText} prend en argument
-l'objet graphique à agrémenter, alors que @code{balloonText} s'utilise
-comme une simple articulation. Les autres arguments sont le décalage
-et le texte de la bulle.
+Vous disposez de deux fonctions musicales, @code{balloonGrobText} et
+@code{balloonText}. @code{balloonGrobText} prend en argument
+l'objet graphique à agrémenter et s'utilise comme
+@code{\once \override}. @code{balloonText}, quant à lui, s'utilise
+comme une simple articulation et fonctionne comme @code{\tweak} pour
+attacher du texte à l'une des notes d'un accord. Les autres arguments
+sont le décalage et le texte de la bulle.
-@cindex bulles
-@cindex notation, expliquer
+Les info-bulles n'ont aucune influence sur l'espacement des notes ; on
+peut toutefois le gérer ainsi :
+@c KEEP LY
+@lilypond[verbatim,quote,relative=2]
+\new Voice \with { \consists "Balloon_engraver" }
+{
+ \balloonGrobText #'Stem #'(3 . 4) \markup { "Je suis une hampe" }
+ a8
+ \balloonGrobText #'Rest #'(-4 . -4) \markup { "Je suis un silence" }
+ r
+ \balloonLengthOn
+ <c, g'-\balloonText #'(-2 . -2) \markup { "Je suis une tête de note" } c>2.
+}
+@end lilypond
+
+@predefined
+@code{\balloonLengthOn},
+@code{\balloonLengthOff}.
+@endpredefined
@seealso
-Référence du programme : @rinternals{balloon-interface}.
+Morceaux choisis :
+@rlsrnamed{Editorial annotations,Annotations éditoriales}.
+
+Référence des propriétés internes :
+@rinternals{Balloon_engraver},
+@rinternals{BalloonTextItem},
+@rinternals{balloon-interface}.
+
+
+@node Quadrillage temporel
+@unnumberedsubsubsec Quadrillage temporel
+@translationof Grid lines
+@cindex quadrillage temporel
+@cindex temporel, quadrillage
-@node Grid lines
-@unnumberedsubsubsec Grid lines
+@funindex Grid_point_engraver
+@funindex Grid_line_span_engraver
+@funindex gridInterval
Vous pouvez tracer des lignes entre les portées, synchronisées avec
les notes.
+
+LilyPond a recours à deux graveurs distincts afin d'afficher le
+quadrillage : le @code{Grid_point_engraver} se charge de
+déterminer l'envergure du crochet, alors que le
+@code{Grid_line_span_engraver} se consacrera au tracé des lignes.
+Les lignes sont par défaut centrées horizontalement sous les notes et
+alignées sur la gauche des têtes. La propriété @code{gridInterval}
+spécifie quant à elle l'espace de temps entre chaque ligne.
+
@c KEEP LY
-@lilypond[ragged-right,quote,verbatim]
+@lilypond[verbatim,quote]
\layout {
\context {
\Staff
\consists "Grid_point_engraver" %% active les guides
- gridInterval = #(ly:make-moment 1 4)
+ gridInterval = #(ly:make-moment 1/4)
+ }
+ \context {
+ \Score
+ \consists "Grid_line_span_engraver"
+ %% centre les lignes guides horizontalement sous les notes
}
}
-\new Score \with {
- \consists "Grid_line_span_engraver"
- %% centre les lignes guides horizontalement sous les notes
- \override NoteColumn #'X-offset = #-0.5
-}
-
-\new ChoirStaff <<
- \new Staff {
- \stemUp
- \relative {
- c'4. d8 e8 f g4
+\score {
+ \new ChoirStaff <<
+ \new Staff \relative {
+ \stemUp
+ c'''4. d8 e8 f g4
}
- }
- \new Staff {
+ \new Staff \relative {
%% centre les lignes guides verticalement
- \override Score.GridLine #'extra-offset = #'( 0.0 . 1.0 )
- \stemDown
- \clef bass
- \relative c {
+ \clef bass
+ \stemDown
c4 g' f e
}
- }
->>
+ >>
+}
@end lilypond
-Exemples : @rlsr{Editorial annotations}.
+@snippets
+
+@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
+{grid-lines--changing-their-appearance.ly}
+
+@seealso
+Morceaux choisis :
+@rlsrnamed{Editorial annotations,Annotations éditoriales}.
+
+Référence des propriétés internes :
+@rinternals{Grid_line_span_engraver},
+@rinternals{Grid_point_engraver},
+@rinternals{GridLine},
+@rinternals{GridPoint},
+@rinternals{grid-line-interface},
+@rinternals{grid-point-interface}.
-@node Analysis brackets
-@unnumberedsubsubsec Analysis brackets
+@node Crochets d'analyse
+@unnumberedsubsubsec Crochets d'analyse
+@translationof Analysis brackets
+
@cindex crochets
@cindex crochets de phrasé
@cindex analyse musicologique
@cindex crochet de regroupement de notes
+@funindex Horizontal_bracket_engraver
+@funindex \startGroup
+@funindex startGroup
+@funindex \stopGroup
+@funindex stopGroup
+
On utilise des crochets en analyse musicale, pour indiquer la
-structure d'une pièce. LilyPond permet d'utiliser une forme
-simplifiée de crochets horizontaux imbriqués, dans la mesure où le
-contexte @rinternals{Staff} comporte le graveur
-@rinternals{Horizontal_bracket_engraver}. Un crochet s'ouvre avec
-@code{\startGroup}, et se ferme avec @code{\stopGroup}.
+structure d'une pièce.
-@lilypond[quote,ragged-right,verbatim]
-\score {
- \relative c'' {
- c4\startGroup\startGroup
- c4\stopGroup
- c4\startGroup
- c4\stopGroup\stopGroup
+@lilypond[verbatim,quote]
+\layout {
+ \context {
+ \Voice
+ \consists "Horizontal_bracket_engraver"
}
- \layout {
- \context {
- \Staff \consists "Horizontal_bracket_engraver"
-}}}
+}
+\relative {
+ c''2\startGroup
+ d\stopGroup
+}
@end lilypond
+Les crochets d'analyses sont susceptibles d'être imbriqués :
-@seealso
-Référence du programme : @rinternals{HorizontalBracket}.
-
-
-@node Blank music sheet
-@unnumberedsubsubsec Blank music sheet
-
-@cindex Papier musique
-@cindex Portées, feuille blanche
-
-Une feuille de papier musique s'obtient en utilisant des notes
-invisibles, et en invalidant le @code{Bar_number_engraver}.
-
-@c KEEP LY
-@lilypond[quote,verbatim]
-\layout{ indent = #0 }
-emptymusic = {
- \repeat unfold 2 % À modifier pour plus de lignes.
- { s1\break }
- \bar "|."
+@lilypond[verbatim,quote]
+\layout {
+ \context {
+ \Voice
+ \consists "Horizontal_bracket_engraver"
+ }
+}
+\relative {
+ c''4\startGroup\startGroup
+ d4\stopGroup
+ e4\startGroup
+ d4\stopGroup\stopGroup
}
-\new Score \with {
- \override TimeSignature #'transparent = ##t
-% décommenter la ligne suivante selon besoin
-% \override Clef #'transparent = ##t
- defaultBarType = #""
- \remove Bar_number_engraver
-} <<
-
-% à adapter selon les portées désirées
- \new Staff \emptymusic
- \new TabStaff \emptymusic
->>
@end lilypond
-
+@seealso
+Morceaux choisis :
+@rlsrnamed{Editorial annotations,Annotations éditoriales}.
+
+Référence des propriétés internes :
+@rinternals{Horizontal_bracket_engraver},
+@rinternals{HorizontalBracket},
+@rinternals{horizontal-bracket-interface},
+@rinternals{Staff}.
projects / lilypond.git / blobdiff