Calibrate a screen

Make hand gestures comfortable where the screen hangs — a one-minute wizard on the screen itself measures the distance, a relaxed hand's comfort zone and the pinch for that camera.

Every screen with a camera hangs differently — above or below the picture, tilted, with visitors close or a few steps back. Where a relaxed hand is, how a pinch looks to that camera and how big a face is where people stand depend on it. Calibrating measures them once, on the screen itself, in about a minute. After that a small movement of a hand held low covers the whole screen — nobody has to hold an arm up — and a resting hand never pinches by accident.

A screen that is not calibrated uses sensible defaults: a hand low in the picture, a face about 2.5 m away.

Start it

Calibrate from the stage preview or on the screen:

From the stage preview — on a laptop in front of the screen, say: open the stage's Preview, press Camera on (this computer's camera stands in for the screen's; a red Camera badge shows while it runs), then Calibrate. Saved there, it is the stage's: its screens use it at once.
From the stage form: on Run → Stages, edit the stage, and under Visitors can use this screen → Hands → Calibration press Calibrate this screen. The wizard opens on the stage's screens.
On the screen: open the operator strip (press O, hold a finger in a top corner, or tap with three fingers) and press Calibrate; or add ?calibrate=1 to its player link, or press K on a keyboard connected to it.
From an AI agent: calibrate_stage.

The stage needs Hands turned on, so the screen opens its camera.

The four steps

Stand where visitors stand

Look at the screen for a few seconds. The screen notes how big your face is there; anyone further away — people walking past at the back — will not count as someone there.
Draw a small rectangle with a relaxed hand

Elbow low, hand about chest height, and wipe a small window in the air. That area becomes the comfort zone, and moving across it moves the pointer across the whole screen.
Open, then pinch — three times

Open the hand wide, then thumb and index together, palm towards the screen. The screen learns how a pinch looks to this camera, so a pinch counts and a resting hand does not.
Test, then save

Point at the circles and pinch them, with the new settings already in use. Then pinch Save (or press Enter), Again (R) or Cancel (Esc). Saved, every screen of the stage uses it at once.

Afterwards

The stage shows when and where it was calibrated, the comfort zone, the pinch and the distance, with Reset to defaults. Calibrate again when the camera moves or is replaced.

Someone counts as there when the camera sees a face or a raised hand (the default), only a face, or only a hand — that decides when the gesture guide and the attract hint appear.

Show a customer how the screen sees them

Press H on the screen or in the stage preview with the camera on (or press Show how it sees you next to the preview or in the operator strip, or add ?debug=hands): a small picture in the corner shows what the camera sees — the hand's points, the face, the comfort zone — and whether someone counts as there, the pinch and the session. H again hides it.

Nothing the camera sees is stored or sent — not in the wizard and not in this view; only the numbers of the calibration are saved.

Showing Wunderframe on a laptop

For a demo, run the real player — exactly what a screen runs — on a laptop or on the big screen it drives. On Run → Stages, press Open for demo under the stage's player link: the player opens in a new tab with the operator strip at the top. Click once to go fullscreen.

Camera on / off — this computer's camera is the screen's (a red Camera badge shows while it runs). Off holds for this tab only.
Calibrate — the wizard above; Save needs a real click or a pinch of a real hand, and saves for the stage.
Show how it sees you — the camera's view in a corner (H).
Steering — Move, Tilt or Hybrid, to try here; it is not saved and the stage keeps its own.
Simulator — a pretend visitor instead of the camera: P a person steps up, H raises a hand, Space pinches, ← → swipe. A photo booth then takes a pretend picture and posts nothing.
Fullscreen and Close.

The strip is hidden on a screen unless asked for: O shows and hides it, as do holding a finger in a top corner or a three-finger tap on a touch laptop, and ?controls=1 on the player link opens it at start. It hides itself after 8 seconds untouched. The strip speaks this browser's language (German, English or French).

A tab with the player link counts as one of the stage's screens while it is open.