Tutorial Toolkit Function Descriptions > Geometry > Curve/Surface Relation
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX''">   
Curve/Surface Relation
  
db_count_surfaces_for_edge
( id, count )
Description:
Counts all surfaces associated with a specified edge in the database.
Input:
INTEGER
id
The id of the edge to which the surfaces are associated.
Output:
 
 
INTEGER
count
The integer number of surfaces associated to the edge in the database.
INTEGER
<Return Value>
Integer indicating success or failure of the routine. If the routine failed, this value contains an indication of the reason.
Example:
See example for db_count_surface, 219. See also db_count_surfaces_for_edge (p. 538) in the MSC Acumen Toolkit - Code Example.
  
db_get_surfaces_for_edge
( edgid, count, srfid )
Description:
Finds the ids of all surfaces associated with a specified edge in the database.
Input:
INTEGER
edgid
Id of the edge to which the surfaces are associated.
INTEGER
count
The number of surfaces that the calling routine expects to receive from the database. This count should be the same as the number of surfaces to which the edge is associated as it should have been fetched from the database prior to making this call.
Output:
INTEGER
srfid()
Ids of the various surfaces associated with the specified edge.
Example:
See example for db_count_surface, 219. See also db_get_surfaces_for_edge (p. 576) in the MSC Acumen Toolkit - Code Example.
 
sgm_db_get_gen_face_edge_ids
( surfaceid, numberloops, numberedges, loopids, edgeids, edgeorients )
 
Description:
Returns the loop ids, edge ids, and orientations for an n-sided surface identified by its id.
Input:
INTEGER
surfaceid
The id of the surface.
INTEGER
numberloops
Total number of loops for the surface.
INTEGER
numberedges
The total number of edges for the surface.
Output:
INTEGER
loopids ( )
The loop handle for each edge. (dim totalNumberOfEdges).
INTEGER
edgeids ( )
The ids of the edge. (dim totalNumberOfEdges).
INTEGER
edgeorients ( )
The orientations of the edge. (dim totalNumberOfEdges).
INTEGER
<Return Value>
Success or an error code.
Example:
See example for sgm_db_get_num_loops_face, 225. Please see sgm_db_get_gen_face_edge_ids (p. 613) in the MSC Acumen Toolkit - Code Example.
  
sgm_db_get_gen_face_vertex_ids
( surfaceid, numberverts, vertexids )
Description:
Returns the vertex ids for an n-sided surface identified by its id.
Input:
INTEGER
surfaceid
The id of the surface.
INTEGER
numberverts
The number of vertices for the surface.
Output:
INTEGER
vertexids ( )
The ids of the vertex.
INTEGER
<Return Value>
Success or an error code.
Example:
Please see sgm_db_get_gen_face_vertex_ids (p. 615) in the MSC Acumen Toolkit - Code Example.
  
sgm_db_get_num_edges_face
( surfaceid, numberfaces )
 
Description:
This function will return the number of edges of the specified surface.
Input:
INTEGER
surfaceid
This value specifies the identifier for a surface or the face of a solid.
Output:
INTEGER
numberfaces
This value returns the number of edges of the specified surface of face of a solid.
INTEGER
<Return Value>
This function returns a value of 0 when executed successfully and a non zero value to indicate a change in status or an error.
Example:
See example for sgm_db_get_num_loops_face, 225. See also sgm_db_get_num_edges_face (p. 616) in the MSC Acumen Toolkit - Code Example.