NAME

DgCheck − Check for circularities within a group network

SYNOPSIS

C:

DtGroupNetworkStatus DgCheck(group)
DtObject group;

FORTRAN:

INTEGER∗4 DGCK(GROUP)
INTEGER∗4 GROUP

DESCRIPTION

DgCheck finds out if there are any circularities within the group network referenced by the root node, group.  Many execution methods (i.e., for rendering and picking) do not check for the existence of circularity within the group networks they execute and will develop fatal errors if such circularities are allowed to persist.  It is the user’s responsibility never to use circular group networks in Dor´
e.

The return value will be one of the following:

DcGroupOk <DCGOK>
The group is free of circularities.

DcGroupBad <DCGBAD>
The group has a non-recoverable circularity.

ERRORS

DgCheck will fail if the group handle is invalid. 

[WARNING - invalid group handle]

DgCheck will fail if an update is in progress. 

[WARNING - traversal in progress]

SEE ALSO

DgOpen(3D), DoGroup(3D), DoInLineGroup(3D)

September 02, 1992