-Pour exprimer l'ambitus d'une pièce, on indique avant la clé deux
-notes représentant la hauteur la plus basse et la plus haute. Pour
-imprimer cet ambitus, il faut ajouter le graveur
-@internalsref{Ambitus_engraver} au contexte @internalsref{Voice}. Ainsi,
-
-@example
-\layout @{
- \context @{
- \Voice
- \consists Ambitus_engraver
- @}
-@}
-@end example
-
-@dots{} donne le résultat suivant :
-
-@lilypond[quote,ragged-right]
-\layout {
- \context {
- \Staff
- \consists Ambitus_engraver
- }
-}
-
-\relative \new Staff {
- as'' c e2 cis,2
-}
-@end lilypond
-
-Si plusieurs voix se trouvent sur une même portée, on peut attribuer
-le graveur @internalsref{Ambitus_engraver} plutôt au contexte
-@internalsref{Staff} qu'au contexte @internalsref{Voice} ; l'ambitus
-affiché sera alors celui de toutes les voix cumulées, non d'une
-seule des voix actives.
-
-@lilypond[verbatim,ragged-right,quote]
-\new Staff \with {
- \consists "Ambitus_engraver"
-}
-<<
- \new Voice \with {
- \remove "Ambitus_engraver"
- } \relative c'' {
- \override Ambitus #'X-offset = #-1.0
- \voiceOne
- c4 a d e f2
- }
- \new Voice \with {
- \remove "Ambitus_engraver"
- } \relative c' {
- \voiceTwo
- es4 f g as b2
- }
->>
-@end lilypond
-
-@noindent
-Cet exemple met en œuvre une fonctionnalité avancée :
-
-@example
-\override Ambitus #'X-offset = #-1.0
-@end example
-
-@noindent
-Ce réglage déplace l'ambitus vers la gauche. Le même résultat aurait pu
-être obtenu avec @code{extra-offset}, mais alors la mise en forme
-automatisée n'aurait pas attribué d'espace supplémentaire pour l'objet déplacé.
-
-@seealso
-
-Référence du Programme : @internalsref{Ambitus},
-@internalsref{AmbitusLine}, @internalsref{AmbitusNoteHead},
-@internalsref{AmbitusAccidental}.
-
-Exemples :
-@lsr{vocal,ambitus@/.ly}.
-
-@refbugs
-
-Les collisions ne sont pas gérées si plusieurs ambitus sont présents
-sur une même portée.