QMedia Text media commands


QM_SetTextMediaColors(movieRef; trackID; textColor; backColor; hiliteColor):error
movieRef Longint Movie reference
trackID Longint Track ID
textColor Longint Text RGB color
backColor Longint Background RGB color
hiliteColor Longint Highlight RGB color
error Longint Error result

Changes the RGB colors that are used when adding samples to a text track.

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 textColor and backColor specify the text and background RGB colors respectively.

Parameter hiliteColor specifies the color used for highlighting text.

All color parameters must be expressed as longints, using 4Dv6's RGB color notation format (0x00RRGGBB - see the SET RGB COLOR 4D command). 4D's RGB color constants can also be used.

The hiliteColor parameter also accepts the qm_SystemHiliteColor constant (-254), which is equivalent to the system's current highlight color.

QMedia sets the default text media colors to the following values:

Text color:0x00000000 (Black)
Background color:0x00FFFFFF (White)
Highlight color:-254 (System highlight color)


  `Set text media colors for track ID $trackID
$txColor:=0x00FF0000 `Red
$bgColor:=0x00FFFFFF `White
$hlColor:=qm_SystemHiliteColor `System highlight color
$err:=QM_SetTextMediaColors ($movie;$trackID;$txColor;$bgColor;$hlColor)

Related commands

QM_GetTextMediaColors Returns the colors of new text samples.

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