img-flir(n)

✨ img-flir(n) ✨

okay bestie, sit down, hydrate, because we're about to talk about the img-flir(n) page from the Img manual and honestly? it's giving niche-but-iconic. this is the whole thing, top to bottom, no skips. 🫶

---

🌸 NAME 🌸

img-flir — the FLIR FPF Public Image format handler, aka flir. that's it, that's the name. 💅

---

🦋 SYNOPSIS 🦋

package require img::flir ?2.1?

literally one line. we love a low-effort entrance. ✨

---

💖 DESCRIPTION 💖

package require img::flir

so here's the tea, bestie: like all the packages of Img, this one does not hand you any brand-new commands. nope. instead it extends the Tk command image that you already have, so that it can handle files containing raster images in the FLIR FPF Public Image format (flir). more specifically? img::flir extends Tk's photo image type (https://www.tcl.tk/man/tcl9.0/TkCmd/photo.html). glow-up, but for image types. 👑

the name of the new format handler is flir. this handler brings you new additional configuration options. scroll down to Options for the detailed breakdown, iykyk.

all of the above means that in a call like

image create photo ?name? ?options?

1. image data in flir format (options -data and -file) is detected automatically. 🔍
2. the format name flir is recognized by the option -format. ✅

in addition, the value of option -format is treated as a list and may contain any of the special options listed in the Options section.

and listen — the package img::flir is not loaded when you do a package require Img. nope, nope. you have to load it explicitly with package require img::flir. don't forget or you'll be sitting there like 😭 wondering why nothing works.

---

🌈 NOTES 🌈

1. this format handler interprets FLIR temperature files as grayscale images. cute and simple. 🩶
2. temperature values specified as short, int, float and double are supported. so many flavors, all valid. 🍓
3. this format handler only supports read functionality. it's a reader, not a writer. it does not write. periodt. 💀

---

💅 OPTIONS 💅

the handler provides the following options:

• -verbose bool — available since version 1.4.9.

if set to true, additional information about the read data is printed to stdout. default is false. so if you want the gossip about your pixels, turn it on. 🗣️

• -map string — available since version 1.4.9.

specify the mode used when mapping the 16, 32 or 64-bit temperature values to 8-bit grayscale values for displaying. possible values: none, minmax, agc. default mode is minmax. ✨

1. if mode is set to none, no mapping of input values is done. use this mode if the input values are already in the range of 0 ..255. when using mode none, no information about the minimum and maximum input values is gathered during reading and therefore no verbose output is printed. on the other hand, reading the input data is faster. speed vs. gossip, pick your fighter. 🏃‍♀️
2. mode minmax maps the minimum and maximum input data to 256 grayscale values. 📊
3. mode agc applies an automatic gain control algorithm to the input values. currently implemented for 1-channel 32-bit float images only. so specific. we stan a specialist. 🎀

• -min double — available since version 1.4.9.

specify the minimum pixel value to be used for mapping the input data to 8-bit image values. if not specified or negative, the minimum value found in the image data is used. valid for mapping mode: minmax.

• -max double — available since version 1.4.9.

specify the maximum pixel value to be used for mapping the input data to 8-bit image values. if not specified or negative, the maximum value found in the image data is used. valid for mapping mode: minmax. twin of -min, obviously. 👯

• -gamma double — available since version 1.4.9.

specify a gamma correction to be applied when mapping the input data to 8-bit image values. default is 1.0. valid for mapping modes: minmax and agc.

• -saturation double — available since version 1.4.9.

the supplied value specifies the saturation value, i.e. all input values greater than the saturation value are mapped to white. if not specified or negative, do not use saturation. valid for mapping mode: agc. 🤍

• -cutoff double — available since version 1.4.9.

the supplied value specifies the cut-off value in percent. the cut-off value specifies how many pixels from the lower and upper part of the histogram are not considered for mapping. this option is useful if there are some hot or cold spots in the image. default is 3.0. valid for mapping mode: agc. 🔥🧊

---

🔥 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

(yes, img-flir is in the list of things img-flir says to see also. iconic self-reference 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 the img-flir(n) manual, version 2.1, living in the Img manual set — so if you ever need to remember which version of this page you're reading, it's 2.1, fr fr. now go read some FLIR temperature files as grayscale images and slay. 💖✨🎀