at.atmosynth.patch
Schema Diff
+247 -17
Compatibility Analysis
Breaking Changes Detected
17 breaking changes, 62 non-breaking changes.
Breaking Changes (17)
- RequiredEdgeAdded RequiredEdgeAdded { vertex_id: "at.atmosynth.patch#tuningKeys", src: "at.atmosynth.patch#tuningKeys", tgt: "at.atmosynth.patch#tuningKeys.first", kind: "prop", name: Some("first") }
- RequiredEdgeAdded RequiredEdgeAdded { vertex_id: "at.atmosynth.patch#tuningKeys", src: "at.atmosynth.patch#tuningKeys", tgt: "at.atmosynth.patch#tuningKeys.middle", kind: "prop", name: Some("middle") }
- RequiredEdgeAdded RequiredEdgeAdded { vertex_id: "at.atmosynth.patch#tuningKeys", src: "at.atmosynth.patch#tuningKeys", tgt: "at.atmosynth.patch#tuningKeys.size", kind: "prop", name: Some("size") }
- RequiredEdgeAdded RequiredEdgeAdded { vertex_id: "at.atmosynth.patch#tuningKeys", src: "at.atmosynth.patch#tuningKeys", tgt: "at.atmosynth.patch#tuningKeys.periodDegree", kind: "prop", name: Some("periodDegree") }
- RequiredEdgeAdded RequiredEdgeAdded { vertex_id: "at.atmosynth.patch#tuningKeys", src: "at.atmosynth.patch#tuningKeys", tgt: "at.atmosynth.patch#tuningKeys.reference", kind: "prop", name: Some("reference") }
- RequiredEdgeAdded RequiredEdgeAdded { vertex_id: "at.atmosynth.patch#tuningKeys", src: "at.atmosynth.patch#tuningKeys", tgt: "at.atmosynth.patch#tuningKeys.last", kind: "prop", name: Some("last") }
- RequiredEdgeAdded RequiredEdgeAdded { vertex_id: "at.atmosynth.patch#timeSignature", src: "at.atmosynth.patch#timeSignature", tgt: "at.atmosynth.patch#timeSignature.numerator", kind: "prop", name: Some("numerator") }
- RequiredEdgeAdded RequiredEdgeAdded { vertex_id: "at.atmosynth.patch#timeSignature", src: "at.atmosynth.patch#timeSignature", tgt: "at.atmosynth.patch#timeSignature.denominator", kind: "prop", name: Some("denominator") }
- RequiredEdgeAdded RequiredEdgeAdded { vertex_id: "at.atmosynth.patch#tuning", src: "at.atmosynth.patch#tuning", tgt: "at.atmosynth.patch#tuning.degrees", kind: "prop", name: Some("degrees") }
- RequiredEdgeAdded RequiredEdgeAdded { vertex_id: "at.atmosynth.patch#lineage", src: "at.atmosynth.patch#lineage", tgt: "at.atmosynth.patch#lineage.relation", kind: "prop", name: Some("relation") }
- RequiredEdgeAdded RequiredEdgeAdded { vertex_id: "at.atmosynth.patch#swing", src: "at.atmosynth.patch#swing", tgt: "at.atmosynth.patch#swing.amount", kind: "prop", name: Some("amount") }
- RequiredEdgeAdded RequiredEdgeAdded { vertex_id: "at.atmosynth.patch#swing", src: "at.atmosynth.patch#swing", tgt: "at.atmosynth.patch#swing.value", kind: "prop", name: Some("value") }
- RequiredEdgeAdded RequiredEdgeAdded { vertex_id: "at.atmosynth.patch#bendPoint", src: "at.atmosynth.patch#bendPoint", tgt: "at.atmosynth.patch#bendPoint.at", kind: "prop", name: Some("at") }
- RequiredEdgeAdded RequiredEdgeAdded { vertex_id: "at.atmosynth.patch#bendPoint", src: "at.atmosynth.patch#bendPoint", tgt: "at.atmosynth.patch#bendPoint.value", kind: "prop", name: Some("value") }
- RemovedVertex RemovedVertex { vertex_id: "at.atmosynth.patch:body.forkedFrom" }
- RemovedEdge RemovedEdge { src: "at.atmosynth.patch:body", tgt: "at.atmosynth.patch:body.forkedFrom", kind: "prop", name: Some("forkedFrom") }
- RemovedEdge RemovedEdge { src: "at.atmosynth.patch:body.forkedFrom", tgt: "at.atmosynth.patch#lineage", kind: "ref", name: None }
Non-Breaking Changes (62)
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#alternatePattern.sixteenths" }
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#alternatePattern.swing" }
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#bendPoint" }
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#bendPoint.at" }
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#bendPoint.value" }
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#lane.sixteenths" }
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#lineage.relation" }
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#noteEvent.bend" }
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#noteEvent.bend:items" }
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#notePattern.sixteenths" }
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#notePattern.swing" }
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#sampleSlotFill.name" }
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#swing" }
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#swing.amount" }
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#swing.value" }
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#timeSignature" }
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#timeSignature.denominator" }
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#timeSignature.numerator" }
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#tuning" }
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#tuning.degrees" }
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#tuning.degrees:items" }
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#tuning.keys" }
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#tuning.name" }
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#tuningKeys" }
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#tuningKeys.first" }
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#tuningKeys.last" }
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#tuningKeys.map" }
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#tuningKeys.map:items" }
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#tuningKeys.middle" }
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#tuningKeys.periodDegree" }
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#tuningKeys.reference" }
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#tuningKeys.size" }
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch:body.concertPitch" }
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch:body.lineage" }
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch:body.lineage:items" }
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch:body.timeSignature" }
- AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch:body.tuning" }
- AddedEdge AddedEdge { src: "at.atmosynth.patch#alternatePattern", tgt: "at.atmosynth.patch#alternatePattern.sixteenths", kind: "prop", name: Some("sixteenths") }
- AddedEdge AddedEdge { src: "at.atmosynth.patch#alternatePattern", tgt: "at.atmosynth.patch#alternatePattern.swing", kind: "prop", name: Some("swing") }
- AddedEdge AddedEdge { src: "at.atmosynth.patch#alternatePattern.swing", tgt: "at.atmosynth.patch#swing", kind: "ref", name: None }
- AddedEdge AddedEdge { src: "at.atmosynth.patch#lane", tgt: "at.atmosynth.patch#lane.sixteenths", kind: "prop", name: Some("sixteenths") }
- AddedEdge AddedEdge { src: "at.atmosynth.patch#noteEvent", tgt: "at.atmosynth.patch#noteEvent.bend", kind: "prop", name: Some("bend") }
- AddedEdge AddedEdge { src: "at.atmosynth.patch#noteEvent.bend", tgt: "at.atmosynth.patch#noteEvent.bend:items", kind: "items", name: None }
- AddedEdge AddedEdge { src: "at.atmosynth.patch#noteEvent.bend:items", tgt: "at.atmosynth.patch#bendPoint", kind: "ref", name: None }
- AddedEdge AddedEdge { src: "at.atmosynth.patch#notePattern", tgt: "at.atmosynth.patch#notePattern.sixteenths", kind: "prop", name: Some("sixteenths") }
- AddedEdge AddedEdge { src: "at.atmosynth.patch#notePattern", tgt: "at.atmosynth.patch#notePattern.swing", kind: "prop", name: Some("swing") }
- AddedEdge AddedEdge { src: "at.atmosynth.patch#notePattern.swing", tgt: "at.atmosynth.patch#swing", kind: "ref", name: None }
- AddedEdge AddedEdge { src: "at.atmosynth.patch#sampleSlotFill", tgt: "at.atmosynth.patch#sampleSlotFill.name", kind: "prop", name: Some("name") }
- AddedEdge AddedEdge { src: "at.atmosynth.patch#tuning", tgt: "at.atmosynth.patch#tuning.keys", kind: "prop", name: Some("keys") }
- AddedEdge AddedEdge { src: "at.atmosynth.patch#tuning", tgt: "at.atmosynth.patch#tuning.name", kind: "prop", name: Some("name") }
- AddedEdge AddedEdge { src: "at.atmosynth.patch#tuning.degrees", tgt: "at.atmosynth.patch#tuning.degrees:items", kind: "items", name: None }
- AddedEdge AddedEdge { src: "at.atmosynth.patch#tuning.keys", tgt: "at.atmosynth.patch#tuningKeys", kind: "ref", name: None }
- AddedEdge AddedEdge { src: "at.atmosynth.patch#tuningKeys", tgt: "at.atmosynth.patch#tuningKeys.map", kind: "prop", name: Some("map") }
- AddedEdge AddedEdge { src: "at.atmosynth.patch#tuningKeys.map", tgt: "at.atmosynth.patch#tuningKeys.map:items", kind: "items", name: None }
- AddedEdge AddedEdge { src: "at.atmosynth.patch:body", tgt: "at.atmosynth.patch:body.concertPitch", kind: "prop", name: Some("concertPitch") }
- AddedEdge AddedEdge { src: "at.atmosynth.patch:body", tgt: "at.atmosynth.patch:body.lineage", kind: "prop", name: Some("lineage") }
- AddedEdge AddedEdge { src: "at.atmosynth.patch:body", tgt: "at.atmosynth.patch:body.timeSignature", kind: "prop", name: Some("timeSignature") }
- AddedEdge AddedEdge { src: "at.atmosynth.patch:body", tgt: "at.atmosynth.patch:body.tuning", kind: "prop", name: Some("tuning") }
- AddedEdge AddedEdge { src: "at.atmosynth.patch:body.lineage", tgt: "at.atmosynth.patch:body.lineage:items", kind: "items", name: None }
- AddedEdge AddedEdge { src: "at.atmosynth.patch:body.lineage:items", tgt: "at.atmosynth.patch#lineage", kind: "ref", name: None }
- AddedEdge AddedEdge { src: "at.atmosynth.patch:body.timeSignature", tgt: "at.atmosynth.patch#timeSignature", kind: "ref", name: None }
- AddedEdge AddedEdge { src: "at.atmosynth.patch:body.tuning", tgt: "at.atmosynth.patch#tuning", kind: "ref", name: None }
Migration Guidance
Removed Elements
RemovedVertex { vertex_id: "at.atmosynth.patch:body.forkedFrom" }
Added Elements
AddedVertex { vertex_id: "at.atmosynth.patch#alternatePattern.sixteenths" }AddedVertex { vertex_id: "at.atmosynth.patch#alternatePattern.swing" }AddedVertex { vertex_id: "at.atmosynth.patch#bendPoint" }AddedVertex { vertex_id: "at.atmosynth.patch#bendPoint.at" }AddedVertex { vertex_id: "at.atmosynth.patch#bendPoint.value" }AddedVertex { vertex_id: "at.atmosynth.patch#lane.sixteenths" }AddedVertex { vertex_id: "at.atmosynth.patch#lineage.relation" }AddedVertex { vertex_id: "at.atmosynth.patch#noteEvent.bend" }AddedVertex { vertex_id: "at.atmosynth.patch#noteEvent.bend:items" }AddedVertex { vertex_id: "at.atmosynth.patch#notePattern.sixteenths" }AddedVertex { vertex_id: "at.atmosynth.patch#notePattern.swing" }AddedVertex { vertex_id: "at.atmosynth.patch#sampleSlotFill.name" }AddedVertex { vertex_id: "at.atmosynth.patch#swing" }AddedVertex { vertex_id: "at.atmosynth.patch#swing.amount" }AddedVertex { vertex_id: "at.atmosynth.patch#swing.value" }AddedVertex { vertex_id: "at.atmosynth.patch#timeSignature" }AddedVertex { vertex_id: "at.atmosynth.patch#timeSignature.denominator" }AddedVertex { vertex_id: "at.atmosynth.patch#timeSignature.numerator" }AddedVertex { vertex_id: "at.atmosynth.patch#tuning" }AddedVertex { vertex_id: "at.atmosynth.patch#tuning.degrees" }AddedVertex { vertex_id: "at.atmosynth.patch#tuning.degrees:items" }AddedVertex { vertex_id: "at.atmosynth.patch#tuning.keys" }AddedVertex { vertex_id: "at.atmosynth.patch#tuning.name" }AddedVertex { vertex_id: "at.atmosynth.patch#tuningKeys" }AddedVertex { vertex_id: "at.atmosynth.patch#tuningKeys.first" }AddedVertex { vertex_id: "at.atmosynth.patch#tuningKeys.last" }AddedVertex { vertex_id: "at.atmosynth.patch#tuningKeys.map" }AddedVertex { vertex_id: "at.atmosynth.patch#tuningKeys.map:items" }AddedVertex { vertex_id: "at.atmosynth.patch#tuningKeys.middle" }AddedVertex { vertex_id: "at.atmosynth.patch#tuningKeys.periodDegree" }AddedVertex { vertex_id: "at.atmosynth.patch#tuningKeys.reference" }AddedVertex { vertex_id: "at.atmosynth.patch#tuningKeys.size" }AddedVertex { vertex_id: "at.atmosynth.patch:body.concertPitch" }AddedVertex { vertex_id: "at.atmosynth.patch:body.lineage" }AddedVertex { vertex_id: "at.atmosynth.patch:body.lineage:items" }AddedVertex { vertex_id: "at.atmosynth.patch:body.timeSignature" }AddedVertex { vertex_id: "at.atmosynth.patch:body.tuning" }
Additional Notes
- Breaking: RequiredEdgeAdded { vertex_id: "at.atmosynth.patch#bendPoint", src: "at.atmosynth.patch#bendPoint", tgt: "at.atmosynth.patch#bendPoint.at", kind: "prop", name: Some("at") }
- Breaking: RequiredEdgeAdded { vertex_id: "at.atmosynth.patch#bendPoint", src: "at.atmosynth.patch#bendPoint", tgt: "at.atmosynth.patch#bendPoint.value", kind: "prop", name: Some("value") }
- Breaking: RequiredEdgeAdded { vertex_id: "at.atmosynth.patch#swing", src: "at.atmosynth.patch#swing", tgt: "at.atmosynth.patch#swing.amount", kind: "prop", name: Some("amount") }
- Breaking: RequiredEdgeAdded { vertex_id: "at.atmosynth.patch#swing", src: "at.atmosynth.patch#swing", tgt: "at.atmosynth.patch#swing.value", kind: "prop", name: Some("value") }
- Breaking: RequiredEdgeAdded { vertex_id: "at.atmosynth.patch#lineage", src: "at.atmosynth.patch#lineage", tgt: "at.atmosynth.patch#lineage.relation", kind: "prop", name: Some("relation") }
- Breaking: RequiredEdgeAdded { vertex_id: "at.atmosynth.patch#tuning", src: "at.atmosynth.patch#tuning", tgt: "at.atmosynth.patch#tuning.degrees", kind: "prop", name: Some("degrees") }
- Breaking: RequiredEdgeAdded { vertex_id: "at.atmosynth.patch#tuningKeys", src: "at.atmosynth.patch#tuningKeys", tgt: "at.atmosynth.patch#tuningKeys.first", kind: "prop", name: Some("first") }
- Breaking: RequiredEdgeAdded { vertex_id: "at.atmosynth.patch#tuningKeys", src: "at.atmosynth.patch#tuningKeys", tgt: "at.atmosynth.patch#tuningKeys.middle", kind: "prop", name: Some("middle") }
- Breaking: RequiredEdgeAdded { vertex_id: "at.atmosynth.patch#tuningKeys", src: "at.atmosynth.patch#tuningKeys", tgt: "at.atmosynth.patch#tuningKeys.size", kind: "prop", name: Some("size") }
- Breaking: RequiredEdgeAdded { vertex_id: "at.atmosynth.patch#tuningKeys", src: "at.atmosynth.patch#tuningKeys", tgt: "at.atmosynth.patch#tuningKeys.periodDegree", kind: "prop", name: Some("periodDegree") }
- Breaking: RequiredEdgeAdded { vertex_id: "at.atmosynth.patch#tuningKeys", src: "at.atmosynth.patch#tuningKeys", tgt: "at.atmosynth.patch#tuningKeys.reference", kind: "prop", name: Some("reference") }
- Breaking: RequiredEdgeAdded { vertex_id: "at.atmosynth.patch#tuningKeys", src: "at.atmosynth.patch#tuningKeys", tgt: "at.atmosynth.patch#tuningKeys.last", kind: "prop", name: Some("last") }
- Breaking: RequiredEdgeAdded { vertex_id: "at.atmosynth.patch#timeSignature", src: "at.atmosynth.patch#timeSignature", tgt: "at.atmosynth.patch#timeSignature.numerator", kind: "prop", name: Some("numerator") }
- Breaking: RequiredEdgeAdded { vertex_id: "at.atmosynth.patch#timeSignature", src: "at.atmosynth.patch#timeSignature", tgt: "at.atmosynth.patch#timeSignature.denominator", kind: "prop", name: Some("denominator") }
- Breaking: RemovedEdge { src: "at.atmosynth.patch:body", tgt: "at.atmosynth.patch:body.forkedFrom", kind: "prop", name: Some("forkedFrom") }
- Breaking: RemovedEdge { src: "at.atmosynth.patch:body.forkedFrom", tgt: "at.atmosynth.patch#lineage", kind: "ref", name: None }
- Non-breaking: AddedEdge { src: "at.atmosynth.patch#alternatePattern", tgt: "at.atmosynth.patch#alternatePattern.sixteenths", kind: "prop", name: Some("sixteenths") }
- Non-breaking: AddedEdge { src: "at.atmosynth.patch#alternatePattern", tgt: "at.atmosynth.patch#alternatePattern.swing", kind: "prop", name: Some("swing") }
- Non-breaking: AddedEdge { src: "at.atmosynth.patch#alternatePattern.swing", tgt: "at.atmosynth.patch#swing", kind: "ref", name: None }
- Non-breaking: AddedEdge { src: "at.atmosynth.patch#lane", tgt: "at.atmosynth.patch#lane.sixteenths", kind: "prop", name: Some("sixteenths") }
- Non-breaking: AddedEdge { src: "at.atmosynth.patch#noteEvent", tgt: "at.atmosynth.patch#noteEvent.bend", kind: "prop", name: Some("bend") }
- Non-breaking: AddedEdge { src: "at.atmosynth.patch#noteEvent.bend", tgt: "at.atmosynth.patch#noteEvent.bend:items", kind: "items", name: None }
- Non-breaking: AddedEdge { src: "at.atmosynth.patch#noteEvent.bend:items", tgt: "at.atmosynth.patch#bendPoint", kind: "ref", name: None }
- Non-breaking: AddedEdge { src: "at.atmosynth.patch#notePattern", tgt: "at.atmosynth.patch#notePattern.sixteenths", kind: "prop", name: Some("sixteenths") }
- Non-breaking: AddedEdge { src: "at.atmosynth.patch#notePattern", tgt: "at.atmosynth.patch#notePattern.swing", kind: "prop", name: Some("swing") }
- Non-breaking: AddedEdge { src: "at.atmosynth.patch#notePattern.swing", tgt: "at.atmosynth.patch#swing", kind: "ref", name: None }
- Non-breaking: AddedEdge { src: "at.atmosynth.patch#sampleSlotFill", tgt: "at.atmosynth.patch#sampleSlotFill.name", kind: "prop", name: Some("name") }
- Non-breaking: AddedEdge { src: "at.atmosynth.patch#tuning", tgt: "at.atmosynth.patch#tuning.keys", kind: "prop", name: Some("keys") }
- Non-breaking: AddedEdge { src: "at.atmosynth.patch#tuning", tgt: "at.atmosynth.patch#tuning.name", kind: "prop", name: Some("name") }
- Non-breaking: AddedEdge { src: "at.atmosynth.patch#tuning.degrees", tgt: "at.atmosynth.patch#tuning.degrees:items", kind: "items", name: None }
- Non-breaking: AddedEdge { src: "at.atmosynth.patch#tuning.keys", tgt: "at.atmosynth.patch#tuningKeys", kind: "ref", name: None }
- Non-breaking: AddedEdge { src: "at.atmosynth.patch#tuningKeys", tgt: "at.atmosynth.patch#tuningKeys.map", kind: "prop", name: Some("map") }
- Non-breaking: AddedEdge { src: "at.atmosynth.patch#tuningKeys.map", tgt: "at.atmosynth.patch#tuningKeys.map:items", kind: "items", name: None }
- Non-breaking: AddedEdge { src: "at.atmosynth.patch:body", tgt: "at.atmosynth.patch:body.concertPitch", kind: "prop", name: Some("concertPitch") }
- Non-breaking: AddedEdge { src: "at.atmosynth.patch:body", tgt: "at.atmosynth.patch:body.lineage", kind: "prop", name: Some("lineage") }
- Non-breaking: AddedEdge { src: "at.atmosynth.patch:body", tgt: "at.atmosynth.patch:body.timeSignature", kind: "prop", name: Some("timeSignature") }
- Non-breaking: AddedEdge { src: "at.atmosynth.patch:body", tgt: "at.atmosynth.patch:body.tuning", kind: "prop", name: Some("tuning") }
- Non-breaking: AddedEdge { src: "at.atmosynth.patch:body.lineage", tgt: "at.atmosynth.patch:body.lineage:items", kind: "items", name: None }
- Non-breaking: AddedEdge { src: "at.atmosynth.patch:body.lineage:items", tgt: "at.atmosynth.patch#lineage", kind: "ref", name: None }
- Non-breaking: AddedEdge { src: "at.atmosynth.patch:body.timeSignature", tgt: "at.atmosynth.patch#timeSignature", kind: "ref", name: None }
- Non-breaking: AddedEdge { src: "at.atmosynth.patch:body.tuning", tgt: "at.atmosynth.patch#tuning", kind: "ref", name: None }
1
1
{
2
2
"$type": "com.atproto.lexicon.schema",
3
3
"defs": {
4
4
"alternatePattern": {
5
5
"description": "One of the loops after the first on a sequencer. It has its own length and its own notes, and shares the grid written beside the first.",
6
6
"properties": {
7
7
"bars": {
8
-
"description": "How long this loop is, in bars of four beats.",
8
+
"description": "How long this loop is, in bars of the patch's time signature. Where `sixteenths` is present it is the length and this is the whole bars that covers, rounded up.",
9
9
"maximum": 8,
10
10
"minimum": 1,
11
11
"type": "integer"
12
12
},
13
13
"events": {
14
14
"description": "The notes in this loop.",
15
15
"items": {
16
16
"ref": "#noteEvent",
17
17
"type": "ref"
18
18
},
19
19
"maxLength": 2048,
20
20
"type": "array"
21
21
},
22
22
"name": {
23
23
"description": "What the creator called this loop. Optional permanently: a loop that says nothing is called by its place.",
24
24
"maxGraphemes": 32,
25
25
"maxLength": 320,
26
26
"minLength": 1,
27
27
"type": "string"
28
+
},
29
+
"sixteenths": {
30
+
"description": "How long this loop is, in sixteenth notes, where it is not a whole number of bars. It keeps its length when the time signature changes. Optional permanently: absent is `bars` of the patch's bar.",
31
+
"maximum": 2048,
32
+
"minimum": 1,
33
+
"type": "integer"
34
+
},
35
+
"swing": {
36
+
"description": "How this loop swings. Each loop swings for itself. Optional permanently: a loop that says nothing is played straight.",
37
+
"ref": "#swing",
38
+
"type": "ref"
28
39
}
29
40
},
30
41
"required": [
31
42
"bars"
32
43
],
33
44
"type": "object"
34
45
},
46
+
"bendPoint": {
47
+
"description": "One point of a note's bend: how far from its pitch the note is at a moment of it.",
48
+
"properties": {
49
+
"at": {
50
+
"description": "The tick of the note this point is at, counted from the note's own start at 96 ticks to the beat, so a phrase bent at one tempo is bent the same way at another.",
51
+
"minimum": 0,
52
+
"type": "integer"
53
+
},
54
+
"value": {
55
+
"description": "How far the note is bent here, in semitones, from -96 to 96, written as its decimal text, as every number in this description that need not be whole is. Upwards is positive.",
56
+
"type": "string"
57
+
}
58
+
},
59
+
"required": [
60
+
"at",
61
+
"value"
62
+
],
63
+
"type": "object"
64
+
},
35
65
"connection": {
36
66
"description": "An audio connection between two module instances, naming the declared ports at each end.",
37
67
"properties": {
38
68
"from": {
39
69
"ref": "#outputRef",
40
70
"type": "ref"
41
71
},
42
72
"to": {
43
73
"ref": "#inputRef",
44
74
"type": "ref"
45
75
}
46
76
},
47
77
"required": [
48
78
"from",
49
79
"to"
50
80
],
51
81
"type": "object"
52
82
},
53
83
"glide": {
54
84
"description": "How one sequencer's notes slide into one another. Its presence is the switch: an instance carrying it slides, and one carrying nothing does not. The speed is written one of two ways, and which field is present says which — a duration, or a note value at the player's tempo, so a slide that is a sixteenth long stays a sixteenth when the song is played faster. A slide moves one note to the next, so a loop with a glide plays one note at a time.",
55
85
"properties": {
56
86
"fromLast": {
57
87
"description": "Whether a note struck after a rest slides in from the note before it. Absent is yes, so every note of the loop slides; false is fingered portamento, where only a note held over the next one slides into it and a note after a rest starts where it means to.",
58
88
"type": "boolean"
59
89
},
60
90
"ms": {
61
91
"description": "How long a note takes to reach the next, in milliseconds.",
62
92
"maximum": 5000,
63
93
"minimum": 1,
64
94
"type": "integer"
65
95
},
66
96
"rate": {
67
97
"description": "Or: how long, as a note value at the tempo. The same vocabulary the grid is written in.",
68
98
"knownValues": [
69
99
"bar",
70
100
"1/2",
71
101
"1/4",
72
102
"1/8",
73
103
"1/16",
74
104
"1/32",
75
105
"1/64",
76
106
"1/128"
77
107
],
78
108
"type": "string"
79
109
}
80
110
},
81
111
"type": "object"
82
112
},
83
113
"inputRef": {
84
114
"properties": {
85
115
"audioInput": {
86
116
"maxLength": 64,
87
117
"minLength": 1,
88
118
"type": "string"
89
119
},
90
120
"instanceId": {
91
121
"maxLength": 64,
92
122
"minLength": 1,
93
123
"type": "string"
94
124
}
95
125
},
96
126
"required": [
97
127
"instanceId",
98
128
"audioInput"
99
129
],
100
130
"type": "object"
101
131
},
102
132
"inputRoute": {
103
133
"description": "One note source wired into the input of a sequencer or a note range. Notes arriving at a sequencer's are what it records, and what it passes on to the instances it plays unless its instance says `thru: false`; notes arriving at a note range's are passed on where they fall inside its range.",
104
134
"properties": {
105
135
"from": {
106
136
"description": "The note output these notes leave: a keyboard's, a sequencer's or a note range's.",
107
137
"ref": "#noteOutputRef",
108
138
"type": "ref"
109
139
},
110
140
"instanceId": {
111
141
"description": "The sequencer or the note range, at its input.",
112
142
"maxLength": 64,
113
143
"minLength": 1,
114
144
"type": "string"
115
145
}
116
146
},
117
147
"required": [
118
148
"from",
119
149
"instanceId"
120
150
],
121
151
"type": "object"
122
152
},
123
153
"lane": {
124
-
"description": "One automation lane: a line drawn over a whole number of bars, counted from the downbeat the loops share and going round at its own length, so a point in bar 3 of a four-bar lane is heard in bar 3 of every four.",
154
+
"description": "One automation lane: a line drawn over a whole number of bars, or of sixteenths where it says so, counted from the downbeat the loops share and going round at its own length, so a point in bar 3 of a four-bar lane is heard in bar 3 of every four.",
125
155
"properties": {
126
156
"bars": {
127
-
"description": "How long this lane is, in bars of four beats.",
157
+
"description": "How long this lane is, in bars of the patch's time signature. Where `sixteenths` is present it is the length and this is the whole bars that covers, rounded up.",
128
158
"maximum": 64,
129
159
"minimum": 1,
130
160
"type": "integer"
131
161
},
132
162
"name": {
133
163
"description": "What the creator called this lane. Optional permanently: a lane that says nothing is called by its place.",
134
164
"maxGraphemes": 32,
135
165
"maxLength": 320,
136
166
"minLength": 1,
137
167
"type": "string"
138
168
},
139
169
"points": {
140
170
"description": "The points, in order of `at`, one to a tick. Before the first point the lane is at the first point's value and after the last at the last's; a lane with no points is at nothing.",
141
171
"items": {
142
172
"ref": "#lanePoint",
143
173
"type": "ref"
144
174
},
145
175
"maxLength": 512,
146
176
"type": "array"
147
177
},
148
178
"resolution": {
149
179
"description": "The grid this lane's points are drawn and snapped to. It is a guide and not a part of what is played: changing it moves no point already written. Optional permanently: absent is sixteenths.",
150
180
"ref": "#resolution",
151
181
"type": "ref"
182
+
},
183
+
"sixteenths": {
184
+
"description": "How long this lane is, in sixteenth notes, where it is not a whole number of bars. It keeps its length when the time signature changes. Optional permanently: absent is `bars` of the patch's bar.",
185
+
"maximum": 16384,
186
+
"minimum": 1,
187
+
"type": "integer"
152
188
}
153
189
},
154
190
"required": [
155
191
"bars"
156
192
],
157
193
"type": "object"
158
194
},
159
195
"lanePoint": {
160
196
"description": "One point of an automation lane: a value at a moment.",
161
197
"properties": {
162
198
"at": {
163
199
"description": "The tick of the lane this point is at, counted from its start at 96 ticks to the beat, and less than the lane's length.",
164
200
"minimum": 0,
165
201
"type": "integer"
166
202
},
167
203
"hold": {
168
204
"description": "Whether the value is held until the next point, which is jumped to, rather than travelled to in a straight line. Optional permanently: absent is a straight line, and only `true` is written.",
169
205
"type": "boolean"
170
206
},
171
207
"value": {
172
208
"description": "The value here, a number from 0 to 1 written as its decimal text, as every number in this description that need not be whole is.",
173
209
"type": "string"
174
210
}
175
211
},
176
212
"required": [
177
213
"at",
178
214
"value"
179
215
],
180
216
"type": "object"
181
217
},
182
218
"lineage": {
183
-
"description": "The patch this one was forked from, and its creator. Preserved even when the source is later deleted.",
219
+
"description": "One patch this one came from, how, and its creator. Preserved even when that patch is later deleted, because it is written here and not there.",
184
220
"properties": {
185
221
"creatorDid": {
186
222
"format": "did",
187
223
"type": "string"
188
224
},
189
225
"patchId": {
190
226
"maxLength": 128,
191
227
"type": "string"
192
228
},
229
+
"relation": {
230
+
"description": "`fork`: this patch began as a copy of that one, and a patch is forked from one at most. `import`: that patch was put inside this one, each patch named once however often it was. A reader meeting another value still has a parent, and should say only that this patch came from it.",
231
+
"knownValues": [
232
+
"fork",
233
+
"import"
234
+
],
235
+
"maxLength": 32,
236
+
"type": "string"
237
+
},
193
238
"uri": {
194
239
"format": "at-uri",
195
240
"type": "string"
196
241
}
197
242
},
198
243
"required": [
244
+
"relation",
199
245
"uri",
200
246
"creatorDid"
201
247
],
202
248
"type": "object"
203
249
},
204
250
"main": {
205
251
"description": "A patch, held in its creator's own repository.",
206
252
"key": "tid",
207
253
"record": {
208
254
"properties": {
255
+
"concertPitch": {
256
+
"description": "The frequency A4 sounds at in this patch, in hertz, from 380 to 500, written as its decimal text — \"432\", \"415.3\" — as every number in this description that need not be whole is. Every note's frequency is tuned against it, which is what an oscillator a module does not drive itself and a module's note signal play at; under a `tuning` it anchors the tuning's reference key, which sounds where twelve-tone equal temperament puts it at this pitch. A sample is not retuned by it: its own reference pitch is a note rather than a frequency, and it plays as recorded. Optional permanently: a patch that says nothing is tuned to 440, which is what every patch written before the field existed says.",
257
+
"maxLength": 32,
258
+
"type": "string"
259
+
},
209
260
"connections": {
210
261
"items": {
211
262
"ref": "#connection",
212
263
"type": "ref"
213
264
},
214
265
"type": "array"
215
266
},
216
267
"createdAt": {
217
268
"format": "datetime",
218
269
"type": "string"
219
270
},
220
271
"description": {
221
272
"maxLength": 3000,
222
273
"type": "string"
223
274
},
224
275
"descriptionVersion": {
225
276
"description": "Version of the patch description this record follows.",
226
277
"minimum": 1,
227
278
"type": "integer"
228
-
},
229
-
"forkedFrom": {
230
-
"ref": "#lineage",
231
-
"type": "ref"
232
279
},
233
280
"inputRouting": {
234
281
"description": "What reaches the input of each sequencer, each note range, each transpose, each pitch assignment and each one-shot: which note sources a sequencer hears, to record from and — unless it says otherwise (`thru`) — to pass on to whatever it plays; which a note range hears, to pass on what falls inside its range (`noteRange`); which a transpose or a pitch assignment hears, to pass on at another pitch (`transpose`, `assignedNote`); and which a one-shot hears, to pass on lasting one length (`noteLength`). A sequencer with nothing wired here records nothing, and the others pass nothing on. Optional permanently: a patch that says nothing has nothing wired into any of them, which is what every patch written before the input existed says.",
235
282
"items": {
236
283
"ref": "#inputRoute",
237
284
"type": "ref"
238
285
},
239
286
"type": "array"
240
287
},
288
+
"lineage": {
289
+
"description": "The patches this one came from: the one it was forked from, if it was, and every one imported into it. Only the direct ones — each of those names its own — so the whole of where a patch came from is read by following these upward. The modules it pins and the samples it fills are not repeated here: they are already in its instances. Optional permanently: a patch that says nothing came from nothing but its modules. A patch written before this field existed may say its fork as `forkedFrom` instead, `{uri, creatorDid, patchId?}`, which a reader treats as a lineage of relation `fork`; it is never written again.",
290
+
"items": {
291
+
"ref": "#lineage",
292
+
"type": "ref"
293
+
},
294
+
"maxLength": 64,
295
+
"type": "array"
296
+
},
241
297
"midiRouting": {
242
298
"description": "The note plane: which note inputs receive note events, and from which note source — a sequencer, or the player's keys and MIDI devices. \"MIDI\" is the historical name; what travels here is notes, whatever produced them.",
243
299
"items": {
244
300
"ref": "#midiRoute",
245
301
"type": "ref"
246
302
},
247
303
"type": "array"
248
304
},
249
305
"moduleInstances": {
250
306
"items": {
251
307
"ref": "#moduleInstance",
252
308
"type": "ref"
253
309
},
254
310
"type": "array"
255
311
},
256
312
"name": {
257
313
"maxLength": 200,
258
314
"minLength": 1,
259
315
"type": "string"
260
316
},
261
317
"output": {
262
318
"description": "Which instance reaches the audio output.",
263
319
"ref": "#outputRef",
264
320
"type": "ref"
265
321
},
266
322
"patternRouting": {
267
323
"description": "The song plane: which sequencers and automation blocks each arranger or scenes block chooses the loops or lanes of. A sequencer or an automation block has one pattern input, so it appears here at most once. Optional permanently: a patch that says nothing has no arranger in it, and every sequencer plays the loop it names as active and every automation block the lane.",
268
324
"items": {
269
325
"ref": "#patternRoute",
270
326
"type": "ref"
271
327
},
272
328
"type": "array"
273
329
},
274
330
"tags": {
275
331
"description": "Freely created tags, lower-cased on write so one hashtag matches one set of patches.",
276
332
"items": {
277
333
"maxLength": 128,
278
334
"type": "string"
279
335
},
280
336
"type": "array"
281
337
},
282
338
"tempo": {
283
-
"description": "The tempo this patch was written at, in beats per minute. It is what a sequenced patch counts its bars against, so a patch that plays itself arrives at the speed its creator meant. It seeds the player's own tempo rather than replacing it: how fast a visitor plays is still theirs, and moving it moves everything counting against it. Optional permanently — a patch that says nothing is played at whatever tempo the player already had.",
339
+
"description": "The tempo this patch was written at, in beats per minute, a beat being a quarter note whatever the time signature says. It is what a sequenced patch counts its bars against, so a patch that plays itself arrives at the speed its creator meant. It seeds the player's own tempo rather than replacing it: how fast a visitor plays is still theirs, and moving it moves everything counting against it. Optional permanently — a patch that says nothing is played at whatever tempo the player already had.",
284
340
"maximum": 300,
285
341
"minimum": 20,
286
342
"type": "integer"
287
343
},
344
+
"timeSignature": {
345
+
"description": "How many of which note one bar of this patch is. Every length here counted in bars — a loop, a section, an automation lane — is counted in this bar, so a loop of four bars is twelve beats in 3/4. Optional permanently: a patch that says nothing is in 4/4, which is what every patch written before the field existed says.",
346
+
"ref": "#timeSignature",
347
+
"type": "ref"
348
+
},
349
+
"tuning": {
350
+
"description": "Which pitch each key of this patch sounds at, as a Scala .scl file and its .kbm key map say it. Every frequency a key is played at comes from it — an oscillator a module does not drive itself, a module's note signal, and a sample, which sounds at its key what an oscillator at that key would — and a pitch bend is applied after it, in twelve-tone semitones. The concert pitch is still the one frequency here: the tuning's reference key sounds where twelve-tone equal temperament puts it at the patch's concert pitch. A key the map sends nowhere sounds nothing. Optional permanently: a patch that says nothing is in twelve-tone equal temperament, which is what every patch written before the field existed says.",
351
+
"ref": "#tuning",
352
+
"type": "ref"
353
+
},
288
354
"types": {
289
355
"description": "Zero or more of the ten fixed types. A patch may carry several.",
290
356
"items": {
291
357
"knownValues": [
292
358
"Lead",
293
359
"Pad",
294
360
"Bass",
295
361
"Plucked",
296
362
"Percussion",
297
363
"Keys",
298
364
"Brass",
299
365
"Strings",
300
366
"Vocal",
301
367
"SFX"
302
368
],
303
369
"type": "string"
304
370
},
305
371
"type": "array"
306
372
}
307
373
},
308
374
"required": [
309
375
"descriptionVersion",
310
376
"name",
311
377
"description",
312
378
"moduleInstances",
313
379
"createdAt"
314
380
],
315
381
"type": "object"
316
382
},
317
383
"type": "record"
318
384
},
319
385
"midiControl": {
320
386
"description": "One MIDI control change bound to one of the module's exposed parameters. The controller's 0 to 127 sweeps the parameter across the range the module declares — along the parameter's scale, so a logarithmic one moves by equal ratios — or across the part of it this binding names with from and to; where the module declares a closed value set instead, it sweeps across those values in order. A control is read from every input on every channel, like every other MIDI message here: there is nothing to configure.",
321
387
"properties": {
322
388
"controller": {
323
389
"description": "The control change number. Five are spoken for by MIDI itself and cannot be bound: 64, the sustain pedal, and 6, 38, 100 and 101, which carry registered-parameter traffic.",
324
390
"maximum": 127,
325
391
"minimum": 0,
326
392
"type": "integer"
327
393
},
328
394
"from": {
329
395
"description": "The value the control reaches at 0, in the parameter's own units and as its decimal form. Given with to or not at all; neither is the parameter's whole declared range. A value outside that range is read as the nearer end of it.",
330
396
"maxLength": 200,
331
397
"type": "string"
332
398
},
333
399
"parameter": {
334
400
"description": "The id of the exposed parameter this control moves. One parameter is moved by at most one controller; one controller may move several parameters.",
335
401
"maxLength": 64,
336
402
"minLength": 1,
337
403
"type": "string"
338
404
},
339
405
"to": {
340
406
"description": "The value the control reaches at 127, as from is at 0. It may be below from, which is a control that turns the parameter down as it is turned up.",
341
407
"maxLength": 200,
342
408
"type": "string"
343
409
}
344
410
},
345
411
"required": [
346
412
"parameter",
347
413
"controller"
348
414
],
349
415
"type": "object"
350
416
},
351
417
"midiRoute": {
352
418
"description": "Where one instance's notes come from. `instanceId` and `midiInput` name the note input they arrive at; `from` names the note output they leave. \"MIDI\" in these names is historical: a route carries note events from any note source, a sequencer as much as a MIDI device. **A route with no `from` comes from the player** — the on-screen keys, the computer keyboard and every MIDI device at once — which is what every route written before note sources existed says, and what it goes on saying.",
353
419
"properties": {
354
420
"from": {
355
421
"description": "The note output these notes leave. Absent where they come from the player.",
356
422
"ref": "#noteOutputRef",
357
423
"type": "ref"
358
424
},
359
425
"instanceId": {
360
426
"maxLength": 64,
361
427
"minLength": 1,
362
428
"type": "string"
363
429
},
364
430
"midiInput": {
365
431
"description": "The note input, one of the module's `midiInputs`, these notes arrive at. It receives note events from any note source; \"MIDI\" is the historical name.",
366
432
"maxLength": 64,
367
433
"minLength": 1,
368
434
"type": "string"
369
435
}
370
436
},
371
437
"required": [
372
438
"instanceId",
373
439
"midiInput"
374
440
],
375
441
"type": "object"
376
442
},
377
443
"moduleInstance": {
378
444
"description": "One use of one module version. A patch may use the same module more than once; each instance is separately addressable and carries its own parameter values and slot fills.",
379
445
"properties": {
380
446
"assignedNote": {
381
447
"description": "The one note this instance passes every note on at, whichever note arrived, where its module is a pitch assignment: a MIDI note number (60 is middle C). Only the pitch changes: each note still starts and stops when it did, at the strength it was played with. It lives here, in the patch, for the reason a note range does: which pitch a pad plays its sound at is a decision about this use of the module. Absent on every instance whose module is not a pitch assignment, and on one that passes every note at its own pitch.",
382
448
"maximum": 127,
383
449
"minimum": 0,
384
450
"type": "integer"
385
451
},
386
452
"enabled": {
387
453
"description": "Whether this instance does its work. An instance that is switched off makes no sound of its own, and anything reaching its audio inputs leaves its audio outputs unaltered. Optional permanently: an instance that says nothing is on, which is what every record written before this field existed says.",
388
454
"type": "boolean"
389
455
},
390
456
"glide": {
391
457
"description": "Whether the notes this instance plays slide into one another, and how. It lives here, in the patch, beside the unison and for the unison's reason: how a line slides is a decision about this use of the module, and forks with the patch. The player's own glide is a setting of their browser and says nothing about this one, so a loop written to slide slides for everyone who opens the patch, and a loop that does not is never made monophonic by the player's. Optional permanently: an instance that says nothing has no glide, which is what every record written before this field existed says.",
392
458
"ref": "#glide",
393
459
"type": "ref"
394
460
},
395
461
"instanceId": {
396
462
"maxLength": 64,
397
463
"minLength": 1,
398
464
"type": "string"
399
465
},
400
466
"lane": {
401
467
"description": "Which of `lanes` plays, counting the first as zero. Choosing a lane is an edit like choosing a sequencer's loop, so it is written here, and the patch opens on it. Optional permanently: absent is the first, and a reader plays one past the last as the last.",
402
468
"maximum": 7,
403
469
"minimum": 0,
404
470
"type": "integer"
405
471
},
406
472
"lanes": {
407
-
"description": "The automation lanes this instance holds, where its module is an automation block: each a whole number of bars of values from nothing to one, played in time with the loops. One plays at a time, as one of a sequencer's loops does, and an arranger or a scenes block wired to the block's pattern input chooses which. It lives here, in the patch, for the reason a pattern does: what is played is a decision about this use of the module. Absent on every instance whose module is not an automation block.",
473
+
"description": "The automation lanes this instance holds, where its module is an automation block: each so many bars or sixteenths of values from nothing to one, played in time with the loops. One plays at a time, as one of a sequencer's loops does, and an arranger or a scenes block wired to the block's pattern input chooses which. It lives here, in the patch, for the reason a pattern does: what is played is a decision about this use of the module. Absent on every instance whose module is not an automation block.",
408
474
"items": {
409
475
"ref": "#lane",
410
476
"type": "ref"
411
477
},
412
478
"maxLength": 8,
413
479
"type": "array"
414
480
},
415
481
"midiControls": {
416
482
"description": "Which MIDI control changes move this instance's parameters while it is played. A binding lives here, in the patch, because which knob moves what is a decision about this use of the module and not about the module.",
417
483
"items": {
418
484
"ref": "#midiControl",
419
485
"type": "ref"
420
486
},
421
487
"type": "array"
422
488
},
423
489
"module": {
424
490
"ref": "#moduleRef",
425
491
"type": "ref"
426
492
},
427
493
"name": {
428
494
"description": "What the creator called this instance, so that two uses of one module — a sequencer playing the bass beside one playing the chords — are told apart by what each does. It lives here, in the patch, because what a use of a module is for is a decision about this use and not about the module. Optional permanently: an instance that says nothing is called by its module's name, which is what every record written before an instance could be named says.",
429
495
"maxGraphemes": 32,
430
496
"maxLength": 320,
431
497
"minLength": 1,
432
498
"type": "string"
433
499
},
434
500
"noteLength": {
435
501
"description": "How many milliseconds every note this instance passes on lasts, where its module is a one-shot, however briefly or long whatever played it held it: a pad tapped in front of a drum plays the drum's whole hit. When the length is up the note is let go of and its sound follows its own release. Only how long a note lasts changes: each still starts when it was struck, at its own pitch and the strength it was played with. It lives here, in the patch, for the reason a note range does. Absent on every instance whose module is not a one-shot; on a one-shot, absent is 100 milliseconds.",
436
502
"maximum": 10000,
437
503
"minimum": 1,
438
504
"type": "integer"
439
505
},
440
506
"notePattern": {
441
507
"description": "The pattern this instance loops, where its module is a sequencer. It lives here, in the patch, for the reason a sample slot fill and a control binding do: what is played is a decision about this use of the module, and writing one never touches the module's record. Absent on every instance whose module is not a sequencer.",
442
508
"ref": "#notePattern",
443
509
"type": "ref"
444
510
},
445
511
"noteRange": {
446
512
"description": "Which notes this instance passes on, where its module is a note range. It lives here, in the patch, for the reason a pattern does: which pad or which half of a keyboard plays which sound is a decision about this use of the module, and forks with the patch. Absent on every instance whose module is not a note range, and on one that passes every note.",
447
513
"ref": "#noteRange",
448
514
"type": "ref"
449
515
},
450
516
"parameterValues": {
451
517
"items": {
452
518
"ref": "#parameterValue",
453
519
"type": "ref"
454
520
},
455
521
"type": "array"
456
522
},
457
523
"position": {
458
524
"description": "Where the creator placed this instance in the patch's arrangement, so the arrangement travels with the patch and a fork inherits it. Optional permanently, and the only field in either description that exists for presentation.",
459
525
"ref": "#position",
460
526
"type": "ref"
461
527
},
462
528
"sampleSlotFills": {
463
529
"description": "Samples this instance supplies for the module's declared slots. A fill lives here, in the patch, so writing one never touches the module.",
464
530
"items": {
465
531
"ref": "#sampleSlotFill",
466
532
"type": "ref"
467
533
},
468
534
"type": "array"
469
535
},
470
536
"scene": {
471
537
"description": "Which of `scenes` is playing, counting the first as zero. Choosing a scene is an edit like choosing a sequencer's loop, so it is written here, and the patch opens on it. Optional permanently: absent is the first, and a reader plays one past the last as the last.",
472
538
"maximum": 25,
473
539
"minimum": 0,
474
540
"type": "integer"
475
541
},
476
542
"sceneLaunch": {
477
543
"description": "When a scene chosen on this instance takes over, and where the loops it names start. Optional permanently: absent is on the next bar, from their first step.",
478
544
"ref": "#sceneLaunch",
479
545
"type": "ref"
480
546
},
481
547
"scenes": {
482
548
"description": "The scenes this instance switches between, where its module is a scenes block: which loop each sequencer wired to it plays in each. It lives here for the reason a song does. Absent on every instance whose module is not a scenes block.",
483
549
"items": {
484
550
"ref": "#scene",
485
551
"type": "ref"
486
552
},
487
553
"maxLength": 26,
488
554
"type": "array"
489
555
},
490
556
"song": {
491
557
"description": "The song this instance plays, where its module is an arranger: which loop each sequencer wired to it plays, section by section. It lives here, in the patch, for the reason a pattern does: what is played is a decision about this use of the module. Absent on every instance whose module is not an arranger.",
492
558
"ref": "#song",
493
559
"type": "ref"
494
560
},
495
561
"thru": {
496
562
"description": "Whether the notes reaching this instance's input are passed on to whatever it plays, where its module is a sequencer: a keyboard wired into it is then heard through it as well as recorded by it. It lives here, in the patch, because what a sequencer passes on is part of how the patch sounds. Optional permanently: an instance that says nothing passes them on, and only `false` is ever written.",
497
563
"type": "boolean"
498
564
},
499
565
"transpose": {
500
566
"description": "How many semitones this instance moves every note it passes on, where its module is a transpose: twelve is an octave up, and a negative number is down. A note moved past the lowest or the highest MIDI note is not passed on. It lives here, in the patch, for the reason a note range does. Absent on every instance whose module is not a transpose, and on one that moves nothing.",
501
567
"maximum": 127,
502
568
"minimum": -127,
503
569
"type": "integer"
504
570
},
505
571
"unison": {
506
572
"description": "How many voices each note this instance plays is sounded by, detuned narrowly against each other and centred on the note. It lives here, in the patch, for the reason the pattern above it does: how a loop is voiced is a decision about this use of the module. The player's own unison is a setting of their browser and says nothing about this one, so a loop written thick stays thick for everyone who opens the patch. Optional permanently: an instance that says nothing plays one voice per note, which is what every record written before this field existed says.",
507
573
"maximum": 6,
508
574
"minimum": 1,
509
575
"type": "integer"
510
576
},
511
577
"voiceScope": {
512
578
"description": "Whether this instance is built once for each sounding note or once for the whole patch. One of the two, always: the choice is made when the module is added, from what the module is, and is the creator's to move afterwards. There is no third value and no leaving it out — an instance that said nothing left the answer to be worked out afresh every time the patch was played, which is a decision nobody could see and nobody could change.",
513
579
"enum": [
514
580
"perNote",
515
581
"perPatch"
516
582
],
517
583
"type": "string"
518
584
}
519
585
},
520
586
"required": [
521
587
"instanceId",
522
588
"module",
523
589
"voiceScope"
524
590
],
525
591
"type": "object"
526
592
},
527
593
"moduleRef": {
528
594
"description": "A pin to one exact published version of a module. Resolving it fetches that record, whoever authored it.",
529
595
"properties": {
530
596
"authorDid": {
531
597
"format": "did",
532
598
"type": "string"
533
599
},
534
600
"moduleId": {
535
601
"maxLength": 128,
536
602
"minLength": 1,
537
603
"type": "string"
538
604
},
539
605
"versionKey": {
540
606
"description": "The pinned version's record key, which is also the `versionKey` that version carries. A reader fetches the module record at this key.",
541
607
"maxLength": 128,
542
608
"minLength": 1,
543
609
"type": "string"
544
610
}
545
611
},
546
612
"required": [
547
613
"moduleId",
548
614
"versionKey",
549
615
"authorDid"
550
616
],
551
617
"type": "object"
552
618
},
553
619
"noteEvent": {
554
620
"description": "One note struck at one moment of the loop, held from it, and struck as hard and as often as it says. It is written one of two ways: a note written now says the tick it is at and how many ticks it is held for, and a note written while the grid was part of what a note was says the step of that grid and how many of those steps it was held for. Both are read; the first is written.",
555
621
"properties": {
556
622
"at": {
557
623
"description": "The tick of the loop this note is struck at, counted from its start at 96 ticks to the beat. Ticks rather than steps of the grid, because a note is at a moment and the grid is a guide over it: 96 is divided exactly by every grid this description offers, so a note keeps its moment however the grid is changed.",
558
624
"minimum": 0,
559
625
"type": "integer"
560
626
},
627
+
"bend": {
628
+
"description": "How this note is bent while it is held, as the hand that played it bent it with a wheel or a finger: points in order of `at`, one to a tick, joined by straight lines. Before the first point the note is at the first point's value and after the last it stays at the last's; nothing at or after `hold` is heard, since a note let go is bent no further. Optional permanently: a note that says nothing is played at the pitch it is written at, which is what every pattern written before a note could be bent says, and an unbent note writes no field.",
629
+
"items": {
630
+
"ref": "#bendPoint",
631
+
"type": "ref"
632
+
},
633
+
"maxLength": 256,
634
+
"type": "array"
635
+
},
561
636
"hold": {
562
-
"description": "How many ticks this note is held for. Counted in ticks rather than in seconds for the reason the start is: a phrase written at 90 is the same phrase, held notes and all, at 140. A note is cut off by the loop's end and by the next note of its own pitch, since the same pitch overlapping itself is one voice rather than two.",
637
+
"description": "How many ticks this note is held for. Counted in ticks rather than in seconds for the reason the start is: a phrase written at 90 is the same phrase, held notes and all, at 140. A note is cut off by the next note of its own pitch, since the same pitch overlapping itself is one voice rather than two. The next is counted round the loop: a note may run past the loop's end and on into the next time round, as a key held over the end of the loop does, as far as the first note of its pitch there and never longer than the loop.",
563
638
"minimum": 1,
564
639
"type": "integer"
565
640
},
566
641
"length": {
567
642
"description": "How many steps of the grid this note is held for, where its start is written as a step. Absent is one, which is what every pattern written before notes had a length says.",
568
643
"minimum": 1,
569
644
"type": "integer"
570
645
},
571
646
"note": {
572
647
"description": "The MIDI note number. 60 is middle C.",
573
648
"maximum": 127,
574
649
"minimum": 0,
575
650
"type": "integer"
576
651
},
577
652
"probability": {
578
653
"description": "How likely this note is to be struck each time the loop comes round, in percent, asked afresh on every pass. Optional permanently: a note that says nothing is struck every time, which is what every pattern written before a note could say otherwise says, and a certain note writes no field. Nought is not offered, for the reason a velocity of nought is not.",
579
654
"maximum": 100,
580
655
"minimum": 1,
581
656
"type": "integer"
582
657
},
583
658
"step": {
584
659
"description": "Which step of the grid this note is on, counted from the start of the loop. The older way of saying where a note is, read from every pattern published before a note carried a tick and written by none.",
585
660
"minimum": 0,
586
661
"type": "integer"
587
662
},
588
663
"velocity": {
589
664
"description": "How hard this note is struck, on the MIDI scale. It is part of what is played rather than how it is listened to — a phrase is written with its accents in it, and a loop where every note lands identically is a loop nobody wrote. Optional permanently: a note that says nothing is struck at 100, which is what every pattern written before a note could say says, and a note struck at 100 writes no field. Nought is not offered, since a note that could never be heard is a note taken off the loop rather than one written onto it.",
590
665
"maximum": 127,
591
666
"minimum": 1,
592
667
"type": "integer"
593
668
}
594
669
},
595
670
"required": [
596
671
"note"
597
672
],
598
673
"type": "object"
599
674
},
600
675
"noteOutputRef": {
601
676
"properties": {
602
677
"instanceId": {
603
678
"maxLength": 64,
604
679
"minLength": 1,
605
680
"type": "string"
606
681
},
607
682
"noteOutput": {
608
683
"maxLength": 64,
609
684
"minLength": 1,
610
685
"type": "string"
611
686
}
612
687
},
613
688
"required": [
614
689
"instanceId",
615
690
"noteOutput"
616
691
],
617
692
"type": "object"
618
693
},
619
694
"notePattern": {
620
-
"description": "The loops one sequencer holds, and the grid they are written on. A loop is a whole number of bars and the notes in it are counted in ticks of the beat, so a pattern means the same thing at any tempo — what a tick is worth in seconds is the player's tempo's business and not the pattern's. The first loop is written here, where a pattern has always been written; any after it are alternates.",
695
+
"description": "The loops one sequencer holds, and the grid they are written on. A loop is a whole number of bars, or of sixteenths where it says so, and the notes in it are counted in ticks of the beat, so a pattern means the same thing at any tempo — what a tick is worth in seconds is the player's tempo's business and not the pattern's. The first loop is written here, where a pattern has always been written; any after it are alternates.",
621
696
"properties": {
622
697
"active": {
623
698
"description": "Which loop is played, counting the one written here as zero. Absent is the first. It is in the record because it is what a visitor opening the patch hears — unlike stopping a loop, which is how a browser is listening and is written nowhere. Every loop counts from the same downbeat and wraps at its own length whether or not it is the one being heard, so switching between them reveals where the other had got to rather than starting it.",
624
699
"minimum": 0,
625
700
"type": "integer"
626
701
},
627
702
"alternates": {
628
703
"description": "The loops after the first. Absent while the sequencer holds a single pattern, which is what every sequencer written before there could be more than one says.",
629
704
"items": {
630
705
"ref": "#alternatePattern",
631
706
"type": "ref"
632
707
},
633
708
"maxLength": 7,
634
709
"type": "array"
635
710
},
636
711
"bars": {
637
-
"description": "How long the first loop is, in bars of four beats. There is no time signature anywhere here, and 4/4 is what a bar means to everyone who has not been told otherwise. Each loop keeps its own length: one may be four bars and the next five.",
712
+
"description": "How long the first loop is, in bars of the patch's time signature (`timeSignature`), which is 4/4 where it says none. Each loop keeps its own length: one may be four bars and the next five. Where `sixteenths` is present it is the length and this is the whole bars that covers, rounded up, so a reader that knows only bars plays the loop with a silent tail rather than refusing it.",
638
713
"maximum": 8,
639
714
"minimum": 1,
640
715
"type": "integer"
641
716
},
642
717
"events": {
643
718
"description": "The notes in the first loop. A moment carrying no note is a rest; a note starting outside the loop's length is not played.",
644
719
"items": {
645
720
"ref": "#noteEvent",
646
721
"type": "ref"
647
722
},
648
723
"maxLength": 2048,
649
724
"type": "array"
650
725
},
651
726
"name": {
652
727
"description": "What the creator called the first loop. Optional permanently: a loop that says nothing is called by its place, which is what every loop written before a loop could be named says.",
653
728
"maxGraphemes": 32,
654
729
"maxLength": 320,
655
730
"minLength": 1,
656
731
"type": "string"
657
732
},
658
733
"resolution": {
659
734
"description": "The grid every loop on this sequencer is drawn and snapped to. It is a guide and not a part of what is played: it decides where a note being put down lands, and changing it moves nothing already written, so a loop may hold a note no line of the current grid passes through.",
660
735
"ref": "#resolution",
661
736
"type": "ref"
737
+
},
738
+
"sixteenths": {
739
+
"description": "How long the first loop is, in sixteenth notes, where it is not a whole number of bars: three beats is twelve. It is a length in the beat rather than the bar, so a loop that says it keeps its length when the time signature changes. Optional permanently: absent is `bars` of the patch's bar, which is what every loop written before a loop could end inside a bar says.",
740
+
"maximum": 2048,
741
+
"minimum": 1,
742
+
"type": "integer"
743
+
},
744
+
"swing": {
745
+
"description": "How the first loop swings. Optional permanently: a loop that says nothing is played straight, which is what every loop written before a loop could swing says.",
746
+
"ref": "#swing",
747
+
"type": "ref"
662
748
}
663
749
},
664
750
"required": [
665
751
"bars",
666
752
"resolution"
667
753
],
668
754
"type": "object"
669
755
},
670
756
"noteRange": {
671
757
"description": "The notes a note range passes on: from its lowest to its highest, both included, as MIDI note numbers (60 is middle C). Either end may be left out, and an end left out is open, so a range with only a lowest passes that note and everything above it. The same note at both ends is one key or one pad.",
672
758
"properties": {
673
759
"highest": {
674
760
"description": "The highest note passed on, at or above the lowest. Absent is the highest there is.",
675
761
"maximum": 127,
676
762
"minimum": 0,
677
763
"type": "integer"
678
764
},
679
765
"lowest": {
680
766
"description": "The lowest note passed on. Absent is the lowest there is.",
681
767
"maximum": 127,
682
768
"minimum": 0,
683
769
"type": "integer"
684
770
}
685
771
},
686
772
"type": "object"
687
773
},
688
774
"outputRef": {
689
775
"properties": {
690
776
"audioOutput": {
691
777
"maxLength": 64,
692
778
"minLength": 1,
693
779
"type": "string"
694
780
},
695
781
"instanceId": {
696
782
"maxLength": 64,
697
783
"minLength": 1,
698
784
"type": "string"
699
785
}
700
786
},
701
787
"required": [
702
788
"instanceId",
703
789
"audioOutput"
704
790
],
705
791
"type": "object"
706
792
},
707
793
"parameterValue": {
708
794
"description": "A value for one of the module's exposed parameters, or an explicit fall-back to the module's declared default.",
709
795
"properties": {
710
796
"id": {
711
797
"maxLength": 64,
712
798
"minLength": 1,
713
799
"type": "string"
714
800
},
715
801
"useDefault": {
716
802
"description": "Set where the patch explicitly defers to the module's default rather than recording a value.",
717
803
"type": "boolean"
718
804
},
719
805
"value": {
720
806
"description": "The value this patch sets the parameter to, always as text. A number is its decimal form — \"0.5\", and \"2\" for a whole one — because the ATproto data model has no floating-point type and a string is the only type that carries both a number and a word. Where the module declares a closed set of values instead, this is one of those strings, and a label that looks like a number stays the label it is: the module's own description says which of the two this parameter is.",
721
807
"maxLength": 200,
722
808
"type": "string"
723
809
}
724
810
},
725
811
"required": [
726
812
"id"
727
813
],
728
814
"type": "object"
729
815
},
730
816
"patternRoute": {
731
817
"description": "One sequencer whose loops, or one automation block whose lanes, an arranger or a scenes block chooses.",
732
818
"properties": {
733
819
"from": {
734
820
"description": "The arranger, or the scenes block.",
735
821
"maxLength": 64,
736
822
"minLength": 1,
737
823
"type": "string"
738
824
},
739
825
"instanceId": {
740
826
"description": "The sequencer or automation block, at its pattern input.",
741
827
"maxLength": 64,
742
828
"minLength": 1,
743
829
"type": "string"
744
830
}
745
831
},
746
832
"required": [
747
833
"from",
748
834
"instanceId"
749
835
],
750
836
"type": "object"
751
837
},
752
838
"position": {
753
839
"properties": {
754
840
"x": {
755
841
"type": "integer"
756
842
},
757
843
"y": {
758
844
"type": "integer"
759
845
}
760
846
},
761
847
"required": [
762
848
"x",
763
849
"y"
764
850
],
765
851
"type": "object"
766
852
},
767
853
"resolution": {
768
854
"description": "One note value, as a length and what that length is multiplied by. The same vocabulary the player's own musical time is counted in.",
769
855
"properties": {
770
856
"unit": {
771
857
"description": "Three of them into the time of two, or not. Absent is normal. A dotted grid is not offered: it does not divide a bar evenly, so it would leave a pattern whose steps do not line up with its own loop.",
772
858
"knownValues": [
773
859
"normal",
774
860
"triplet"
775
861
],
776
862
"type": "string"
777
863
},
778
864
"value": {
779
-
"description": "The note value one step is worth. A bar is four beats.",
865
+
"description": "The note value one step is worth. `bar` is one bar of the patch's time signature; every other value is a note, the same length in any bar.",
780
866
"knownValues": [
781
867
"bar",
782
868
"1/2",
783
869
"1/4",
784
870
"1/8",
785
871
"1/16",
786
872
"1/32",
787
873
"1/64",
788
874
"1/128"
789
875
],
790
876
"type": "string"
791
877
}
792
878
},
793
879
"required": [
794
880
"value"
795
881
],
796
882
"type": "object"
797
883
},
798
884
"sampleSlotFill": {
799
885
"properties": {
800
886
"blob": {
801
887
"accept": [
802
888
"audio/wav"
803
889
],
804
-
"maxSize": 2097152,
890
+
"maxSize": 10485760,
805
891
"type": "blob"
806
892
},
893
+
"name": {
894
+
"description": "What the creator calls this sample — Kick, Snare, Open hat — so a kit's pads are told apart by what each plays. It lives on the fill because it is a name for the sample that fills the slot: replaced with the sample, and gone with it. Optional permanently: a fill that says nothing is called by its slot, which is what every record written before a sample could be named says.",
895
+
"maxGraphemes": 32,
896
+
"maxLength": 320,
897
+
"minLength": 1,
898
+
"type": "string"
899
+
},
807
900
"ownerDid": {
808
901
"format": "did",
809
902
"type": "string"
810
903
},
811
904
"slotId": {
812
905
"maxLength": 64,
813
906
"minLength": 1,
814
907
"type": "string"
815
908
}
816
909
},
817
910
"required": [
818
911
"slotId",
819
912
"blob",
820
913
"ownerDid"
821
914
],
822
915
"type": "object"
823
916
},
824
917
"scene": {
825
918
"description": "One scene: which loop each sequencer wired to the scenes block plays while it is the scene playing. It lasts until another scene is chosen.",
826
919
"properties": {
827
920
"loops": {
828
921
"description": "Which loop each sequencer plays in this scene. A sequencer wired to the scenes block with no entry here rests while it plays.",
829
922
"items": {
830
923
"ref": "#sectionLoop",
831
924
"type": "ref"
832
925
},
833
926
"maxLength": 64,
834
927
"type": "array"
835
928
},
836
929
"name": {
837
930
"description": "What the creator called this scene. Optional permanently: a scene that says nothing is called by its letter.",
838
931
"maxGraphemes": 32,
839
932
"maxLength": 320,
840
933
"minLength": 1,
841
934
"type": "string"
842
935
}
843
936
},
844
937
"type": "object"
845
938
},
846
939
"sceneLaunch": {
847
940
"description": "When a scene chosen takes over, and where its loops start.",
848
941
"properties": {
849
942
"quantize": {
850
-
"description": "Where a scene chosen takes over: `none` at once, or on the next beat, bar, two bars or four bars, counted from the downbeat the loops count from. Optional permanently: absent is `bar`.",
943
+
"description": "Where a scene chosen takes over: `none` at once, or on the next beat, bar, two bars or four bars of the patch's time signature — a beat being the note its lower number names — counted from the downbeat the loops count from. Optional permanently: absent is `bar`.",
851
944
"knownValues": [
852
945
"none",
853
946
"beat",
854
947
"bar",
855
948
"2bars",
856
949
"4bars"
857
950
],
858
951
"type": "string"
859
952
},
860
953
"restart": {
861
954
"description": "Whether the loops a scene names start from their first step where it takes over, or carry on from where they already were. Optional permanently: absent is from their first step, so only `false` is written.",
862
955
"type": "boolean"
863
956
}
864
957
},
865
958
"type": "object"
866
959
},
867
960
"section": {
868
961
"description": "One section of a song: how long it is, and which loop each arranged sequencer plays for that long.",
869
962
"properties": {
870
963
"bars": {
871
-
"description": "How long this section is, in bars of four beats.",
964
+
"description": "How long this section is, in bars of the patch's time signature.",
872
965
"maximum": 64,
873
966
"minimum": 1,
874
967
"type": "integer"
875
968
},
876
969
"loops": {
877
970
"description": "Which loop each sequencer plays for this section. A sequencer wired to the arranger with no entry here rests for the section.",
878
971
"items": {
879
972
"ref": "#sectionLoop",
880
973
"type": "ref"
881
974
},
882
975
"maxLength": 64,
883
976
"type": "array"
884
977
},
885
978
"name": {
886
979
"description": "What the creator called this section. Optional permanently: a section that says nothing is called by its place.",
887
980
"maxGraphemes": 32,
888
981
"maxLength": 320,
889
982
"minLength": 1,
890
983
"type": "string"
891
984
}
892
985
},
893
986
"required": [
894
987
"bars"
895
988
],
896
989
"type": "object"
897
990
},
898
991
"sectionLoop": {
899
992
"properties": {
900
993
"instanceId": {
901
994
"description": "The sequencer, or the automation block.",
902
995
"maxLength": 64,
903
996
"minLength": 1,
904
997
"type": "string"
905
998
},
906
999
"loop": {
907
1000
"description": "Which of the sequencer's loops it plays, counting the one its pattern writes first as zero, or which of the automation block's lanes. One it does not hold is played as its last.",
908
1001
"maximum": 7,
909
1002
"minimum": 0,
910
1003
"type": "integer"
911
1004
}
912
1005
},
913
1006
"required": [
914
1007
"instanceId",
915
1008
"loop"
916
1009
],
917
1010
"type": "object"
918
1011
},
919
1012
"song": {
920
1013
"description": "An arranger's song: sections played one after another from its first beat. Each section starts every loop it names from that loop's first step, and lets go of whatever is still sounding when it ends, so a loop shorter than its section repeats and one longer is cut off.",
921
1014
"properties": {
922
1015
"end": {
923
1016
"description": "What happens when the last section ends: `stop` leaves the sequencers it arranges silent, `loop` plays the song again from its first section, and `hold` keeps playing the last section. Optional permanently: absent is `stop`.",
924
1017
"knownValues": [
925
1018
"stop",
926
1019
"loop",
927
1020
"hold"
928
1021
],
929
1022
"type": "string"
930
1023
},
931
1024
"sections": {
932
1025
"description": "The sections, in the order they are played.",
933
1026
"items": {
934
1027
"ref": "#section",
935
1028
"type": "ref"
936
1029
},
937
1030
"maxLength": 64,
938
1031
"type": "array"
939
1032
}
940
1033
},
941
1034
"type": "object"
1035
+
},
1036
+
"swing": {
1037
+
"description": "Every second eighth or sixteenth of a loop played late. The notes stay at the ticks they are written at, and the swing is applied as the loop is played: each pair of notes counted from the loop's start is heard with its second note `amount` percent of the way through the pair rather than half of it, and a note between two lines moves in proportion, so nothing changes order. A pair the loop's end cuts short is played straight. A reader meeting a value or an amount it does not swing by plays the loop straight.",
1038
+
"properties": {
1039
+
"amount": {
1040
+
"description": "Where the second note of each pair is heard, in percent of the pair. Fifty would be straight, which is written as no swing at all; seventy-five is a dotted note and the note after it.",
1041
+
"maximum": 75,
1042
+
"minimum": 51,
1043
+
"type": "integer"
1044
+
},
1045
+
"value": {
1046
+
"description": "The note whose every second one is played late: eighths, whose pairs are each a beat, or sixteenths, whose pairs are each half of one.",
1047
+
"knownValues": [
1048
+
"1/8",
1049
+
"1/16"
1050
+
],
1051
+
"type": "string"
1052
+
}
1053
+
},
1054
+
"required": [
1055
+
"amount",
1056
+
"value"
1057
+
],
1058
+
"type": "object"
1059
+
},
1060
+
"timeSignature": {
1061
+
"description": "A time signature as it is printed over a stave: how many beats one bar holds, over the note a beat is. The tempo counts quarter notes whatever the lower number is; what the two decide is how long a bar is, and so where every bar line falls.",
1062
+
"properties": {
1063
+
"denominator": {
1064
+
"description": "The note a beat is: 2 a half, 4 a quarter, 8 an eighth, 16 a sixteenth. The lower number.",
1065
+
"enum": [
1066
+
2,
1067
+
4,
1068
+
8,
1069
+
16
1070
+
],
1071
+
"type": "integer"
1072
+
},
1073
+
"numerator": {
1074
+
"description": "How many beats one bar holds: the upper number.",
1075
+
"maximum": 32,
1076
+
"minimum": 1,
1077
+
"type": "integer"
1078
+
}
1079
+
},
1080
+
"required": [
1081
+
"numerator",
1082
+
"denominator"
1083
+
],
1084
+
"type": "object"
1085
+
},
1086
+
"tuning": {
1087
+
"description": "A tuning: its degrees, each an interval above its first note, and which degree each key plays.",
1088
+
"properties": {
1089
+
"degrees": {
1090
+
"description": "The tuning's degrees above its first, which is the unison and is not written, exactly as Scala writes a pitch: a value with a point in it is cents (\"701.955\", \"-3.5\", \"1200.\"), and anything else a ratio of whole numbers above nothing (\"3/2\", or \"2\" for 2/1), which is kept as text so that it stays exact. The last is the period, the interval after which the degrees repeat, and is above the unison.",
1091
+
"items": {
1092
+
"maxLength": 32,
1093
+
"type": "string"
1094
+
},
1095
+
"maxLength": 128,
1096
+
"minLength": 1,
1097
+
"type": "array"
1098
+
},
1099
+
"keys": {
1100
+
"description": "Which degree each key plays: a .kbm file. Optional permanently: absent is the map Scala assumes without one, in which every key plays the next degree, key 60 plays the first and key 69 is the reference.",
1101
+
"ref": "#tuningKeys",
1102
+
"type": "ref"
1103
+
},
1104
+
"name": {
1105
+
"description": "What the tuning is called: a .scl file's description line.",
1106
+
"maxLength": 200,
1107
+
"type": "string"
1108
+
}
1109
+
},
1110
+
"required": [
1111
+
"degrees"
1112
+
],
1113
+
"type": "object"
1114
+
},
1115
+
"tuningKeys": {
1116
+
"description": "A key map, as a Scala .kbm file says it, except that it names no frequency: the reference key sounds where twelve-tone equal temperament puts it at the patch's concert pitch.",
1117
+
"properties": {
1118
+
"first": {
1119
+
"description": "The lowest key that sounds.",
1120
+
"maximum": 127,
1121
+
"minimum": 0,
1122
+
"type": "integer"
1123
+
},
1124
+
"last": {
1125
+
"description": "The highest key that sounds.",
1126
+
"maximum": 127,
1127
+
"minimum": 0,
1128
+
"type": "integer"
1129
+
},
1130
+
"map": {
1131
+
"description": "The degree each key of one repetition plays, from the middle key up, `size` of them: 0 is the unison, the number of degrees the period, and -1 a key that sounds nothing.",
1132
+
"items": {
1133
+
"minimum": -1,
1134
+
"type": "integer"
1135
+
},
1136
+
"maxLength": 128,
1137
+
"type": "array"
1138
+
},
1139
+
"middle": {
1140
+
"description": "The key that plays the first degree, the unison, and where the map's repetitions are counted from.",
1141
+
"maximum": 127,
1142
+
"minimum": 0,
1143
+
"type": "integer"
1144
+
},
1145
+
"periodDegree": {
1146
+
"description": "The degree one repetition of the map spans, its formal octave: each repetition up plays every key's degree that far above the last.",
1147
+
"minimum": 1,
1148
+
"type": "integer"
1149
+
},
1150
+
"reference": {
1151
+
"description": "The key the concert pitch anchors: it sounds where twelve-tone equal temperament puts it at the patch's concert pitch. It must play a degree.",
1152
+
"maximum": 127,
1153
+
"minimum": 0,
1154
+
"type": "integer"
1155
+
},
1156
+
"size": {
1157
+
"description": "How many keys one repetition of the map spans. 0 is a linear map, in which every key plays the next degree and the degrees repeat at their period; `map` is then empty and `periodDegree` is not read.",
1158
+
"maximum": 128,
1159
+
"minimum": 0,
1160
+
"type": "integer"
1161
+
}
1162
+
},
1163
+
"required": [
1164
+
"size",
1165
+
"first",
1166
+
"last",
1167
+
"middle",
1168
+
"reference",
1169
+
"periodDegree"
1170
+
],
1171
+
"type": "object"
942
1172
}
943
1173
},
944
1174
"description": "A synth patch: which modules it uses, how they are wired, what their parameters are set to, and how it is played. A patch plus the module records it pins is everything needed to reproduce it.",
945
1175
"id": "at.atmosynth.patch",
946
1176
"lexicon": 1
947
1177
}