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

@ignore
   Translation of GIT committish: 032de07c17caacd038f113ebcb54e9c473d64e0f

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

@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 notation, taille
@cindex taille des notes
@cindex tête 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

@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 {
  % 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

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 {
  \time 3/4
  d''4---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,fragment]
% the default font-size for NoteHead is 0
% the default font-size for Fingering is -5
c''4-3

\set fontSize = -3
% the effective font size for NoteHead is now -3
% the effective font size for Fingering is now -8
c''4-3

\override Fingering.font-size = 0
% the effective font size for Fingering is now -3
c''4-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 c'' {
  \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 de note
@cindex note, 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{Définition de la taille de portée},
@ref{Mise en forme d'une citation},
@ref{Portées d'ossia},
@ref{Sélection de la fonte et de la taille}.

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 https://sourceforge.net/p/testlilyissues/issues/3987/
@c https://sourceforge.net/p/testlilyissues/issues/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

Les doigtés peuvent être indiqués comme suit :
@var{note}-@var{chiffre_du_doigt}

@lilypond[verbatim,quote]
\relative { c''4-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 {
  c''4-1 d-2 f\finger \markup \tied-lyric "4~3" c\finger "2 - 3"
}
@end lilypond

@cindex pouce, doigté

@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 { <a'_\thumb a'-3>2 <b_\thumb b'-3> }
@end lilypond

@cindex doigté d'accord
@cindex accord, doigté

Les doigtés des accords peuvent être saisis note par note, en les
indiquant après chaque hauteur de note.

@lilypond[verbatim,quote]
\relative {
  <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

@cindex doigté, positionnement
@cindex positionnement, doigté
@funindex fingeringOrientations
@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{controlling-the-placement-of-chord-fingerings.ly}

@cindex doigté, dans la portée
@lilypondfile[verbatim,quote,texidoc,doctitle]
{allowing-fingerings-to-be-printed-inside-the-staff.ly}

@cindex collision, doigté d'accord
@cindex doigté, accord, collision
@funindex fingeringOrientations
@funindex stringNumberOrientations
@funindex strokeFingerOrientations
@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{Fingering},
@rinternals{Fingering_engraver},
@rinternals{fingering-event},
@rinternals{FingeringEvent},
@rinternals{New_fingering_engraver}.


@node Dictée à trous
@unnumberedsubsubsec Dictée à trous
@translationof Hidden notes

@cindex masquée, note
@cindex invisible, note
@cindex transparente, note
@cindex note invisible
@cindex note masquée

@funindex \hideNotes
@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 {
  c''4 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 c'' {
  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{Masquage de portées},
@ref{Silences invisibles},
@ref{Visibilité des objets}.

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 objet en couleur
@cindex couleur
@cindex colorisation d'objet
@cindex coloration d'objet
@cindex coloration de note
@cindex colorisation de note
@cindex note en couleur
@cindex x11, couleur
@cindex couleur x11

@funindex color
@funindex \with-color
@funindex x11-color

Des objets peuvent être colorisés individuellement.  Une liste des
noms des couleurs disponibles se trouve à l'annexe
@ref{Liste des couleurs}.

@lilypond[verbatim,quote,fragment]
\override NoteHead.color = #red
c''4 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]
\new Staff \with {
  instrumentName = \markup {
    \with-color #(x11-color 'red) "Clarinet"
    }
  }

  \relative c'' {
  \override Staff.StaffSymbol.color = #(x11-color 'SlateBlue2)
  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 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]
\new Staff \with {
  instrumentName = \markup {
    \with-color #(x11-color 'red) "Clarinet"
    }
  }
  \relative c'' {
  \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{La commande d'affinage (tweak)},
@ref{Liste des couleurs}.

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

@cindex x11, couleur
@cindex couleur, note d'un accord
@cindex note colorisée dans un accord
@cindex accord 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ôme, note
@cindex note fantôme
@cindex parenthèses, note entre
@cindex crochets, note entre

@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 {
  c''2 \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 {
  c''2-\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 hampe
@cindex hampe invisible
@cindex visibilité des hampes
@cindex masquage de hampe
@cindex hampe, orientation
@cindex hampe montante
@cindex hampe descendante
@cindex hampe neutre

@funindex \stemUp
@funindex \stemDown
@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

@cindex hampe,ligne médiane, direction
@cindex ligne médiane, hampe, direction
@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 \balloonLengthOn
@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]
\new Voice \with { \consists "Balloon_engraver" }
\relative c'' {
  \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]
\new Voice \with { \consists "Balloon_engraver" }
\relative c'' {
  \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 {
      \stemUp
      c''4. d8 e8 f g4
    }
    \new Staff \relative {
    %% centre les lignes guides verticalement
      \clef bass
      \stemDown
      c4  g'  f  e
    }
  >>
}
@end lilypond

@snippets

@cindex quadrillage temporel, apparence
@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 crochet
@cindex crochet de phrasé
@cindex analyse musicologique
@cindex crochet de regroupement de notes
@cindex musicologie, crochet d'analyse

@funindex Horizontal_bracket_engraver
@funindex \startGroup
@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''2\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''4\startGroup\startGroup
  d4\stopGroup
  e4\startGroup
  d4\stopGroup\stopGroup
}
@end lilypond

@snippets

@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{analysis-brackets-above-the-staff.ly}

@cindex étiquette, crochet d'analyse
@cindex analyse, crochet, étiquette
@funindex HorizontalBracketText
@lilypondfile[verbatim,quote,ragged-right,texidoc,doctitle]
{analysis-brackets-with-labels.ly}


@seealso
Référence des propriétés internes :
@rinternals{Horizontal_bracket_engraver},
@rinternals{HorizontalBracket},
@rinternals{horizontal-bracket-interface},
@rinternals{HorizontalBracketText},
@rinternals{horizontal-bracket-text-interface},
@rinternals{Staff}.
