QMediaLight Movie file commands

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_ConvertFileToMovieFile Converts a media file to a movie file.

QMediaLight © Escape OE
Generated by QDoc 2.8 on Thu, Oct 8, 2009 18:08:46