Functions | |
void | Show_Shell_By_Tristrips (HC_KEY key, int *pcount, HC_POINT *points, int *tristrips_length, int *tristrips, int *face_indices_length, int *face_indices) |
void | Show_Shell_By_Tristrips_Size (HC_KEY key, int *pcount, int *tristrips_length, int *face_indices_length) |
void Show_Shell_By_Tristrips | ( | HC_KEY | key, |
int * | pcount, | ||
HC_POINT * | points, | ||
int * | tristrips_length, | ||
int * | tristrips, | ||
int * | face_indices_length, | ||
int * | face_indices | ||
) |
Returns the previous definition of a shell, as referenced by a key.
key | - Unique numeric identifier pointing to a shell in the database. |
pcount | - Number of valid points in points. Returned to caller. Passed by reference always. |
points | - Vector of x-y-z triplets for the coordinates of the vertices to be used to build the shell. (A simple N x 3 array may also be used.) Returned to caller. Passed by reference always. |
tristrips_length | - The length of the tristrips array. Returned to user. |
tristrips | - An encoded description of the connectivity of points into triangle strips. Returned to user. |
face_indices_length | - The length of the face_indices array. Returned to user |
face_indices | - An encoded description of how triangles should be combined to form faces, and the assignment of face identifiers. Can be null. |
Use Show_Shell_By_Tristrip() to retrieve the HOOPS tristrips for a shell.
Use Show_Shell_By_Tristrip_Size() to retrieve the sizes of the point cloud and tristrip arrays before allocating space for those structures.
Under normal circumstances, Show_Shell (and its variants) assume that the key refers to a shell. If the currently open item is an LOD (see Open_LOD() ), then the key is ignored, and the show routine retrieves whatever contents were inserted into the LOD. If the currently open item is a NURBS surface, then the show functions retrieve information about the tessellated representation of the NURBS surface. For such purposes, if the tessellated representation was a mesh, it will be converted into a shell. If it had never been generated (no Update_Display had ever happened), it will be constructed with default attributes.
void Show_Shell_By_Tristrips_Size | ( | HC_KEY | key, |
int * | pcount, | ||
int * | tristrips_length, | ||
int * | face_indices_length | ||
) |
Finds the size of a shell that has been inserted by tristrips. This is useful in determining the size of the data structures that must hold points, tristrips, and face_indices.
key | - Unique numeric identifier pointing to a shell in the database. |
pcount | - Number of valid points in points. Returned to caller. Passed by reference always. |
tristrips_length | - The length of the tristrips array. Returned to user. |
face_indices_length | - The length of the face_indices array. Returned to user |
No additional details. See Show_Shell_By_Tristrips()