Command line argumentsΒΆ
Every flag is optional. Flags seed the startup dialog rather than bypassing it;
anything omitted falls back to the last saved session setting. Boolean flags
have an explicit --no- counterpart, and passing both forms of the same flag
is an error.
Usage: ./gravy_lens [options]
Options:
-n, --nthreads <n> Lensing worker threads (default: cores minus 2).
-s, --strength <f> Lens strength multiplier (default 4.0).
-f, --softening <f> Kernel softening radius in px (default 50.0).
-m, --visionSize <n> Vision request size (default 512).
-d, --deviceIndex <n> Camera device index (default 0).
--fps, --frameRate <n> Target camera frame rate (default 30).
-g, --debugGrid Show 2x2 diagnostic grid at start.
--no-debugGrid Force the debug grid off.
-p, --padFactor <n> FFT padding multiplier (default 2).
-t, --temporalSmooth <f> Mask temporal blending factor (default 0.25).
--personSensitivity <n> Person sensitivity, 0-100 (default 50).
--lr, --lowerRes <f> Internal calculation scale, 0.1-1.0.
--quality, --qualityMode <mode> fast, balanced, high, or custom.
--sb, --secondsPerBackground <n> Seconds per background; -1 = manual (default -1).
--di, --distortInside Also lens the interior of the mask (default on).
--no-distortInside Force interior distortion off.
--flip Mirror camera feed horizontally.
--no-flip Force mirroring off.
--roi, --selectROI Open ROI selector on first session start.
--no-selectROI Skip startup ROI selector.
The flags are most useful for scripting a known-good configuration for a particular room, so that a machine set up the night before comes back in the same state:
# Mirror mode, ROI prompt at startup, manual background switching
./gravy_lens --flip --roi --sb -1
# Telescope mode, no mirroring, backgrounds cycling every 20 seconds
./gravy_lens --no-flip --sb 20