Text media commands
|
QMedia
Text media commands
|
|
| 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. |