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

@ignore
    Translation of GIT committish: f8e7ac6dcdc5255d0c409ca68407f04dc8b98b99

    When revising a translation, copy the HEAD committish of the
    version that you are working on.  For details, see the Contributors'
    Guide, node Updating translation committishes..
@end ignore

@c \version "2.17.6"

@c Translators: Jean-Charles Malahieude

@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
* Dans la portée::
* Hors de la portée::
@end menu


@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
* Indication de la taille de fonte musicale::
* Doigtés::
* Dictée à trous::
* Coloration d'objets::
* Parenthèses::
* Hampes::
@end menu


@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 magstep
@funindex \huge
@funindex \large
@funindex \normalsize
@funindex \small
@funindex \tiny
@funindex \teeny
@funindex huge
@funindex large
@funindex normalsize
@funindex small
@funindex tiny
@funindex teeny

Le plus sûr moyen de régler la taille de la police, quel que soit le
contexte, consiste à définir la propriété @code{fontSize}.
Ceci ne modifiera en rien la taille des différents symboles tels que
ligatures ou liaisons.

@warning{En matière de taille des éléments textuels, référez-vous au
chapitre @ref{Sélection de la fonte et de la taille}.}

@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

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 % 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[verbatim,quote,relative=2]
\set fontSize = #3
c4.-> d8---3
\override NoteHead.font-size = #-4
c4.-> d8---3
\override Script.font-size = #2
c4.-> d8---3
\override Stem.font-size = #-5
c4.-> d8---3
@end lilypond

@cindex standard, taille des notes
@cindex notes, taille standard

@funindex font-interface
@funindex font-size

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
10 points.

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}.

@predefined
@code{\teeny},
@code{\tiny},
@code{\small},
@code{\normalsize},
@code{\large},
@code{\huge}.
@endpredefined

@seealso
Morceaux choisis :
@rlsrnamed{Editorial annotations,Annotations éditoriales}.

Référence des propriétés internes :
@rinternals{font-interface}.


@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 :
@var{note}-@var{chiffre_du_doigt}

@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[verbatim,quote,relative=2]
c4-1 d-2 f-4 c^\markup { \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 (@emph{thumb} en anglais).

@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[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.

@snippets

@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{controlling-the-placement-of-chord-fingerings.ly}

@lilypondfile[verbatim,quote,texidoc,doctitle]
{allowing-fingerings-to-be-printed-inside-the-staff.ly}

@lilypondfile[verbatim,quote,texidoc,doctitle]
{avoiding-collisions-with-chord-fingerings.ly}

@seealso
Manuel de notation :
@ref{Direction et positionnement}.

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}.

@knownissues
La syntaxe @samp{@var{note}-@var{digit}} ne prend pas en charge, par
défaut, les chiffres supérieurs à 9.


@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
@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[verbatim,quote,relative=2]
c4 d
\hideNotes
e4 f
\unHideNotes
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.

@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{Liste des couleurs}.

@lilypond[verbatim,quote,relative=2]
\override NoteHead.color = #red
c4 c
\override NoteHead.color = #(x11-color 'LimeGreen)
d
\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 @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.

@lilypond[verbatim,quote,relative=2]
\override Staff.StaffSymbol.color = #(x11-color 'SlateBlue2)
\set Staff.instrumentName = \markup {
  \with-color #(x11-color 'navy) "Clarinet"
}

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

@cindex rgb-color
@cindex couleur rgb
@cindex couleur rvb
@cindex rgb, couleur
@cindex rvb, couleur

@funindex rgb-color

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[verbatim,quote,relative=2]
\override Staff.StaffSymbol.color = #(x11-color 'SlateBlue2)
\set Staff.instrumentName = \markup {
  \with-color #(x11-color 'navy) "Clarinet"
}

\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
Manuel de notation :
@ref{Liste des couleurs},
@ref{La commande d'affinage (tweak)}.

Morceaux choisis :
@rlsrnamed{Editorial annotations,Annotations éditoriales}.

@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.

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 des notes à l'intérieur d'un accord avec
@code{\override}.  Si besoin est, utilisez @code{\tweak}.  Pour plus de
détails, consultez @ref{La commande d'affinage (tweak)}.


@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.  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

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.

@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 Hampes
@unnumberedsubsubsec Hampes
@translationof Stems

@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
@code{\stemUp},
@code{\stemDown},
@code{\stemNeutral}.
@endpredefined

@snippets

@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{default-direction-of-stems-on-the-center-line-of-the-staff.ly}


@seealso
Manuel de notation :
@ref{Direction et positionnement}.

Morceaux choisis :
@rlsrnamed{Editorial annotations,Annotations éditoriales}.

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
* Info-bulle::
* Quadrillage temporel::
* Crochets d'analyse::
@end menu


@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.

En voici un exemple :
@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
  <c, g'-\balloonText #'(-2 . -2) \markup { "Je suis une tête de note" } c>2.
}
@end lilypond

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.

Les info-bulles ont une influence sur les espacements, que l'on peut
gérer ainsi :

@c KEEP LY
@lilypond[verbatim,quote,relative=2]
\new Voice \with { \consists "Balloon_engraver" }
{
  \balloonLengthOff
  \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
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

@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[verbatim,quote]
\layout {
  \context {
    \Staff
    \consists "Grid_point_engraver" %% active les guides
    gridInterval = #(ly:make-moment 1 4)
  }
  \context {
    \Score
    \consists "Grid_line_span_engraver"
     %% centre les lignes guides horizontalement sous les notes
  }
}

\score {
  \new ChoirStaff <<
    \new Staff \relative c'' {
      \stemUp
      c'4. d8 e8 f g4
    }
    \new Staff \relative c {
    %% centre les lignes guides verticalement
      \clef bass
      \stemDown
      c4  g'  f  e
    }
  >>
}
@end lilypond

@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 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[verbatim,quote]
\layout {
  \context {
    \Voice
    \consists "Horizontal_bracket_engraver"
  }
}
\relative c'' {
  c2\startGroup
  d\stopGroup
}
@end lilypond

Les crochets d'analyses sont susceptibles d'être imbriqués :

@lilypond[verbatim,quote]
\layout {
  \context {
    \Voice
    \consists "Horizontal_bracket_engraver"
  }
}
\relative c'' {
  c4\startGroup\startGroup
  d4\stopGroup
  e4\startGroup
  d4\stopGroup\stopGroup
}
@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}.