OPTIMIZE2BW(1)

📦 version 1.2.1, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 optimize2bw — the ExactImage manual, but make it make sense 💖

okay bestie, sit down, grab a strawberry 🍓, because we're about to talk about optimize2bw, the automatic thresholder from the ExactImage toolkit. she's a section 1 girlie, she lives in your terminal, and she's lowkey iconic for turning your chaotic scans into clean black-and-white archives. no cap. 👑

✨ NAME ✨

optimize2bw — the automatic thresholder of the ExactImage toolkit. that's it, that's the whole vibe. 💅

🌸 SYNOPSIS 🌸

so here's how you call her:

optimize2bw [option...] {-i | --input} input-file
            {-o | --output} output-file

optimize2bw --help

basically: give her an input file and an output file, sprinkle in whatever options you want, and she does the thing. and if you're just here to lurk, --help is right there. 🫶

🦋 DESCRIPTION 🦋

ExactImage is a fast C++ image processing library. and the way that it's different from a lot of other library frameworks? she can operate in several color spaces and bit depths natively, which means low memory usage and low computational requirements. it's giving efficient. it's giving mindful. we love a resource-conscious queen. ✨

so optimize2bw reads image files and performs automatic thresholding plus optional scaling on the data. why would you want that, you ask? for long term archiving of documents that have to be stored in sub-byte black and white data, so you can reduce storage requirements. like, she's not just a pretty face — she's the reason your archive of 10,000 scanned documents doesn't eat your entire disk. main character energy, honestly. 💀💖

🎀 OPTIONS 🎀

here's every single flag she takes, no skipping, no summarising, we're doing this properly:

  • -i file, --input file — read the image from the specified file. this is your input bestie, the raw material. 🍓
  • -o file, --output file — save the output image to the specified file. this is where the glow-up lands. 💅
  • -n, --denoise — remove ("denoise") single bit pixel noise. little lonely stray pixels? gone. not me sending them to the shadow realm. 🙈
  • -d n, --dpi n — scale the image to the specified resolution. set your dpi, get your dpi. 🎯
  • -h n, --high n — set the high normalization value.
  • -l n, --low n — set the low normalization value.
  • -r n, --radius n — set the "unsharp mask" radius. the default is 0. ⭐
  • -s n, --scale n — set the output scale factor. the default is 1.0. 🌈
  • -sd x, --standard-deviation x — set the standard deviation for Gaussian distribution. the default is 0.0. 🧚
  • -t n, --threshold n — set the threshold value. the default is 0. 🔥
  • --help — display help text and exit. when in doubt, ask the girl herself. 💜

💅 EXAMPLES 💅

look at her go:

$ optimize2bw -i logo.jpg -o logo.tif
Scale: 0

that's it. in goes the logo.jpg, out comes the logo.tif, and she tells you Scale: 0. periodt. ✨

🌈 SEE ALSO 🌈

  • exactimage(7) — the whole family, go meet the rest of them. 🫶

👑 AUTHORS 👑

  • Jakub Wilk <jwilk@debian.org> — wrote this manual page for the Debian system. thank you for your service, legend. 🎀
  • https://exactcode.com/opensource/exactimage/ — this manual page incorporates texts found on the ExactImage homepage. 💖

This manual page was written for the Debian system (and may be used by others).

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 or (at your option) any later version published by the Free Software Foundation.

On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL-2.

okay and that's the whole page, bestie!! 🦋 this one's from the ExactImage Manual, page optimize2bw, dated 04/11/2010 — yes she's a 2010 girlie and she still ate. mwah. 💖✨🎀

📦 where this page comes from