QMediaLight Movie area commands

QM_SetAreaMovie

QM_SetAreaMovie(areaRef; movieRef):error
areaRef Longint Movie area reference
movieRef Longint Movie reference
error Longint Error result

Assigns a movie instance to a movie plug-in area. QMedia creates a movie controller for the assigned movie.

The movie plug-in area is specified by the areaRef parameter.

Parameter movieRef is a reference to a movie instance. A movie instance is created with a call to QM_NewMovieFromFile or QM_NewMovieFromURL. Any movie instance previously assigned to the area is freed. If movieRef is 0, the area is cleared.

If the command completes successfully, the result is set to zero (qm_noErr), otherwise an non-zero error code is returned.

Example

  `Assign movie $movie to plug-in area xMovieArea
 
$error:=QM_SetAreaMovie (xMovieArea;$movie)
 

Related commands

QM_GetAreaMovie Returns the movie currently assigned to a movie plug-in area.

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