QMedia 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.

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