leChopShape

leChopShape(
d_shapeId 
l_points 
g_closed 
[ g_remove ] 
[ x_sides ]
) 
=> l_newShapes / nil

Description

Cuts the shape d_shapeId using the chop shape l_points.

Arguments

d_shapeId	The database ID of the shape to be cut.
l_points	List of points describing the chop shape.
g_closed	Specifies whether the chop shape is closed or not. Valid Values: t or nil
g_remove	Specifies whether to remove the objects inside the chop shape. Default Value: nil Valid Values: t or nil
x_sides	Specifies the number of sides to be used when converting conic shapes to polygons before cutting them. Default Value: 20 Valid Values: any positive integer

Value Returned

l_newShapes	The list of shapes resulting from the operation if the shape is chopped.
nil	The shape is not chopped.

Example

Using the coordinates in the list, cuts a triangle out of the shape shape2 after converting it to a polygon with 10 sides. Does not close the chop shape and does not remove any object. Returns the object IDs of the new shapes.

The objects are not removed if the chop shape is not closed. An open chop shape does not clearly indicate which objects are inside.

leChopShape( shape2 list(0:0 0:10 8:8) nil nil 10 )

Interactive Function

Enter this function with only the window ID argument; the system prompts you to point to the shape to be chopped, to create the chop shape, and specify if the shape is closed. If you do not specify w_windowId, the current window is used.

leHiChop( [ w_windowId ] ) => t / nil

Return to top