GINO Graphics Suite - GINO v9.0  

gDefineSegWorkspace

Syntax

[C/C++:]
void gDefineSegWorkspace(int nw);
[F90:]
subroutine gDefineSegWorkspace(nw)
integer, intent(in) :: nw

Arguments

nw
Number of real words to be set aside for storing Software Display Files

= 0, Delete software display file
>0, Create or change size of display file

Description

If the software emulation of segment facilities is required the user may opt to store this information either in a scratch file or in a workspace area.

The routine gDefineSegWorkspace() both creates a workspace within the gSetWorkspaceLimit() workspace and switches storage of segments to that workspace.

As the gDefineSegWorkspace() workspace is part of the gSetWorkspaceLimit() workspace, gSetWorkspaceLimit() must be called before gDefineSegWorkspace() and include at least as much space as required by gDefineSegWorkspace().

To change the size of the software display file gDefineSegWorkspace() may be called more than once. A call to gDefineSegWorkspace(0) deletes the display file and frees the space in the total workspace area. Any value less than zero will generate an error message.

The gDefineSegWorkspace() workspace is maintained across device nominations along with any segment information it may contain. This allows segments to be created on one device and used on any subsequent device within the same program.

See Also

gDefineSegWorkspace Usage
gSetWorkspaceLimit
gSetSegMode