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