|
Command
Purpose
Function:
int QisLib_SetLayersOn(const char* LayerString);
Inputs:
LayerString: A string with the following format [Backus-Naur form]
< LayerString >: "All" | < LayerEntry > { "," < LayerEntry > }
< LayerEntry > : < Layer > { ":" < DataType > }
< Layer > : A valid layer number. (Refer to Support & Compliance section)
< DataType > : A valid datatype number. (Refer to Support & Compliance section)
Return:
success: 0
failure: one of the following values :
Errors:
-1: QisLib has not been initialized.
-2: The specified input is invalid (possibly null).
-3: The format of the input arguments is invalid.
-4: File open in progress, operation not permitted.
Description:
- Instructs the QisLib to turn on the specified layer:datatypes.
- If only the layer number is specified, all datatypes for that layer are turned on.
- All other layer:datatype combinations will be turned off. Hence, multiple calls to
this function is not cumulative.
- Invalid layer or datatypes numbers will be ignored.
Example:
QisLib_SetLayersOn("1,2:3");
// Turn on layer 1 and all datatypes
// for layer 1
// Turn on layer 2 datatype 3 only
// All other layer:datatype
// combinations are turned off
QisLib_SetLayersOn("All");
// Sets all layer:datatype
// combinations on.
References:QisLib_SetLayersOff QisLib_SetInputLayerMap Support And Compliance |