Syntax

[C/C++:]
void gDefineSegGroup(int ngrp, int ngmin, int ngmax);

[F90:]
subroutine gDefineSegGroup(ngrp, ngmin, ngmax)
integer, intent(in) :: ngrp,ngmin,ngmax

Arguments

ngrp
Segment group number

ngmin
Start segment number

ngmax
End segment number

Description

The routine gDefineSegGroup() defines a segment group. The segment group number ngrp must lie within the range defined by a call to gDefineGroupRange().

A segment group consists of all the picture segments that fall within the range, ngmin to ngmax, which is defined by the call to gDefineSegGroup(). If ngmin or ngmax is out of range or if ngmin exceeds ngmax, an error message is output and no further action is taken.

Once a segment group has been created, any segment manipulation carried out on the group number will operate on all the existing segments in that group in numerical order.

Segment groups are maintained across device nomination. Up to 50 segment groups may be defined. gDefineSegGroup() redefines a segment group corresponding to ngrp that already exists. If there is no more space in the segment group table, an error message is output and no further action is taken.

See Also

gDefineSegGroup Usage
gDefineGroupRange

---