Command
QisLib_SetLayersOutlineColor

Purpose


Function:
	int QisLib_SetLayersOutlineColor(const char* OptionString);

Inputs:
	OptionString: A string with the following format [Backus-Naur form]
	< OptionString >: < LayerString > { "," < LayerString > }
	< LayerString > : < Layer > { ":" < DataType > } "-" < Color >
	< Layer > : A valid layer number. (Refer to Support & Compliance)
	< DataType > : A valid datatype number. (Refer to Support & Compliance)
	< Color > : < IndexColor > | < RGBColor >
	< IndexColor > : Any number from 0 to 7 (see Description below).
	< RGBColor > : < R > " " < G > " " < B >
	< R >, < G >, < B > : Numbers from 0 to 65535 representing RGB color components.

Return:
	success: 0
	failure: one of the following values :

Errors:
	1: 'DisplayHandle' parameter of QisLib_InitLib is NULL, operation not permitted.
	-1: QisLib has not been initialized.
	-2: The specified input is invalid (null) .
	-3: One of more arguments are invalid.
	-4: Error occurred while allocating specified color .
	-5: Error occurred while saving color to the map file.
	-6: File open in progress, operation not permitted.

Description:
	- Sets the outline color for the specified layer:datatype combinations.
	- On Unix/Linux, this function does nothing if the 'DisplayHandle' parameter was set
	to NULL in QisLib_InitLib.
	- It can be a fixed color (0-7) or RGB color (R,G,B from 0 to 65535).
	- If the datatype is absent, the color is set for all datatypes for that layer.
	- Fixed Color values: 0(Background) 1(Foreground) 2(Red) 3(Green) 4(Yellow) 5(Blue)
	6(Magenta) 7(Cyan).
	- Qislib will match the RGB color to the nearest color supported by the hardware.

Examples:
	QisLib_SetLayersOutlineColor("1-5,2:3-7,3-60000 50000 40000, 4:3-50000 50000 50000");
	// Sets the outline colors for all datatypes of layer 1 as Blue,
	// for layer 2:3 as Cyan,
	// all datatypes of layer 3 as RGB color (60000 50000 40000),
	// 4:3 as RGB color 50000 50000 50000

References:
QisLib_SetLayersOutlineType
QisLib_SetOutline