METAPIXEL(1)

📦
version 1.0.2 · 2 versions
  • 1.0.2 · debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking (latest)
  • 1.0.2 · fedora 43, fedora 44
, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ METAPIXEL ✨

okay bestie, welcome to the glow-up era of your terminal 💅 this is the manual for metapixel (section 1, if we're being official about it) and honestly? it's giving "make art out of tiny pictures" and I am obsessed.

💖 NAME 💖

metapixel — generator for photomosaics 🌸

🦋 SYNOPSIS 🦋

metapixel-prepare [options] [srcdir] [destdir]

prepares the pictures in srcdir by creating resized images and a table file in destdir ✨

metapixel [options] [--metapixel input.jpg output.png --library destdir]

creates a photomosaic output.png using input.jpg as the input image and destdir/tables.mxt as table file 🎀

🌈 DESCRIPTION 🌈

This manual page documents briefly the metapixel and metapixel-prepare commands. For more information check the README file included in the distribution. no cap, the README is where the lore lives 📖

metapixel is a program for generating photomosaics. It can generate classical photomosaics, in which the source image is viewed as a matrix of equally sized rectangles for each of which a matching image is substitued, as well as collage-style photomosaics, in which rectangular parts of the source image at arbitrary positions (i.e. not aligned to a matrix) are substituted by matching images. so like... grid mode AND chaos mode, both iconic, both valid 👑

metapixel-prepare is a utility that needs to be run before metapixel can be used. It prepares your source images so that they can be used by metapixel to create the actual photomosaic. she's the backstage crew, the main character can't perform without her 💅

🎀 USAGE 🎀

metapixel-prepare srcdir destdir has to be run first. srcdir is the path to the directory containing the source images, e.g. ~/Pictures/Holidays. destdir, e.g. ~/.metapixel, is the path to the directory where you want to store the rescaled images and the tables.mxt index file. This directory should be created manually before running metapixel-prepare.

🚨 bestie listen — you have to make destdir yourself first. metapixel-prepare will not do it for you, she's not your mom 💀

metapixel --metapixel input.jpg output.png --library destdir is then used to transform an image (input.jpg) into a mosaic (output.png) using the source images (described by destdir/tables.mxt). that's the moment. the transformation. the reveal. 😭✨

💅 OPTIONS 💅

The options are described in the README file or by running metapixel or metapixel-prepare with the --help option. yeah fr, --help is right there, go ask her directly 🫶

🌸 SEE ALSO 🌸

The README file is included in the Metapixel distribution. 📚

👑 AUTHOR 👑

This manual page was written by Chris Vanden Berghe <Chris@VandenBerghe.org> for the Debian(TM) system (but 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 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.

⭐ AUTHOR ⭐

Chris Vanden Berghe

  • Author.

Copyright © 2004 Chris Vanden Berghe

and that's the whole page, bestie!! 🥳 this manual is from the [FIXME: source] situation, dated May 5, 2004 — vintage, retro, a little mysterious, very demure. now go forth and mosaic something gorgeous 🌈🦋💖

📦 where this page comes from