Skip to content

Library containing perceptual hash algorithms using the ImageSharp library

License

Notifications You must be signed in to change notification settings

coenm/ImageHash

Repository files navigation

ImageHash
ImageHash

Build Status Coverage NuGet

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

Contents

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 algorithms:
// var hashAlgorithm = new DifferenceHash();
// var hashAlgorithm = new PerceptualHash();

string filename = "your filename";
using var stream = File.OpenRead(filename);

ulong imageHash = hashAlgorithm.Hash(stream);

snippet source | anchor

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);

snippet source | anchor

You can also take a look at DotNet APIs.

Some screenshots of the demo application

Screenshot 1

Screenshot 2

Screenshot 3