=============================================================================
QuickTime for Java SDK                              Updated: 30 November 1998

Read Me Notes to "Keyboard Controller" Demo and Sample Code

=============================================================================
This demo program shows how to customise user control of the playback of a movie that is a member of a Compositor using the Keyboard.

=============================================================================
The minimum runtime requirements for this Sample Code are:

- Common
	- Sun Compliant Java Runtime Environment 1.1
	- QuickTime 3 
	- QTJava.zip

- MacOS:
	- System 8 or later
	- Macintosh Runtime for Java (MRJ) 2.1

- Mac OS X
	- 10.0 or later

- Windows 95, 98, NT, 2000 or XP.
	- JRE/JDK from Sun Microsystems, Inc. recommended

=============================================================================
Media requirements for this Sample Code are found in the media directory of the QTJava SDK:

(1) jumps.mov

=============================================================================
Notes & Comments

Adding a keyboard Listener to the movie allows it to be controlled via the Keyboard  (once that component has the focus). The key events are received by the KeyController.

The movie is added to the Compositor using the MoviePresenter and a one to one relationship between the key controller and the movie is established in the construction of the controller

Once the controller is added to the Compositor its interest in key events will be available (through the Compositor calling the addedTo method on the Controller). It gets this addedTo / removedFrom messages from the Compositor because it implements the ListenerController and the SimpleSpace super class of the Compositor knows how to deal with controllers of this ilk.

=============================================================================
General Comments

- QTSession.open and close:

A QTSession.open will perform a gestalt check to ensure that QuickTime is present and is initialized. This is a required call before any QuickTime Java classes can be used.

When the user closes the window the program will quit, first calling QTSession.close to terminate QuickTime. It is necessary for programs to call QTSession.close if they have previously called QTSession.open in order to shut down QuickTime properly.


=============================================================================

QuickTime and QuickTime for Java are trademarks of Apple Computer, Inc.
(c) 1998 Apple Computer Inc. All rights reserved.
