Create LED pixel-mapper
create_led_mapperMap images from a TOP to LED fixtures over Art-Net or sACN, creating a resizable pixel-mapping network with DMX output and a built-in test source.
Instructions
Build a pixel-mapping chain from a source TOP to an LED fixture grid and DMX Out CHOP over Art-Net or sACN. The generated network resizes to width×height, samples one texel per fixture pixel, preserves RGB channels, and returns created node paths, channel count, warnings, and live Brightness/Universe controls on the parent COMP. It defaults to a moving Ramp test source so the chain can cook without input; real network output still requires a reachable fixture/node and should be verified before sending. Use create_dmx_fixture_pipeline for fixture patching and this tool when you specifically need image-to-pixel mapping.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fps | No | Output frame rate (DMX Out CHOP sample rate). | |
| net | No | Network DMX protocol: Art-Net or sACN (streaming ACN). | artnet |
| name | No | Base name for the created nodes. | |
| width | No | Pixels per row (columns). Each texel of the WxH grid drives one LED fixture. | |
| height | No | Rows of pixels. 1 = a single LED strip. | |
| layout | No | Pixel wiring order along the strip/grid: horizontal (rows left-to-right), vertical (columns), or serpentine (alternate rows reversed — boustrophedon strips). | horizontal |
| source | No | TOP path whose image is mapped to the fixtures. If omitted, a built-in moving Ramp TOP test source is created so the chain cooks with no input. | |
| net_address | No | Target IP address for Art-Net / sACN. Defaults to the operator's own default. | |
| parent_path | No | COMP to build the pixel-map chain in. | /project1 |
| start_channel | No | DMX start channel (1-512) of the first pixel within the starting universe. | |
| start_universe | No | Art-Net / sACN universe of the first pixel. |