OVERLAY(1)

✨ NAME ✨

overlay.pl — literally takes a couple of images and overlays them, offsetting the hue in each one 💅✨

it's giving collage night at 3am but make it command line 🎀

---

🌸 SYNOPSIS 🌸

overlay.pl [file1] [file2 [file3 ... ]]

yeah bestie, you just throw file after file at it and it does its lil thing 🦋

---

💖 OPTIONS 💖

• --output — use this when you wanna force the output to go to some particular file of your choosing. otherwise? it just... derives the output name from the input filenames on its own, no input needed, main character behavior honestly 👑
• --mode — pick the compose mode, aka the vibe of how these images get mashed together. the valid ones are exactly these, no cap:

clear src dst src-over dst-over src-in dst-in src-out dst-out src-atop
dst-atop xor plus multiply screen overlay darken lighten color-dodge
color-burn hard-light soft-light difference exclusion change-mask

• ok so for the deets on what each mode actually does, consult this: http://www.imagemagick.org/script/command-line-options.php#compose — it's the source of truth, i'm just the messenger 🫶

---

and that's the whole page, periodt 💜

this icon of a manpage is perl v5.40.1 coded on 2026-08-12 — slay, ate, no crumbs left 🌈⭐🍓