Crate oximedia_calibrate 

Professional color calibration and matching tools for OxiMedia.

oximedia-calibrate provides comprehensive color calibration and matching capabilities for professional video and image processing workflows. This includes:

• Camera Calibration: ColorChecker-based camera profiling and characterization
• Display Calibration: Monitor calibration, gamma correction, and profiling
• Color Matching: Match colors across multiple cameras and devices
• ICC Profile Generation: Create ICC color profiles from measurements
• ICC Profile Application: Apply ICC profiles to images and video
• LUT Generation: Generate calibration LUTs from measurements
• White Balance: Advanced white balance algorithms and presets
• Color Temperature: Automatic color temperature detection and shifting
• Gamut Mapping: Map device gamut to working color space
• Chromatic Adaptation: Adapt colors to different illuminants

Example

use oximedia_calibrate::{
    camera::{ColorChecker, ColorCheckerType},
    white::WhiteBalancePreset,
    temp::estimate_color_temperature,
};

// Detect ColorChecker in an image
let checker = ColorChecker::detect_in_image(&image_data, ColorCheckerType::Classic24)?;

// Generate camera profile
let profile = checker.generate_camera_profile()?;

// Apply white balance
let balanced = WhiteBalancePreset::Daylight.apply_to_image(&image_data)?;

// Estimate color temperature
let temp = estimate_color_temperature(&image_data)?;

Features

Camera Calibration

• Automatic ColorChecker detection in images
• Patch extraction with subpixel accuracy
• Camera profile generation (ICC/LUT)
• Multi-illuminant calibration support
• Calibration verification and validation

Display Calibration

• Gamma curve measurement and calibration
• Display uniformity testing
• Monitor profiling for accurate color reproduction
• Display characterization

Color Matching

• Multi-camera color matching workflows
• Scene-to-scene color matching for continuity
• Match to reference target capabilities
• Color consistency verification

ICC Profiles

• ICC v2 and v4 profile generation
• ICC profile parsing and validation
• ICC profile application to images
• Profile inspection and analysis

LUT Generation

• Measurement-based LUT creation
• 1D and 3D calibration LUTs
• LUT verification and validation
• Interpolation quality assessment

White Balance

• Automatic white balance from scene analysis
• Standard presets (Daylight, Tungsten, Fluorescent, etc.)
• Custom white balance from reference patch
• Gray world and white patch algorithms

Color Temperature

• Automatic color temperature estimation
• Temperature shift application
• Kelvin to RGB conversion
• Illuminant D-series support

Gamut Mapping

• Device gamut to working space mapping
• Perceptual gamut mapping strategies
• Gamut compression algorithms
• Out-of-gamut color handling

Chromatic Adaptation

• Bradford chromatic adaptation transform
• Von Kries adaptation
• CAT02 adaptation (CIECAM02)
• Custom illuminant adaptation

ColorChecker Support

• X-Rite ColorChecker Classic (24 patches)
• X-Rite ColorChecker Passport
• Datacolor SpyderCheckr
• Custom target support

Calibration Workflows

Camera Profiling Workflow

1. Shoot ColorChecker under target lighting
2. Detect ColorChecker in image
3. Extract patch colors
4. Generate camera ICC profile or LUT
5. Apply calibration to footage
6. Verify calibration accuracy

Display Calibration Workflow

1. Measure display with colorimeter
2. Generate gamma and uniformity profiles
3. Create display ICC profile
4. Apply profile to output pipeline
5. Verify display accuracy

Camera Matching Workflow

1. Calibrate primary camera (Camera A)
2. Shoot matching target with Camera B
3. Generate matching LUT/profile
4. Apply to Camera B footage
5. Verify color matching across cameras

Modules

aces_calibration

ACES (Academy Color Encoding System) Input Device Transform (IDT) generation.

aging_model

Display aging and drift modeling for calibration compensation.

ambient_compensation

Ambient light compensation — adjust display profiles based on ambient light.

batch_calibrate

Batch calibration — calibrate multiple cameras from a single shooting session.

calibrate_report

Calibration report generation and analysis.

calibration_extras

Additional calibration utilities implementing the core calibration APIs.

calibration_schedule

Calibration schedule — track when devices are due for re-calibration.

camera

Camera calibration and profiling.

chart_detection

Calibration chart detection (color checker, resolution chart).

chromatic

Chromatic adaptation transforms.

color_checker

Color checker target definitions and patch reference data.

color_space

Colour space calibration primitives.

delta_e

Advanced color difference metrics.

display

Display calibration and profiling.

display_verify

Display verification: white point, black level, and target compliance.

flare_correction

Lens flare correction for calibration accuracy.

gamut

Gamut mapping and compression.

gamut_checker

Gamut boundary analysis and out-of-gamut pixel detection.

geometry

Geometric camera calibration models.

hdr_calibration

HDR display calibration with PQ and HLG transfer functions and peak luminance mapping.

icc

ICC profile generation, parsing, and application.

icc_profile

ICC color profile parsing and management.

lens_profile

Lens distortion and vignetting profiling.

lut

Calibration LUT generation and verification.

match

Color matching across cameras and scenes.

metamerism

Metamerism index calculation and detection.

monitor_calibration

Display / monitor calibration support.

patch_extract

Patch extraction and sampling from calibration target images.

printer_calibration

Printer calibration and CMYK soft-proofing workflows.

spectral

Spectral reflectance and color matching functions.

spectral_reconstruction

Spectral reconstruction — recover spectral power distributions (SPDs) from RGB camera measurements.

temp

Color temperature estimation and adjustment.

temporal_uniformity

Temporal uniformity analysis: per-frame luminance tracking and flicker detection.

test_chart

Test chart analysis for color calibration.

uniformity

Display uniformity measurement and analysis.

white

White balance algorithms and presets.

white_balance

White balance calibration for professional camera workflows.

Enums

CalibrationError

Errors that can occur during color calibration operations.

Illuminant

Standard illuminant types.

Observer

Observer angle for colorimetric calculations.

Type Aliases

CalibrationResult

Result type for calibration operations.

Lab

LAB color value (Lab* color space).

Matrix3x3

3x3 color matrix.

Matrix3x4

3x4 color matrix with offset.

Rgb

RGB color value (normalized to 0.0-1.0 range).

Rgba

RGBA color value (normalized to 0.0-1.0 range).

Xyz

XYZ tristimulus value.