QMedia Text media commands |

### QM_GetTextMediaBox

QM_GetTextMediaBox(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

Returns the text box currently 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 receive the coordinates of the text box in the track's coordinate system. If all parameters are equal 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

``Get the text box of track ID $trackID` `` `C_LONGINT($txLeft;$txTop;$txRight;$txBottom)` `` `$err:=QM_GetTextMediaBox ($movie;$trackID;txLeft;$txTop;$txRight;$txBottom)` ``

Related commands

QM_SetTextMediaBox | Changes the text box of new text samples.

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