QMedia Movie data exchange commands |

### QM_ConvertFileToMovieFile

QM_ConvertFileToMovieFile(inputFile; movieFile; cvtFlags; importerID):error
| inputFile | Text | Source file path
| movieFile | Text | Movie file path
| cvtFlags | Longint | Conversion flags
| importerID | Longint | Movie importer ID
| error | Longint | Error result

Converts a media file to a movie file.

Parameter inputFile is the full pathname to the input media file.

Parameter movieFile is the full pathname to the movie file to be created. The specified file may not already exist, but its containing folder path must be valid. If movieFile points to an existing file, the later is replaced by the new movie file.

If movieFile is empty, QMedia presents the standard file saving dialog where the user can select the location and type the name of the new movie file. If the user cancels the dialog, error qm_userCancelErr is returned, otherwise parameter movieFile receives the full pathname of the new movie file.

Parameter cvtFlags is an optional set of flags that specify options for the conversion operation. Currently, the only acceptable value is the qm_ShowSettingsDialog constant (1). If cvtFlags is set to qm_ShowSettingsDialog (1) and the movie importer that handles the specific conversion supports a settings dialog, the settings dialog is displayed during the conversion operation.

Parameter compID is optional. It can be set to the ID of a specific movie importer to handle the conversion operation. If compID is ommited or set to 0, QuickTime finds the proper movie importer.

To get information about the available movie importers, use the QM_GetMovieImporters and QM_GetMovieImporterInfo commands.

Related commands

QM_TestMovieFile | Tests if a file contains valid movie data.
QM_GetMovieImporters | Returns the IDs of all available movie importers.
QM_GetMovieImporterInfo | Returns information about a movie importer.
QM_ExportMovieToFile | Exports data from a movie to a media file.

QMedia © Escape OE
Generated by QDoc 2.8 on Thu, Nov 24, 2011 18:41:50