Skip to main content

Running a Successful Calibration

Learn how camera calibration works within Hive and how to run a successful calibration process.

Updated this week

Overview

Calibration in Hiveis more than just a one-time setup; it's the foundation for unlocking enhanced features such as Magic Movement Tools, and Auto-tracking. Unlike other platforms that rely purely on image framing, Hive calibrates each source based on its driver, with device-specific routines stored, retrieved, and refined through Hive's Cloud Calibration Database.

This process measures intrinsic properties of the camera like zoom scaling, focal length, and PTZ speeds, resulting in hyper-accurate and repeatable movement commands. Whether you're running a high-end broadcast studio or a solo streaming setup, calibration ensures your camera is functioning at its peak.


Calibration: What It Does

Calibrating a camera in Hive performs the following:

  • Analyzes zoom model scaling, mapping how image size increases with zoom

  • Estimates focal length in pixels (Fx and Fy) for accurate spatial tracking

  • Measures PTZ speeds to predict movement and enable smooth automated actions

  • Stores calibration data locally and remotely for future sessions

  • Enables advanced features like auto-tracking and magic motion tools

Think of calibration as Hive “learning” your camera’s real-world behavior, so it can predict and manipulate it with studio-level precision.


How Calibration Works (Behind the Scenes)

1. Zoom Model (Image Scaling)

This routine estimates how much objects scale in the image as zoom is applied. For example:

  • A box that is 100px wide at lowest zoom and 1000px at highest zoom indicates a 10x scale.

  • These results are stored in Image Scaling Functions, which Hive uses for real-time framing accuracy.

Note: Manufacturer zoom ratings (e.g., 30x) often refer to focal length multipliers, not real image scaling. Hive's measured scaling reflects true optical behavior.

2. Focal Length Estimation

This routine scans different pan positions to find fields of view with high feature density; areas with distinct edges, objects, and textures, then calculates:

  • Focal length in pixels (Fx and Fy)

  • Data used for converting 2D image points into real-world PTZ coordinates

3. PTZ Speeds

To enable features like cine-movement and predictive Auto-tracking, Hive measures how fast the camera pans, tilts, and zooms in degrees per second. These values are saved to:

  • Enable smooth movement transitions

  • Accurately track motion over time

  • Avoid overshooting during complex movements


How to Run a Calibration in Hive

Option A: Manual Calibration

  • Navigate to the Advanced Settings of your video source

  • Click the Calibrate button if available

  • Follow on-screen instructions

Option B: Automatic Prompt

  • When Hive detects a new or modified source that needs calibration in the Hive Studio Application, it will prompt you.

  • Click “Agree” to begin the calibration sequence

  • Wait for confirmation or next-step instructions


Setup Requirements and Best Practices

  1. Stable Mounting

    • Use a tabletop, tripod, rig, or mount that doesn’t bounce, sway, or shake

    • Avoid handheld or resting on loose surfaces

  2. Rich Visual Environment

    • Do NOT aim at plain white or blank walls

    • Use rooms with objects, texture, depth, and varied colors

    • Avoid reflections and repetitive patterns

  3. Lighting

    • Ensure room is well-lit, consistent, and free of flickers noticable to the naked eye.

    • Natural light is acceptable if stable

  4. Scene Framing

    • Recommended: Place camera 3–4 meters away from subjects if possible. Having multiple moving subjects may cause delay.

    • Desktop distances for streaming setups are also fine

    • Optional: Use a chip chart for studio-grade calibration


When Calibration Fails

Common failure reasons:

  • Camera movement during calibration

  • There are moving objects or live subjects in the scene

  • Poor lighting or low contrast scenes

  • Mechanical error in the camera (e.g., stuck zoom motor)

Iris will guide you with corrective suggestions:

  • Retry: Re-run failed routines

  • Skip: Cancel and discard current results

  • Use Generic: Use calibration data from similar device models


Tips, Limitations, and Recommendations

  • Use Calibrated Devices: Add devices with supported brands/models to enable auto-download of Global calibration data.

  • Calibrate Once, Use Often: Calibration is persistent unless the environment or hardware changes.

  • Avoid Movement: Even subtle vibrations can derail calibration accuracy.

  • Recalibrate If Needed: After hardware repairs, firmware updates, or environmental changes.


FAQs

Q1: Do I need to calibrate every camera?

No. Calibration is only recommended for first time integration installation, after frequent setups & breakdowns, and for your Producer’s peace of mind.

Q2: Can I edit or redo a calibration?

Yes. You can manually recalibrate anytime via Advanced Settings and by right clicking on the source thumbnail in the Sources Tray

Q3: Can I calibrate third-party or encoder-only devices?

Not all. Calibration is only available for cameras with supported Hive drivers.


Calibration in Hive is more than optional fine-tuning, it's a foundational process that unlocks advanced camera intelligence. By understanding your camera’s physical behavior through zoom scaling, focal length, and movement speed, Hive transforms standard cameras into precision-controlled tools. With flexible routines, cloud syncing, and user-friendly recovery steps, calibration is designed for everyone, from solo streamers to full-scale production houses.


Did this answer your question?