+@rlsrnamed{Winds,Vents}
+
+
+@node Bois
+@subsection Bois
+@translationof Woodwinds
+
+Nous allons ici nous intéresser aux spécificités de la section des bois.
+
+@menu
+* Diagrammes pour bois::
+@end menu
+
+@node Diagrammes pour bois
+@subsubsection Diagrammes pour bois
+@translationof Woodwind diagrams
+
+Les doigtés pour obtenir une note particulière peuvent s'afficher sous
+forme graphique. LilyPond dispose de diagrammes pour la plupart des
+bois, et tout particulièrement les instruments suivants@tie{}:
+
+@itemize
+@item piccolo
+@item flûte
+@item hautbois
+@item clarinette
+@item clarinette basse
+@item saxophone
+@item basson
+@item contrebasson
+@end itemize
+
+@noindent
+Les diagrammes sont générés en tant qu'objet de type
+@emph{markup}@tie{}:
+
+@lilypond[verbatim,quote,relative=2]
+c1^\markup
+ \woodwind-diagram #'piccolo #'((lh . (gis))
+ (cc . (one three))
+ (rh . (ees)))
+@end lilypond
+
+Les clés ou trous peuvent être partiellement enfoncés ou bouchés@tie{}:
+
+@c KEEP LY
+@lilypond[verbatim, quote, relative=2]
+\textLengthOn
+c1^\markup {
+ \center-column {
+ "quart de trou"
+ \woodwind-diagram #'flute #'((cc . (one1q))
+ (lh . ())
+ (rh . ()))
+ }
+}
+
+c1^\markup {
+ \center-column {
+ "demi-trou"
+ \woodwind-diagram #'flute #'((cc . (one1h))
+ (lh . ())
+ (rh . ()))
+ }
+}
+
+c1^\markup {
+ \center-column {
+ "trois quarts de trou"
+ \woodwind-diagram #'flute #'((cc . (one3q))
+ (lh . ())
+ (rh . ()))
+ }
+}
+
+c1^\markup {
+ \center-column {
+ "anneau"
+ \woodwind-diagram #'flute #'((cc . (oneR))
+ (lh . ())
+ (rh . ()))
+ }
+}
+
+c1^\markup {
+ \center-column {
+ "bouché"
+ \woodwind-diagram #'flute #'((cc . (oneF two))
+ (lh . ())
+ (rh . ()))
+ }
+}
+@end lilypond
+
+L'indication du doigté permettant de triller s'obtient en grisant une
+position@tie{}:
+
+@lilypond[verbatim,quote,relative=2]
+c1^\markup {
+ \woodwind-diagram #'bass-clarinet
+ #'((cc . (threeT four))
+ (lh . ())
+ (rh . (b fis)))
+}
+@end lilypond
+
+Certaines combinaisons particulières en matière de trille sont
+possibles@tie{}:
+
+@c KEEP LY
+@lilypond[verbatim,quote,relative=2]
+\textLengthOn
+c1^\markup {
+ \center-column {
+ "quart de trou et anneau"
+ \woodwind-diagram #'flute #'((cc . (one1qTR))
+ (lh . ())
+ (rh . ()))
+ }
+}
+
+c1^\markup {
+ \center-column {
+ "anneau et fermé"
+ \woodwind-diagram #'flute #'((cc . (oneTR))
+ (lh . ())
+ (rh . ()))
+ }
+}
+
+c1^\markup {
+ \center-column {
+ "anneau et ouvert"
+ \woodwind-diagram #'flute #'((cc . (oneRT))
+ (lh . ())
+ (rh . ()))
+ }
+}
+
+c1^\markup {
+ \center-column {
+ "ouvert et fermé"
+ \woodwind-diagram #'flute #'((cc . (oneT))
+ (lh . ())
+ (rh . ()))
+ }
+}
+
+c1^\markup {
+ \center-column {
+ "quart de trou et trois quarts"
+ \woodwind-diagram #'flute #'((cc . (one1qT3q))
+ (lh . ())
+ (rh . ()))
+ }
+}
+@end lilypond
+
+Bien que cela ne produise pas de notation, vous pouvez obtenir à l'écran
+ou dans un fichier de journalisation la liste de toutes les possibilités
+pour un instrument donné, en utilisant dans un fichier
+
+@lilypond[verbatim,quote]
+
+#(print-keys-verbose 'flute)
+
+@end lilypond
+
+De nouveaux diagrammes sont réalisables, en suivant les directives
+contenues dans les fichiers @file{scm/define-woodwind-diagrams.scm} et
+@file{scm/display-woodwind-diagrams.scm}. Ceci requiert toutefois la
+maîtrise du langage Scheme.
+
+
+@snippets
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{woodwind-diagrams-listing.ly}
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{graphical-and-text-woodwind-diagrams.ly}
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{changing-the-size-of-woodwind-diagrams.ly}
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{woodwind-diagrams-key-lists.ly}
+
+@seealso
+
+Fichiers d'initialisation :
+@file{scm/define-woodwind-diagrams.scm},
+@file{scm/display-woodwind-diagrams.scm}.
+
+Morceaux choisis :
+@rlsrnamed{Winds,Vents}.
+
+Référence des propriétés internes :
+@rinternals{TextScript},
+@rinternals{instrument-specific-markup-interface}.
+