QMedia Text media commands |

### QM_SetTextMediaBox

QM_SetTextMediaBox(movieRef; trackID; boxLeft; boxTop; boxRight; boxBottom):error
| movieRef | Longint | Movie reference
| trackID | Longint | Track ID
| boxLeft | Longint | Text box left
| boxTop | Longint | Text box top
| boxRight | Longint | Text box right
| boxBottom | Longint | Text box bottom
| error | Longint | Error result

Changes the text box that is used when adding samples to a text track. The text box is the rectangle within the track's bounds where text is drawn.

Parameter movieRef is the reference to the movie instance. The movie reference must have been previously obtained with a call to QM_NewMovieFromFile.

Parameter trackID is the ID of the track.

Parameters boxLeft, boxTop, boxRight and boxBottom specify the text box coordinates in the track's coordinate system. If all parameters are set to -1, the text box is specified by the track's bounds.

QMedia sets the default text box coordinates to {-1, -1, -1, -1}.

Example

``Set the text box for track ID $trackID to cover the whole track` `` `$err:=QM_SetTextMediaBox ($movie;$trackID;-1;-1;-1;-1)` ``

Related commands

QM_GetTextMediaBox | Returns the text box of new text samples.

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