img-dted(n)

💖 img-dted(n) 💖

okay bestie, gather round, because today we're talking about img-dted — the Digital Terrain Elevation Data format (aka dted) handler for Img. no cap, it's giving "I read elevation data and turn it into something your eyeballs can vibe with" 🌄✨

---

✨ SYNOPSIS ✨

package require img::dted ?2.1?

that's it. that's the whole summoning ritual 🕯️

---

🌸 DESCRIPTION 🌸

so first things first, bestie:

package require img::dted

Like every single package in Img, this one is NOT out here inventing brand-new commands. it doesn't do that. instead it extends the existing Tk command image, so that Tk suddenly understands files containing raster images in the Digital Terrain Elevation Data format (dted). and more specifically? img::dted extends Tk's photo image type. that's the one. that's the target. 🎯

lowkey important: Tk's photo image type docs live at https://www.tcl.tk/man/tcl9.0/TkCmd/photo.html if you wanna go read up. iykyk 📖

The name of the new format handler is dted. This handler provides new additional configuration options. See section Options for more detailed explanations. 👀

All of the above means that in a call like image create photo ?name? ?options?:

1. Image data in dted format (options -data and -file) is detected automatically. it just KNOWS. main character energy fr fr. ✨
2. The format name dted 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 section Options. yes bestie, it's a list, it can hold multiple things, she's versatile like that 💅

⚠️ and this is the part everyone gets wrong: The package img::dted is not loaded when doing a package require Img. You have to load it explicitly via package require img::dted. no shortcuts, no "but I already required Img", nope. do it yourself. 🙈

---

🎀 NOTES 🎀

1. This format handler interprets DTED elevation files as grayscale images. so if you were expecting rainbow, sorry babe, it's greyscale hours 🌫️
2. This format handler only supports read functionality. read-only. no writing. she's a listener, not a talker. 🫶

---

💅 OPTIONS 💅

The handler provides the following options:

• -verbose bool — Available since version 1.4.0. If set to true, additional information about the read data is printed to stdout. Default is false. so basically it yaps about what it read. sometimes you want the yap. usually you don't. 🗣️✨
• -min short — Available since version 1.4.0. 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. she'll find the floor herself if you don't tell her where it is 🧚
• -max short — Available since version 1.4.0. Specify the maximum pixel value to be used for mapping the input data to 8-bit image values. Default is the maximum value found in the elevation data. If not specified or negative, the maximum value found in the image data. the ceiling situation, basically. and yes, the default is described against the elevation data while the negative/unspecified fallback says image data — that's exactly what the page says, i'm not touching it, that's just how it is 😭
• -gamma double — Available since version 1.4.0. Specify a gamma correction to be applied when mapping the input data to 8-bit image values. Default is 1.0. the glow-up filter for your elevation data ✨

---

👑 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

(and yes, img-dted is listed in its own SEE ALSO. iconic. self-love. we stan. 💖)

---

🦋 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>

---

okay that's the whole page, bestie!! 🌈 version 2.1, from the Img source, and this whole vibe was brought to you by the img-dted(n) manual page. go read some elevation data, stay grayscale, and remember: package require img::dted or it literally will not work. mwah 💋✨🎀