Enum MotionEstimation 

#[non_exhaustive]
pub enum MotionEstimation {
    Auto,
    Direct,
    Chained {
        refine_radius: u32,
    },
}

Strategy for estimating a temporal neighbour’s motion vector.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Auto

Resolve to Direct or Chained from the temporal radius at denoiser construction. See MotionEstimation::resolve for the exact rule and its empirical basis.

Direct

Match every neighbour directly against the centre frame at the configured search radius. Cost scales with the temporal radius, since each neighbour repeats the full coarse+fine search.

Chained

Estimate motion between adjacent frames only, once per pushed frame, then compose the per-step vectors into a seed for each neighbour and correct residual drift with a small seeded refinement search.

Fields

refine_radius: u32

Search radius for the seeded refinement pass, in pixels at the finest pyramid level. Small because the composed seed already carries most of the true displacement.

Implementations

impl MotionEstimation

pub fn chained_default() -> Self

Convenience constructor for Chained with the library default refinement radius.

pub fn resolve(self, temporal_radius: u32) -> Self

Resolve Auto against the temporal radius, returning a concrete Direct or Chained estimation. Never returns Auto. Direct and Chained pass through unchanged, regardless of temporal_radius. See [CHAINED_RADIUS_THRESHOLD] for the threshold this applies.

Trait Implementations

impl Clone for MotionEstimation

fn clone(&self) -> MotionEstimation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for MotionEstimation

impl Debug for MotionEstimation

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

Formats the value using the given formatter.

impl Default for MotionEstimation

fn default() -> MotionEstimation

Returns the “default value” for a type.

impl PartialEq for MotionEstimation

fn eq(&self, other: &MotionEstimation) -> bool

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for MotionEstimation