UPRIGHTDIFF(1)

🌸 NAME 🌸

uprightdiff — literally examines the differences between two images, no cap 💅

✨ SYNOPSIS ✨

uprightdiff [options] <input-1> <input-2> <output>

🦋 DESCRIPTION 🦋

okay so bestie, uprightdiff is here to do a full vibe check on two images and clock every single difference between them. It produces a visual annotation AND it reports statistics. Both. At the same time. iconic behavior fr fr ✨

The way it's built? It is optimised for images which come from browser screenshots — that's its whole main character era, iykyk 🫶 It analyses the image for vertical motion, and annotates connected regions that have the same vertical displacement. Then it highlights any remaining ("residual") differences which are not explained by vertical motion on a pixel-by-pixel basis. periodt. 💖

👑 the options, bestie 👑

• --help — Show help message and exit. that's it, that's the whole job 🎀
• --block-size arg — Block size for initial search. (default 16)
• --window-size arg — Initial range for vertical motion detection. (default 200)
• --brush-width arg — Brush width when heuristically expanding blocks. A higher value gives smoother motion regions. This should be an odd number. (default 9)
• --outer-hl-window arg — The size of the outer square used for detecting isolated small features to highlight. This size defines what we mean by "isolated". It should be an odd number. (default 21)
• --inner-hl-window arg — The size of the inner square used for detecting isolated small features to highlight. This size defines what we mean by "small". It should be an odd number. (default 5)
• --intermediate-dir arg — A directory where intermediate images should be placed. This is our equivalent of debug or trace output. peek behind the curtain energy 🪄
• -v [--verbose] — Write progress info to stderr. so you can watch it cook 🍓
• --format arg — The output format for statistics, may be text (the default), json or none.
• -t [--log-timestamp] — Annotate progress info with elapsed time. ⏱️

ngl, if you're passing a number that isn't odd to --brush-width, --outer-hl-window or --inner-hl-window… that's on you bestie, they should be odd numbers 💀

💜 AUTHOR 💜

Tim Starling <tstarling@wikimedia.org> — thank you for your service king 👑

okay that's the whole page bestie, go forth and diff some screenshots 🌈🦋

uprightdiff 1.0 · August 2017 — mwah, love u, bye 💖✨