[ << Backend ]	[Top][Contents][Index]	[ Scheme functions >> ]
[ < AmbitusNoteHead ]	[ Up: All layout objects ]	[ Arpeggio > ]

---

3.1.9 ApproximatePitchNoteHead

A note head for a pitch that cannot be notated with certainty. See also NoteHead.

ApproximatePitchNoteHead objects are created by the following engraver(s): Note_heads_engraver.

Standard settings:

bend-me (boolean):

'()

Decide whether this grob is bent.

direction (direction):

note-head::calc-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):

note-head::calc-duration-log

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

extra-spacing-height (pair of numbers):

ly:note-head::include-ledger-line-height

In the horizontal spacing problem, we increase the height of each item by this amount (by adding the ‘car’ to the bottom of the item and adding the ‘cdr’ to the top of the item). In order to make a grob infinitely high (to prevent the horizontal spacing problem from placing any other grobs above or below this grob), set this to (-inf.0 . +inf.0).

glyph-name (string):

note-head::calc-glyph-name

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.

no-ledgers (boolean):

#t

If set, don’t draw ledger lines on this object.

parenthesis-friends (list):

'(accidental-grob dot)

A list of Grob types, as symbols. When parentheses enclose a Grob that has ’parenthesis-friends, the parentheses widen to include any child Grobs with type among ’parenthesis-friends.

stem-attachment (pair of numbers):

ly:note-head::calc-stem-attachment

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.

stencil (stencil):

ly:note-head::print

The symbol to print.

style (symbol):

'arrow

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

X-offset (number):

ly:note-head::stem-x-shift

The horizontal amount that this object is moved relative to its X-parent.

Note that many objects have special positioning considerations, which cause any setting of X-offset to be ignored or modified, even though the object supports the self-alignment-interface.

Y-extent (pair of numbers):

#<unpure-pure-container ly:grob::stencil-height >

Extent (size) in the Y direction, measured in staff-space units, relative to object’s reference point.

Y-offset (number):

#<unpure-pure-container ly:staff-symbol-referencer::callback >

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

Note that many objects have special positioning considerations, which cause any setting of Y-offset to be ignored or modified, even though the object supports the self-alignment-interface.

Remarks:

• An example is the highest note the singer can sing. The notated pitch shows the rough expectation. By default, this head is triangular and has no ledger lines.

This object supports the following interface(s): accidental-participating-head-interface, bend-interface, font-interface, gregorian-ligature-interface, grob-interface, item-interface, ledgered-interface, ligature-head-interface, mensural-ligature-interface, note-head-interface, rhythmic-grob-interface, rhythmic-head-interface, staff-symbol-referencer-interface and vaticana-ligature-interface.

This object is of class Item (characterized by item-interface).