Command
QisLib_GetStructureExtents

QisLib_GetStructureExtents


Function:
	int QisLib_GetStructureExtents(const char* StructName, CQisWindow* ExtentsBuffer);

Inputs:
	StructName: Name of the cell whose extents are required.
	ExtentsBuffer: Address of buffer for returning the cell extents.

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

Errors:
	-1: Input argument is invalid (null).
	-2: The cell does not exist.
	-3: Unable to obtain extents for the specified cell.
	-4: No GDSII or OASIS file has been opened.
	-5: File open in progress, operation not permitted.

Description:
	- Gets the data extents of the specified cell.

	- The extents are either in database units (DBU) or user units (UU) depending on the
	  QisLib_SetVectorUnit setting. (Default = UU)

	- Applying QisLib_SetTransformation on a specific cell also affects the extents
	  returned by QisLib_GetStructureExtents for that cell.

        - As of v2.81 the extents returned by this function reflects the presence/absence
          of layers loaded using the function QisLib_SetInputLayerMap

        - As of v2.81, If QisLib_SetIgnoreTexts function is used with _QIS_OFF to not 
          load text data, then the extents calculation will ignore text data

        - As of v2.81 the extents returned by this function takes into account the
          width and type of paths present along the cell boundary (bounding box)
          However, under certain rare cases when these paths are non-orthogonal, 
          the extents are approximated.

References:
CQisWindow
QisLib_SetVectorUnit
QisLib_SetTransformation
QisLib_SetIgnoreTexts
QisLib_SetInputLayerMap