calib-targets-core 0.9.0

//! Core types and utilities for calibration target detection.
//!
//! This crate is intentionally small and purely geometric. It does *not*
//! depend on any concrete corner detector implementation or image type, but it
//! owns the shared detector configuration contracts used across the workspace.
//!
//! ## Quickstart
//!
//! ```
//! use calib_targets_core::{LabeledCorner, TargetDetection, TargetKind};
//! use nalgebra::Point2;
//!
//! let corner = LabeledCorner::new(Point2::new(12.0, 8.0), 0.9);
//! let detection = TargetDetection::new(TargetKind::Chessboard, vec![corner]);
//!
//! println!("{}", detection.corners.len());
//! ```
//!
//! ## Includes
//!
//! - Homography estimation and warping helpers.
//! - Lightweight grayscale image views and sampling.
//! - Grid alignment and target detection types.
#![deny(missing_docs)]

mod chess;
mod corner;
mod grid_alignment;
mod homography;
mod image;
pub mod io;
mod logger;
mod orientation_clustering;
mod rectify;

pub use homography::{
    estimate_homography_rect_to_img, homography_from_4pt, warp_perspective_gray, Homography,
};
pub use image::{
    sample_bilinear, sample_bilinear_fast, sample_bilinear_u8, GrayImage, GrayImageView,
};
pub use rectify::{RectToImgMapper, RectifiedView};

// Only the two `chess-corners` types the workspace's own public API
// legitimately exposes are re-exported: `DetectorConfig` is the ChESS config
// object a consumer constructs, `OrientationMethod` is the documented
// orientation knob. Advanced ChESS tuning types are imported from the
// `chess-corners` crate directly, where they belong — re-exporting the whole
// upstream surface would freeze it into this crate's semver contract.
pub use chess::{DetectorConfig, OrientationMethod};
pub use corner::{AxisEstimate, GridCoords, LabeledCorner, TargetDetection, TargetKind};
pub use grid_alignment::{GridAlignment, GridTransform, GRID_TRANSFORMS_D4};

#[cfg(feature = "tracing")]
pub use logger::init_tracing;

pub use logger::init_with_level;