QM_TestMovieFile

QM_TestMovieFile(filePath; movieType; mustConvert):error
	filePath	Text	Test file path
	movieType	String4	Movie type
	mustConvert	Longint	Convert to movie flag
	error	Longint	Error result

Tests if a file contains valid movie data.

This command is useful in finding out if a file is a QuickTime movie, can be opened as a movie, or can be converted to a movie. QuickTime has extensive support for foreign (non movie) media file formats. Foreign media files can be opened in-place, or converted to movie files. For a list of supported media file formats, see the QM_GetMovieImporters and QM_GetMovieImporterInfo commands.

Parameter filePath is the full pathname to the file to be tested. If filePath is invalid, a file system error is returned. If filePath is empty, QMedia presents the standard file selection dialog where the user can preview and select a movie file. If the user selects a movie file, its full pathname is returned in filePath, otherwise error qm_userCancelErr is returned.

Parameter movieType receives a four character code that identifies the type of the movie file. If the file is a standard QuickTime movie, movieType is set to "MooV". If the file is a foreign media file that can be opened by QuickTime as a movie, movieType is set to the type of the movie importer that will be used to open the file. For graphic files supported by QuickTime (JPEG, TIFF, PICT, etc.), movieType is set to "grip". If the file cannot be handled by QuickTime, movieType is set to an empty string.

Parameter mustConvert receives a flag that indicates whether the specified file can be opened in-place, or must be first converted to a movie file. If mustConvert is set to 0, the file can be opened as a movie with the QM_NewMovieFromFile command. If mustConvert is set to 1, the file must be first converted to a movie file. The file convertion can be done with the QM_ConvertFileToMovieFile command.

Related commands

QM_NewMovieFromFile	Creates a movie instance from a movie file.
QM_GetMovieImporters	Returns the IDs of all available movie importers.
QM_GetMovieImporterInfo	Returns information about a movie importer.
QM_ConvertFileToMovieFile	Converts a media file to a movie file.