avatar

Documentation

Overview

Package avatar provides perceptual hashing for profile avatars.

Index

• func Distance(a, b uint64) int
• func Hash(ctx context.Context, cache httpcache.Cacher, avatarURL string, ...) uint64
• func Score(a, b uint64) float64
• func Similar(a, b uint64) bool

Functions

func Distance

func Distance(a, b uint64) int

Distance returns the hamming distance between two hashes.

func Hash

func Hash(ctx context.Context, cache httpcache.Cacher, avatarURL string, logger *slog.Logger) uint64

Hash fetches an avatar image and computes its perceptual hash. Returns 0 on any error (network, decode, unsupported format). Uses the provided cache for HTTP responses (raw image bytes are cached).

func Score

func Score(a, b uint64) float64

Score returns a similarity score (0.0-1.0) based on hamming distance. Returns 0 if either hash is 0 or distance exceeds threshold.

func Similar

func Similar(a, b uint64) bool

Similar returns true if two avatar hashes are perceptually similar. A hamming distance of 10 or less (out of 64 bits) indicates similarity.