3.1.9 Arpeggio

Arpeggio objects are created by: Arpeggio_engraver and Span_arpeggio_engraver.

Standard settings:

X-extent (pair of numbers):


Hard coded extent in X direction.

stencil (unknown):


The symbol to print.

Y-offset (number):


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

X-offset (number):


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

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.

positions (pair of numbers):


Pair of staff coordinates (left . right), where both left and right are in staff-space units of the current staff. For slurs, this value selects which slur candidate to use; if extreme positions are requested, the closest one is taken.

padding (dimension, in staff space):


Add this much extra space between objects that are next to each other.

script-priority (number):


A sorting key that determines in what order a script is within a stack of scripts.

side-axis (number):


If the value is #X (or equivalently 0), the object is placed horizontally next to the other object. If the value is #Y or 1, it is placed vertically.

staff-position (number):


Vertical position, measured in half staff spaces, counted from the middle line.

Y-extent (pair of numbers):


Hard coded extent in Y direction.

This object supports the following interface(s): staff-symbol-referencer-interface, side-position-interface, item-interface, font-interface, arpeggio-interface and grob-interface.

Internals Reference