Command
QisLib_SetInputLayerMap

Purpose

Function:
	int QisLib_SetInputLayerMap(const char* LayerString);

Inputs:
	LayerString: A string with the following format [Backus-Naur form]
	< LayerString > : "Off" | < Map > { "," < Map > }
	< Map > : < LayerIn > "-" < LayerOut >
	< LayerIn > : "All" | < LayerEntry >
	< LayerOut > : "NULL" | < LayerEntry >
	< LayerEntry > : < Layer > { ":" < DataType > }
	< Layer > : A valid layer number. (Refer to Support & Compliance)
	< DataType > : A valid datatype number. (Refer to Support & Compliance)

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

Errors:
	-1: QisLib has not been initialized.
	-2: The specified input string is invalid (null).
	-3: Internal memory error occurred. Some settings may not take effect.
	-4: File open in progress, operation not permitted.

Description:
	- This function informs QisLib to treat data on a particular layer: datatype as if
	they are on another layer:datatype while opening a GDSII/OASIS file.
	- The keyword "NULL" informs QisLib to ignore a particular layer:datatype as if not
	present. The keyword "All" refers to all layer:datatypes present in the GDSII/OASIS file.
	- QisLib_SetInputLayerMap can be used effectively to merge entities having different
	layer, datatypes to be on the same layer.
	- QisLib_SetInputLayerMap can also be used to filter out entities on certain layers
	and datatypes.
	- QisLib_SetInputLayerMap must be called before opening the file or else it will not
	have any effect.
	- Settings containing "All", override all previous settings.
	- The effect of multiple calls to this function is cumulative.
	- Unlike QisLib_SetLayersOn and QisLib_SetLayersOff, the settings made by this
	function are preserved for all QisLib_OpenGDSII, QisLib_OpenOASIS.
	- To reset these settings or to not have any layer mapping, call this function with
	"Off" as argument.

Example:
	QisLib_SetInputLayerMap("1-NULL,2:3-10:3,4-11,5-11");
	// This call will result in the following:
	- None of the data on layer 1 will be loaded when the
	GDSII/OASIS file is opened.
	- Layer 2:3 will be opened as 10:3
	- Layer 4 will be opened as layer 11
	- Layer 5 will be opened as layer 11
	- So all data on layer 4 and 5 will now appear on layer 11
	QisLib_SetInputLayerMap("All-NULL");
	// This call will result in the following:
	- No layers will be loaded when the GDSII/OASIS file is opened
	QisLib_SetInputLayerMap("Off");
	// This call will turn off layer mapping.