1 $Id$ 2 3 Installing Tix.py 4 ---------------- 5 6 0) To use Tix.py, you need Tcl/Tk (V8.3.3), Tix (V8.1.1) and Python (V2.1.1). 7 Tix.py has been written and tested on an Intel Pentium running RH Linux 5.2 8 and Mandrake Linux 7.0 and Windows with the above mentioned packages. 9 10 Older versions, e.g. Tix 4.1 and Tk 8.0, might also work. 11 12 There is nothing OS-specific in Tix.py itself so it should work on 13 any machine with Tix and Python installed. You can get Tcl and Tk 14 from http://dev.scriptics.com and Tix from http://tix.sourceforge.net. 15 16 1) Build and install Tcl/Tk 8.3. Build and install Tix 8.1. 17 Ensure that Tix is properly installed by running tixwish and executing 18 the demo programs. Under Unix, use the --enable-shared configure option 19 for all three. We recommend tcl8.3.3 for this release of Tix.py. 20 21 2a) If you have a distribution like ActiveState with a tcl subdirectory 22 of $PYTHONHOME, which contains the directories tcl8.3 and tk8.3, 23 make a directory tix8.1 as well. Recursively copy the files from 24 <tix>/library to $PYTHONHOME/lib/tix8.1, and copy the dynamic library 25 (tix8183.dll or libtix8.1.8.3.so) to the same place as the tcl dynamic 26 libraries ($PYTHONHOME/Dlls or lib/python-2.1/lib-dynload). In this 27 case you are all installed, and you can skip to the end. 28 29 2b) Modify Modules/Setup.dist and setup.py to change the version of the 30 tix library from tix4.1.8.0 to tix8.1.8.3 31 These modified files can be used for Tkinter with or without Tix. 32 33 3) The default is to build dynamically, and use the Tcl 'package require'. 34 To build statically, modify the Modules/Setup file to link in the Tix 35 library according to the comments in the file. On Linux this looks like: 36 37 # *** Always uncomment this (leave the leading underscore in!): 38 _tkinter _tkinter.c tkappinit.c -DWITH_APPINIT \ 39 # *** Uncomment and edit to reflect where your Tcl/Tk libraries are: 40 -L/usr/local/lib \ 41 # *** Uncomment and edit to reflect where your Tcl/Tk headers are: 42 -I/usr/local/include \ 43 # *** Uncomment and edit to reflect where your X11 header files are: 44 -I/usr/X11R6/include \ 45 # *** Or uncomment this for Solaris: 46 # -I/usr/openwin/include \ 47 # *** Uncomment and edit for BLT extension only: 48 # -DWITH_BLT -I/usr/local/blt/blt8.0-unoff/include -lBLT8.0 \ 49 # *** Uncomment and edit for PIL (TkImaging) extension only: 50 # (See http://www.pythonware.com/products/pil/ for more info) 51 # -DWITH_PIL -I../Extensions/Imaging/libImaging tkImaging.c \ 52 # *** Uncomment and edit for TOGL extension only: 53 # -DWITH_TOGL togl.c \ 54 # *** Uncomment and edit for Tix extension only: 55 -DWITH_TIX -ltix8.1.8.3 \ 56 # *** Uncomment and edit to reflect your Tcl/Tk versions: 57 -ltk8.3 -ltcl8.3 \ 58 # *** Uncomment and edit to reflect where your X11 libraries are: 59 -L/usr/X11R6/lib \ 60 # *** Or uncomment this for Solaris: 61 # -L/usr/openwin/lib \ 62 # *** Uncomment these for TOGL extension only: 63 # -lGL -lGLU -lXext -lXmu \ 64 # *** Uncomment for AIX: 65 # -lld \ 66 # *** Always uncomment this; X11 libraries to link with: 67 -lX11 68 69 4) Rebuild Python and reinstall. 70 71 You should now have a working Tix implementation in Python. To see if all 72 is as it should be, run the 'tixwidgets.py' script in the Demo/tix directory. 73 Under X windows, do 74 /usr/local/bin/python Demo/tix/tixwidgets.py 75 76 If this does not work, you may need to tell python where to find 77 the Tcl, Tk and Tix library files. This is done by setting the 78 TCL_LIBRARY, TK_LIBRARY and TIX_LIBRARY environment variables. Try this: 79 80 env TCL_LIBRARY=/usr/local/lib/tcl8.3 \ 81 TK_LIBRARY=/usr/local/lib/tk8.3 \ 82 TIX_LIBRARY=/usr/local/lib/tix8.1 \ 83 /usr/local/bin/python Demo/tix/tixwidgets.py 84 85 86 If you find any bugs or have suggestions for improvement, please report them 87 via http://tix.sourceforge.net 88 89 90
