Function Name: Get Number Of Paths To Transmittal Root

Definition

Determines how many different paths can be traversed from the Transmittal Root to the given object, where a path is defined as a bidirectional aggregate to component relationship. Feature Nodes / Geometry Nodes and Feature Edges / Geometry Edges are handled differently. For these objects, the number of paths is derived from specific DRM relationships.

If object_in, or any of the objects between it and its Transmittal Root, are referenced as a component from another transmittal and that transmittal is open, then the paths counted are those to the other transmittal's Transmittal Root. Otherwise, the paths are to the Transmittal Root within object_in's own transmittal.

To get the number of paths for

1. a Feature Edge
   • We retrieve its Bordered Feature Face component, if it exists.
   • We then retrieve the Feature Faces to which the Bordered Feature Face associates.
   • For each Feature Face, we compute the number of paths from that Feature Face to the Transmittal Root.
   • The total number of paths for all the Feature Faces is the number of paths of the Feature Edge.

2. a Geometry Edge
   • We retrieve its Bordered Geometry Face component, if it exists.
   • We then retrieve the Geometry Faces to which the Bordered Geometry Face associates.
   • For each Geometry Face, we compute the number of paths from that Geometry Face to the Transmittal Root.
   • The total number of paths for all the Geometry Faces is the number of paths of the Geometry Edge.

3. a Feature Node
   • We count the number of times the Feature Node is used as a component of other objects through 1-way aggregations.

4. a Geometry Node
   • We count the number of times the Geometry Node is used as a component of other objects through 1-way aggregations.

Returns

SE_NULL_REQUIRED_PARAMETER - if number_of_paths_out_ptr is NULL. In this case, *number_of_paths_out_ptr is set to 0.

SE_INVALID_OR_NULL_OBJECT - if object_in is not a handle to a valid SEDRIS object. In this case, *number_of_paths_out_ptr is set to 0.

SE_UNRESOLVED_START_OBJECT - if object_in is unresolved. In this case, *number_of_paths_out_ptr is set to 0.

SE_FAILURE - and *number_of_paths_out_ptr is set to 0, if the API implementation specified does not provide this function in its shared library, and dynamic binding is specified at compile time.

Prototype

Parameters Notes

object_in

 a SEDRIS object.

number_of_paths_out_ptr

 a pointer to an SE_UINT32 variable in the user's
    memory space where the number of paths will be stored.