Radix (DDF-Syntax) DMXC3

From English DMXC-Wiki
Books.png Radix (DDF-Syntax) DMXC3 Article describes
DMXControl 3.2.1
Arrow back.png Matrix
Gobo Arrow forw.png
Table of Contents
Part 1: Basics
Part 2: Functions
Part 3: Procedures
Part 4: Examples


In a radial matrix (shortly Radix), the controllable pixels are arranged in a circular pattern. Depending on the device's design, either multiple LEDs are grouped together (for example, two half rings) or all LEDs can be addressed individually. For radial matrices, DMXControl 3 provides its own group of effects. For targeted pixel control, the GUI provides a corresponding control panel window.


Radix

Basic structure

Variant Code
Radial matrix (Radix) with three rings and a total of 19 RGB pixels, automatically patched in sequence
<radix dmxchannel="0">
  <ring segments="1" />
  <ring segments="6" />
  <ring segments="12" />
</radix>

Matrix with three rings, where addressing is automatic from inside to outside:

  • RGB pixels inner ring with 1 pixel: DMX channels 1 to 3.
  • RGB pixels middle ring with 6 pixels: DMX channels 4 to 22.
  • RGB pixels outer ring with 12 pixels: DMX channels 23 to 59.
Radial matrix (Radix) with two rings and a total of 7 RGB pixels, manually specified pixel positions
<radix dmxchannel="0">
  <ring>
    <segment nr="0"/>
  </ring>
  <ring>
    <segment nr="1"/>
    <segment nr="3"/>
    <segment nr="5"/>
    <segment nr="2"/>
    <segment nr="4"/>
    <segment nr="6"/>
  </ring>
</radix>

Matrix with two rings, where addressing is automatic based on the pixels:

  • RGB pixels inner ring: DMX channels 1 to 3.
  • RGB pixels outer ring: DMX channels 4 to 21.

Note: Additional rings can be addressed by adding the ring tag with the corresponding segment subtags.

Radial matrix (Radix) with three rings and a total of 19 RGBW pixels, manually specified DMX addresses of the pixels
<radix>
  <ring>
    <rgb>
      <r dmxchannel="0"/>
      <g dmxchannel="1"/>
      <b dmxchannel="2"/>
      <w dmxchannel="3"/>
    </rgb>
  </ring>
  <ring>
    <rgb>
      <r dmxchannel="4"/>
      <g dmxchannel="5"/>
      <b dmxchannel="6"/>
      <w dmxchannel="7"/>
    </rgb>
    <rgb>
      <r dmxchannel="8"/>
      <g dmxchannel="9"/>
      <b dmxchannel="10"/>
      <w dmxchannel="11"/>
    </rgb>
    ...
    <rgb>
      <r dmxchannel="24"/>
      <g dmxchannel="25"/>
      <b dmxchannel="26"/>
      <w dmxchannel="27"/>
    </rgb>
  </ring>
  <ring>
    <rgb>
      <r dmxchannel="28"/>
      <g dmxchannel="29"/>
      <b dmxchannel="30"/>
      <w dmxchannel="31"/>
    </rgb>
    <rgb>
      <r dmxchannel="32"/>
      <g dmxchannel="33"/>
      <b dmxchannel="34"/>
      <w dmxchannel="35"/>
    </rgb>
    ...
    <rgb>
      <r dmxchannel="72"/>
      <g dmxchannel="73"/>
      <b dmxchannel="74"/>
      <w dmxchannel="75"/>
    </rgb>
  </ring>
</radix>

Matrix with three rings, where addressing of the pixels is manual:

  • RGBW pixels inner ring: DMX channels 1 to 4.
  • RGBW pixels middle ring: from DMX channel 5, 7 pixels positioned clockwise with the first pixel at 12 o'clock.
  • RGB pixels outer ring: from DMX channel 28, 12 pixels positioned clockwise with the first pixel at 12 o'clock.

Additional attributes

The radial matrix can be customized using various attributes. These attributes are assigned either to the parent tag radix or to the ring tags.

  • radix (main tag)
    • Color offset: Specifies the DMX channels for the RGB+-colors white, amber, etc.
    • shape: round/honeycomb - Basic arrangement of the pixels
  • ring (subordinate tag)
    • angleoffset: Positioning of the first pixel of a ring

shape

The shape attribute defines the arrangement of the pixels. Currently, two variants are commonly used:

  • Round arrangement: The individual pixels actually describe a circle.
  • Honeycomb: The rings are arranged more hexagonally.

angleoffset

Variant Code
RGB Radix with angular offset between outer two rings, pixels automatically patched in sequence
<radix dmxchannel="0">
  <ring segments="1" />
  <ring segments="6" angleoffset="15" />
  <ring segments="12" angleoffset="60" />
</radix>

Matrix with three rings, where addressing is automatic from inside to outside:

  • RGB pixels inner ring with 1 pixel without angular offset.
  • RGB pixels middle ring with 6 pixels and an angular offset of the first pixel of 15° clockwise (reference point 12 o'clock).
  • RGB pixels outer ring with 12 pixels and an angular offset of the first pixel of 60° clockwise (reference point 12 o'clock).