QMediaLight Movie instance commands

QM_NewMovieFromURL

QM_NewMovieFromURL(movieRef; movieUrl):error
movieRef Longint Movie reference
movieUrl Text Movie URL
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 movieUrl is the fully qualified (including protocol) URL to the movie. If movieUrl is invalid, a network error is returned. If movieUrl is empty, QMedia presents the URL selection dialog where the user can type the URL. If the user cancels the dialog, error qm_userCancelErr is returned.

Example

  `Create a new movie reference from a url
 
C_TEXT($url)
$url:="rtsp://216.178.7.117/~irh/irh.mov"
 
C_LONGINT($movie;$err)
 
$err:=QM_NewMovieFromURL ($movie;$url)
 

Related commands

QM_NewMovieFromFile 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:06