Struct MotionField 

pub struct MotionField {
    pub vectors: Vec<MotionVector>,
    pub cols: u32,
    pub rows: u32,
    pub block_size: u32,
}

A field of motion vectors covering an entire frame.

Fields

vectors: Vec<MotionVector>

Motion vectors in row-major order.

cols: u32

Number of blocks horizontally.

rows: u32

Number of blocks vertically.

block_size: u32

Block size used for estimation.

Implementations

impl MotionField

pub fn new(frame_width: u32, frame_height: u32, block_size: u32) -> Self

Create a new motion field with zero vectors.

pub fn get(&self, bx: u32, by: u32) -> Option<&MotionVector>

Get the motion vector at block position (bx, by).

pub fn set(&mut self, bx: u32, by: u32, mv: MotionVector)

Set the motion vector at block position (bx, by).

pub fn interpolate(&self, x: f64, y: f64) -> MotionVector

Interpolate a motion vector at a continuous pixel position.

pub fn global_motion(&self) -> MotionVector

Compute global motion from the motion field (median of all vectors).

pub fn average_magnitude(&self) -> f64

Compute the average magnitude of all motion vectors.

pub fn count_above_threshold(&self, threshold: f64) -> usize

Count the number of vectors exceeding a magnitude threshold.

Trait Implementations

impl Clone for MotionField

fn clone(&self) -> MotionField

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MotionField

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

Formats the value using the given formatter.