SE_shape_get_3D_length

Returns the three-dimensional length of a shape or a shape part.

Usage syntax

LONG SE_get_3D_length (const SE_SHAPE shape, LONG part_num, LFLOAT *length);

Parameters
shape A handle to an active shape object
part_num The number of the part to return the length for
length A pointer to the 3-D length of the shape part or shape
Description

Returns the three-dimensional length of the supplied shape. If part_num is 0, the three-dimensional length of the entire shape is returned. If part_num is nonzero, the 3-D length of the specified part is returned.

Returns

SE_SUCCESS
SE_INCOMPATIBLE_COORDREFS

SE_INVALID_PARTNUM

SE_INVALID_POINTER

SE_INVALID_SHAPE_OBJECT

Notes

•  Ignores any CAD data.

•  The x,y units and the z-units must be equal for length to be correctly calculated.