LilyPond Notation Reference: 2.6.3.1 Woodwind diagrams

#### 2.6.3.1 Woodwind diagrams

Woodwind diagrams can be used to indicate the fingering to be used for specific notes and are available for the following instruments:

- piccolo
- flute
- oboe
- clarinet
- bass clarinet
- saxophone
- bassoon
- contrabassoon

Woodwind diagrams are created as markups:

>     c1^\markup {
>       \woodwind-diagram #'piccolo #'((lh . (gis))
>                                      (cc . (one three))
>                                      (rh . (ees)))
>     }

Keys can be open, partially-covered, ring-depressed, or fully covered:

>     \textLengthOn
>     c1^\markup {
>       \center-column {
>         "one quarter"
>         \woodwind-diagram #'flute #'((cc . (one1q))
>                                      (lh . ())
>                                      (rh . ()))
>       }
>     }

>     c1^\markup {
>       \center-column {
>         "one half"
>         \woodwind-diagram #'flute #'((cc . (one1h))
>                                      (lh . ())
>                                      (rh . ()))
>       }
>     }

>     c1^\markup {
>       \center-column {
>         "three quarter"
>         \woodwind-diagram #'flute #'((cc . (one3q))
>                                      (lh . ())
>                                      (rh . ()))
>       }
>     }

>     c1^\markup {
>       \center-column {
>         "ring"
>         \woodwind-diagram #'flute #'((cc . (oneR))
>                                      (lh . ())
>                                      (rh . ()))
>       }
>     }

>     c1^\markup {
>       \center-column {
>         "full"
>         \woodwind-diagram #'flute #'((cc . (oneF two))
>                                      (lh . ())
>                                      (rh . ()))
>       }
>     }

Trills are indicated as shaded keys:

>     c1^\markup {
>       \woodwind-diagram #'bass-clarinet
>                         #'((cc . (threeT four))
>                            (lh . ())
>                            (rh . (b fis)))
>     }

A variety of trills can be displayed:

>     \textLengthOn
>     c1^\markup {
>       \center-column {
>         "one quarter to ring"
>         \woodwind-diagram #'flute #'((cc . (one1qTR))
>                                      (lh . ())
>                                      (rh . ()))
>       }
>     }

>     c1^\markup {
>       \center-column {
>         "ring to shut"
>         \woodwind-diagram #'flute #'((cc . (oneTR))
>                                      (lh . ())
>                                      (rh . ()))
>       }
>     }

>     c1^\markup {
>       \center-column {
>         "ring to open"
>         \woodwind-diagram #'flute #'((cc . (oneRT))
>                                      (lh . ())
>                                      (rh . ()))
>       }
>     }

>     c1^\markup {
>       \center-column {
>         "open to shut"
>         \woodwind-diagram #'flute #'((cc . (oneT))
>                                      (lh . ())
>                                      (rh . ()))
>       }
>     }

>     c1^\markup {
>       \center-column {
>         "one quarter to three quarters"
>         \woodwind-diagram #'flute #'((cc . (one1qT3q))
>                                      (lh . ())
>                                      (rh . ()))
>       }
>     }

The list of all possible keys and settings for a given instrument can be displayed on the console or in the log file, although they will not show up in the music output:

>     #(print-keys-verbose 'flute)

New diagrams can be created by following the patterns in ‘`scm/define-woodwind-diagrams.scm`’ and ‘`scm/display-woodwind-diagrams.scm`’. However, this will require Scheme ability and may not be accessible to all users.

#### Predefined commands

#### Selected Snippets

Woodwind diagrams listing

The following music shows all of the woodwind diagrams currently defined in LilyPond.

>     \relative c' {
>       \textLengthOn
>       c1^
>       \markup {
>         \center-column {
>           'piccolo
>           " "
>            \woodwind-diagram
>                       #'piccolo
>                       #'()
>         }
>       }

>       c1^
>       \markup {
>         \center-column {
>            'flute
>            " "
>            \woodwind-diagram
>               #'flute
>               #'()
>         }
>       }
>       c1^\markup {
>         \center-column {
>           'oboe
>           " "
>           \woodwind-diagram
>             #'oboe
>             #'()
>         }
>       }

>       c1^\markup {
>         \center-column {
>           'clarinet
>           " "
>           \woodwind-diagram
>             #'clarinet
>             #'()
>         }
>       }

>       c1^\markup {
>         \center-column {
>           'bass-clarinet
>           " "
>           \woodwind-diagram
>             #'bass-clarinet
>             #'()
>         }
>       }

>       c1^\markup {
>         \center-column {
>           'saxophone
>           " "
>           \woodwind-diagram
>             #'saxophone
>             #'()
>         }
>       }

>       c1^\markup {
>         \center-column {
>           'bassoon
>           " "
>           \woodwind-diagram
>             #'bassoon
>             #'()
>         }
>       }

>       c1^\markup {
>         \center-column {
>           'contrabassoon
>           " "
>           \woodwind-diagram
>             #'contrabassoon
>             #'()
>         }
>       }
>     }

Graphical and text woodwind diagrams

In may cases, the keys other than the central column can be displayed by key name as well as by graphical means.

>     \relative c'' {
>       \textLengthOn
>       c1^\markup
>         \woodwind-diagram
>           #'piccolo
>           #'((cc . (one three))
>              (lh . (gis))
>              (rh . (ees)))

>       c^\markup
>         \override #'(graphical . #f) {
>           \woodwind-diagram
>             #'piccolo
>             #'((cc . (one three))
>                (lh . (gis))
>                (rh . (ees)))
>         }
>     }

Changing the size of woodwind diagrams

The size and thickness of woodwind diagrams can be changed.

>     \relative c'' {
>       \textLengthOn
>       c1^\markup
>         \woodwind-diagram
>           #'piccolo
>           #'()

>       c^\markup
>         \override #'(size . 1.5) {
>           \woodwind-diagram
>             #'piccolo
>             #'()
>         }
>       c^\markup
>         \override #'(thickness . 0.15) {
>           \woodwind-diagram
>             #'piccolo
>             #'()
>         }
>     }

Woodwind diagrams key lists

The snippet below produces a list of all possible keys and key settings for woodwind diagrams as defined in ‘`scm/define-woodwind-diagrams.scm`’. The list will be displayed on the console and in the log file, but not in the music.

>     #(print-keys-verbose 'piccolo)
>     #(print-keys-verbose 'flute)
>     #(print-keys-verbose 'flute-b-extension)
>     #(print-keys-verbose 'oboe)
>     #(print-keys-verbose 'clarinet)
>     #(print-keys-verbose 'bass-clarinet)
>     #(print-keys-verbose 'low-bass-clarinet)
>     #(print-keys-verbose 'saxophone)
>     #(print-keys-verbose 'baritone-saxophone)
>     #(print-keys-verbose 'bassoon)
>     #(print-keys-verbose 'contrabassoon)

#### See also

Installed Files: ‘`scm/define-woodwind-diagrams.scm`’, ‘`scm/display-woodwind-diagrams.scm`’.

Snippets: Winds.

Internals Reference: TextScript, instrument-specific-markup-interface.

Más nyelvek: deutsch, español, français, 日本語.

#### LilyPond — Notation Reference