QM_NewMovieFromFile

QM_NewMovieFromFile(movieRef; filePath):error
	movieRef	Longint	Movie reference
	filePath	Text	Movie file pathname
	error	Longint	Error result

Creates a movie instance from a movie file and returns a reference to the instance.

The movie reference is returned in the movieRef parameter. Unless the movie instance is later assigned to a movie plug-in area, it must be freed (when no longer needed) with a call to the QM_FreeMovie command.

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

Example

`Create a new movie reference from a file

C_TEXT($path)
$path:="" `Display file selection dialog

C_LONGINT($movie;$err)

$err:=QM_NewMovieFromFile ($movie;$path)

Related commands

QM_NewMovieFromURL	Creates a movie instance from a movie file.
QM_FreeMovie	Frees a movie instance.