Region

Region

A region object represents a period of time, in beats, that instructs the Composer to either create music or create silence for a metered duration. There are two type of regions: music and silence.

Music Region

A Music region represents the start of a unique period of music.

Data Item Type Required/ Optional Description
id number required An identifier which must be unique within the parent span
region string required The type of region (music in this case)
descriptor text required The descriptor id needed to compose music
beat number required The beat, relative to the span, at which the region object’s music begins
end_type object optional An end_type object specifying the way that a region ends
key object optional The key_signature active at the beginning of the region
edits array optional An array of edit objects to be applied
materials array optional An array of materials used by the region

Example:

{
    "id": 222,
    "region": "music",
    "descriptor": "driving_classic_rock",
    "beat": 0,
    "end_type": { ... },
    "key": { ... },
    "edits": [ ... ],
    "materials": [ ... ]
}

Silence Region

A silence region represents the start of a period with no music. Here silence specifically means that no new music will be composed. However any hits, tails from events, etc. will be unaltered.

Data Item Type Required/ Optional Description
region string required The type of region (silence in this case)
beat number required The beat, relative to the span, at which the period of silence begins

Example:

{
    "region": "silence",
    "beat": 64
}