|
Command
Purpose
Function:
int QisLib_SetLayersFillColor(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.
< DataType > : A valid datatype number.
< 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 is 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 fill 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.
- This color will override the fill pattern color specified in colfill.pat for the
corresponding layer:datatype
Example:
QisLib_SetLayersFillColor("1-5,2:3-7,3-60000 50000 40000, 4:3-50000 50000 50000");
// Sets the fill colors for all datatypes of layer 1 as Blue,
// for layer 2:3 as Cyan,
// for all datatypes of 3 as RGB color (60000 50000 40000),
// for layer 4:3 as RGB color 50000 50000 50000
|