Interface and shortcuts¶
Sessions¶
All configuration goes through an explicit session. The Session Setup dialog opens at launch with your previous choices remembered; changing anything mid-session means reopening settings and restarting.
Open Session > Settings… (Cmd+,).
Edit the configuration.
Click Restart Session.
The current colour target and region of interest are preserved across restarts where possible. Live mode and debug-grid toggles also survive.
The settings dialog is scrollable and works on small laptop displays. It shows only the controls relevant to the selected lens mode, hides technical controls behind the Custom presets, and validates camera and background choices in place. Restore Defaults resets every control to the shipped defaults.
Camera¶
Capture resolution can be Automatic, 480p, 720p, or 1080p; the selected camera’s actual negotiated format appears in the session window title, which is worth checking when a camera quietly ignores a request. Frame rate and Flip (horizontal mirroring) are set here too — see Ways to run the demo for which way mirroring should go.
The debug grid¶
Shift+D toggles a 2×2 diagnostic view: camera feed, mask, deflection, and final output. When something looks wrong, this tells you which stage is at fault — a bad mask and a bad lens look identical in the final image, and completely different here. Learn to read it before you need it.
Keyboard shortcuts¶
Action |
Shortcut |
Menu |
|---|---|---|
Switch lens mode |
Shift+M |
Lens > Switch Lens Mode |
Select / reselect colour |
Shift+S |
Lens > Select Colour… |
Select region of interest |
Shift+R |
Lens > Select Region… |
Clear the region |
— |
Lens > Use Full Frame |
Previous / next background |
Left / Right |
Background > Previous / Next |
Toggle debug grid |
Shift+D |
View > Debug Grid |
Show camera inside the lens |
Shift+I |
View > Show Camera Inside Lens |
Toggle full screen |
Ctrl+Cmd+F |
View > Toggle Full Screen |
Session settings |
Cmd+, |
Session > Settings… |
Quit |
Cmd+Q |
File > Quit |
Help > Keyboard Shortcuts shows the same list inside the app, which is the version to trust if the two ever disagree.