Skip to content

    These docs are a work in progress. The software can already be useddownload WavePhase.

    Documentation

    Docs for WavePhase v0.9.3 · reviewed 2026-08-10

    A newer app release may have shipped since this review. These pages describe the latest public WavePhase release. If something looks different in your build, check for an app update.

    Output

    LED Bars & Pixel Mapping

    Place LED bars and panels on a virtual canvas, point any visual at them, and WavePhase samples the image at each pixel and sends it out as DMX.

    Define an LED fixture

    An LED fixture describes a grid of addressable pixels. Create one and set:

    • Grid — columns × rows (the pixel resolution of the bar or panel).
    • Pixel format — the channel order per pixel: RGB, GRB, RGBW, single-channel intensity, and more, or a custom order.
    • Wiring mode — row-major or column-major addressing.
    • Serpentine — alternate the direction of each row to match strips that snake back and forth.
    • Start corner — top-left, top-right, bottom-left, or bottom-right, to match how the strip is physically wired.

    Match the hardware exactly

    Pixel format, serpentine, and start corner must match how the strip is actually built — otherwise your image will appear scrambled. If a mapped image looks torn or mirrored, these are the first settings to check.

    Place instances on the canvas

    Add LED instances to the pixel-mapping canvas — each is a placed copy of an LED fixture you can position, size, and rotate in normalised 0..1 canvas coordinates. Lay them out to mirror your real-world rig: a line of bars, a matrix, an arch.

    • Position, size, rotation — where the fixture sits on the canvas.
    • Brightness & gamma — per-instance tone shaping.
    • DMX patch — universe, start channel, and protocol (Art-Net/sACN) for that instance.

    The LED Map Out node

    The LED Map Out node ties it together. It takes a Video input, renders it to the canvas, samples the image at every LED pixel, scales to 0–255 per channel, and sends DMX to each instance's patch.

    1. 1

      Feed it a visual

      Wire any video source — a generator, an effect chain, a compositor, or media — into the LED Map Out's video input (see Generating Visuals).
    2. 2

      Add your instances

      Place the LED instances on the map's canvas and patch each to its DMX address.
    3. 3

      Output

      The node continuously samples the visual at each pixel and streams DMX — your bars now show the moving image.

    Putting it to use

    Because the input is just a visual, anything you can render you can map: an audio-reactive plasma, a scrolling gradient, text, or a camera feed. Continue to Putting It Together to see the full audio-to-pixels chain.

    Was this page helpful?