PIXELIZE(1)

📦
version 2.0.0~git20220108.d1f9da9 · 2 versions
  • 2.0.0~git20220108.d1f9da9 · debian bookworm, debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking (latest)
  • 1.0.0 · ubuntu jammy
, in debian bookworm, debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ PIXELIZE(1) — the user-commands era of the manual, bestie ✨

okay so picture this: a whole manual page, but it's fun. we're in section 1 (User Commands), the vibe is immaculate, and the program is called pixelize. let's get into it 💖

🌸 NAME 🌸

pixelize — create an image consisting of many small images. yes, that's the whole bit. an image made of images. inception but make it mosaic. 🦋

💅 SYNOPSIS 💅

pixelize [OPTIONS] [image_file]

that's it. that's the summoning circle. ✨

🎀 DESCRIPTION 🎀

so pixelize is a program that uses a whole bunch of scaled-down images to try and duplicate another image as closely as it possibly can. it's giving "art project that accidentally slaps." 🫶

here's the actual tea on how it works, no cap: pixelize splits up the image you wanna render (or duplicate) into a grid of small rectangular areas. then it analyzes each one of those areas, and replaces it with an image picked from a big database of images. and it genuinely tries to pick the images that best match each area. like, it's trying its best, okay?? 😭👑

⚠️ IMPORTANT, DO NOT SKIP THIS PART: before you run pixelize you have to create an image database — a file called pic_db.dat — using the make_db(1) utility. no database, no pixelizing. it's the law. 🚨

✨ OPTIONS ✨

okay so first, the fine print, and it's actually important: mandatory arguments to long options are mandatory for short options too. periodt. 💅

and now, the Application options — the main characters:

  • -i, --in=file_name — input file name. the image you're feeding in. the raw material. the ✨before✨. 🍓
  • -o, --out=file_name — output file name. where the glow-up gets written. the ✨after✨. 💖
  • -m, --mode — command line mode. flip it into CLI mode, no window, just vibes. 👑

🗂️ FILES 🗂️

  • pic_db.dat — the file containing a database of all the pictures pixelize is gonna use to match and replace against areas of the processed image. this is THE file. without it you're just a girl standing in front of an image asking it to pixelize itself. 💀

🐛 BUGS 🐛

found a bug? don't suffer in silence, bestie. please report any bugs you find to Paul Wilkins <pwilkins@lashwhip.com>. he wants to know. fr fr. 🙈

⚖️ LICENCE ⚖️

pixelize is covered by the GNU General Public License (GPL), version 2 or later. iconic, legally protected, and free as a butterfly. 🦋✨

👀 SEE ALSO 👀

  • make_db(1) — literally the one you need first. go build that database, iykyk. 🌈

👑 AUTHOR 👑

Paul Wilkins <pwilkins@lashwhip.com> — the actual legend behind all of this. 🫶

and that's the whole page, bestie!! 🎀 this was pixelize version 2.0.0, from January 2020, and it's the PIXELIZE(1) page — so go make a mosaic, and remember: make_db(1) first, always. slay, drink water, and pixelize responsibly 💖✨🌸

📦 where this page comes from