The beam object

Type: Dictionary

Describes a single beam.

For music that uses secondary beams (i.e., sixteenth notes or smaller), encoding the secondary beams is optional. If they're encoded explicitly, they go within a nested "beams" object within the beam. This nesting can be recursive, for multi-layered beams.

Beam hooks are encoded as a secondary beam containing only a single event. A beam hook can optionally encode the direction of its hook, with "direction".

Keys

Name	Type	Required?	Description
_c	string	No	An optional comment. This serves a similar function as XML or HTML comments.
beams	An array of beam objects	No	Secondary beams within this beam.
direction	beam hook direction	No	If this beam represents a beam hook, this encodes the direction of the hook. Default value is "auto".
events	An array of ID objects	Yes	IDs of the events that comprise this beam — in order by their position in the beam.
id	ID	No

Parent objects

This object is used by the following parent objects:

part measure: "beams"

Examples

This object is used in the following examples:

Beams, Beams (across barlines), Beams (hooks), Beams (secondary beam breaks implied), Beams (secondary beam breaks), Beams (with inner grace notes), Grace notes (beamed), Grand staff piano music, Parts, Tuplets