|
Command
Purpose
Function:
int QisLib_SetLayersFill(const char* OptionString);
Inputs:
OptionString: A string with the following format [Backus-Naur form]
< OptionString > : < LayerString > { "," < LayerString > }
< LayerString > : < Layer > { ":" < DataType > } "-" < Pattern >
< Layer > : A valid layer number.
< DataType > : A valid datatype number.
< Pattern > : A number from colfill.pat file specifying fill pattern.
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 pattern for the specified layer:datatype combinations.
- On Unix/Linux, this function does nothing if the 'DisplayHandle' parameter was set
to NULL in QisLib_InitLib.
- To get a list of patterns, view the colfill.pat file.
- If the datatype is absent, the pattern is set for all datatypes for that layer.
- By default, the fill pattern color is specified by colfill.pat file. This can be
overridden by QisLib_SetLayersFillColor call.
Example:
QisLib_SetLayersFill("1-83,2:3-85");
// Sets the fill pattern for all datatypes corresponding to layer
// 1 as pattern 83 from colfill.pat
// and sets the fill pattern for layer 2 datatype 3 as pattern
// 85 from colfill.pat.
References:QisLib_SetLayersFillColor QisLib_SetLayersOutlineColor |