QM_SetTextMediaColors

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)

Example

`Set text media colors for track ID $trackID

C_LONGINT($txColor;$bgColor;$hlColor)

$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.