The interval object

Type: Dictionary

A musical interval between pitches.

It's defined by specifying the "staffDistance" and "halfSteps" between the pitches. These can be positive, negative or zero. Generally "staffDistance" and "halfSteps" will have the same sign, but there are edge-case situations where they might differ.

In the future, we plan to add other ways of specifying intervals.

Keys

Name Type Required? Description
_c string No An optional comment. This serves a similar function as XML or HTML comments.
halfSteps integer (signed) Yes The number of chromatic steps between the pitches.
id ID No
staffDistance integer (signed) Yes The distance between the pitches, in context of a musical staff.

For example, in a treble clef staff, the staffDistance between the bottom E line and the bottom F space is 1. The staffDistance between the bottom E line and the G line directly above is 2.

Parent objects

This object is used by the following parent objects: