Clef - LilyPond program-reference
Description: LilyPond program-reference

Next: ClusterSpanner, Previous: ChordName, Up: All layout objects

#### Clef

Clef objects are created by: Clef_engraver

Standard settings:

`breakable` (boolean):
  `#t`

  Can this object appear at a line break, like clefs and bar lines?

`font-family` (symbol):
  `'music`

  The font family is the broadest category for selecting text fonts. Options include: `sans`, `roman`

`break-align-symbol` (symbol):
  `'clef`

  This key is used for aligning and spacing breakable items.

`break-visibility` (vector):
  `#(#f #f #t)`

  A vector of 3 booleans, #(end-of-line unbroken begin-of-line). #t means visible, #f means killed.

`space-alist` (list):
  `'((ambitus extra-space . 2.0) (staff-bar extra-space . 0.7) (key-cancellation minimum-space . 3.5) (key-signature minimum-space . 3.5) (time-signature minimum-space . 4.2) (first-note minimum-fixed-space . 5.0) (next-note extra-space . 0.5) (right-edge extra-space . 0.5))`

  A table that specifies distances between prefatory items, like clef and time-signature. The format is an alist of spacing tuples: `(`break-align-symbol type`.` distance`)`, where type can be the symbols `minimum-space` or `extra-space`.

`Y-offset` (number):
  `ly:staff-symbol-referencer::callback`

  The vertical amount that this object is moved relative to its Y-parent

This object supports the following interfaces: break-aligned-interface, font-interface, staff-symbol-referencer-interface, clef-interface, item-interface and grob-interface

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

Other languages: English.
Using automatic language selection.