
README for QuickTimeTcl 3.1

QuickTimeTcl is an extension to Tcl/Tk on Mac OS X and Windows that provides 
many bindings to QuickTime from Tcl/Tk. Starting with this release, support 
for Mac OS Classic has been abandoned. 
 
Documentation:

For more documentation, see the manual pages in the 'docs' folder. These 
contain the latest information. There are also some simple tcl example code 
in the 'ExampleCode' folder that can be helpful; just source them in.

Requirements:

Tcl/Tk 8.4 (8.4.4 on Mac OS X) and QuickTime 5 or higher.

Testing:

The current version of QuickTimeTcl is developed and tested on Mac OS X 10.2 
and Windows 2000 using Tcl/Tk 8.4. 

QuickTime:

Download QuickTime from "http://www.apple.com/quicktime/download", or get a 
standalone installer from (good for switching between versions or if you are 
behind a firewall) "http://www.apple.com/quicktime/download/support". 
You don't need the pay (Pro) version. Not even I have it and that works fine anyway. 
Many things, altough not all, you pay for can be reproduced by some coding using 
this package :-)
    
Installing:

Just run the installer on the respective platform, or:
    
Mac OS X: Make a folder QuickTimeTcl3.1 with the QuickTimeTcl.dylib and pkgIndex.tcl 
files inside, and put this folder either in /Library/Tcl/ or ~/Library/Tcl/.

Windows: put the QuickTimeTcl directory inside the lib directory of the Tcl directory, 
as:
    
	Program
	    ...
	    Tcl
		bin
		doc
		include
		lib
		    ...
		    QuickTimeTcl
			QuickTimeTcl.dll
			pkgIndex.tcl
		    ...


WebCams on Windows:

On Windows, the 'vdig' (video digitizer) component which should be the hardware 
manufacturers responsibilty is sadly lacking on most WebCams. The grabber is 
therefore only tested with an emulated 'vdig' component WinVdig from www.vdig.com (.org). 
If you never got a QuickTime 'vdig' component with your PC camera, try WinVdig. 
Note, however, that this is only a second best solution.                 
   
Compiling:
 
Mac OS X:

Use 'pbxbild clean install' in the directory of the ProjectBuilder file.

Win32:

If you compile under windows the 'Cursor' symbol in 'X.h' need to be redefined 
as 'XCursor', just as what is done on the Mac.         
    
BUGS:   

If you want to see some printouts of what is happening inside QuickTimeTcl, use the 
command 'quicktimetcl::debuglevel 3'.
    
-   There are some tuning to be done to get maximal performance for QTVR panoramas; 
    the cursor flashes which is perhaps the cause.
		    
-   (Windows) -resizable not working.

-  The effect command not implemented yet for Mac OS X.
	    

LICENSE:
	  
This software is distributed under the BSD license. c.f. 
http://www.opensource.org/licenses/bsd-license 
    

Acknowledgements:   
Bruce O'Neel made the original version of QuickTimeTcl; 
The Windows port contains some tiny code fragments from Steve Aronson.

Enjoy,  Mats Bengtsson

matben@privat.utfors.se

Hamngatan 21
SE-582 26  Linkoping
Sweden

  1998 Bruce O'Neel,  2000-2003 Mats Bengtsson
  
