Show_Shell_By_Tristrips

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)

---

Function Documentation

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.

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

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()