img-gif(n)

✨ img-gif(n) ✨

okay bestie, welcome to img-gif, a page from the Img manual. it's giving GIF. it's giving photo image type. let's get into it 🎀

---

🌸 NAME 🌸

img-gif — Graphics Interchange Format (gif) 💅

---

🦋 SYNOPSIS 🦋

package require img::gif ?2.1?

---

💖 DESCRIPTION 💖

so the whole vibe starts here:

package require img::gif

like every single package in Img, this one does not hand you shiny new commands. nope. instead it extends the existing Tk command image, so that Tk suddenly understands files holding raster images in the Graphics Interchange Format (gif). more specifically, img::gif extends Tk's photo image type (the Tcl/Tk photo manual is at https://www.tcl.tk/man/tcl9.0/TkCmd/photo.html — go look, iykyk).

the name of the new format handler is gif. and this handler brings new additional configuration options with it — check the Options section below for the full tea, no crumbs left out. 🍓

all of the above means that in a call like

image create photo ?name? ?options?

1. image data in gif format (that's the options -data and -file) is detected automatically — not me doing detective work, it just knows.
2. the format name gif is recognized by the option -format. periodt.

plus, the value of the option -format is treated as a list, and it may contain any of the special options listed in the Options section. so you can stack them in there. slay.

heads up: the package img::gif is not loaded when you do a package require Img. you have to load it explicitly with package require img::gif. it does not come for free, bestie 😭

---

📝 NOTES 📝

1. chapter Multi-page Images of the Img manual page describes the handling of images with multiple pages. go read it if you're doing multi-page stuff, fr fr.

---

👑 OPTIONS 👑

the handler provides the following options:

• -verbose bool — this option is supported for reading and writing. available since version 2.0. if set to true, additional information about the read or written image is printed to stdout. default is false. so it yaps about what it's doing when you ask it to 🌈
• -index integer — this option is supported for reading only. available since version 1.2.4. reads the page at the specified index. the first page is at index 0. default is 0. so index 0 is the main character and everyone else is just a page in her story 💅

---

🌈 SEE ALSO 🌈

img, img-bmp, img-dted, img-flir, img-gif, img-ico, img-jpeg, img-pcx, img-pixmap, img-png, img-ppm, img-ps, img-raw, img-sgi, img-sun, img-tga, img-tiff, img-window, img-xbm, img-xpm

(the whole squad. yes, img-gif is listed in its own SEE ALSO. iconic behavior honestly 🫶)

---

💜 COPYRIGHT 💜

• Copyright (c) 1995-2025 Jan Nijtmans <nijtmans@users.sourceforge.net>
• Copyright (c) 2002-2025 Andreas Kupries <andreas_kupries@users.sourceforge.net>
• Copyright (c) 2003-2025 Paul Obermeier <obermeier@users.sourceforge.net>

---

and that's the whole page, bestie 💖 this was img-gif, version 2.1, living in the Img manual. thanks for reading, go make something cute, and remember: package require img::gif or it literally won't work. mwah 💅✨🎀