at.atmosynth.arrangement

atmosynth.at

Documentation

An arrangement, held in its creator's own repository.

main record

An arrangement, held in its creator's own repository.

Record Key tid Timestamp-based ID

Properties

createdAt string datetime Required

An RFC 3339 formatted timestamp.

description string Optional

No description available.

maxLength: 3000 bytes
keys array of ref at.atmosynth.defs#keyPoint Optional

The key map: the first point at 0, each later than the one before. Optional: absent says no key, which is an arrangement's to leave unsaid.

maxLength: 1024 items
length integer Optional

Where the arrangement ends, in ticks. Optional: absent ends it with its last clip.

minimum: 1
lineage array of ref at.atmosynth.defs#lineage Optional

Where the arrangement came from: the arrangement it was forked from, the patch it was made of, and every record anything in it was imported from, so its credits are complete without reading anything else.

maxLength: 64 items
loop ref #loopRange Optional

The range its creator loops over while working on it. Optional: absent is no loop range. A reader that does not loop, such as a renderer, ignores it: an arrangement played through is played once, from start to end.

meter array of ref at.atmosynth.defs#meterPoint Optional

The meter map: the first point at 0, each later one on a bar line of the meter before it. Optional: absent is 4/4 throughout.

maxLength: 1024 items
name string Required

No description available.

maxLength: 200 bytesminLength: 1 bytes
openToParts boolean Optional

Whether parts offered to this arrangement and not yet included are shown to everybody, rather than to its creator alone. Anybody may write a part naming any arrangement in their own repository; this only decides what the arrangement's own page lists. Optional: absent is its creator alone, and only `true` is written.

parts array of ref #includedPart Optional

Parts other people wrote for this arrangement, in their own repositories, which its creator has included. An included part is heard as it is now; a part its writer has since deleted is no longer heard.

maxLength: 64 items
tags array of string Optional

Freely created tags, lower-cased on write.

maxLength: 32 items
tempo array of ref at.atmosynth.defs#tempoPoint Required

The tempo map: the first point at 0, each later than the one before. One point is an arrangement at one tempo. A player that is a host with a clock of its own, a DAW, plays at its tempo instead.

maxLength: 1024 itemsminLength: 1 items
tracks array of ref at.atmosynth.defs#track Required

The tracks, in the order they are shown. One of them is the bus `master`, which every track reaches in the end and which alone goes to the speakers.

maxLength: 256 itemsminLength: 1 items
View raw schema 
{
  "description": "An arrangement, held in its creator's own repository.",
  "key": "tid",
  "record": {
    "properties": {
      "createdAt": {
        "format": "datetime",
        "type": "string"
      },
      "description": {
        "maxLength": 3000,
        "type": "string"
      },
      "keys": {
        "description": "The key map: the first point at 0, each later than the one before. Optional: absent says no key, which is an arrangement's to leave unsaid.",
        "items": {
          "ref": "at.atmosynth.defs#keyPoint",
          "type": "ref"
        },
        "maxLength": 1024,
        "type": "array"
      },
      "length": {
        "description": "Where the arrangement ends, in ticks. Optional: absent ends it with its last clip.",
        "minimum": 1,
        "type": "integer"
      },
      "license": {
        "ref": "at.atmosynth.defs#license",
        "type": "ref"
      },
      "lineage": {
        "description": "Where the arrangement came from: the arrangement it was forked from, the patch it was made of, and every record anything in it was imported from, so its credits are complete without reading anything else.",
        "items": {
          "ref": "at.atmosynth.defs#lineage",
          "type": "ref"
        },
        "maxLength": 64,
        "type": "array"
      },
      "loop": {
        "description": "The range its creator loops over while working on it. Optional: absent is no loop range. A reader that does not loop, such as a renderer, ignores it: an arrangement played through is played once, from start to end.",
        "ref": "#loopRange",
        "type": "ref"
      },
      "markers": {
        "description": "Named moments, in order of `at`.",
        "items": {
          "ref": "at.atmosynth.defs#marker",
          "type": "ref"
        },
        "maxLength": 1024,
        "type": "array"
      },
      "meter": {
        "description": "The meter map: the first point at 0, each later one on a bar line of the meter before it. Optional: absent is 4/4 throughout.",
        "items": {
          "ref": "at.atmosynth.defs#meterPoint",
          "type": "ref"
        },
        "maxLength": 1024,
        "type": "array"
      },
      "name": {
        "maxLength": 200,
        "minLength": 1,
        "type": "string"
      },
      "openToParts": {
        "description": "Whether parts offered to this arrangement and not yet included are shown to everybody, rather than to its creator alone. Anybody may write a part naming any arrangement in their own repository; this only decides what the arrangement's own page lists. Optional: absent is its creator alone, and only `true` is written.",
        "type": "boolean"
      },
      "parts": {
        "description": "Parts other people wrote for this arrangement, in their own repositories, which its creator has included. An included part is heard as it is now; a part its writer has since deleted is no longer heard.",
        "items": {
          "ref": "#includedPart",
          "type": "ref"
        },
        "maxLength": 64,
        "type": "array"
      },
      "tags": {
        "description": "Freely created tags, lower-cased on write.",
        "items": {
          "maxLength": 128,
          "type": "string"
        },
        "maxLength": 32,
        "type": "array"
      },
      "tempo": {
        "description": "The tempo map: the first point at 0, each later than the one before. One point is an arrangement at one tempo. A player that is a host with a clock of its own, a DAW, plays at its tempo instead.",
        "items": {
          "ref": "at.atmosynth.defs#tempoPoint",
          "type": "ref"
        },
        "maxLength": 1024,
        "minLength": 1,
        "type": "array"
      },
      "tracks": {
        "description": "The tracks, in the order they are shown. One of them is the bus `master`, which every track reaches in the end and which alone goes to the speakers.",
        "items": {
          "ref": "at.atmosynth.defs#track",
          "type": "ref"
        },
        "maxLength": 256,
        "minLength": 1,
        "type": "array"
      }
    },
    "required": [
      "name",
      "tempo",
      "tracks",
      "createdAt"
    ],
    "type": "object"
  },
  "type": "record"
}
includedPart object

One part this arrangement includes, and how its creator mixes it.

Properties

mix array of ref#partMix Optional

The arrangement's creator's mix of the part's tracks, which stands in place of the part's own strips and destinations wherever it names a track. A track it does not name is heard as the part writes it.

maxLength: 32 items
part ref com.atproto.repo.strongRef Required

The part, and the version of it that was included. The part is heard as it is now; the version says what the arrangement's creator agreed to, so a change since can be shown to them.

View raw schema 
{
  "description": "One part this arrangement includes, and how its creator mixes it.",
  "properties": {
    "mix": {
      "description": "The arrangement's creator's mix of the part's tracks, which stands in place of the part's own strips and destinations wherever it names a track. A track it does not name is heard as the part writes it.",
      "items": {
        "ref": "#partMix",
        "type": "ref"
      },
      "maxLength": 32,
      "type": "array"
    },
    "part": {
      "description": "The part, and the version of it that was included. The part is heard as it is now; the version says what the arrangement's creator agreed to, so a change since can be shown to them.",
      "ref": "com.atproto.repo.strongRef",
      "type": "ref"
    }
  },
  "required": [
    "part"
  ],
  "type": "object"
}
loopRange object

A range of the timeline, in ticks, played over and over while the loop is on.

Properties

end integer Required

Where the range ends, in ticks: after `start`.

minimum: 1
on boolean Optional

Whether the loop is on. Optional: absent is off, and only `true` is written.

start integer Required

Where the range starts, in ticks.

minimum: 0
View raw schema 
{
  "description": "A range of the timeline, in ticks, played over and over while the loop is on.",
  "properties": {
    "end": {
      "description": "Where the range ends, in ticks: after `start`.",
      "minimum": 1,
      "type": "integer"
    },
    "on": {
      "description": "Whether the loop is on. Optional: absent is off, and only `true` is written.",
      "type": "boolean"
    },
    "start": {
      "description": "Where the range starts, in ticks.",
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "start",
    "end"
  ],
  "type": "object"
}
partMix object

The arrangement creator's mix of one track of an included part.

Properties

to string Optional

The id of the bus in this arrangement the track goes to, in place of the part's own `to`.

maxLength: 64 bytes
track string Required

The id of the track in the part.

maxLength: 64 bytesminLength: 1 bytes
View raw schema 
{
  "description": "The arrangement creator's mix of one track of an included part.",
  "properties": {
    "strip": {
      "ref": "at.atmosynth.defs#strip",
      "type": "ref"
    },
    "to": {
      "description": "The id of the bus in this arrangement the track goes to, in place of the part's own `to`.",
      "maxLength": 64,
      "type": "string"
    },
    "track": {
      "description": "The id of the track in the part.",
      "maxLength": 64,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "track"
  ],
  "type": "object"
}

Lexicon Garden

@