Navigation :

Key Signature

A key_signature object specifies a music key signature.

Data Item	Type	Required/ Optional	Description
`tonic`	text	optional	The tonic of the scale. If omitted, the Composer selects the tonic automatically. See below for valid values
`quality`	text	optional	The scale quality. If omitted, the Composer selects the quality automatically. See below for valid values

Note: A particular descriptor typically supports only a subset of quality types. If a quality is provided which the descriptor for the active region does not support, it will be changed.

Values for tonic are a text representation of a musical note consisting of a letter and accidental.

Valid values for letter are:

Valid values for accidental are:

eses (double flat)
es (flat)
<empty string> (natural)
is (sharp)
isis (double sharp)

Examples:

Musical Note	`tonic` Value
C^♯	`cis`
D^𝄫	`deses`
E^♮	`e`
B^♭	`fes`

Valid values for quality are:

major
natural_minor
ionian
dorial
phrygian
lydian
mixolydian
aeolian
locrian

For reference, the Composer generally classifies the available qualities into two groups:

Majorish	Minorish
`major`	`natural_minor`
`ionian`	`aeolian`
`mixolydian`	`dorian`
`lydian`	`phrygian`

Note: major is equivalent to ionian, and natural_minor is equivalent to aeolian.

Example:

{
    "tonic": "bes",
    "quality": "major"
}