QMedia Movie area geometry commands

QM_SetMovieRect

QM_SetMovieRect(areaRef; movieLeft; movieTop; movieRight; movieBottom):error
areaRef Longint Movie area reference
movieLeft Longint Movie left
movieTop Longint Movie top
movieRight Longint Movie right
movieBottom Longint Movie bottom
error Longint Error result

Changes the position and size of the movie in a movie plug-in area. The coordinates of movie's boundary rectangle are specified relative to the top-left corner of the plug-in area.

The movie plug-in area is specified by areaRef.

Parameters movieLeft, movieTop, movieRight and movieBottom are the coordinates of the movie's left, top, right and bottom edges respectively. All coordinates must be specified relative to the top-left corner of the plug-in area.

When calling this command, QuickTime may adjust the actual location and size of the movie. For example, if the movie has no visual characteristics (a sound movie), QuickTime sets the movie's bounding rectangle to empty (0, 0, 0, 0). In that case, parameters movieLeft, movieTop, movieRight and movieBottom also receive the actual coordinates of the movie's bounding rectangle.

Example

  `Set the bounds of the movie in plug-in area xMovieArea to {20, 20, 120, 120}
 
C_LONGINT($left;$top;$right;$bottom)
 
$left:=20
$top:=20
$right:=120
$bottom:=120
 
$error:=QM_SetMovieRect (xMovieArea;$left;$top;$right;$bottom)
 

Related commands

QM_GetMovieRect Returns the boundary rectangle of the movie in a movie plug-in area.
QM_SetControllerRect Changes the position and size of the movie controler in a movie plug-in area.
QM_GetControllerRect Returns the boundary rectangle of the movie controler in a movie plug-in area.

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