Syntax
[C/C++:]
void gOpenSeg(int nseg);
[F90:]
subroutine gOpenSeg(nseg)
integer, intent(in) :: nseg
Arguments
nseg
Picture segment number
|
> 0, |
Open picture segment nseg |
|
= 0, |
Open (or add to) picture segment 0 |
Description
The routine gOpenSeg() starts a new picture segment.
It must be executed before a picture segment is started. If the user does not call gOpenSeg(), an internal call to gExtendSeg(0) will be made by GINO.
If gOpenSeg() is called from within a picture segment, the current segment is automatically closed and a new one is opened.
On a device with segment facilities,
nseg is the number of the picture segment to be opened. If a picture segment with this number (nseg>0) already exists, the old one is deleted and the new one displayed as it is being created.
Segment handling is enabled if the device has the necessary facilities, or if software emulation has been switched on using gSetSegMode(). If neither of these situations exist, software emulation of segments will automatically be switched on at the first call to gOpenSeg() and a warning message generated to encourage the setting of the correct segment mode.
The maximum limit for a segment number, when using the software emulation of segments, is the largest integer that can be stored, but the limit for hardware segment numbers is device specific and users should refer to Appendix B or use gEnqDeviceState() to enquire the current limit.
If
nseg = 0, then picture segment 0 is extended. This is the default and is treated as a dustbin segment by GINO.
See Also
gOpenSeg UsagegCloseSeggEnqDeviceStategExtendSeggSetSegModeAppendix B
