Inspired by imagehash
A image hashing library written in Go. ImageHash supports:
- Average hashing
- Difference hashing
- Perception hashing
- Double Gradient hashing - An advanced version of gradient hashing that combines both horizontal and vertical gradient comparisons
- Wavelet hashing [TODO]
go get github.com/corona10/goimagehash
func main() {
file1, _ := os.Open("sample1.jpg")
file2, _ := os.Open("sample2.jpg")
defer file1.Close()
defer file2.Close()
img1, _ := jpeg.Decode(file1)
img2, _ := jpeg.Decode(file2)
hash1, _ := goimagehash.AverageHash(img1)
hash2, _ := goimagehash.AverageHash(img2)
distance, _ := hash1.Distance(hash2)
fmt.Printf("Distance between images: %v\n", distance)
hash1, _ = goimagehash.DifferenceHash(img1)
hash2, _ = goimagehash.DifferenceHash(img2)
distance, _ = hash1.Distance(hash2)
fmt.Printf("Distance between images: %v\n", distance)
// Double Gradient Hash
dgHash1, _ := goimagehash.DoubleGradientHash(img1, 8, 8)
dgHash2, _ := goimagehash.DoubleGradientHash(img2, 8, 8)
distance, _ = dgHash1.Distance(dgHash2)
fmt.Printf("DoubleGradient distance between images: %v\n", distance)
fmt.Printf("DoubleGradient hash (base64): %s\n", dgHash1.ToBase64())
width, height := 8, 8
hash3, _ := goimagehash.ExtAverageHash(img1, width, height)
hash4, _ := goimagehash.ExtAverageHash(img2, width, height)
distance, _ = hash3.Distance(hash4)
fmt.Printf("Distance between images: %v\n", distance)
fmt.Printf("hash3 bit size: %v\n", hash3.Bits())
fmt.Printf("hash4 bit size: %v\n", hash4.Bits())
var b bytes.Buffer
foo := bufio.NewWriter(&b)
_ = hash4.Dump(foo)
foo.Flush()
bar := bufio.NewReader(&b)
hash5, _ := goimagehash.LoadExtImageHash(bar)
}- Add Double Gradient hashing algorithm support
- Add CLI tool with support for all hashing algorithms
- Support for base64 output format (without padding)
- Enhanced batch processing with duplicate detection
- The performance of Perceptionhash is enhanced.
- Add workflow for GithubAction
- Fix typo on the GoDoc for LoadImageHash
- go.mod is now used for install goimagehash
- Perception/ExtPerception hash creation times are reduced
IMPORTANT goimagehash v1.0.0 does not have compatible with the before version for future features
- More flexible extended hash APIs are provided (ExtAverageHash, ExtPerceptionHash, ExtDifferenceHash)
- New serialization APIs are provided(ImageHash.Dump, ExtImageHash.Dump)
- ExtImageHashFromString, ImageHashFromString is deprecated and will be removed
- New deserialization APIs are provided(LoadImageHash, LoadExtImageHash)
- Bits APIs are provided to measure actual bit size of hash
- Support DifferenceHashExtend.
- Support AverageHashExtend.
- Support PerceptionHashExtend by @TokyoWolFrog.
- Perception Hash is updated.
- Fix a critical bug of finding median value.
- Support Average hashing
- Support Difference hashing
- Support Perception hashing
- Use bits.OnesCount64 for computing Hamming distance by @dominikh
- Support hex serialization methods to ImageHash by @brunoro