Every camera model has slightly different characteristics — how fast it pans, how its zoom lens magnifies, and how its focus changes at different positions. Calibration measures all of these properties so Iris can control your camera with precision.
Once calibrated, your camera unlocks the full suite of Iris movement tools. Without calibration, the most powerful tools are unavailable or operate with reduced accuracy.
What Calibration Measures
Calibration isn't just a one-button setup — it's Iris learning your camera's real-world behavior. Specifically, it measures three things:
Zoom scaling — How much objects actually scale in the image as zoom is applied. This is the true optical behavior of your lens, not the manufacturer's stated zoom ratio (e.g., a "30x zoom" spec refers to focal length multiplier, not real image scaling).
Focal length — Calculated in pixels by scanning different pan positions to find areas with high visual detail. This data is used for converting what Iris sees in the 2D video feed into accurate real-world PTZ coordinates.
PTZ speeds — How fast the camera pans, tilts, and zooms in degrees per second. This enables smooth movement transitions, predictive auto-tracking, and prevents overshooting during complex moves.
The results are saved to the cloud and persist across sessions — you don't need to recalibrate every time you start a new session.
What Calibration Unlocks
These tools require a calibrated camera:
Click to Center
Cine Center
Fast Frame
Cine Frame
Auto-Tracking — specifically requires full calibration; the Auto-Tracking panel will prompt you to calibrate if you haven't
These tools work without calibration:
Joystick — available as soon as your camera is connected
Zoom (scroll wheel) — available as soon as your camera is connected
What You'll Need
A PTZ camera that supports pan, tilt, and zoom. Fixed cameras or cameras without all three capabilities can't be calibrated.
Brand and model selected — Cameras set to "Other" cannot be calibrated. You need to select your camera's actual brand and model first.
Camera powered on and online — The camera must be connected and in a healthy state.
Good lighting and a detailed scene — The camera needs to see visual detail in its environment. Avoid pointing it at a blank wall, and make sure the room has adequate lighting.
Camera not in use — The camera moves on its own during calibration. Don't try to control it manually while it's running.
How to Calibrate
Automatic (First Time)
When you add a new supported PTZ camera to your Studio, Iris checks whether a calibration profile already exists. If none is found, calibration starts automatically — no action needed on your part.
Manual (Recalibrate or First-Time for Non-Auto)
From the source list: Right-click on the camera source → select Calibrate (or Recalibrate if previously calibrated).
From Advanced Settings: Open Advanced Settings for the camera → click Start Calibration (or Calibration Required / Recalibrate depending on the current state).
If your camera's brand and model haven't been set, you'll be prompted to select them first.
During Calibration
Here's what to expect while calibration is running:
A progress badge appears on the camera's video feed showing "Calibrating (X%)" — updating in real time.
The camera moves on its own, panning, tilting, and zooming through a series of positions. This is completely normal — don't interfere.
All movement tools are disabled while calibration runs. You can't use Center, Fast Frame, Joystick, Zoom, or Tracking until it finishes.
A notification appears: "The camera [name] is being calibrated. This process will take a few minutes..."
Iris automatically adjusts certain camera settings during calibration for optimal results — things like setting focus to auto and disabling image flip. All settings are restored to their original values once calibration finishes or is stopped.
How Long Does It Take?
Calibration typically takes a few minutes. The exact duration depends on your camera model and its movement speed.
Stopping Calibration
You can stop calibration at any time by clicking the X icon on the "Calibrating..." badge. The camera will return to its previous position and all temporary settings changes will be restored. If the camera was previously calibrated (fully or with a generic driver), it reverts to that state. If it was never calibrated, it returns to uncalibrated.
When Calibration Succeeds
A green "Calibration Succeeded" badge appears on the video feed.
A notification confirms: "The camera [name] is now calibrated! You can now use all the magic movement tools."
All movement tools become available.
The camera returns to its original position.
Calibration results are saved to the cloud — you won't need to recalibrate each time you start a new session.
When Calibration Fails
If calibration fails, you'll see a "Calibration Failed" badge and an error notification suggesting the camera may be pointed at a featureless surface or the room may be too dark.
A dialog appears with three options:
Retry Calibration — Resumes calibration, skipping any steps that already completed successfully. This saves time and focuses on what went wrong.
Use Generic Driver — Falls back to a generic calibration profile based on your camera model family. Movement tools will work, but with less precision than a full calibration tailored to your specific camera. You can upgrade to a full calibration at any time.
Skip Calibration — Dismisses the dialog. You can recalibrate later from Advanced Settings.
If you choose "Use Generic Driver," a warning indicator appears on your source, and the calibration button in Advanced Settings shows "Calibration Required" — reminding you that a full calibration is recommended.
Common Reasons for Failure
Camera pointed at a blank wall or featureless surface
Room is too dark or has flickering light
Movement or people in front of the camera during the process
Mechanical issue with the camera (e.g., stuck zoom motor)
Video feed dropped during calibration
If the video feed drops, Iris automatically retries up to 3 times before failing the calibration step. If you close the app during calibration, the process stops and the camera driver attempts to restore settings and position.
Setup Tips for Successful Calibration
Point the camera at a scene with lots of visual detail — furniture, patterns, objects with distinct edges and textures. The more variety, the better.
Avoid blank walls, low-contrast scenes, and reflective surfaces.
Don't walk in front of the camera during the process.
Ensure adequate, stable lighting — natural light is fine if it's consistent. Avoid flickering sources.
Make sure there's detail at maximum zoom — zoom the camera to its furthest point and check that there's still enough visual information for calibration to work with.
Use a stable mount — tabletop, tripod, or fixed mount. Avoid handheld or loose surfaces where vibration could affect the process.
Do I Need to Recalibrate?
Generally, no. Calibration measures the camera's internal characteristics (lens behavior, motor speeds), not its environment. Moving the camera to a new location doesn't require recalibration.
You might want to recalibrate if:
You've had hardware repairs or firmware updates
The camera was deleted from the Studio and re-added
Movement tools seem less accurate than before
What Happens If…
…you stop calibration manually? Camera returns to its original position and settings are restored. Reverts to previous calibration state (or uncalibrated if it was never calibrated).
…calibration partially fails? Retry will skip completed steps and only re-run the ones that failed.
…you try to start calibration while one is already running? The system rejects the request. One calibration per camera at a time.
…the video feed drops during calibration? The system automatically retries up to 3 times. If it can't recover, that calibration step fails.
…you close the app during calibration? Calibration stops. The camera driver tries to restore settings and position.
…your camera doesn't support PTZ? The calibration button is grayed out and disabled.
…your brand/model is set to "Other"? Calibration isn't available. Select your camera's actual brand and model first.
Troubleshooting
What's happening | Likely cause | What to do |
"Calibration Failed" — message about walls or lighting | Camera pointed at a featureless surface or room is too dark | Reposition the camera toward a scene with visual detail and ensure good lighting. Retry. |
Calibration button is grayed out | Camera not controllable, not powered on, or offline | Ensure the camera is on, connected, and supports PTZ |
"Calibration Required" warning persists | Camera is using a generic driver | Open Advanced Settings and click "Calibration Required" to start a full calibration |
Calibration keeps failing at the same step | Video feed issue or physical obstruction | Reboot the camera, ensure nothing blocks its movement, retry |
Movement tools are disabled | Camera not calibrated or currently calibrating | Wait for calibration to finish, or start it if it hasn't been done |
"Brand & Model Required" message | Camera model is set to "Other" or not set | Go to the Driver section in Advanced Settings and select the correct brand and model |
Calibration succeeds but tools still seem inaccurate | May need recalibration or correct driver | Verify the correct brand/model is selected, then recalibrate |
FAQs
How long does calibration take? Typically a few minutes. Duration depends on your camera model and its movement speed. You can monitor progress via the percentage on the video badge.
Will calibration interrupt my live production? Yes. The camera moves on its own and all movement tools are disabled. Calibrate during setup or downtime, not during a live event.
Do I need to recalibrate if I move the camera? No. Calibration measures the camera's internal characteristics, not its environment. Moving to a new location doesn't require recalibration.
What is a "generic driver"? A generic driver uses calibration data from a reference camera of the same model family. Movement tools work, but with less precision than a full calibration specific to your individual camera. You can upgrade to a full calibration at any time.
Can I use Auto-Tracking without calibration? No. Auto-Tracking requires a fully calibrated camera. The Auto-Tracking panel will prompt you to calibrate first if you haven't.
What camera settings does calibration change? Calibration temporarily sets focus to auto, turns off zoom compensation, and disables image flip. All settings are restored after calibration completes or is stopped.
Can I calibrate multiple cameras at the same time? Yes — you can calibrate different cameras simultaneously (one calibration per camera). You can't run two calibrations on the same camera at once.
What does the warning indicator on my source mean? It means the camera either hasn't been calibrated or is using a generic driver. Click the source and start calibration to resolve it.
Does calibration data persist? Yes. Results are saved to the cloud. You don't need to recalibrate each session.
Can I calibrate if my brand/model is set to "Other"? No. You need to select your camera's actual brand and model first. Go to the Driver section in Advanced Settings.
What if my camera can't be calibrated in my current environment? Use the Generic Driver option as a temporary solution. It enables movement tools with reduced precision until you can recalibrate in a better environment.
Related Articles
Brand and Model Selection — Why selecting the correct driver matters for calibration and control.
Advanced Settings — Where to start calibration and configure device parameters.
Fast Frame / Cine Frame — Movement tools unlocked by calibration.
Auto-Tracking — Requires full calibration to function.
Supported Camera Models — Full compatibility list.