NAME
	  DtFaceGetIndex - Get the list of polygonal indices for all
	  the polygons in the given shape and group IDs.


     SYNOPSIS
	  #include <Dt.h>


	  int  DtFaceGetIndexByShape( int shapeID, int groupID,	int *count, long **indices);
	  int  DtFaceGetIndexByGroup( int shapeID, int groupID,	int *count, long **indices);


     DESCRIPTION
	  DtFaceGetIndex() returns a list of polygon vertex indices
	  via the pointer to the variable indices given	the shape
	  number, shapeID, and group number, groupID. The total	number
	  of indices (the length of the	indices	array) is returned via
	  the pointer to the count parameter.  Each polygon in the
	  indices array	is separated by	an index DtEND_OF_FACE (-1).
	  The number of	indices	return via the pointer to count
	  includes the DtEND_OF_FACE separators.  For example, if the
	  first	group (groupID = 0) of the first shape (shapeID	= 0)
	  has two triangles, the format	of the index array will	be:

	       1 2 3 -1	4 5 6 -1

	  were indices 1, 2, and 3 are for polygon 0 and 4, 5, and 6
	  are for polygon 1.  The parameter count will be set to 8.

	  The indices array is an internal buffer.  Do not free	or
	  modify the index array.

	  DtFaceGetIndexByShape() returns an array of indices relative
	  to the vertex	list for the shape (as returned	by
	  DtShapeGetVertices(3W)).  DtFaceGetIndexByGroup() returns an
	  array	of indices relative to the vertex list for the group
	  (as returned by DtGroupGetVertices(3W)).



     DIAGNOSTICS
	  DtFaceGetIndex() returns one on success and zero on failure.


     SEE ALSO
	  DtFaceGetIndexByGroup(3W)
	  DtFaceGetIndexByShape(3W)
	  DtGroupGetVertices(3W)
	  DtIndexCount(3W)
	  DtShapeGetVertices(3W)

     FILES
	  Link with -lDtOMio