Lyrics - LilyPond program-reference
Description: LilyPond program-reference

Next: MensuralStaff, Previous: InnerStaffGroup, Up: Contexts

#### Lyrics

Corresponds to a voice with lyrics. Handles the printing of a single line of lyrics.

This context creates the following layout objects:

InstrumentName, LyricExtender, LyricHyphen, LyricSpace, LyricText, StanzaNumber and VerticalAxisGroup.

This context sets the following properties:

- Set grob-property `bar-size` in BarLine to `0.1`.
- Set grob-property `font-size` in InstrumentName to `1.0`.
- Set grob-property `self-alignment-Y` in InstrumentName to `#f`.
- Set grob-property `padding` in SeparationItem to `0.2`.
- Set grob-property `remove-empty` in VerticalAxisGroup to `#t`.
- Set grob-property `remove-first` in VerticalAxisGroup to `#t`.
- Set translator property `verticalExtent` to `#f`
- Set translator property `extraVerticalExtent` to `#f`
- Set grob-property `minimum-Y-extent` in VerticalAxisGroup to `'(-1.2 . 2.4)`.

This context is a `bottom' context; it can not contain other contexts.

This context is built from the following engravers:

`Hara_kiri_engraver`
  Like Axis_group_engraver, but make a hara-kiri spanner, and add interesting items (ie. note heads, lyric syllables and normal rests)

  Properties (read)

  `keepAliveInterfaces` (list)
    List of symbols, signifying grob interfaces that are worth keeping an staff with `remove-empty` set around for.
  This engraver creates the following layout objects: VerticalAxisGroup.
`Font_size_engraver`
  Puts fontSize into font-size grob property.

  Properties (read)

  `fontSize` (number)
    The relative size of all grobs in a context.
`Skip_event_swallow_translator`
  Swallow \skip.

  Music types accepted:

  skip-event

`Instrument_name_engraver`
  Creates a system start text for instrument or vocal names.

  Properties (read)

  `vocNam` (markup)
    Name of a vocal line, short version.
  `vocalName` (markup)
    Name of a vocal line.
  `instrument` (markup)
    The name to print left of a staff. The `instrument` property labels the staff in the first system, and the `instr` property labels following lines.
  `instr` (markup)
    See `instrument`
  `currentCommandColumn` (layout object)
    Grob that is X-parent to all current breakable (clef, key signature, etc.) items.
  This engraver creates the following layout objects: InstrumentName.
`Stanza_number_engraver`

  Properties (read)

  `stanza` (markup)
    Stanza `number' to print before the start of a verse. Use in Lyrics context.
  This engraver creates the following layout objects: StanzaNumber.
`Hyphen_engraver`
  Create lyric hyphens and distance constraints between words.

  Music types accepted:

  hyphen-event

  This engraver creates the following layout objects: LyricHyphen and LyricSpace.

`Extender_engraver`
  Create lyric extenders

  Music types accepted:

  extender-event

  This engraver creates the following layout objects: LyricExtender.

`Lyric_engraver`

  Music types accepted:

  lyric-event

  This engraver creates the following layout objects: LyricText.

This page is for LilyPond-2.8.8 (stable-branch).

Other languages: English.
Using automatic language selection.