calib-targets-core

Shared types and geometric utilities for the calib-targets workspace. Small, dependency-light, and purely geometric — it does not depend on any concrete corner detector or image crate. Every detector in the workspace (chessboard, ChArUco, marker board, PuzzleBoard) emits its result in terms of these types.

Most users install calib-targets (the facade) rather than this crate directly. Install calib-targets-core only if you are writing a new detector or consuming detection results without the facade.

Install

[dependencies]
calib-targets-core = "0.7"
nalgebra = "0.34"

Types you will see

Type	Role
[`Corner`]	Raw ChESS corner: position, axes, contrast, strength, fit RMS. No `(i, j)` label.
[`LabeledCorner`]	`Corner` + grid label: `position`, `grid: Option<(i, j)>`, `id`, `target_position`, `score`. The common detector output.
[`TargetDetection`]	`{ kind: TargetKind, corners: Vec<LabeledCorner> }`. Uniform wrapper across all detector types.
[`TargetKind`]	`Chessboard`, `ChArUco`, `PuzzleBoard`, `CheckerboardMarker`. Non-exhaustive.
[`GridCoords`]	Integer `(i, j)` grid index, with `i` right, `j` down. Labels are always rebased so that the bounding-box minimum sits at `(0, 0)`.
[`GridAlignment`] / [`GridTransform`]	Dihedral-group D4 (8 transforms) aligning a detected grid to a board-fixed coordinate system.

Utilities

[homography_from_4pt] + [Homography] — 4-point DLT solver with Hartley normalisation.
[warp_perspective_gray] — grayscale perspective warp.
[sample_bilinear] / [sample_bilinear_fast] / [sample_bilinear_u8] — subpixel sampling helpers on a [GrayImageView].
[cluster_orientations] + [OrientationClusteringParams] — axis-angle histogram clustering used by the chessboard detector.
[ChessConfig] + friends — shared ChESS corner-detector configuration struct, consumed by every higher-level detector through DetectorParams::chess.

Coordinate conventions

Image pixels. Origin at top-left; x right, y down. Pixel centre sampling uses (x + 0.5, y + 0.5).
Grid indices. (i, j) with i right, j down. Grid labels are non-negative — every detector rebases the bounding-box minimum to (0, 0).
Quad / homography corner order. TL, TR, BR, BL (clockwise). Never self-crossing.
Corner orientation. Corner::axes holds two ordered axis angles with axes[1] − axes[0] ≈ π/2. The CCW sweep from axes[0] to axes[1] crosses a dark sector. See the workspace conventions chapter.

Quickstart

use calib_targets_core::{Corner, TargetDetection, TargetKind};
use nalgebra::Point2;

let corner = Corner {
    position: Point2::new(10.0, 20.0),
    orientation_cluster: None,
    axes: Default::default(),
    contrast: 0.0,
    fit_rms: 0.0,
    strength: 1.0,
};

let detection = TargetDetection {
    kind: TargetKind::Chessboard,
    corners: Vec::new(),
};

println!("{:?} {}", corner.position, detection.corners.len());