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

@ignore
    Translation of GIT committish: 3c907f2dd5ba3dd91e30454922d8361225ca28d5

    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.18.0"

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

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

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

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


@predefined
@code{\magnifyMusic},
@code{\teeny},
@code{\tiny},
@code{\small},
@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}.

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 :
@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\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 (@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}.


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

@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{automatically-changing-the-stem-direction-of-the-middle-note-based-on-the-melody.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 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
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}.