Calculate GDTF Channel Layout

[Firionus]

The channel layout of a DmxMode in a GDTF file is not trivial to calculate, because each DmxChannel can reference a top-level Geometry which could be inherited from by other GeometryReference elements. The DmxChannel then needs to be repeated for every GeometryReference. Each GeometryReference has its own DMX Break and Offset that dictate the DMX Address of the channels that reference its parent.

The calculation needs to be compared to the GDTF Builder (gdtf-share.com). Our implementation should result in the same layout as the GDTF Builder.

Also, the channel count can then be calculated.

All of this should be added to the GdtfWrapper

TODO:

• [x] Update XSD from upstream
• [x] Regenerate GDTF sources (should be automatic?)
• [x] create data structure for channel layout
  • [x] DMX Break
  • [x] DMX Offset
  • [x] Name
  • [x] or split name into different parts?
  • [x] what about originalName?
  • [x] info on controlled attribute?
  • [x] coarse/fine/ultrafine/... -> should be something like 1/3, 2/3, 3/3, or maybe detail: 1, 2, 3, or byte 1, 2, 3, or byte 1/2, 2/2, or byte 1 of 2, 2 of 2
  • [x] possibility: List<List<String?>> (empty offsets are null, otherwise: "LED1 -> GenericLED_Dimmer (1/2)")
  • [x] possibility: List<List<DmxChannel?>>, DmxChannel(val geometry: String, val attribute: String, val reference: String?, val detail: Byte)
• [x] Use existing Robin Esprite as one example for channel layout (check version of GDTF file! maybe update GDTF file)
• [x] Document the behaviour of the GDTF Builder with test cases
  • [x] Interleaved Geometry References
  • [x] A1, B1, A2, B2 (A/B are channels, 1/2 are GeometryReferences)
  • [x] A1, A2, B1, B2
  • [x] unfilled spaces
  • [x] single channels
  • [x] overwrite break
    • [x] For Overwrite, use the last Break in the GeometryReference
    • [x] For Break set in Channel, use the first matching Break in GeometryReference from the top
  • [x] Multiple DMX Breaks
• [x] Write tests where our implementation is compared against the behaviour of the Builder
• [x] test for Channel names
• [x] test channel count
• [x] Make tests pass
• [x] Test Fail on clashes between channels (Integration Level)
• [x] Test Fail on missing break -> offset in GeometryReference (Integration Level)
• [x] Update API Docs
• [x] Reactivate Snapshot Test and move them to proper Snapshot Testing Tool

[Firionus]

development started on branch gdtf-channel-layout