fmetrics

Fast image & video fidelity metrics in C & Zig.

Read the wiki for comprehensive documentation (library usage, speed testing, MOS correlation, etc).

Usage

Compilation requires Zig ≥0.17.0 & a macOS, Linux, or Unix-like operating system. To compile, run:

zig build --release=fast

You may add -Dflto=true for FLTO on ELF targets, and -Dstrip=true to strip the binary. Zig 0.17 does not support this LTO build on macOS.

See the benchmark notes for performance and CID22 correlation results.

fmetrics binary usage:

fmetrics by Halide Compression, LLC | [version]

usage: fmetrics <metric> [options] <reference> <distorted>

compare two images/videos using various perceptual quality metrics

metrics:  iwssim, msssim, ssimu2, butter, cvvdp

run `fmetrics <metric> --help` for metric-specific help

options:
  -h, --help
      show this help message

sRGB PNG, PNM/PAM, QOI, or Y4M input expected

Credits

fmetrics is under the Apache 2.0 License. fmetrics is developed by Halide Compression.

Special thanks to Vship, which has inspired parts of fmetrics. Vship is under the MIT NON-AI license.