Visualization Devices
Connect and configure your visualization devices. easyvis supports different types of visualization devices which you can easily connect to easyvis.
Each device has a unique device id (e.g. CrawXg-142119) and a user specific device label (e.g. MySuperCoolDevice).
We support a variety of different setups and outputs, therefore the device can be configured in multiple ways.
Output configuration
There are two important parts which need to be configured for the device’s outputs:
General output configuration
Output configuration that applies to all outputs:
| Config parameter | Description | Required | Allowed Values | Default |
|---|---|---|---|---|
| ip | Static IP address (e.g. required for Artnet) | xxx.xxx.xxx.xxx | ||
| netmask | Static IP netmask (e.g. required for Artnet) | xxx.xxx.xxx.xxx |
Outputs
Defines all outputs which can be addressed by the device. Note that there are certain constellations which are not (yet) supported (e.g. hdmi output and spi output at the same time). The outputs are defined as an array of output objects. With each output the following parameters can be configured:
| Config parameter | Description | Required | Allowed Values | Default |
|---|---|---|---|---|
| id | Unique id of the output | x | any string | |
| type | Type of output | x | ARTNET, HDMI, SPI_SM16716, SPI_WS2812 | |
| config | Specific configuration of an output | compare definition below |
The configuration of an output allows the following parameters:
| Config parameter | Description | Required | Allowed Values | Default |
|---|---|---|---|---|
| width | Absolute width of the output (e.g. number of LEDs in a stripe) | for ARTNET and SPI_* | >0 | |
| height | Absolute height of the output (e.g. number of stripes) | for ARTNET and SPI_* | >0 | |
| startX | Relative x start position (top-left corner) of the part of the image to be grabbed | for ARTNET and SPI_* | 0.0 <= x <= 1.0 | |
| startY | Relative y start position (top-left corner) of the part of the image to be grabbed | for ARTNET and SPI_* | 0.0 <= x <= 1.0 | |
| pattern | Pattern alignment of the LEDs (compare led alignment patterns) | for ARTNET and SPI_* | ZIGZAG, ZIGZAG_INVERTED | |
| orientation | Orientation of the LEDs (compare led alignment patterns) | for ARTNET and SPI_* | 0, 90, 180, 270 | |
| universe | Artnet universe to which the output belongs | for ARTNET | >=0 |
Grabbing
With different outputs which can be used at the same time it is easily possible to split up an input media (e.g. image or video) into multipl outputs. Therefore each output needs to defne which part of the overall image it is grabbing. For this each output defines the top-left corner of the part of the image it is grabbing. In order to be flexible a relative position (startX and startY can be defined between 0.0 and 1.0) for the top-left (x,y) position. The size of the grabbed image is calculated with the width and the height of the output.