[ << Backend ]	[Top][Contents][Index]	[ Scheme functions >> ]
[ < note-column-interface ]	[ Up: Graphical Object Interfaces ]	[ note-name-interface > ]

---

3.2.101 note-head-interface

A note head. There are many possible values for style. For a complete list, see Note head styles.

The sense of the direction property is the direction of the stem that the head is designed to attach to. For certain glyphs, this might seem counterintuitive. Note that stems do not adapt to forced changes in head direction, so even when a head style has direction-dependent glyphs, proper attachment to the stem depends on the design of the font.

User-settable properties:

direction (direction)

If side-axis is 0 (or X), then this property determines whether the object is placed LEFT, CENTER or RIGHT with respect to the other object. Otherwise, it determines whether the object is placed UP, CENTER or DOWN. Numerical values may also be used: UP=1, DOWN=-1, LEFT=-1, RIGHT=1, CENTER=0.

duration-log (integer)

The 2-log of the note head duration, i.e., 0 = whole note, 1 = half note, etc.

glyph-name (string)

The glyph name within the font.

In the context of (span) bar lines or clefs, glyph-name represents a processed form of glyph, where decisions about line breaking, etc., are already taken.

ignore-ambitus (boolean)

If set, don’t consider this notehead for ambitus calculation.

ledger-extra (dimension, in staff space)

A distance relative to a note head’s vertical position to modify the range where ledger lines are drawn, depending on the actually used ledger line positions. If positive, this range gets extended, possibly adding extra ledger lines. If negative, the range gets reduced, possibly removing ledger lines.

ledger-positions (list)

A list of vertical positions of ledger lines. Its exact behaviour depends on the grob; see StaffSymbol, NoteHead, Custos, and Script.

note-names (vector)

Vector of strings containing names for easy-notation note heads.

stem-attachment (pair of numbers)

An (x . y) pair where the stem attaches to the note head. Each component is measured in a -1 to 1 scale so that -1 is the left/bottom edge of the note’s bounding box and 1 is the right/top edge.

style (symbol)

This setting determines in what style a grob is typeset. Valid choices depend on the stencil callback reading this property.

Internal properties:

accidental-grob (graphical (layout) object)

The accidental for this note.

This grob interface is used in the following graphical object(s): AmbitusNoteHead, ApproximatePitchNoteHead, NoteHead, TabNoteHead and TrillPitchHead.