Handlers - eqtVersion(), qtCanOpenFile(), qtClearMovieControllers, qtGetMaxLoadedTimeInMovie(), qtGetMovieFileDimensions(), qtGetMovieFileDuration(), qtGetMovieFileType(), qtGetMovieLoadState(), qtInitialize, qtIsMovieDownloadingProgressively(), qtRegisterMovieControllers, qtTerminate

function eqtVersion ()
Description:
Returns the version of the external.
Return:
Version (i.e. 1.0.0.0)
function qtCanOpenFile (Filepath, QuickSearch, OnlyMovies, BeAggressive)
Description:
Checks if a file can be opened by QuickTime. Even if QuickSearch is set to "false" some files can still trick QuickTime. For example, there are mpg files that QuickTime cannot open (WMP on Windows can but WMP on Mac can't - very unfortunate). QuickTime sees that they are mpg files and happily reports that it can open them. But when the moment of truth arrives QuickTime will not rise to the occasion and after setting the fileName of the player object the result() function will contain "could not create movie reference". So be sure and check the result() after setting the fileName and act accordingly.
Parameters:
Filepath: Path to file to check.
QuickSearch: Set to false to search data to determine if QT can open file. Takes longer but more accurate. Default true.
OnlyMovies: Set to true to only return true if quicktime can open the file as a movie (ignores graphics). Default false.
BeAggressive: Set to true to treat files types like PICT and TEXT as able to be opened. Default false.
Return:
true|false
command qtClearMovieControllers ()
Description:
Clears all registered movie controllers.
Return:
empty
function qtGetMaxLoadedTimeInMovie (MovieControllerID)
Description:
Returns the download state of the movie controller.
Parameters:
MovieControllerID: movieControllerID.
Return:
Total movie downloaded in movie's time base.
function qtGetMovieFileDimensions (FilePath)
Description:
Returns the dimensions of a movie file on your hard drive (width,height).
Parameters:
FilePath: Path to movie file.
Return:
Movie Width, Movie Height
function qtGetMovieFileDuration (FilePath)
Description:
Returns the duration of a file on disk.
Parameters:
FilePath: Path to movie file.
Return:
Movie Duration, Movie TimeScale
function qtGetMovieFileType (FilePath)
Description:
Returns the type of a file on disk.
Parameters:
FilePath: Path to movie file.
Return:
Type (multiframe graphic, image, qtvr, flash, video, sound, unknown, unsupported)
function qtGetMovieLoadState (MovieControllerID)
Description:
Returns the download state of the movie controller.
This function lets your code perform relative comparisons against movie loading milestones to determine if certain operations make sense. Don't call more often then every quarter of a second. Its return values are ordered so that they conform to this rule:
kMovieLoadStateError
< kMovieLoadStateLoading
< kMovieLoadStatePlayable
< kMovieLoadStateComplete
Parameters:
MovieControllerID: movieControllerID.
Return:
Integer value:
-1 (kMovieLoadStateError)
1000 (kMovieLoadStateLoading)
10000 (kMovieLoadStatePlayable)
20000 (kMovieLoadStatePlayThroughOK)
100000 (kMovieLoadStateComplete)
command qtInitialize ()
Description:
Initializes the QT library. You need to call this on Windows if you plan to use EnhancedQT before you open a movie in a player object. There is no harm in calling it on Mac.
Return:
true or false.
function qtIsMovieDownloadingProgressively (MovieControllerID)
Description:
Returns true if the movie in the controller is being progressively downloaded.
Parameters:
MovieControllerID: Target movieControllerID.
Return:
Boolean
command qtRegisterMovieControllers (PlayerLongID...)
Description:
Takes a variable number of arguments (each the long id of a player object) and registers each player object with the external. You must follow these rules when using this handler:
  1. Call qtRegisterMovieControllers AFTER setting the filename of the player objects to a movie.
  2. Call qtClearMovieControllers BEFORE unloading the movies from the player objects (i.e. setting filename to another movie or deleting the player object). Revolution will crash otherwise.
Any player object registered with the external will have intermovie communication abilities and will also receive the following messages:
QTDebugStr pMsg
QTApplicationNumberAndString pNumber, pString
QTFSCommand pCommand, pArgument
QTStatusMsg pType, pMsg (pType can be "streaming","error" or "urllink")
QTMovieLoadState pState (see qtGetMovieLoadState documentation for possible values of pState)
QTHotSpotEnter pHotSpotID
QTHotSpotLeave pHotSpotID
Note: To load an unknown number of player objects using qtRegisterMovieControllers, do the following:
put the long id of player 1 & comma & the long id of player 2 into thePlayers
send "qtRegisterMovieControllers thePlayers" to me
Parameters:
PlayerLongID...: Long id of player to register.
Return:
empty
command qtTerminate ()
Description:
If you call qtInitialize on Windows, then call this before your application quits. There is no harm in calling it on Mac.
Return:
empty