Struct SceneChangeDetector

Source

pub struct SceneChangeDetector;

Expand description

A stateless scene-change detector that classifies a single histogram difference value against a configurable threshold.

This is a lightweight helper for callers that compute histogram differences externally (e.g. from a motion-estimation pass) and just need to decide whether to force an I-frame.

For a stateful, full-featured detector with GOP-boundary management see SceneChangeIdrController.

Implementations§

Source §

impl SceneChangeDetector

Source

pub fn new() -> Self

Create a new SceneChangeDetector.

Source

pub fn is_scene_change(hist_diff: f32, threshold: f32) -> bool

Classify a pre-computed histogram difference as a scene change.

§Parameters

hist_diff – normalised histogram distance in [0.0, 1.0]. A value of 0.0 means identical frames; 1.0 means maximally different.
threshold – decision boundary; values strictly above the threshold are considered scene changes. Typical value: 0.45.

§Returns

true if hist_diff > threshold (scene change detected).

Trait Implementations§

Source §

impl Clone for SceneChangeDetector

Source §

fn clone(&self) -> SceneChangeDetector

Returns a duplicate of the value. Read more

1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more

Source §

impl Debug for SceneChangeDetector

Source §

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

Formats the value using the given formatter. Read more

Source §

impl Default for SceneChangeDetector

Source §

fn default() -> SceneChangeDetector

Returns the “default value” for a type. Read more

Auto Trait Implementations§

§

impl UnwindSafe for SceneChangeDetector

Blanket Implementations§

Source §

impl<T> Any for T
where T: 'static + ?Sized,

Source §

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

Source §

impl<T> Borrow<T> for T
where T: ?Sized,

Source §

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

Source §

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source §

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

Source §

impl<T> CloneToUninit for T
where T: Clone,

Source §

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)

Performs copy-assignment from self to dest. Read more

Source §

impl<T> From<T> for T

Source §

fn from(t: T) -> T

Returns the argument unchanged.

Source §

impl<T, U> Into for T
where U: From<T>,

Source §

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source §

impl<T> IntoEither for T

Source §

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more

Source §

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more

Source §