SE_shape_get_points

Returns the point array of the specified part

Usage syntax

LONG SE_shape_get_points (const SE_SHAPE shape, LONG part_num, SE_ROTATION_TYPE rotation, LONG *subpart_offsets, SE_POINT *point_array, LFLOAT *z, LFLOAT *measure);

Parameters
shape A handle to an active shape object
part_num The number of the part
rotation The winding rule used when returning the points
subpart_offsets The subpart offsets; may be null
point_array A pointer to an allocated array of SE_POINT structures that contain the requested points
z A pointer to an allocated array of LFLOATS that contains the requested z-values
measure A pointer to an allocated array of LFLOATS that contains the requested measure values
Description

SE_shape_get_points returns the point array of the specified part. The specified part_num must be a valid part number of the supplied shape object. You must allocate enough space to contain the points, z, and measure values for the specified part. The SE_shape_get_num_points function can be called to return the number of points for a shape part. If the z and/or measure parameters are NULL, then no z and/or measure values are returned.

Returns

SE_SUCCESS
SE_INVALID_PARTNUM

SE_INVALID_POINTER

SE_INVALID_SHAPE_OBJECT

SE_SHAPE_INTEGRITY_ERROR

Notes

∙  For more information on the subpart_offsets array, see Querying shapes.

∙  Ignores any CAD data