1
2README for QuickTimeTcl 3.1
3
4QuickTimeTcl is an extension to Tcl/Tk on Mac OS X and Windows that provides 
5many bindings to QuickTime from Tcl/Tk. Starting with this release, support 
6for Mac OS Classic has been abandoned. 
7 
8Documentation:
9
10For more documentation, see the manual pages in the 'docs' folder. These 
11contain the latest information. There are also some simple tcl example code 
12in the 'ExampleCode' folder that can be helpful; just source them in.
13
14Requirements:
15
16Tcl/Tk 8.4 (8.4.4 on Mac OS X) and QuickTime 5 or higher.
17
18Testing:
19
20The current version of QuickTimeTcl is developed and tested on Mac OS X 10.2 
21and Windows 2000 using Tcl/Tk 8.4. 
22
23QuickTime:
24
25Download QuickTime from "http://www.apple.com/quicktime/download", or get a 
26standalone installer from (good for switching between versions or if you are 
27behind a firewall) "http://www.apple.com/quicktime/download/support". 
28You don't need the pay (Pro) version. Not even I have it and that works fine anyway. 
29Many things, altough not all, you pay for can be reproduced by some coding using 
30this package :-)
31    
32Installing:
33
34Just run the installer on the respective platform, or:
35    
36Mac OS X: Make a folder QuickTimeTcl3.1 with the QuickTimeTcl.dylib and pkgIndex.tcl 
37files inside, and put this folder either in /Library/Tcl/ or ~/Library/Tcl/.
38
39Windows: put the QuickTimeTcl directory inside the lib directory of the Tcl directory, 
40as:
41    
42	Program
43	    ...
44	    Tcl
45		bin
46		doc
47		include
48		lib
49		    ...
50		    QuickTimeTcl
51			QuickTimeTcl.dll
52			pkgIndex.tcl
53		    ...
54
55
56WebCams on Windows:
57
58On Windows, the 'vdig' (video digitizer) component which should be the hardware 
59manufacturers responsibilty is sadly lacking on most WebCams. The grabber is 
60therefore only tested with an emulated 'vdig' component WinVdig from www.vdig.com (.org). 
61If you never got a QuickTime 'vdig' component with your PC camera, try WinVdig. 
62Note, however, that this is only a second best solution.    
63
64Abstractplane (http://www.abstractplane.com) has an industrial-strength vdig 
65component for QuickTime on Windows which you can try.             
66   
67Compiling:
68
69You may need to copy the header file tkFont.h from the Tk sources to the typical place
70for Tcl include files.
71 
72Mac OS X:
73
74Use the Xcode project.
75
76Win32:
77
78If you compile under windows the 'Cursor' symbol in 'X.h' need to be redefined 
79as 'XCursor', just as what is done on the Mac.         
80It may also be necessary to comment out the enum MEDIA_TYPE in moviesformat.h.
81
82    
83BUGS:   
84
85If you want to see some printouts of what is happening inside QuickTimeTcl, use the 
86command 'quicktimetcl::debuglevel 3'.
87    
88-   There are some tuning to be done to get maximal performance for QTVR panoramas; 
89    the cursor flashes which is perhaps the cause.
90		    
91-   (Windows) -resizable not working.
92
93-  The effect command not implemented yet for Mac OS X.
94	    
95
96LICENSE:
97	  
98All software within the quicktimetcl repository is distributed under the BSD license.
99    
100
101Acknowledgements:   
102Bruce O'Neel made the original version of QuickTimeTcl; 
103The Windows port contains some tiny code fragments from Steve Aronson.
104
105Enjoy,  Mats Bengtsson
106
107matben@privat.utfors.se
108
109Hamngatan 21
110SE-582 26  Linkoping
111Sweden
112
113 � 1998 Bruce O'Neel, � 2000-2003 Mats Bengtsson
114  
115