EMPTY-PAGE(1)

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

💖 EMPTY-PAGE 💖

okay bestie, so this is empty-page from the ExactImage Manual (section 1, the big leagues 💅) — a tiny little utility that looks at a scan and goes "hmm, is this page literally blank or not?" and honestly? she ate.

✨ NAME ✨

empty-page — the empty page detector of the ExactImage toolkit 🕵️♀️

🌸 SYNOPSIS 🌸

empty-page [option...] {-i | --input} input-file

empty-page {-h | --help}

like, you give her an image, she tells you if it's empty. that's it. that's the whole job. iconic behavior fr fr.

🦋 DESCRIPTION 🦋

ExactImage is a fast C++ image processing library ⚡ and no cap, unlike a lot of other library frameworks out there, it lets you operate in several color spaces and bit depths natively — which means low memory usage and low computational requirements. she's efficient. she's mindful. she's not gonna make your poor little laptop cry 😭

so here's what empty-page does: she counts the dark pixels of a black and white image, and then decides — using a threshold — whether the page is most probably empty, and thus can be removed from the image processing stream. bye bye blank page, you will not be missed 🎀

✨ OPTIONS ✨

  • -i file, --input file — read the image from the specified file. this is the one she actually needs, bestie.
  • -m n, --margin n — set the width of the border margin to skip. ⚠️ for speed reasons, the margin has to be a multiple of 8. the default is 16.
  • -p x, --percentage x — set the fraction of permissible dark pixels. the default is 0.05 (that's 5% for the non-math girlies 💅).
  • -h, --help — display the help text and exit. she's helpful like that 🫶

🌈 EXAMPLES 🌈

okay watch this:

$ empty-page -i test.tif
The image has 75461 dark pixels from a total of 1060992 (7.11231%).
non-empty

the way she just told us the exact numbers... 75461 dark pixels out of 1060992, that's 7.11231%, and the verdict is non-empty. periodt. 💀

💜 EXIT STATUS 💜

  • the exit status is 0 if the image is mostly white ✅
  • 1 otherwise ❌

iykyk, that's your script's cue.

🎀 SEE ALSO 🎀

👑 AUTHORS 👑

  • Jakub Wilk <jwilk@debian.org> — wrote this manual page for the Debian system. thank you king 🫡
  • 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.

and that's the whole page, bestie!! ✨ this one's from the empty-page manpage, dated 04/11/2010, living in the ExactImage Manual — go forth and detect those empty pages, mwah 💖🌸🦋

📦 where this page comes from