Struct FlowField 

pub struct FlowField {
    pub vectors: Vec<FlowVector>,
    pub width: u32,
    pub height: u32,
    pub block_size: u32,
}

A dense optical flow field covering a frame on a block grid.

Fields

vectors: Vec<FlowVector>

Flat storage, row-major over block rows × block columns.

width: u32

Frame width in pixels.

height: u32

Frame height in pixels.

block_size: u32

Block size in pixels (each cell in the grid covers this many pixels).

Implementations

impl FlowField

pub fn new(width: u32, height: u32, block_size: u32) -> Self

Create a new, zeroed flow field.

pub fn set(&mut self, x: u32, y: u32, flow: FlowVector)

Set the flow vector at block position (x, y).

x is the block column, y is the block row. Does nothing if the indices are out of range.

pub fn get(&self, x: u32, y: u32) -> Option<&FlowVector>

Get the flow vector at block position (x, y).

Returns None if the indices are out of range.

pub fn block_cols(&self) -> u32

Number of block columns.

pub fn block_rows(&self) -> u32

Number of block rows.

pub fn avg_magnitude(&self) -> f32

Average magnitude of all flow vectors weighted by confidence.

Returns 0.0 when the field is empty or all confidences are zero.

pub fn dominant_direction(&self) -> (f32, f32)

Dominant (average) direction as (dx, dy), confidence-weighted.

Returns (0.0, 0.0) when the field is empty or all confidences are zero.

Trait Implementations

impl Clone for FlowField

fn clone(&self) -> FlowField

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FlowField

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

Formats the value using the given formatter.