Struct MotionVector 

pub struct MotionVector {
    pub dx: i32,
    pub dy: i32,
}

A motion vector with sub-pixel precision.

Components are stored in 1/8 pixel (eighth-pel) precision internally. This allows conversion to any lower precision without loss.

Fields

dx: i32

Horizontal displacement (dx) in 1/8 pixel units.

dy: i32

Vertical displacement (dy) in 1/8 pixel units.

Implementations

impl MotionVector

pub const fn zero() -> Self

Creates a zero motion vector.

pub const fn new(dx: i32, dy: i32) -> Self

Creates a motion vector with the given components (in 1/8 pel).

pub const fn from_full_pel(dx: i32, dy: i32) -> Self

Creates a motion vector from full-pixel coordinates.

pub const fn from_precision(dx: i32, dy: i32, precision: MvPrecision) -> Self

Creates a motion vector at the given precision.

pub const fn is_zero(&self) -> bool

Returns true if this is a zero motion vector.

pub const fn full_pel_x(&self) -> i32

Returns the full-pixel horizontal component.

pub const fn full_pel_y(&self) -> i32

Returns the full-pixel vertical component.

pub const fn frac_x(&self) -> i32

Returns the fractional horizontal component (0-7).

pub const fn frac_y(&self) -> i32

Returns the fractional vertical component (0-7).

pub const fn half_pel_x(&self) -> i32

Returns the half-pel x component (0-1).

pub const fn half_pel_y(&self) -> i32

Returns the half-pel y component (0-1).

pub const fn quarter_pel_x(&self) -> i32

Returns the quarter-pel x component (0-3).

pub const fn quarter_pel_y(&self) -> i32

Returns the quarter-pel y component (0-3).

pub const fn to_precision(&self, precision: MvPrecision) -> Self

Converts to the specified precision (may lose fractional bits).

pub const fn round_to_precision(&self, precision: MvPrecision) -> Self

Rounds to the specified precision.

pub fn clamp(&self) -> Self

Clamps the motion vector to valid range.

pub fn clamp_to_range(&self, range: &SearchRange) -> Self

Clamps to the specified search range (in full pixels).

pub const fn magnitude_squared(&self) -> i64

Returns the squared magnitude.

pub const fn l1_norm(&self) -> i32

Returns the L1 norm (Manhattan distance).

pub fn linf_norm(&self) -> i32

Returns the L-infinity norm (Chebyshev distance).

pub fn scale(&self, num: i32, den: i32) -> Self

Scales the motion vector.

Trait Implementations

impl Add for MotionVector

type Output = MotionVector

The resulting type after applying the + operator.

fn add(self, other: Self) -> Self

Performs the + operation.

impl Clone for MotionVector

fn clone(&self) -> MotionVector

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MotionVector

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

Formats the value using the given formatter.

impl Default for MotionVector

fn default() -> MotionVector

Returns the “default value” for a type.

impl Hash for MotionVector

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Neg for MotionVector

type Output = MotionVector

The resulting type after applying the - operator.

fn neg(self) -> Self

Performs the unary - operation.

impl PartialEq for MotionVector

fn eq(&self, other: &MotionVector) -> 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 Sub for MotionVector

type Output = MotionVector

The resulting type after applying the - operator.

fn sub(self, other: Self) -> Self

Performs the - operation.

impl Copy for MotionVector

impl Eq for MotionVector

impl StructuralPartialEq for MotionVector