Struct Homography 

pub struct Homography<F: Float = f32> {
    pub h: Matrix3<F>,
}

A 3×3 projective homography matrix.

Maps 2D points between two projective planes: p_dst ~ H * p_src.

Fields

h: Matrix3<F>

The raw 3×3 matrix. Defined up to an overall scale; estimators in this module normalise it so the bottom-right entry is 1.

Implementations

impl<F: Float> Homography<F>

pub fn new(h: Matrix3<F>) -> Self

Wrap an existing 3×3 matrix as a homography. The matrix is taken as-is; no normalisation is applied.

pub fn from_array(rows: [[F; 3]; 3]) -> Self

Build a homography from a row-major [[row0], [row1], [row2]] array.

pub fn to_array(&self) -> [[F; 3]; 3]

Return the matrix as a row-major [[row0], [row1], [row2]] array.

pub fn zero() -> Self

A homography backed by the all-zeros matrix. Not invertible — used only as a placeholder before a real estimate is available.

pub fn apply(&self, p: Point2<F>) -> Point2<F>

Apply the homography to a 2D point.

pub fn inverse(&self) -> Option<Self>

Compute the inverse homography, if the matrix is invertible.

Trait Implementations

impl<F: Clone + Float> Clone for Homography<F>

fn clone(&self) -> Homography<F>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<F: Copy + Float> Copy for Homography<F>

impl<F: Debug + Float> Debug for Homography<F>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<F: PartialEq + Float> PartialEq for Homography<F>

fn eq(&self, other: &Homography<F>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<F: PartialEq + Float> StructuralPartialEq for Homography<F>