Skip to main content

ImageMultiHash

Struct ImageMultiHash 

Source
pub struct ImageMultiHash {
    pub segment_hashes: Vec<Hash>,
}
Expand description

A collection of per-segment hashes produced by crop_resistant_hash.

Distance (subtract) returns a f64 — not an integer — because it sums best-match Hamming distances and applies a penalty for unmatched segments.

Fields§

§segment_hashes: Vec<Hash>

Implementations§

Source§

impl ImageMultiHash

Source

pub fn subtract(&self, other: &ImageMultiHash) -> f64

Returns the float distance between two ImageMultiHash objects.

Matches Python ImageMultiHash.__sub__:

matches, sum_distance = self.hash_diff(other)
max_difference = len(self.segment_hashes)
if matches == 0: return max_difference
max_distance = matches * len(self.segment_hashes[0])
tie_breaker = -(sum_distance / max_distance)
match_score = matches + tie_breaker
return max_difference - match_score
Source

pub fn subtract_with( &self, other: &ImageMultiHash, hamming_cutoff: Option<f64>, bit_error_rate: Option<f64>, ) -> f64

Source

pub fn hash_diff( &self, other: &ImageMultiHash, hamming_cutoff: Option<f64>, bit_error_rate: Option<f64>, ) -> (usize, usize)

Returns (matches, sum_of_hamming_distances) for segments within cutoff.

Matches Python ImageMultiHash.hash_diff.

Source

pub fn matches( &self, other: &ImageMultiHash, region_cutoff: usize, hamming_cutoff: Option<f64>, bit_error_rate: Option<f64>, ) -> bool

True if at least region_cutoff segments match within the hamming cutoff.

Source

pub fn best_match<'a>( &self, others: &'a [ImageMultiHash], ) -> Option<&'a ImageMultiHash>

Returns the ImageMultiHash in others that minimizes self.subtract(other).

Source

pub fn to_hex(&self) -> String

Comma-joined hex of each segment hash (matches Python str(multihash)).

Examples found in repository?
examples/squint-cli.rs (line 41)
21fn main() -> ExitCode {
22    let args: Vec<String> = env::args().collect();
23    if args.len() != 4 {
24        eprintln!("usage: squint-cli <algo> <size> <path>");
25        return ExitCode::from(2);
26    }
27    let algo = args[1].as_str();
28    let size: usize = args[2].parse().unwrap_or(8);
29    let path = &args[3];
30
31    let result = match algo {
32        "phash" => phash(path, size).map(|h| h.to_hex()),
33        "phash_simple" => phash_simple(path, size).map(|h| h.to_hex()),
34        "dhash" => dhash(path, size).map(|h| h.to_hex()),
35        "dhash_vertical" => dhash_vertical(path, size).map(|h| h.to_hex()),
36        "average_hash" => average_hash(path, size).map(|h| h.to_hex()),
37        "whash_haar" => whash_haar(path, size).map(|h| h.to_hex()),
38        "whash_db4" => whash_db4(path, size).map(|h| h.to_hex()),
39        "whash_db4_robust" => whash_db4_robust(path, size).map(|h| h.to_hex()),
40        "colorhash" => colorhash(path, size).map(|h| h.to_hex()),
41        "crop_resistant_hash" => crop_resistant_hash(path, None).map(|mh| mh.to_hex()),
42        _ => {
43            eprintln!("unknown algo: {}", algo);
44            return ExitCode::from(2);
45        }
46    };
47
48    match result {
49        Ok(hex) => {
50            println!("{}", hex);
51            ExitCode::from(0)
52        }
53        Err(e) => {
54            eprintln!("error: {}", e);
55            ExitCode::from(1)
56        }
57    }
58}

Trait Implementations§

Source§

impl Clone for ImageMultiHash

Source§

fn clone(&self) -> ImageMultiHash

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 ImageMultiHash

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Display for ImageMultiHash

Source§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

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<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

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> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> 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§

impl<T> Pointee for T

Source§

type Pointer = u32

Source§

fn debug( pointer: <T as Pointee>::Pointer, f: &mut Formatter<'_>, ) -> Result<(), Error>

Source§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

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

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T> ToString for T
where T: Display + ?Sized,

Source§

fn to_string(&self) -> String

Converts the given value to a String. Read more
Source§

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

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more