GIFHISTO(1)

💖 GIFHISTO(1) — the giflib glow-up 💖

okay bestie, welcome to the giflib corner of the manual, this one's called gifhisto and it's literally the color-pop girlie of the toolkit ✨

🌈 NAME 🌈

gifhisto — make a color histogram from GIF color frequencies 🎀

---

✨ SYNOPSIS ✨

gifhisto [-v] [-t] [-s width height] [-n image-number] [-b] [-h]
         [gif-file]

---

🦋 DESCRIPTION 🦋

so this program makes a histogram of how many pixels are using each color, like a headcount but for the palette 💅

the output can be formatted as a GIF histogram file, or as a text file — and both of those go to stdout, no cap 👑

if you don't hand it a GIF file, gifhisto will try to read a GIF file from stdin. it's giving flexible, it's giving resourceful 🫶

---

💅 OPTIONS 💅

• -v — verbose mode (show progress). turns on the printout of running scan lines, so you can watch it work. main character behavior fr 🔥
• -t — force the output to be a text file of this exact form: (colormap size) lines, each one containing two integers — the number of times the color appeared, and the color index. the lines are in increasing color index order. this output can be fed directly to a sort program if you want it ordered by color frequency instead 💖

the colormap picked is the one to be used for the image you're generating the histogram for, as defined in the GIF format. periodt.

• -s width height — size of the GIF histogram file. the height of the histogram should be a power of 2 divisible by the number of colors in the colormap 🧚

width sets the resolution (accuracy, if you like) of the histogram, because the maximum histogram bar gets scaled to fit it 🌸

• -n image-number — image number to test. default is one. one!! not zero!! okay iconic 🎀
• -b — zeros the background color count. here's the tea: only linear scale bars are supported, and usually the background shows up way more often than the other colors, so deleting the background count will improve the scaling of all the other colors ✨
• -h — print one line of command line help, similar to Usage above. short and sweet, we love a low-effort king 💜

---

👑 AUTHOR 👑

Gershon Elber 🫶

---

that's the whole vibe bestie, go make some beautiful histograms 💖

GIFLIB · 2 May 2012 · GIFHISTO(1) — mwah, tysm for reading, slay 🌈💅✨