Brief Index      Full Index      I.M. Reference

Compute_Shell_Subshell


Functions

HC_KEY Compute_Subshell (HC_KEY source, int keep_fcount, const int *keep_faces, int keep_pcount, const int *keep_pts1, const int *keep_pts2, int *face_map, int *pts_map)

Function Documentation

HC_KEY Compute_Subshell ( HC_KEY  source,
int  keep_fcount,
const int *  keep_faces,
int  keep_pcount,
const int *  keep_pts1,
const int *  keep_pts2,
int *  face_map,
int *  pts_map 
)

Creates a subshell from the source shell in the currently open segment and subject to the specified criteria.

Parameters:
source - Key of a shell or mesh.
keep_fcount - The number of entries in the keep_faces array.
keep_faces - An array of face numbers from the source shell that should appear in the subshell. Can be padded by -1's.
keep_pcount - The number of entries in the keep_pts1 and keep_pts2 arrays.
keep_pts1 - An array of vertex numbers that should appear in the subshell.
keep_pts2 - An array of vertex numbers that, along with the corresponding vertex in keep_pts1 define an edge that should appear in the subshell. Can be padded by -1's.
face_map - An array that maps faces from the source shell to the subshell. It should be large enough to accommodate one entry for each face in the source shell. Returned to the user.
pts_map - An array that maps vertices from the source shell to the subshell. It should be large enough to accommodate one entry for each vertex in the source shell. Returned to the user.

DETAILS

All faces in the keep_faces array will appear in the subshell as well as all vertices in those faces. All vertices in the keep_pts1 array will also appear in the subshell. If a keep_pts2 array is specified, edges between each vertex in keep_pts1 and the corresponding vertex in keep_pts2 will appear in the subshell. Typically all these arrays will come from a Compute_Selection_Elements() call. Finally, if a face_map and/or vertex_map is specified, they will be filled with a map from the faces and vertices of the source shell to the correcponding faces and vertices of the subshell. Faces and vertices that do not appear in the subshell will contain -1.

See also:
Compute_Selection, Compute_Selection_Elements

Main Index
Brief Index      Full Index      I.M. Functions