Skip to content

Latest commit

 

History

History
67 lines (47 loc) · 3.2 KB

README.md

File metadata and controls

67 lines (47 loc) · 3.2 KB

ImageHash
ImageHash

Build status Build Status Coverage NuGet MyGet Pre Release

.NET Standard library containing multiple algorithms to calculate perceptual hashes of images and to calculate similarity using those hashes.

Perceptual hash

Definition by phash.org

A perceptual hash is a fingerprint of a multimedia file derived from various features from its content. Unlike cryptographic hash functions which rely on the avalanche effect of small changes in input leading to drastic changes in the output, perceptual hashes are "close" to one another if the features are similar.

Hash Algorithms

This project implements the following algorithms:

  • AverageHash by Dr. Neal Krawetz. Check his blog/article here;
  • PerceptualHash also by Dr. Neal Krawetz.
  • DifferenceHash by David Oftedal with minor improvements of Dr. Neal Krawetz. More information can be found here or here.

Credits

API

Calculate image hash

var hashAlgorithm = new AverageHash();
// or one of the other available algorihms:
// var hashAlgorithm = new DifferenceHash();
// var hashAlgorithm = new PerceptualHash();

string filename = "your filename";
using (var stream = File.OpenRead(filename))
{
    ulong imageHash = hashAlgorithm.Hash(stream);  
}

Calculate image similarity

Note that to calculate the image similarity, both image hashes should have been calculated using the same hash algorihm.

// calculate the two image hashes
ulong hash1 = hashAlgorithm.Hash(imageStream1);  
ulong hash2 = hashAlgorithm.Hash(imageStream2);  

double percentageImageSimilarity = CompareHash.Similarity(hash1, hash2);

You can also take a look at DotNet APIs.

Some screenshots of the demo application

Screenshot 1

Screenshot 2

Screenshot 3