img-flir(3tk)

📦
version 2.1.1 · 3 versions
, in ubuntu resolute, ubuntu stonking

✨ NAME ✨

img-flir — the FLIR FPF Public Image format handler, aka flir 💖 (yes bestie, that's the img-flir(3tk) page, we're in the Img manual and it's giving thermal-camera realness 🌡️)

🎀 SYNOPSIS 🎀

package require img::flir ?2.1?

🦋 DESCRIPTION 🦋

package require img::flir

Okay so here's the vibe: like every package in Img, this one does not hand you any shiny new commands. Nope. Instead it extends the Tk command image that already exists, so that command suddenly knows how to deal with files holding raster images in the FLIR FPF Public Image format (flir). More specifically, img::flir extends Tk's photo image type (the official docs live at https://www.tcl.tk/man/tcl9.0/TkCmd/photo.html if you wanna peek 👀).

The name of the new format handler is flir. And this handler brings brand-new extra configuration options with it. Slide down to the Options section for the full tea ☕.

All of the above means that in a call like:

image create photo ?name? ?options?
  1. Image data in flir format (the -data and -file options) is detected automatically. ✨
  2. The format name flir is recognized by the -format option.

On top of that, the value of the -format option is treated as a list, and it may contain any of the special options listed in the Options section. Cute, right?

Also, super important bestie: the package img::flir is not loaded when you do package require Img. 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. 🩶
  2. Temperature values specified as short, int, float and double are supported. 🔥
  3. This format handler only supports read functionality. No writing, no cap. 🚫✍️

👑 OPTIONS 👑

The handler provides the following options:

  • -verbose bool — Available since version 1.4.9. If you set it to true, extra information about the read data gets printed to stdout. Default is false. 📢
  • -map string — Available since version 1.4.9. This one picks the mode used when mapping the 16, 32 or 64-bit temperature values down 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 happens at all. Use this mode when your input values are already sitting in the 0 ..255 range. When you use mode none, no information about the minimum and maximum input values is gathered while reading, and therefore no verbose output is printed. The trade-off? Reading the input data is faster. ⚡
    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. 🤖
  • -min double — Available since version 1.4.9. Specify the minimum pixel value used for mapping the input data to 8-bit image values. If it's not specified, or if it's negative, the minimum value found in the image data is used instead. Valid for mapping mode: minmax. ⬇️
  • -max double — Available since version 1.4.9. Specify the maximum pixel value used for mapping the input data to 8-bit image values. If it's not specified, or if it's negative, the maximum value found in the image data is used instead. Valid for mapping mode: minmax. ⬆️
  • -gamma double — Available since version 1.4.9. Specify a gamma correction to apply 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 value you supply is the saturation value, meaning all input values greater than the saturation value get mapped to white. If it's not specified, or if it's negative, saturation is not used. Valid for mapping mode: agc. 🤍
  • -cutoff double — Available since version 1.4.9. The value you supply is the cut-off value in percent. The cut-off value says how many pixels from the lower and upper part of the histogram are not considered for mapping. This option is a lifesaver 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

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>

k bye bestie, that's the whole page — img-flir, version 2.1, straight outta the Img manual (3tk). go read some thermal pics, you absolute icon 🫶📸💖

📦 where this page comes from