QMediaLight Movie area geometry commands

QM_SetMoviePlacement

QM_SetMoviePlacement(areaRef; moviePlacement):error
areaRef Longint Movie area reference
moviePlacement Longint Movie placement
error Longint Error result

Controls the placement of a movie in a movie plug-in area.

The movie plug-in area is specified by areaRef.

The movie's placement is specified by the placement parameter. QMedia defines the following constants for the movie placement:

qm_ScaledToFitPropCentered 0 Center the movie in the area. If the movie is larger than the area, it is scaled down proportionally.
qm_ScaledToFitProportional 1 Place the movie on the top-left corner of the area. If the movie is larger than the area, it is scaled down proportionally.
qm_ScaledToFit 2 Resize the movie to fit the dimensions of the plug-in area.

When calculating the placement of a movie, QMedia takes into account the visibility of the movie controler and the movie frame. Thus, if you want to hide or show the controler or the movie frame, it is important to do so before calling QM_SetMoviePlacement. Otherwise, the movie and its controler will not be placed correctly in the area.

Example

  `Set the movie placement in plug-in area xMovieArea to "Scaled to fit"
 
$error:=QM_SetMoviePlacement (xMovieArea;qm_ScaledToFit)
 

Related commands

QM_GetMoviePlacement Returns the placement of a movie in a movie area.

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