Manual / Setup
Camera Calibration
Calibration is the biggest factor in tracking quality. It tells the station where the camera is, where it points, how wide it sees and how its lens bends the picture, so that every pixel maps to a stage position. The Setup Wizard does it; this chapter covers what to choose, what to bring, and what the station keeps afterwards.
To plan grid dimensions and camera placement before you are on site, use the interactive Positioning the Camera sketch.
Before you start
- Installation is done and the web UI is reachable.
- Video Inputs produce a recognisable picture.
- Core Concepts – Reference Point and Grid.
Bring:
- Tape or gaffer marks for the corners of the calibration rectangle (Simple), all four visible in the camera image, or for each calibration point (Advanced).
- A tape measure.
- A laser distance meter (disto) for Advanced's triangulated points.
The wizard works on a snapshot of the video source. Calibrate again after the camera moves or the zoom changes.
The math, briefly
OpenFollow solves the camera's position, orientation and field of view from points with known stage coordinates and their pixel positions in the snapshot. The result maps any image pixel to a stage coordinate and back. The Lens step measures lens distortion separately; it bends the overlay to match the picture and never warps the video.
Which path to take
Lens
- Measure it when edges that are straight on stage look curved in the picture – usually a wide, fisheye or CCTV lens. Draw lines along those edges in the Lens step.
- Skip it for a camera without visible barrel distortion: press Next without drawing lines.
- Load a calibration you already have for the same camera, lens and zoom – saved on a station, in an
.ofsettingsfile or from OpenCV.
Simple or Advanced
| Simple | Advanced | |
|---|---|---|
| You mark | The four corners of one rectangle on the floor | Up to 12 points, typed from a plan or measured with a tape |
| Use it when | A flat floor where you can tape a rectangle and the camera sees all four corners | Corners are hidden by the set, the stage is wider than the picture, the floor has risers or levels, or you have surveyed points already |
| You enter | A rough camera location, the rectangle's width and depth, the point of origin | A rough camera position, two or more known points, and triangulated points by their distances |
| The grid | Becomes the rectangle | Keeps its size; only its height changes |
Start with Simple when it fits: it is the quickest. Switching to Advanced keeps the corners as known points, so you can add points to a Simple calibration. The steps are in Simple and Advanced.
Camera & Lens Calibration
The Camera & Grid tab shows the result in a read-only Camera & Lens Calibration section; values change only by running the Setup Wizard.
- Position and orientation – Position X, Y, Z, Pitch, Yaw, Roll. Pitch is negative looking down; Yaw 0 looks upstage.
- Lens – Horizontal Field of View, Barrel / fisheye, Corner correction, Right of the picture centre, Above the picture centre.
- Calibration – Simple, Advanced or None, with Calibrated (when saved), Video source, Lens rating (a rating, User input, Loaded or OpenCV calibration), Pinned, Accuracy and Camera height: Fixed at …. Accuracy is the largest distance in pixels between a pinned point and where the saved camera sees it; a large value means a point was pinned wrong or the camera moved. Calibration points lists each point's kind, position, pinned state and error.
A different video source, or a camera that moved or zoomed, needs a new calibration.
Grid
The Grid section is a reference plane drawn over the live video. It does not change tracking. Simple calibration saves the measured rectangle as the grid; changing its width, depth or offsets afterwards unpins the corners, and the next Setup Wizard run pins them again. Distances are relative to the Reference Point.
| Group | Fields |
|---|---|
| Display | Grid shows or hides the grid on the Operator Screen. |
| Dimensions | Width (X), Depth (Y), Maximum Height (height of the tracking volume above the grid plane; the [z.frac] / [z.frac.inv] placeholders divide by it and are skipped while it is 0 or empty), Spacing (distance between grid lines). |
| Appearance | Line Color, Line Thickness (1–20 px), Opacity (0 transparent, 1 opaque). |
| Offset Position | X Offset (0 centres the grid), Y Offset (half the depth puts the Reference Point at the front edge), Z Offset (height of the grid plane above the Reference Point; raise it for a riser). |
| Origin Marker | A cross at the Reference Point: Origin on or off, Length (m), Thickness (1–20 px). |
The Grid form applies live but reverts on reload until you press Save.
Sharing & templates
- Apply to all stations – copy the Camera and Grid (and the camera's calibration) to every OpenFollow station on the network. Use it when several operators share one physical camera.
- Save as template… / Load template… – store Camera and Grid together as a reusable template. The chooser also Exports a template as a single
.oftemplatefile and Imports one from another station.
Verifying calibration on stage
After saving, walk a marker around the stage with a tape measure. The reported position, on the Operator Screen, a connected console or a PSN listener, should match real-world distances within your tolerance – typically a few centimetres at the corners, possibly more at the far edges of the field of view.
A constant offset in one direction means the point of origin is wrong. An error that grows toward the edges means the rectangle size is wrong. Right at the corners but wrong in the middle points to the lens: measure it again in the Lens step.
When to recalibrate
- The camera moved or got bumped.
- The lens zoom or focus changed.
- You switched cameras or video sources, or the picture’s size or shape changed (the picture keeps its own aspect ratio, so a 4:3 source sits differently from a 16:9 one).
- You changed any of the physical marks on stage.
You can re-run the Setup Wizard at any time. The current camera, lens and grid stay until you press Save and finish.