canvas::snap(n)

✨ canvas::snap(n) — the one where your canvas gets its pic taken 💅

okay bestie, so this is a page from the Variations on a canvas manual set, and it's about a lil package called canvas::snap — like, the name is literally the whole vibe, it snaps pics of canvases 📸

---

🎀 NAME 🎀

canvas::snap — take a snapshot of a canvas and get a Tk photo image back, no cap ✨

---

🦋 SYNOPSIS 🦋

package require Tcl  8.5

package require Tk  8.5

package require canvas::snap  ?1.0.1?

package require img::window

::canvas::snap pathName

so yeah, you gotta have Tcl 8.5 and Tk 8.5 in the building first, then pull in canvas::snap — the version is literally ?1.0.1? — and img::window too, she's required, don't skip her 🙈 then you're free to call ::canvas::snap pathName 💖

---

🌸 DESCRIPTION 🌸

k so this package gives you exactly one command, and that command takes snapshots of any canvas you point it at. arbitrary canvases!! all of them!! it's giving "universal camera" energy ⭐

---

👑 API 👑

💜 ::canvas::snap pathName

takes a snapshot of the canvas named pathName, and the result you get back is the name of a brand new Tk photo image that contains the snapshot. like, a whole fresh photo image, just for you 🫶

⚠️ okay this is the important part, listen up — this command has a side-effect. to avoid getting ugly white rectangles where other windows might overlap the canvas, it forces the toplevel window the canvas is in to the top of the stacking order. so yeah, your window is gonna jump to the front. that's just how she works, no cap 💀

---

🍓 BUGS, IDEAS, FEEDBACK 🍓

ngl, this document and the package it describes will undoubtedly contain bugs and other problems — the manpage literally says so, iconic honesty 😭

please report those in the category canvas of the Tklib Trackers at [http://core.tcl.tk/tklib/reportlist].

and please also report any ideas for enhancements you may have for either the package and/or the documentation — they want your ideas fr fr, don't be shy 🧚

---

🔥 KEYWORDS 🔥

canvas, image, photo, print screen, snapshot

---

🌈 COPYRIGHT 🌈

Copyright (c) 2004 George Petasis (http://wiki.tcl.tk/1404)
Copyright (c) 2010 Documentation, Andreas Kupries

---

so that's the whole page, bestie — go forth and screenshot your canvases 💅✨

tklib, version 1.0.1, canvas::snap(n) — mwah, bye, love u, go read the rest of the Variations on a canvas set 🎀🦋💜