QMediaLight Movie instance commands

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.

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