GIFBG(1)

🎀 GIFBG(1) — giflib docs, bestie edition 🎀

okay so you found your way into the GIFLIB Documentation and specifically the page for gifbg. hi. welcome. this is the manual for GIFBG(1) and honestly? it's a little cutie. let's get into it 💖

---

✨ NAME ✨

gifbg — generate a test-pattern GIF 🦋

---

✨ SYNOPSIS ✨

gifbg [-v] [-d dir] [-l levels] [-c R G B] [-m min] [-o max] [-s w h]
      [-h]

like. that's the whole vibe. flags in, GIF out. 💅

---

✨ DESCRIPTION ✨

so gifbg is a program that generates a single-color test pattern GIF, and the intensity of that color changes gradually — in any of the basic 8 directions. that's it, that's the whole job, and it does it beautifully.

ngl the input situation is very low-maintenance: gifbg reads no input at all. zero. it just dumps the created GIF file straight to stdout. no cap. 🙈

---

✨ OPTIONS ✨

• -v — verbose mode, aka show progress. enables printout of running scan lines. it's giving "keep me posted" energy. 👑
• -d dir — pick the direction the intensity of the background should increase in. dir can be any one of the 8 principal directions:
  • "T" — for Top
  • "TR" — for Top Right
  • "R" — for Right
  • "BR" — for Bottom Right
  • "B" — for Bottom
  • "BL" — for Bottom Left
  • "L" — for left
  • "TL" — for Top Left

also!! the compass directions work as synonyms for the ones above, so for example "NE" is equal to "TR". iykyk 🧭

direction is case insensitive. the default direction is Top (North). periodt.

• -l levels — numeric, the number of levels the color will be scaled to. default is 16. 🌈
• -c R G B — what to use as the primary background color to scale. this color gets scaled between the minimum intensity (min) and the maximum intensity (max) from one end of the screen to the other, as defined by dir. (see below — -m & -M — for min & max.) default is Blue (0, 0, 255). 💙
• -m min — minimum intensity (in percent) to scale color. default 10%.
• [-M max — maximum intensity (in percent) to scale color. default 100%. (yes bestie, that bracket is really sitting there like that in the original, i'm not touching it 💀)
• -s W H — size of image to create. default 640 by 350. 📐
• -h — print one line of command line help, similar to Usage above. short king behavior fr fr. 🫶

ok important bit: if min == max = 100 (%) and levels == 2, then a boolean mask image of the specified size will be created — all foreground. iconic.

---

✨ AUTHOR ✨

Gershon Elber. 🫡 respect where respect is due.

---

and that's the whole page bestie!! this came from the GIFLIB docs and the date on it is 2 May 2012 — yeah, vintage, but it ate. 💖✨🌸