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) |
Creates a subshell from the source shell or mesh in the currently open segment and subject to the specified criteria. More... | |
Detailed Description
Function Documentation
◆ Compute_Subshell()
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 or mesh 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. Can be padded by -1's. 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 Show_Selection_Elements() call. For more details on the structure of the keep arrays, see the description of vertex1, vertex2, and faces from Show_Selection_Elements(). 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
- Show_Selection_Elements