The kit component object

Type: Dictionary

A kit component represents a single sound used by a kit, along with the position that should be used when the kit component is displayed on a staff. A kit is defined in the part "kit" attribute.

This is generally used for unpitched percussion music, and some applications call it a "percussion map." For example, one kit component might be "Bass drum," with the staff position on the bottom staff line (staffPosition -4).

Within an event, a kit note encodes a specific instance of a kit component (e.g., a specific hit of the bass drum on the first beat of measure 4).

Attributes

Name Type Required? Description
name string No A human-readable name for this kit component, e.g., for purposes of display in a UI.
sound ID No ID of the sound used for this kit component. See the "sounds" attribute in global.
staffPosition staff position Yes

Plus globally available attributes: _c, _x, id

Parent objects

This object is used by the following parent objects: