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

Read Me Notes to "Sound Record" Demo and Sample Code

=============================================================================
This code shows using the SequenceGrabber for simple audio recording

=============================================================================
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

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

=============================================================================
No media requirements for this Sample Code.
=============================================================================
Notes & Comments

Settings - allows the user to specify the source, compression and format for the recording

Record - create a file to save the recorded information in and start recording

Stop - stop recording and show window with movie in it

You need to dispose of your connection to the Audio Channel before playing back the recorded sound, (otherwise you won't hear your recorded sound). This is a limitation of the Windows sound architecture.

It is important that your code call setDataOutput() before any other sequence grabber call's e.g prepare(). Failure to do so will result in your program silently aborting.

You do not need to create a moviefile to save the recorded data as the sequence grabber will automatically create a movie file for you based on the file you set in the setDataOutput method.

It is important to note that the Java Garbage Collector may hold onto previously created files, and not
free them up when expected. The call QTUtils.reclaimMemory() in the SoundRecord.java code
signals the garbage collector to run, however this is not a guarantee that the GC will immediately be invoked.
The side affect of this behaviour is that you may occassionaly see a message that a file is use if you try to save a
recording the second time using the same filename.

=============================================================================
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.
