| 1 | |
| 2 | <html> |
| 3 | <head> |
| 4 | <meta name="description" content="Pmw - a toolkit for building high-level compound widgets in Python"> |
| 5 | <meta name="content" content="python, megawidget, mega widget, compound widget, gui, tkinter"> |
| 6 | <title>Getting started with Pmw</title> |
| 7 | </head> |
| 8 | |
| 9 | <body bgcolor="#ffffff" text="#000000" link="#0000ee" |
| 10 | vlink="551a8b" alink="ff0000"> |
| 11 | |
| 12 | <h1 ALIGN="CENTER">Getting started with Pmw</h1> |
| 13 | |
| 14 | <center><P ALIGN="CENTER"> |
| 15 | <IMG SRC = blue_line.gif ALT = "" WIDTH=320 HEIGHT=5> |
| 16 | </p></center> |
| 17 | |
| 18 | <dl> |
| 19 | <dt> <h2>Introduction</h2></dt><dd> |
| 20 | <p> |
| 21 | This document describes how to fetch and install Pmw, and how to run |
| 22 | the demonstrations and tests. |
| 23 | |
| 24 | </p> |
| 25 | |
| 26 | </dd> |
| 27 | <dt> <h2>Requirements</h2></dt><dd> |
| 28 | <p> |
| 29 | Pmw.1.2 requires the _tkinter and Tkinter modules. It works |
| 30 | with python versions 1.5.2 and greater (tested up to 2.2.1) and Tk |
| 31 | versions 8.0 and greater (tested up to 8.3.2). |
| 32 | |
| 33 | </p> |
| 34 | |
| 35 | <p> |
| 36 | If the BLT extension to Tk is present, Pmw will use the BLT busy |
| 37 | command during modal dialogs to display a clock cursor. Also, the |
| 38 | Pmw.Blt interface to the BLT busy, graph, stripchart, tabset and |
| 39 | vector commands will be available. BLT versions 2.4i and greater are |
| 40 | supported (tested up to 2.4u). You can find BLT at |
| 41 | <a href="http://www.tcltk.com/blt/">http://www.tcltk.com/blt/</a>. |
| 42 | |
| 43 | </p> |
| 44 | |
| 45 | </dd> |
| 46 | <dt> <h2>Distribution and installation</h2></dt><dd> |
| 47 | <p> |
| 48 | Releases of the Pmw distribution are available via http from |
| 49 | <code>http://download.sourceforge.net/pmw/</code>. This release is available |
| 50 | as <a href="http://download.sourceforge.net/pmw/Pmw.1.2.tar.gz"> |
| 51 | <code>Pmw.1.2.tar.gz</code></a>, released on 5 August 2003. |
| 52 | This is a compressed tar file. Under Linux, Unix, etc, you will need to |
| 53 | unpack it using <code>tar</code> and you may also need to use |
| 54 | <code>gzip</code> or <code>gunzip</code> to uncompress it. |
| 55 | Under Microsoft Windows, you will need a program such as WinZip (<a |
| 56 | href="http://www.winzip.com">http://www.winzip.com</a>) that can |
| 57 | unpack the gzipped tar files. You may need to change the suffix of |
| 58 | the file to <strong>.tgz</strong> for WinZip to recognise it. |
| 59 | |
| 60 | </p> |
| 61 | |
| 62 | <p> |
| 63 | |
| 64 | This will unpack into a directory named Pmw. You now need to put this |
| 65 | directory somewhere python can find it, preferably in one of the |
| 66 | standard places, such as in the <code>site-packages</code> directory |
| 67 | (eg: <code>/usr/lib/python2.2/site-packages/Pmw</code>) or the |
| 68 | <code>sys.prefix</code> directory (eg: <code>C:\Program |
| 69 | Files\Python\Pmw</code> or <code>/usr/lib/python2.2</code>). |
| 70 | |
| 71 | </p> |
| 72 | |
| 73 | <p> |
| 74 | |
| 75 | For example, under Unix, assuming you have placed the tar file in the |
| 76 | <code>/tmp</code> directory, you can simply run the following |
| 77 | commands: |
| 78 | |
| 79 | </p> |
| 80 | |
| 81 | <dl> |
| 82 | <dd> |
| 83 | <pre> |
| 84 | cd /usr/lib/python2.2/site-packages |
| 85 | gunzip /tmp/Pmw.1.2.tar.gz (or gzip -d /tmp/Pmw.1.2.tar.gz) |
| 86 | tar xvf /tmp/Pmw.1.2.tar |
| 87 | </pre> |
| 88 | </dd> |
| 89 | </dl> |
| 90 | |
| 91 | <p> |
| 92 | |
| 93 | If you do not have write permission for these standard directories, |
| 94 | place the Pmw |
| 95 | directory somewhere on your <code>PYTHONPATH</code> or |
| 96 | <code>sys.path</code>. If this is not possible, place the Pmw |
| 97 | directory somewhere else and add the parent directory to your |
| 98 | <code>PYTHONPATH</code> or <code>sys.path</code>. |
| 99 | |
| 100 | </p> |
| 101 | |
| 102 | <p> |
| 103 | |
| 104 | If you have previously installed Pmw version 0.6 or later, then the |
| 105 | new version can share the same <code>Pmw</code> directory as the |
| 106 | previous versions. You will need to perform the <code>tar</code> |
| 107 | extraction in the directory containing (that is, the parent directory |
| 108 | of) the existing <code>Pmw</code> directory. By default, your |
| 109 | applications will use the most recent version of Pmw. If required, |
| 110 | the function <code>Pmw.setversion()</code> can be used to specify a |
| 111 | version to be used. See the reference manual for details. If you are |
| 112 | no longer using the older versions, you can safely remove the |
| 113 | corresponding subdirectories from the <code>Pmw</code> directory. |
| 114 | |
| 115 | </p> |
| 116 | |
| 117 | <p> |
| 118 | |
| 119 | If you need assistance in installing BLT under Unix, please contact me |
| 120 | (<a href="mailto:gregm@iname.com"><i>gregm@iname.com</i></a>) and I |
| 121 | will try to help. For other operating systems, such as Microsoft or |
| 122 | Macintosh, you should try asking the python newsgroup. If anyone can |
| 123 | give me a description of how to install BLT under other operating |
| 124 | systems please contribute it and I will place it here. |
| 125 | |
| 126 | </p> |
| 127 | |
| 128 | </dd> |
| 129 | <dt> <h2>Documentation</h2></dt><dd> |
| 130 | <p> |
| 131 | The <code>doc</code> directory for each Pmw version contains all the |
| 132 | documentation for that version of Pmw. See the local <a |
| 133 | href="index.html">home page</a> for a complete list of documents. The |
| 134 | files in this directory are also available from the <a |
| 135 | href="http://pmw.sourceforge.net/">official Pmw home page</a>. |
| 136 | |
| 137 | </p> |
| 138 | |
| 139 | <p> |
| 140 | An excellent tutorial and reference covering the Pmw interface to the |
| 141 | powerful Blt graph widget, "<a |
| 142 | href="http://www.ifi.uio.no/~hpl/Pmw.Blt/doc/">A User's Guide to |
| 143 |