Implement Patch

[DorianSnowball]

Implement Fixture Patch as a list of all fixtures in the current show.

A Fixture consists of the following fields:

• uuid*
  • Assigned upon patching of Fixture, immutable
  • 128-bit
• fid
  • Fixture Identifier
  • u32, freely chosen by the user
  • equivalent to the CustomId in the MVR specification
• attributes
  • an object, where the name of the attribute are the keys and the values are the values
  • internally, each attribute may have multiple sources associated with it (programmer, cues) that are mixed according to different rules
  • values may be described by effects (which really are functions, depending on time, position of fixture, interactive input and previous internal state)
  • maybe make different APIs for requesting current value of attribute and where it comes from to simplify and reduce overhead
• name
  • string, freely chosen by user
• fixtureTypeId
  • Fixture Type Unique ID, see Fixture Types
• dmxMode
  • string
  • must be found in fixtureType
• universe
  • Art-Net portAddress universe unique ID
• startAddress
  • first DMX address in assigned universe
  • 9-bit uint, therefore value-limited u16 or i16

[DorianSnowball]

This system should also provide the default values for new fixtures like:

• last added fixture type
• for every added fixture type: store the last used mode

Other default values can be derived client side

[Firionus]

After taking this on, I'm starting a ToDo list here:

• [x] ArtNetAddress Class
  • [x] What kind of Error Handling? Exception (unchecked in Kotlin!) or Result Monad (std? kotlin-result? Arrow? ...)?
  • [x] Tests for constructor from normal number (short or int?) (-1, 0, 32_767, 32_768)
  • [x] Constructor from Net/SubNet/Universe + Tests at valid/invalid lower/upper bounds (code in LibArtNet already implemented?)
  • [x] Getter for Net, SubNet, Universe + Tests
  • [x] Docstring
• [x] DmxAddress Class
  • [x] Test for 1 and 512 (successful), 0 and 513 (failure)
  • [x] Docstring
• [x] PatchFixture Data Class
  • [x] small docstring
• [ ] merge gdtf branch to get access to GDTF type (into main?)
• [ ] merge feature/impl-eventhandler (into main?)
• [x] collection of all data belonging to patch stream (HashMaps of PatchFixtures and GDTFs)
  • [x] accessor API
  • [x] implement accessors that call stream update
  • [x] Docstring