Calibrator Lite

Camera (server) / Camera (user)

Whether the camera is attached to the server or to the machine running the interface.

Radio

Lens

How the calibrator turns marker pixels into 3D rays when solving the camera pose. Pinhole covers all ordinary photo and webcam lenses, where straight lines in the room stay straight in the image. Choose the fisheye entry for a lens sold as a fisheye, or one that visibly curves straight edges in a test photo.

Pinhole (rectilinear) / Fisheye (equisolid-angle)

Rotation

Rotates the captured photo to match how the camera is mounted.

0° / 90° CW / 180° / 90° CCW

Fix Camera

Reuses the existing camera pose and intrinsics instead of solving them again.

Checkbox

Fix Projectors

Reuses the existing projector frustums and homography.

Checkbox

Image quality

Resolution and compression of the captured photos.

L Fine / L Norm / M Fine / S Fine

Av

Aperture held fixed through the auto-exposure passes, and reused for the captures. A smaller f-number lets in more light but makes only one distance sharp; a larger one keeps more of the screen's depth sharp with less light. Shared by Alignment and Black Level.

Auto (max light), or an explicit aperture code

Focus

Projects a line pattern and takes a test shot so the camera can be focused on it. Reports Focusing…, then Focus done or Focus failed.

Button

Take Photo

Captures a single photo with the current settings. Reports Capturing…, then Photo captured or the camera error.

Button

Manual Camera Settings

Opens ISO, Shutter ms and Aperture for direct control instead of auto-exposure.

Section

Camera FoV

Auto-Fit solves the field of view during calibration; Manual uses the value you enter.

Auto-Fit / Manual

Lens distortion correction

Whether distortion coefficients are fitted during calibration.

None / Auto

Distortion

How many radial coefficients are fitted. More coefficients follow a strongly curved lens more closely, at the cost of needing more well-spread correspondences to stay stable.

k1 only / k1, k2 (default) / k1, k2, k3 / k1, k2, k3, k4

Calibrate Camera

Runs the camera-calibration wizard, which measures the lens from a series of photos.

Button

Import from User

Takes intrinsics already measured on the user-side machine for the same camera, matched by serial number.

Button

Auto-detect

Finds the markers in the photo. Needs a photo loaded first.

Button

Cycle corner markers clockwise / counter-clockwise

Rotates which marker sits at which corner, without moving them.

Buttons

Mirror corner markers horizontally / vertically

Flips the assignment across an axis.

Buttons

Flip 180°

Turns the assignment through half a turn, also swapping TC and BC.

Button

Brightness boost

Captures a brighter preview so markers stay visible on a dark screen. Toggles between boosted and normal exposure.

Toggle

Confirm Corners

Accepts the placement and returns.

Button

Mask outside / Mask inside

Whether the area you draw is the part to keep or the part to exclude.

Toggle

Polyline drawing

Click to add vertices; Close polyline finishes the shape, which needs at least three points. Cancel polyline drawing abandons it.

Drawing tool

Extend (px)

Grows the mask outwards by a margin in pixels.

Pixels

Delete vertex / Delete polygon

Removes a single point, or the whole shape.

Context menu

Auto mask

Detects the projected area and builds the mask from it. Needs a photo loaded first.

Button

Start Calibration

Projects the stripe patterns, photographs them, and solves projector poses and warp meshes. Shows Starting…, then progress.

Button

Stop

Ends the run. Shows Stopping….

Button

Adjust

Re-runs from the existing result with edited corners or masks, rather than starting over.

Button

Output

Which results are written to the projectors: Warping, Blending, Gamma.

Checkboxes

Stored result

Which stored calibration is currently applied.

Readout

Apply previous (older) result / Apply next (newer) result

Steps through the stored calibrations and applies one.

Buttons

Clear

Removes the applied result.

Button

Stripe width

Stripe line thickness.

Pixels, default 3

Step size

Target pixels per stripe. Lower gives more stripes and a finer grid; higher gives fewer and brighter ones.

Pixels, default 16

Colors

Number of stripe colours in the codebook. 0 = automatic, each projector picking the smallest workable number (4–7); a value of 1–7 forces that number on every projector. Fewer colours mean fewer capture photos per phase.

0–7, default 0

Erode edge

Narrows the displayed stripe by one pixel for sharper edge detection.

Checkbox

Mesh step

Warp-mesh vertex spacing. Lower gives a smoother warp and a larger mesh file.

Pixels, default 4

Filter

Grid filter threshold margin. Higher keeps more points and tolerates moiré; lower filters more strictly.

Default 3.0

Cubic

UV-map upscale interpolation. Off is linear, with no overshoot; on is cubic, smoother on curved screens.

Checkbox, default off

Fill mode

Algorithm used to fill holes and masked areas in the UV map. Deg, Cheb, K and MaxExtrap tune the polynomial variants.

Laplace / Polynomial / Local quadratic

UV border correct

Corrects the UV map at the border of the projected area.

Checkbox

Frustum oversize %

Enlarges the solved projector frustum so more of the projector is filled.

Percent

Wait frames

Frames to wait between projecting a pattern and photographing it, so the projector has settled.

Frames, or automatic

Multi-projector photos

Captures more than one projector per photo. No effect unless the projectors are fixed.

Checkbox

Smooth mesh

Smooths the warp mesh. Thr sets the threshold, Str the strength, Pass the number of passes.

Checkbox + 3 values

Auto-exposure

Target brightness to aim for, Tol the acceptance tolerance (default 25), Top% the share of brightest pixels measured, Min neighbors the neighbour count a pixel needs to count.

4 values

Show Stripe

Projects a stripe pattern continuously, for checking focus and exposure by eye.

Button

Skip photos

Reuses photos already on disk instead of capturing new ones.

Checkbox

Debug images

Writes the intermediate images from each stage to disk.

Checkbox

Silent shutter

Uses the camera's silent shutter mode.

Checkbox

Force X Shear 0 / Force Y Shear 0

Pins the solved shear terms to zero.

Checkboxes

Step size (10bit)

Size of each brightness step the measurement walks through.

10-bit levels

Target saturation

Share of the camera's range the exposure aims at.

Percent

Border shrink (px)

Pulls the corrected area in from the edge by this margin.

Pixels

Pixel response

Response curve applied when turning measured brightness into a correction.

Value

Black target

Uniform lifts everything to one level; Adaptive follows the measured variation across the screen.

Uniform / Adaptive

Adaptive sharpness

How closely the adaptive target follows local variation. Medium sits between the two.

Smooth / Medium / Sharp

Max black gradient (10-bit/100px)

Steepest brightness change the correction may introduce over 100 pixels — the limit that keeps a correction from becoming visible as an edge.

10-bit per 100 px

Auto gradient

Derives that limit from the measurement instead of using the entered value.

Checkbox

Correction Enabled

Applies the stored correction to the output.

Checkbox

Native black

Captures the screen with the projectors at black — Capturing native black….

Auto-exposure

Finds the exposure for the measurement and reports the shutter and ISO it settled on.

Confirm Target

Shows the target brightness for you to adjust and accept.

Confirm gradient

Adjust max gradient, then Confirm — the last chance to change the limit before the correction is built.

Result

Reports completion with the saturation reached, or where it stopped, and writes the correction image.

Use Cached

Reuses a calibration already stored for this camera body. Offered only when one exists.

Button

Re-Calibrate

Measures again, replacing the cached values.

Button

Lens model

Taken from the main dialog and shown here for confirmation.

Read-only

Pattern source

Show on screen projects the pattern; I have a printed pattern expects a physical board.

Radio

Distortion degree

How many distortion coefficients to fit.

Value

Start

Begins the session.

Button

Cancel

Closes without measuring.

Button

Start Automatic

Begins a ten-second countdown, then meters exposure on its own, retrying until the brightness target is met.

Button

Stop Auto / Resume Auto

Pauses and restarts automatic capture.

Buttons

Capture

Takes one photo. The camera's own shutter release does the same.

Button

Exposure readout

The shutter, ISO and number of metering attempts.

Shutter: n ms ISO: n Attempts: n

Per-photo result

Photo accepted, or why it was rejected — No pattern detected, Pattern partially visible — move closer, or Wrong camera orientation.

Status

Photos

How many photos have been accepted, out of the 15 the wizard wants.

RMS

Reprojection error, in pixels. The single best indicator of a good measurement.

FOV(H)

Horizontal field of view solved so far, in degrees.

cx / cy

Optical centre offset from the image centre.

k1

First radial distortion coefficient.

Status

Three indicators: Photo count, Coverage, and RMS < 0.5 px.