Lexicon Garden

at.atmosynth.patchPresentation

A patch's presentation, in the repository that holds the patch and under the patch's own record key: the key is the link, and nothing in it names the patch. A patch and its presentation are written together. A patch with none, or whose presentation cannot be read, is still drawn: from its instances' deprecated `position` fields where they say anything, and otherwise by the reader's own layout.

Repository @atmosynth.at did:plc:fzjkahpwapmoqxybwdjb6ysf namespace authority
Details · record, key tid
Kindrecord
Record keytid
Authorityatmosynth.at
Indexed
Compare Edit in builder → Fork →

Record

record · key tid

Properties

createdAt

requiredstring · datetime

frames

array

The patch's frames, each a named, coloured rectangle on the canvas the positions are on. Nothing lists which blocks a frame holds: what stands inside it is in it, and moves with it. Where neither of two frames is inside the other, the later one here is drawn above. Optional: absent is no frames.

  • maxLength: 256
itemsref
Reference

positions

array

Where each block stands, one entry to an instance at most. An entry naming an instance the patch does not have is ignored, and an instance named by none is placed by the reader's own layout. Optional: absent is every block placed that way.

itemsref
Reference

#frame

object

A named, coloured rectangle round blocks. A block is inside a frame when its position, its top-left corner, is inside the rectangle; a frame is inside another when its whole rectangle is. Moving a frame moves every block and every frame inside it when the move begins.

Properties

colour

requiredstring

The hue it is drawn in, by name rather than as a colour value, so that every reader draws it right for its own theme and contrast. A reader meeting a name it does not know draws the frame in its neutral colour.

  • maxLength: 32
  • knownValues: red | orange | yellow | green | teal | blue | purple | pink

height

requiredinteger

How far it reaches down from `y`: its bottom edge is at `y + height`, which is outside it.

  • minimum: 1

id

requiredstring

This frame's name within the presentation, never shown. Unique in it, and kept for as long as the frame is, so that two people editing one frame at once are editing the same one.

  • minLength: 1
  • maxLength: 64

name

string

What the creator called it, written on its top border. Optional: absent is a frame with no label.

  • minLength: 1
  • maxLength: 320
  • maxGraphemes: 64

width

requiredinteger

How far it reaches right of `x`: its right edge is at `x + width`, which is outside it.

  • minimum: 1

x

requiredinteger

The left edge, on the canvas the positions are on.

y

requiredinteger

The top edge.

#position

object

Where one block stands: the top-left corner of the block, on the patch's canvas, in the units the canvas is drawn in.

Properties

instanceId

requiredstring

The instance this is the position of: an `instanceId` of the patch.

  • minLength: 1
  • maxLength: 64

x

requiredinteger

y

requiredinteger