map::display(3tk)

💖 map::display — Map Display Support 💖

okay bestie, welcome to map::display(3tk), part of the tklib fam, and it is exactly what it sounds like: a whole widget for showing maps. it's giving main character energy for anyone building Tk apps with tiles. 🌍✨

---

✨ NAME ✨

map::display — the Map Display Widget. that's it, that's the name, iconic.

---

🎀 SYNOPSIS 🎀

so first you gotta require everything, no skipping, the dependencies are the vibe:

package require Tcl 8.6-

package require Tk 8.6-

package require canvas::sqmap

package require canvas::zoom

package require crosshair

package require debug

package require debug::caller

package require snit

package require widget::scrolledwindow

package require map::display ?0.1?

see that ?0.1? at the end? that's the optional version, bestie. it's optional. don't come for me. 💅

---

🦋 DESCRIPTION 🦋

okay so here's the tea: this package hands you a map display widget with the basic behaviours already baked in — we're talking Drag, Center, and Zoom +/-. the essentials. the starter pack. the holy trinity if you will. 🫶

and where do the map tiles come from? a configurable provider, duh. think map::provider::osm or literally anything that's API compatible with it. plug and play, no cap. 🌈

and THEN — and this is the part that ate — the widget is extensible. you can attach engines to it that bring extra behaviours to the party, like:

• displaying geo/* resources 👀
• editing geo/* resources ✏️
• and whatever other engine magic you feel like attaching

it's modular, it's cute, it's lowkey a whole ecosystem. obsessed. 💖

---

💅 API 💅

heads up bestie: the original page has this heading but there's literally nothing under it. nothing. empty. a whole vibe with no content. so this is me faithfully telling you: there's no API docs here. not my fault, I'm just the messenger. 🙈

---

🌸 EXAMPLE 🌸

another one: this section exists on the page, but there's no example in it. an empty example section is highkey the funniest thing a manpage can do, and I respect it. keeping it real. 💀

---

😭 BUGS, IDEAS, FEEDBACK 😭

okay so real talk, and I'm gonna say this with love: this document, AND the package it describes, will undoubtedly contain bugs and other problems. like, the original literally says that. it's not even being shady, it's just being honest. fr fr. 💀

so if you find something busted, please report it! and here's exactly how:

• report bugs in the category map of the Tklib Trackers at http://core.tcl.tk/tklib/reportlist
• and ALSO — yes, also — report any ideas for enhancements you might have, for either the package and/or the documentation

that's right, they want your ideas too. they're asking. don't be shy, bestie, send it. 🫶✨

---

⭐ KEYWORDS ⭐

display, map, map, map display

(yes map is in there twice. no I will not be removing it. the original said it twice and I am nothing if not faithful. 😤)

---

👑 CATEGORY 👑

Map Display and Supporting Utilities

like, the category is literally "Map Display and Supporting Utilities". it knows what it is. it's not confused. queen behaviour. 💜

---

and that's the whole page, bestie!! this little doc shipped as part of tklib, version 0.1, filed under map::display(3tk) — so go forth, drag your maps around, center them, zoom in and out, and attach engines like the absolute icon you are. 🎀✨🦋 bye diva!! 💖