Syntax

[C/C++:]
void gRenameSeg(int nseg, int newseg);

[F90:]
subroutine gRenameSeg(nseg, newseg)
integer, intent(in) :: nseg,newseg

Arguments

nseg
Picture segment number

newseg
New number to be given to picture segment nseg

Description

The routine gRenameSeg() is called to rename picture segment nseg as newseg. The result is a single segment with number newseg.

If nseg = newseg, no action is taken.

If newseg already exists, it is deleted.

When the software emulation of picture segments is used and nseg does not exist an error message is generated. When using this routine in the default hardware segmentation mode, gSetSegMode(GHARDWARE), no error message is generated. However, the device may output a local error message.

Some displays do not permit this segment operation on the currently opened segment.

See Also

gRenameSeg Usage
gSetSegMode

---