GIFECHO(1)

💖 GIFECHO(1) 💖

okay bestie, welcome to the gifecho page from the GIFLIB Documentation — yes she's a real one, section 1, and she's about to turn your silly little text into an actual GIF. no cap. 🎀

✨ NAME ✨

gifecho — generate a GIF from ASCII text 💅

🦋 SYNOPSIS 🦋

gifecho [-v] [-s colormap-size] [-f foreground] [-c R G B] [-t text]
        [-h] [gif-file]

🌸 DESCRIPTION 🌸

so basically, this program generates GIF images out of regular text. iconic behaviour, honestly. the text can be one line or multi-line, and it gets converted using an 8 by 8 fixed font. yes, fixed. she's not flexible and that's her whole vibe. ✨

now listen: this program reads stdin if no text is provided on the command line (that's the -t situation), and it will dump the created GIF file to stdout. so if you're not careful she's just gonna yeet a whole GIF into your terminal. lowkey obsessed with that energy. 😭

🎀 OPTIONS 🎀

• -v — verbose mode, aka show progress. this enables printout of running scan lines. it's giving "she's telling you what she's doing" and honestly we love the transparency. 🫶
• -s colormap-size — explicitly defines the size of the color map of the resulting gif image. usually the image will be bicolor with fg as color 1, unless [-f] is explicitly given — in which case the color map size will be big enough to hold it. BUT it is sometimes convenient to set the color map size to certain size while the fg color is small, mainly so this image may be merged with another (images must match color map size). matching colormap sizes = the friend group has to be coordinated, periodt. 💅
• -f foreground — select the foreground index (background is always 0, no debate). by default it is one and therefore the image result is bicolored. if FG is set to n then the color map will be created with 2^k entries where 2^k > n for minimum k, assuming k <= 8. this color map will be all zeros except this foreground index. this option is useful if this text image should be integrated into another image colormap using their colors. blending in with the other girlies, we see you. 🌈
• -c R G B — the color to use as the foreground color. White by default. three numbers, R G B, in that order, no shuffling. ⭐
• -t text — one line of text can be provided on the command line. ⚠️ note: you must encapsulate the Text within quotes if it has spaces (the quotes themselves are not treated as part of the text). if no -t option is provided, stdin is read until end of file. she's patient, she'll wait. 💜
• -h — print one line command line help, similar to Usage above. a lil "here's how you use me" moment, short and sweet. 🍓

🧚 NOTES 🧚

there is a hardcoded limit of 100 the number of lines. that's the ceiling, bestie. do not test her. 💀

👑 AUTHOR 👑

Gershon Elber. the legend herself. thank you for your service. 🙈

and that's the whole page fr fr — she's from GIFLIB, dated 2 May 2012, and she's still serving. mwah, bye bestie 💖 ✨ 🎀