=============================================================================
QuickTime for Java SDK                              Updated: 19 January 2001

Read Me Notes to "MovieTextFinder" Sample Code

=============================================================================
This sample code shows how to search movie text media for text strings. It is largely based on the QTTest sample code in the regular QuickTime SDK. The QTText sample is based on the code provided with the develop article QuickTime Text by Nick Thompson (issue 20). Make sure to read that article for complete details on the techniques employed in this sample.

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

The minimum runtime requirements for this Sample Code are:

- Common
	- Sun Compliant Java Runtime Environment 1.1
	- Sun Java Foundation Classes (JFC) Swing 1.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 same folder along with the application:

(1) TextOnly.mov - a text-only movie with a single text track

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

This sample demonstrates two different techniques for searching for text strings in movie text media - the quicktime.std.movies.searchText method, and the quicktime.std.movies.media.TextMediaHandler.findNextText method.

The quicktime.std.movies.searchText method simply requires you create a Movie object for the movie you would like to search. When you call the findTextInMovieTextTrack method in the sample code, the searchText method is called, using the Movie object you passed when you created an instance of the MovieTextFinder class.


The quicktime.std.movies.media.TextMediaHandler.findNextText method works differently. This method requires you create a TextMediaHandler object for the text media in your movie. When you call the findTextInMovieTextTrack method in the sample code, the first thing the code does is locate the first active text track in the movie. Next, a Media object for the text track is created, and a TextMediaHandler object is created from this Media object. Finally, the TextMediaHandler findNextText method is called to perform the text search.

Text searches using the above techniques can be made using a number of optional parameters. For example, a search can be designated as forward or backward from the current movie time. Also, wrap searches can be made, and searches can be case-sensitive.

=============================================================================
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) 2001 Apple Computer Inc. All rights reserved.
