Introduction editPod is a new kind of toplevel widget. The Pod command can create new windows or it can also transform existing toplevel-windows.
Anatomy of a Pod widgetHere is a sample from a real application:Another picture showing how to adapt an existing application : Kandinsky dance
How to Use the Package editBasically, in order to create a Pod-window you only need to add 2 lines:
package require Pod Pod .myPodor, you can transform an existing toplevel in a Pod-window
Pod adapt .topWinThere are few other command you can use for customizing the Pod (read below).
# change the look .myPod configure -background blue # disable the interactive resizability .myPod configure -resizable falseFor full details, read the "Pod Reference"  within the doc directory.
Platform Compatibility editPod is pure-Tcl code but it is based on some wm sub-commands unfortunately supported only on Windows and Mac. In particular, the following command are not well supported on Unix:
- wm overrideredirect $win
- wm attributes $win -transparentcolor $color (*New in TclTk 8.4.15*)
- wm attributes $win -alpha $val
AMG: What are the speckles visible in the lower-right corner of the screenshots? Are they resizing grab handles?ABU: Correct ! You can enable/disable these grab handles
$w configure -resizable falseAnyway, even if interactive-resizing is disabled, you can always resize the Pod by program:
wm geometry $w 250x200
More about Platform Compatibility editWindows
- 100% - Note that the minimal required version is 8.4.15 (it is the first supporting the "wm attributes $w -transparentcolor $color" command).
- Version 1.2 is 99.9% identical to the Windows version. The only difference is an annoying flickering when large Pod-widgets are being resized.
- Rounded corners are not drawn properly. Toplevel transparency is not supported.
- About the wm overrideredirect ... command, there are some troubles ...similar to those found on Mac.
MHo: On my WinXP, after minimizing and then maximizing again, the window is not in the foreground (Z-order changed). Trouble activating widgets are not uncommon on windows, I think - I always use focus -force. The Snit package is required.
LV Another use of the term pod comes from the perl community and stands for plain old doc, a simple code markup language designed to be used for embedding documentation within code. It is a bit more complex than this wiki's markup, but perhaps a bit simpler than doctools. The relevancy for this wiki is that I have seen, over the years, requests from developers for some kind of tcl documentation scheme that was as easy to use as pod.And a derivation of the term pod is of course Apple's iPod. Some people may stop by this page looking for software that interacts with an iPod - this isn't that sort of software.
[braindust] - 2010-04-23 10:24:49Thank You Aldo Buratti for the nice work! ver. 1.2 download link seems not to be available anymore :-( Has anybody a working link? Thanks!AEC I just added a copy of pod to the half bakery. You may retrieve it from there.ABU 21-apr 2012 - Link for Pod 1.2 restored[braindust] Thank You! I really appreciate that.