Test image and latency test - sblantipodi/firefly_luciferin GitHub Wiki

When configuring the number of LEDs in use,

you can use the Test Image to verify that all LEDs are positioned correctly.
This tool also allows you to check whether the captured image margins match your desired layout and to fine-tune them as needed.

The first and last LEDs are displayed in gray, making it easier to verify strip orientation and order.

Additional Test Image Features

The Test Image also provides access to advanced calibration and diagnostic tools:

  1. Editing Color Grading (Hue, Saturation and Lightness tuning)
    Fine-tune individual colors directly from the test image.
    Learn more

  2. Latency Test
    This test displays colors in rapid succession to help you evaluate the latency between the image shown on your monitor and the color displayed on the LED strip.

    • Increasing the framerate helps reduce latency
    • The test can be run at 10 different speeds
    • Useful when selecting the right smoothing level for your setup

Custom LED Layout

Using the Test Image, you can manually define custom LED zones in addition to the automatic mode, which distributes LEDs evenly around the monitor based on the configured LED count.

Custom LED layouts are useful when:

  • Avoiding persistent on-screen overlays (e.g., minimaps or HUD elements)
  • Creating specific capture areas
  • Assigning dedicated zones to satellite devices

(Click the image above to watch the video on YouTube)

The custom LED layout is profile-specific.
Each profile can be automatically activated when a specific application or videogame starts.

How it works

  • Click on the background to reveal the image behind the test image
  • Drag LED zones to move them around
  • Hold CTRL while dragging to disable snap-to-grid
  • Click and drag to select multiple LED zones
  • CTRL+Click an LED zone to add it to the selection
  • SHIFT+Click an LED zone to remove it from the selection
  • Press DELETE to remove selected LED zones
  • Use CTRL+Z / CTRL+Y to undo or redo actions
  • Move LED zones pixel by pixel with arrow keys, hold CTRL to move faster
  • Click the + icon on an LED zone to duplicate it, and the square icon to resize it
  • Select all the LEDs you want to modify, resize them to your desired size, and then press SHIFT + TAB to space them automatically
  • Press TAB repeatedly on the selected zones to resize them while keeping the spacing
  • When creating a new LED zone, you can assign a custom name that satellites can use as a zone identifier
  • Click an LED number to toggle it on or off