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