Key Signature
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 aquality
is provided which the descriptor for the activeregion
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:
c
d
e
f
g
a
b
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♭ | bes |
Valid values for quality
are available form the entities endpoint under
data.attributes.tags
with a category
key named scale_quality
.
Example:
{
"tonic": "bes",
"quality": "major"
}