DMX VARIABLE

NOTE: As WATCHOUT does not directly support DMX input, you'll need to utilize an Art-Net adapter to convert DMX to Ethernet. Once converted, you can add a Variable.

You can listen to Art-Net channels by specifying the variable key as follows: artnet.universe(1).channel(2), which binds the variable to channel 2 of Art-Net universe 1.

Specifying Universe

When specifying the universe, provide a value between 0 and 32767. If not specified, universe 0 will be used by default.

Higher Resolutions

By default, a single Art-Net value is represented as an 8-bit value. However, Art-Net supports higher resolutions by bundling up to four channels together. To bind multiple channels to the same variable, specify them like so: artnet.uv(1).ch(1, 2), where 1 represents the coarse channel and 2 the fine channel. Alternatively, you can use this syntax: artnet.uv(1).coarse(1).fine(2).ultra(3).uber(4).

All of the following examples are valid:

  • artnet.channel(1)
  • artnet.universe(42).channel(1)
  • artnet.universe(42).channels(1)
  • artnet.universe(42).channel(1).normalized()
  • artnet.universe(42).channel(1,2)
  • artnet.universe(42).channels(99,2,3,4)

Interpretation

In many situations, working with normalized values is more convenient than dealing with absolute values. We support this by appending .normalized() to the end of the variable key. The resulting value will be a floating-point number between 0 and 1.

If you need to work with absolute values, note that the resulting maximum value depends on the number of channels you specify.

ChannelsBitsExpressionDecimal
Coarse82^8 -1255
Coarse + Fine162^16 - 165535
Coarse + Fine + Ultra242^24 - 116777215
Coarse + Fine + Ultra + Uber322^32 - 14294967295

NOTE: You need to manually set this in the maximum field.

For more information about Art-Net, refer to Wikipedia