SE_shape_difference

Returns the difference (logical AND NOT of space) of two shapes.

Usage syntax

LONG SE_shape_difference (const SE_SHAPE primary_shape, const SE_SHAPE secondary_shape, SE_SHAPE tgt_shape);

Parameters
primary_shape A handle to an active shape object
secondary_shape A handle to an active shape object
tgt_shape A handle to an active shape object
Description

SE_shape_difference returns the difference (the logical AND NOT of space) of two shapes as tgt_shape.

Returns

SE_SUCCESS
SE_COORD_OUT_OF_BOUNDS

SE_FAILURE

SE_INCOMPATIBLE_COORDREFS

SE_INCOMPATIBLE_SHAPES

SE_INVALID_ENTITY_TYPE

SE_INVALID_ENVELOPE

SE_INVALID_POINTER

SE_INVALID_SHAPE

SE_INVALID_SHAPE_OBJECT

SE_OUT_OF_CLMEM

SE_SHAPE_INTEGRITY_ERROR

Notes

∙  This function works in 2-D space. The resulting shape will not have z- or m-values.

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

∙  This function is not implemented yet for line-line and line-area combinations. Area-area combinations will return only area shapes at this time.