[ << Notation musicale générale ]	[Top][Contents][Index]	[ Notation spécialisée >> ]
[ < Coloration d’objets ]	[ Up : Dans la portée ]	[ Parenthèses > ]

---

Surlignage de portées

Pour des besoins pédagogiques ou d’analyse, il peut être utile de mettre en évidence un fragment musical comme, par exemple, pour indiquer une modulation. Ceci peut se réaliser à l’aide de la commande \staffHighlight complétée d’une couleur – pour les manières de saisir des couleurs, voir Coloration d’objets. Le surlignage s’interrompt par la commande \stopStaffHighlight.

\relative {
  \time 2/4
  c'4 4
  \staffHighlight "lightsteelblue"
  g'8( fis g4)-.
  \stopStaffHighlight
  c2
}

Lorsque plusieurs surlignages se succèdent, nul n’est besoin de stipuler un \stopStaffHighlight, dans la mesure où \staffHighlight interrompt implicitement l’éventuel surlignage en cours. Il n’est pas non plus nécessaire de positionner un \stopStaffHighlight. Ces manières implicites de terminer un surlignage sont particulièrement adaptées lorsque chaque mesure est surlignée.

\relative {
  \time 2/4
  \staffHighlight "lightpink"
  c'4 4
  \staffHighlight "lightsteelblue"
  g'8( fis g4)-.
  \staffHighlight "lightpink"
  c2
}

Les portées sont par défaut surlignées de manière indépendante.

music = {
  \time 2/4
  \staffHighlight "lightpink"
  c'4 4
  \staffHighlight "lightsteelblue"
  g'8( fis g4)-.
  \staffHighlight "lightpink"
  c2
}

<<
  \new Staff \music
  \new Staff \music
>>

Plusieurs portées peuvent toutefois être surlignées de concert dès lors que le Staff_highlight_engraver aura été déplacé dans un contexte supérieur à Staff (ou bien RhythmicStaff ou similaire). Il suffit en pareil cas d’utiliser les commandes \consists et \remove – see Modification des greffons de contexte pour de plus amples informations. Le surlignage de toutes les portées s’obtient donc en déplaçant le graveur dans le contexte Score.

\layout {
  \context {
    \Staff
    \remove Staff_highlight_engraver
  }
  \context {
    \Score
    \consists Staff_highlight_engraver
  }
}

music = {
  \time 2/4
  \staffHighlight "lightpink"
  c'4 4
  \staffHighlight "lightsteelblue"
  g'8( fis g4)-.
  \staffHighlight "lightpink"
  c2
}

<<
  \new Staff \music
  \new Staff \music
>>

Le Staff_highlight_engraver peut aussi être déplacé dans des contextes intermédiaires comme un StaffGroup.

music = {
  \time 2/4
  \staffHighlight "lightpink"
  c'4 4
  \staffHighlight "lightsteelblue"
  g'8( fis g4)-.
  \staffHighlight "lightpink"
  c2
}

<<
  \new StaffGroup \with { \consists Staff_highlight_engraver } <<
    \new Staff \with { \remove Staff_highlight_engraver } \music
    \new Staff \with { \remove Staff_highlight_engraver } \music
  >>
  \new Staff \music
>>

La propriété StaffHighlight.shorten-pair permet d’ajuster les points de début et de fin de l’étendue du surlignage.

{
  c'1
  \once \override Staff.StaffHighlight.shorten-pair = #'(1.0 . 1.0)
  \staffHighlight lightsteelblue
  c'1
}

Commandes prédéfinies

\staffHighlight, \stopStaffHighlight.

Voir aussi

Manuel de notation : Coloration d’objets, Modification des greffons de contexte.

Référence des propriétés internes : StaffHighlight, staff-highlight-interface, Staff_highlight_engraver, StaffHighlightEvent, staff-highlight-event.

Problèmes connus et avertissements

Le surlignage peut se révéler quelque peu hasardeux en présence d’une barre de début de reprise. La propriété shorten-pair vue ci-dessus permet alors de contourner le problème.

{
  \staffHighlight "lightsteelblue"
  c'1
  \stopStaffHighlight
  \repeat volta 2 { c'1 }
  c'1
}