n
Number of real words reserved for use as a workspace area
= 0,
Workspace area is freed
n1,n2
Range of real words in global workspace area
= 0,
Workspace area is freed
Description
The routine gSetWorkspaceLimit() defines the size of GINO's workspace area. The size of the workspace area must be large enough to cope with the combined requirements of the workspaces that exist at any given time. Workspaces are required for storing polygons (see gDefinePolygonWorkspace()), for storing a list of polygon identifiers (see gSelectPolygons()) and for area-filling polygons (see gFillSelectedPolygons()). Additional space is also required if software emulation of picture segments is required and this is to be held in memory rather than in a scratch disk file (see gDefineSegWorkspace() and gSetSegMode()).
An existing workspace area may be enlarged by calling this routine a second or subsequent time each with a larger value of n or n2. A smaller value does not reduce the area.
The complete workspace area is removed (and all its contents lost) when gSetWorkspaceLimit() is called with all arguments = 0 and by gCloseGino(). However, any workspace defined with gSetWorkspaceLimit() and its contents is maintained across device nominations, and therefore does not need to be redefined for each device.