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