at.atmosynth.patch

atmosynth.at

Schema Diff

+45 -3

From

CID
bafyreiaoul3ca4e...
Indexed At
2026-09-08 07:18 UTC
View this version

To

CID
bafyreicenwggxyj...
Indexed At
2026-09-14 18:09 UTC
View this version

Compatibility Analysis

Breaking Changes Detected

2 breaking changes, 12 non-breaking changes.

Breaking Changes (2)
  • KindChanged KindChanged { vertex_id: "at.atmosynth.patch#parameterValue.value", old_kind: "unknown", new_kind: "string" }
  • ConstraintAdded ConstraintAdded { vertex_id: "at.atmosynth.patch#parameterValue.value", sort: "maxLength", value: "200" }
Non-Breaking Changes (12)
  • AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#glide" }
  • AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#glide.fromLast" }
  • AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#glide.ms" }
  • AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#glide.rate" }
  • AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#moduleInstance.glide" }
  • AddedVertex AddedVertex { vertex_id: "at.atmosynth.patch#noteEvent.velocity" }
  • AddedEdge AddedEdge { src: "at.atmosynth.patch#glide", tgt: "at.atmosynth.patch#glide.fromLast", kind: "prop", name: Some("fromLast") }
  • AddedEdge AddedEdge { src: "at.atmosynth.patch#glide", tgt: "at.atmosynth.patch#glide.ms", kind: "prop", name: Some("ms") }
  • AddedEdge AddedEdge { src: "at.atmosynth.patch#glide", tgt: "at.atmosynth.patch#glide.rate", kind: "prop", name: Some("rate") }
  • AddedEdge AddedEdge { src: "at.atmosynth.patch#moduleInstance", tgt: "at.atmosynth.patch#moduleInstance.glide", kind: "prop", name: Some("glide") }
  • AddedEdge AddedEdge { src: "at.atmosynth.patch#moduleInstance.glide", tgt: "at.atmosynth.patch#glide", kind: "ref", name: None }
  • AddedEdge AddedEdge { src: "at.atmosynth.patch#noteEvent", tgt: "at.atmosynth.patch#noteEvent.velocity", kind: "prop", name: Some("velocity") }

Migration Guidance

Added Elements

  • AddedVertex { vertex_id: "at.atmosynth.patch#glide" }
  • AddedVertex { vertex_id: "at.atmosynth.patch#glide.fromLast" }
  • AddedVertex { vertex_id: "at.atmosynth.patch#glide.ms" }
  • AddedVertex { vertex_id: "at.atmosynth.patch#glide.rate" }
  • AddedVertex { vertex_id: "at.atmosynth.patch#moduleInstance.glide" }
  • AddedVertex { vertex_id: "at.atmosynth.patch#noteEvent.velocity" }

Constraint Changes

  • ConstraintAdded ConstraintAdded { vertex_id: "at.atmosynth.patch#parameterValue.value", sort: "maxLength", value: "200" }

Additional Notes

  • Breaking: KindChanged { vertex_id: "at.atmosynth.patch#parameterValue.value", old_kind: "unknown", new_kind: "string" }
  • Non-breaking: AddedEdge { src: "at.atmosynth.patch#glide", tgt: "at.atmosynth.patch#glide.fromLast", kind: "prop", name: Some("fromLast") }
  • Non-breaking: AddedEdge { src: "at.atmosynth.patch#glide", tgt: "at.atmosynth.patch#glide.ms", kind: "prop", name: Some("ms") }
  • Non-breaking: AddedEdge { src: "at.atmosynth.patch#glide", tgt: "at.atmosynth.patch#glide.rate", kind: "prop", name: Some("rate") }
  • Non-breaking: AddedEdge { src: "at.atmosynth.patch#moduleInstance", tgt: "at.atmosynth.patch#moduleInstance.glide", kind: "prop", name: Some("glide") }
  • Non-breaking: AddedEdge { src: "at.atmosynth.patch#moduleInstance.glide", tgt: "at.atmosynth.patch#glide", kind: "ref", name: None }
  • Non-breaking: AddedEdge { src: "at.atmosynth.patch#noteEvent", tgt: "at.atmosynth.patch#noteEvent.velocity", kind: "prop", name: Some("velocity") }
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 8
          "description": "How long this loop is, in bars of four beats.",
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
      },
23 23
      "required": [
24 24
        "bars"
25 25
      ],
26 26
      "type": "object"
27 27
    },
28 28
    "connection": {
29 29
      "description": "An audio connection between two module instances, naming the declared ports at each end.",
30 30
      "properties": {
31 31
        "from": {
32 32
          "ref": "#outputRef",
33 33
          "type": "ref"
34 34
        },
35 35
        "to": {
36 36
          "ref": "#inputRef",
37 37
          "type": "ref"
38 38
        }
39 39
      },
40 40
      "required": [
41 41
        "from",
42 42
        "to"
43 43
      ],
44 44
      "type": "object"
45 45
    },
46 +
    "glide": {
47 +
      "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.",
48 +
      "properties": {
49 +
        "fromLast": {
50 +
          "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.",
51 +
          "type": "boolean"
52 +
        },
53 +
        "ms": {
54 +
          "description": "How long a note takes to reach the next, in milliseconds.",
55 +
          "maximum": 5000,
56 +
          "minimum": 1,
57 +
          "type": "integer"
58 +
        },
59 +
        "rate": {
60 +
          "description": "Or: how long, as a note value at the tempo. The same vocabulary the grid is written in.",
61 +
          "knownValues": [
62 +
            "bar",
63 +
            "1/2",
64 +
            "1/4",
65 +
            "1/8",
66 +
            "1/16",
67 +
            "1/32",
68 +
            "1/64",
69 +
            "1/128"
70 +
          ],
71 +
          "type": "string"
72 +
        }
73 +
      },
74 +
      "type": "object"
75 +
    },
46 76
    "inputRef": {
47 77
      "properties": {
48 78
        "audioInput": {
49 79
          "maxLength": 64,
50 80
          "minLength": 1,
51 81
          "type": "string"
52 82
        },
53 83
        "instanceId": {
54 84
          "maxLength": 64,
55 85
          "minLength": 1,
56 86
          "type": "string"
57 87
        }
58 88
      },
59 89
      "required": [
60 90
        "instanceId",
61 91
        "audioInput"
62 92
      ],
63 93
      "type": "object"
64 94
    },
65 95
    "lineage": {
66 96
      "description": "The patch this one was forked from, and its creator. Preserved even when the source is later deleted.",
67 97
      "properties": {
68 98
        "creatorDid": {
69 99
          "format": "did",
70 100
          "type": "string"
71 101
        },
72 102
        "patchId": {
73 103
          "maxLength": 128,
74 104
          "type": "string"
75 105
        },
76 106
        "uri": {
77 107
          "format": "at-uri",
78 108
          "type": "string"
79 109
        }
80 110
      },
81 111
      "required": [
82 112
        "uri",
83 113
        "creatorDid"
84 114
      ],
85 115
      "type": "object"
86 116
    },
87 117
    "main": {
88 118
      "description": "A patch, held in its creator's own repository.",
89 119
      "key": "tid",
90 120
      "record": {
91 121
        "properties": {
92 122
          "connections": {
93 123
            "items": {
94 124
              "ref": "#connection",
95 125
              "type": "ref"
96 126
            },
97 127
            "type": "array"
98 128
          },
99 129
          "createdAt": {
100 130
            "format": "datetime",
101 131
            "type": "string"
102 132
          },
103 133
          "description": {
104 134
            "maxLength": 3000,
105 135
            "type": "string"
106 136
          },
107 137
          "descriptionVersion": {
108 138
            "description": "Version of the patch description this record follows.",
109 139
            "minimum": 1,
110 140
            "type": "integer"
111 141
          },
112 142
          "forkedFrom": {
113 143
            "ref": "#lineage",
114 144
            "type": "ref"
115 145
          },
116 146
          "midiRouting": {
117 147
            "description": "Which module instances receive MIDI input.",
118 148
            "items": {
119 149
              "ref": "#midiRoute",
120 150
              "type": "ref"
121 151
            },
122 152
            "type": "array"
123 153
          },
124 154
          "moduleInstances": {
125 155
            "items": {
126 156
              "ref": "#moduleInstance",
127 157
              "type": "ref"
128 158
            },
129 159
            "type": "array"
130 160
          },
131 161
          "name": {
132 162
            "maxLength": 200,
133 163
            "minLength": 1,
134 164
            "type": "string"
135 165
          },
136 166
          "output": {
137 167
            "description": "Which instance reaches the audio output.",
138 168
            "ref": "#outputRef",
139 169
            "type": "ref"
140 170
          },
141 171
          "tags": {
142 172
            "description": "Freely created tags, lower-cased on write so one hashtag matches one set of patches.",
143 173
            "items": {
144 174
              "maxLength": 128,
145 175
              "type": "string"
146 176
            },
147 177
            "type": "array"
148 178
          },
149 179
          "tempo": {
150 180
            "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.",
151 181
            "maximum": 300,
152 182
            "minimum": 20,
153 183
            "type": "integer"
154 184
          },
155 185
          "types": {
156 186
            "description": "Zero or more of the ten fixed types. A patch may carry several.",
157 187
            "items": {
158 188
              "knownValues": [
159 189
                "Lead",
160 190
                "Pad",
161 191
                "Bass",
162 192
                "Plucked",
163 193
                "Percussion",
164 194
                "Keys",
165 195
                "Brass",
166 196
                "Strings",
167 197
                "Vocal",
168 198
                "SFX"
169 199
              ],
170 200
              "type": "string"
171 201
            },
172 202
            "type": "array"
173 203
          }
174 204
        },
175 205
        "required": [
176 206
          "descriptionVersion",
177 207
          "name",
178 208
          "description",
179 209
          "moduleInstances",
180 210
          "createdAt"
181 211
        ],
182 212
        "type": "object"
183 213
      },
184 214
      "type": "record"
185 215
    },
186 216
    "midiControl": {
187 217
      "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, or, where the module declares a closed value set instead, 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.",
188 218
      "properties": {
189 219
        "controller": {
190 220
          "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.",
191 221
          "maximum": 127,
192 222
          "minimum": 0,
193 223
          "type": "integer"
194 224
        },
195 225
        "parameter": {
196 226
          "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.",
197 227
          "maxLength": 64,
198 228
          "minLength": 1,
199 229
          "type": "string"
200 230
        }
201 231
      },
202 232
      "required": [
203 233
        "parameter",
204 234
        "controller"
205 235
      ],
206 236
      "type": "object"
207 237
    },
208 238
    "midiRoute": {
209 239
      "description": "Where one instance's notes come from. `instanceId` and `midiInput` name the MIDI input they arrive at; `from` names the note output they leave. **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.",
210 240
      "properties": {
211 241
        "from": {
212 242
          "description": "The note output these notes leave. Absent where they come from the player.",
213 243
          "ref": "#noteOutputRef",
214 244
          "type": "ref"
215 245
        },
216 246
        "instanceId": {
217 247
          "maxLength": 64,
218 248
          "minLength": 1,
219 249
          "type": "string"
220 250
        },
221 251
        "midiInput": {
222 252
          "maxLength": 64,
223 253
          "minLength": 1,
224 254
          "type": "string"
225 255
        }
226 256
      },
227 257
      "required": [
228 258
        "instanceId",
229 259
        "midiInput"
230 260
      ],
231 261
      "type": "object"
232 262
    },
233 263
    "moduleInstance": {
234 264
      "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.",
235 265
      "properties": {
236 266
        "enabled": {
237 267
          "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.",
238 268
          "type": "boolean"
239 269
        },
270 +
        "glide": {
271 +
          "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.",
272 +
          "ref": "#glide",
273 +
          "type": "ref"
274 +
        },
240 275
        "instanceId": {
241 276
          "maxLength": 64,
242 277
          "minLength": 1,
243 278
          "type": "string"
244 279
        },
245 280
        "midiControls": {
246 281
          "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.",
247 282
          "items": {
248 283
            "ref": "#midiControl",
249 284
            "type": "ref"
250 285
          },
251 286
          "type": "array"
252 287
        },
253 288
        "module": {
254 289
          "ref": "#moduleRef",
255 290
          "type": "ref"
256 291
        },
257 292
        "notePattern": {
258 293
          "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 note source.",
259 294
          "ref": "#notePattern",
260 295
          "type": "ref"
261 296
        },
262 297
        "parameterValues": {
263 298
          "items": {
264 299
            "ref": "#parameterValue",
265 300
            "type": "ref"
266 301
          },
267 302
          "type": "array"
268 303
        },
269 304
        "position": {
270 305
          "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.",
271 306
          "ref": "#position",
272 307
          "type": "ref"
273 308
        },
274 309
        "sampleSlotFills": {
275 310
          "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.",
276 311
          "items": {
277 312
            "ref": "#sampleSlotFill",
278 313
            "type": "ref"
279 314
          },
280 315
          "type": "array"
281 316
        },
282 317
        "unison": {
283 318
          "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.",
284 319
          "maximum": 6,
285 320
          "minimum": 1,
286 321
          "type": "integer"
287 322
        },
288 323
        "voiceScope": {
289 324
          "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.",
290 325
          "enum": [
291 326
            "perNote",
292 327
            "perPatch"
293 328
          ],
294 329
          "type": "string"
295 330
        }
296 331
      },
297 332
      "required": [
298 333
        "instanceId",
299 334
        "module",
300 335
        "voiceScope"
301 336
      ],
302 337
      "type": "object"
303 338
    },
304 339
    "moduleRef": {
305 340
      "description": "A pin to one exact published version of a module. Resolving it fetches that record, whoever authored it.",
306 341
      "properties": {
307 342
        "authorDid": {
308 343
          "format": "did",
309 344
          "type": "string"
310 345
        },
311 346
        "moduleId": {
312 347
          "maxLength": 128,
313 348
          "minLength": 1,
314 349
          "type": "string"
315 350
        },
316 351
        "versionKey": {
317 352
          "maxLength": 128,
318 353
          "minLength": 1,
319 354
          "type": "string"
320 355
        }
321 356
      },
322 357
      "required": [
323 358
        "moduleId",
324 359
        "versionKey",
325 360
        "authorDid"
326 361
      ],
327 362
      "type": "object"
328 363
    },
329 364
    "noteEvent": {
330 -
      "description": "One note struck at one moment of the loop and held from it, at one fixed strength — a pattern is what is played and not how hard. 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.",
365 +
      "description": "One note struck at one moment of the loop, held from it, and struck as hard 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.",
331 366
      "properties": {
332 367
        "at": {
333 368
          "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.",
334 369
          "minimum": 0,
335 370
          "type": "integer"
336 371
        },
337 372
        "hold": {
338 373
          "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.",
339 374
          "minimum": 1,
340 375
          "type": "integer"
341 376
        },
342 377
        "length": {
343 378
          "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.",
344 379
          "minimum": 1,
345 380
          "type": "integer"
346 381
        },
347 382
        "note": {
348 383
          "description": "The MIDI note number. 60 is middle C.",
349 384
          "maximum": 127,
350 385
          "minimum": 0,
351 386
          "type": "integer"
352 387
        },
353 388
        "step": {
354 389
          "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.",
355 390
          "minimum": 0,
356 391
          "type": "integer"
392 +
        },
393 +
        "velocity": {
394 +
          "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.",
395 +
          "maximum": 127,
396 +
          "minimum": 1,
397 +
          "type": "integer"
357 398
        }
358 399
      },
359 400
      "required": [
360 401
        "note"
361 402
      ],
362 403
      "type": "object"
363 404
    },
364 405
    "noteOutputRef": {
365 406
      "properties": {
366 407
        "instanceId": {
367 408
          "maxLength": 64,
368 409
          "minLength": 1,
369 410
          "type": "string"
370 411
        },
371 412
        "noteOutput": {
372 413
          "maxLength": 64,
373 414
          "minLength": 1,
374 415
          "type": "string"
375 416
        }
376 417
      },
377 418
      "required": [
378 419
        "instanceId",
379 420
        "noteOutput"
380 421
      ],
381 422
      "type": "object"
382 423
    },
383 424
    "notePattern": {
384 425
      "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.",
385 426
      "properties": {
386 427
        "active": {
387 428
          "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.",
388 429
          "minimum": 0,
389 430
          "type": "integer"
390 431
        },
391 432
        "alternates": {
392 433
          "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.",
393 434
          "items": {
394 435
            "ref": "#alternatePattern",
395 436
            "type": "ref"
396 437
          },
397 438
          "maxLength": 7,
398 439
          "type": "array"
399 440
        },
400 441
        "bars": {
401 442
          "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.",
402 443
          "maximum": 8,
403 444
          "minimum": 1,
404 445
          "type": "integer"
405 446
        },
406 447
        "events": {
407 448
          "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.",
408 449
          "items": {
409 450
            "ref": "#noteEvent",
410 451
            "type": "ref"
411 452
          },
412 453
          "maxLength": 2048,
413 454
          "type": "array"
414 455
        },
415 456
        "resolution": {
416 457
          "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.",
417 458
          "ref": "#resolution",
418 459
          "type": "ref"
419 460
        }
420 461
      },
421 462
      "required": [
422 463
        "bars",
423 464
        "resolution"
424 465
      ],
425 466
      "type": "object"
426 467
    },
427 468
    "outputRef": {
428 469
      "properties": {
429 470
        "audioOutput": {
430 471
          "maxLength": 64,
431 472
          "minLength": 1,
432 473
          "type": "string"
433 474
        },
434 475
        "instanceId": {
435 476
          "maxLength": 64,
436 477
          "minLength": 1,
437 478
          "type": "string"
438 479
        }
439 480
      },
440 481
      "required": [
441 482
        "instanceId",
442 483
        "audioOutput"
443 484
      ],
444 485
      "type": "object"
445 486
    },
446 487
    "parameterValue": {
447 488
      "description": "A value for one of the module's exposed parameters, or an explicit fall-back to the module's declared default.",
448 489
      "properties": {
449 490
        "id": {
450 491
          "maxLength": 64,
451 492
          "minLength": 1,
452 493
          "type": "string"
453 494
        },
454 495
        "useDefault": {
455 496
          "description": "Set where the patch explicitly defers to the module's default rather than recording a value.",
456 497
          "type": "boolean"
457 498
        },
458 499
        "value": {
459 -
          "description": "The value this patch sets the parameter to. A number that is not a whole number is carried as its decimal string — \"0.5\", not 0.5 — because the ATproto data model has no floating-point type and a PDS refuses one. A whole number is an ordinary integer, and a reader turns such a string back into a number. 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.",
460 -
          "type": "unknown"
500 +
          "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.",
501 +
          "maxLength": 200,
502 +
          "type": "string"
461 503
        }
462 504
      },
463 505
      "required": [
464 506
        "id"
465 507
      ],
466 508
      "type": "object"
467 509
    },
468 510
    "position": {
469 511
      "properties": {
470 512
        "x": {
471 513
          "type": "integer"
472 514
        },
473 515
        "y": {
474 516
          "type": "integer"
475 517
        }
476 518
      },
477 519
      "required": [
478 520
        "x",
479 521
        "y"
480 522
      ],
481 523
      "type": "object"
482 524
    },
483 525
    "resolution": {
484 526
      "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.",
485 527
      "properties": {
486 528
        "unit": {
487 529
          "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.",
488 530
          "knownValues": [
489 531
            "normal",
490 532
            "triplet"
491 533
          ],
492 534
          "type": "string"
493 535
        },
494 536
        "value": {
495 537
          "description": "The note value one step is worth. A bar is four beats.",
496 538
          "knownValues": [
497 539
            "bar",
498 540
            "1/2",
499 541
            "1/4",
500 542
            "1/8",
501 543
            "1/16",
502 544
            "1/32",
503 545
            "1/64",
504 546
            "1/128"
505 547
          ],
506 548
          "type": "string"
507 549
        }
508 550
      },
509 551
      "required": [
510 552
        "value"
511 553
      ],
512 554
      "type": "object"
513 555
    },
514 556
    "sampleSlotFill": {
515 557
      "properties": {
516 558
        "blob": {
517 559
          "accept": [
518 560
            "audio/wav"
519 561
          ],
520 562
          "maxSize": 2097152,
521 563
          "type": "blob"
522 564
        },
523 565
        "ownerDid": {
524 566
          "format": "did",
525 567
          "type": "string"
526 568
        },
527 569
        "slotId": {
528 570
          "maxLength": 64,
529 571
          "minLength": 1,
530 572
          "type": "string"
531 573
        }
532 574
      },
533 575
      "required": [
534 576
        "slotId",
535 577
        "blob",
536 578
        "ownerDid"
537 579
      ],
538 580
      "type": "object"
539 581
    }
540 582
  },
541 583
  "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.",
542 584
  "id": "at.atmosynth.patch",
543 585
  "lexicon": 1
544 586
}

Compare Other Versions

Lexicon Garden

@