Command
QisLib_SetOutputLayerMap

Purpose


Function:
	int QisLib_SetOutputLayerMap(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 saving 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_SetOutputLayerMap can be used effectively to merge entities having different
	layer, datatypes to be on the same layer.
	- QisLib_SetOutputLayerMap can also be used to filter out entities on certain layers
	and datatypes.
	- QisLib_SetOutputLayerMap is called before QisLib_SaveGDSII, QisLib_SaveOASIS,
	QisLib_SaveGDSIIStructure, QisLib_SaveOASISStructure.
	- 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_SaveGDSII, QisLib_SaveOASIS,
	QisLib_SaveGDSIIStructure, QisLib_SaveOASISStructure.
	- To reset these settings or to not have any layer mapping, call this function with
	"Off" as argument.

Example:
	QisLib_SetOutputLayerMap("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 saved to the GDSII/OASIS file.
	- Layer number 2:3 will be saved as 10:3.
	- Layer 4 will be saved as layer 11
	- Layer 5 will be saved as layer 11
	- So all data on layer 4 and 5 will now appear on layer 11
	QisLib_SetOutputLayerMap("All-NULL");
	// This call will result in the following:
	- No layers will be saved to the GDSII/OASIS file.
	QisLib_SetOutputLayerMap("Off");
	// This call will turn off layer mapping.

References:
QisLib_SaveGDSII
QisLib_SaveOASIS
QisLib_SaveGDSIIStructure
QisLib_SaveOASISStructure