NAME
DtLineGetIndex - Get the list of line indices for all the
lines in the given shape and group IDs.
SYNOPSIS
#include <Dt.h>
int DtLineGetIndex( int shapeID, int groupID, int *count, long **indices);
DESCRIPTION
DtLineGetIndex() returns a list of line 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 line 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 lines, the format of the index array will be:
1 2 3 4 5 6 -1 7 8 9 -1
were indices 1, 2, 3, 4, 5, 6 are for line 0 and 7, 8, and 9
are for line 1. The parameter count will be set to 11.
If no line objects exist the indices array will be set to
NULL. The indices array is an internal buffer. Do not free
or modify the index array.
DIAGNOSTICS
DtLineGetIndex() returns one on success and zero on failure.
SEE ALSO
DtIndexCount(3W)
FILES
Link with -lDtOMio