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.