Introduction

Getting Started

Programming Guides

API Reference

Additional Resources

Show_Shell_By_Tristrips

Functions

void DShow_Shell_By_Tristrips (HC_KEY key, int *pcount, HC_DPOINT *points, int *tristrips_length, int *tristrips, int *face_indices_length, int *face_indices)
 Similar to Show_Shell_By_Tristrips(), but operates on double-precision data. More...
 
void DShow_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 (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. More...
 
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. More...
 

Detailed Description

Function Documentation

void DShow_Shell_By_Tristrips ( HC_KEY  key,
int *  pcount,
HC_DPOINT *  points,
int *  tristrips_length,
int *  tristrips,
int *  face_indices_length,
int *  face_indices 
)

Similar to Show_Shell_By_Tristrips(), but operates on double-precision data.

Parameters
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.
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.

Similar to Show_Shell_By_Tristrips(), but returns double-precision data.

Parameters
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.

DETAILS

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.

NOTES

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.

RESTRICTIONS

See also
Insert_Shell, Insert_Shell_By_Tristrips, Get_Selection, Open_Geometry, Open_LOD, Begin_Contents_Search, Compute_Coordinates. Open_Geometry
Parameters
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.
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.

Parameters
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

DETAILS

No additional details. See Show_Shell_By_Tristrips()