SE_shape_generate_buffer

Generates a buffer around the source shape, and returns the resulting new shape.

Usage syntax

LONG SE_shape_generate_buffer (const SE_SHAPE src_shape, LFLOAT distance, LONG max_pts, SE_SHAPE tgt_shape);

Parameters
src_shape A handle to an active shape object
distance The buffer distance
max_pts The maximum number of points allowed in the new shape
tgt_shape A handle to an active shape object, returned as the new shape
Description

Generates a buffer around the source shape, returning the resulting new shape as tgt_shape. Negative buffer distances are supported for area shapes only. If the source shape is not an area shape, the absolute value of the buffer distance is used. An SE_INVALID_NUMBER_OF_POINTS error will occur if the target shape is not large enough to hold the resulting buffer. In this case, increase the allocated size of the target shape.

Returns

SE_SUCCESS
SE_CORRIDOR_OUT_OF_BOUNDS

SE_FAILURE

SE_INVALID_ENTITY_TYPE

SE_INVALID_PARAM_VALUE

SE_INVALID_POINTER

SE_INVALID_SHAPE

SE_INVALID_SHAPE_OBJECT

SE_OUT_OF_CLMEM

SE_READ_ONLY_SHAPE

SE_INVALID_NUMBER_OF_POINTS

SE_SHAPE_INTEGRITY_ERROR

Notes
•  This function works in 2-D space. Resulting shapes won’t have z- or m-values.

 

•  If you pass a shape returned from SE_stable_search or SE_stable_get_shape to ‘tgt_shape’, the SE_READ_ONLY_SHAPE error is returned.

•  Ignores any CAD data in the source shape and removes any CAD data in the target shape.

•  If the max_pts argument isn't large enough to accomodate the resulting shape, it will return SE_INVALID_NUMBER_OF_POINTS.