leStretchShape

leStretchShape(
d_shapeId 
l_delta 
l_freePoints 
[ g_lockAngles ]
) 
=> t / nil

Description

Stretches shape d_shapeId by the delta l_delta. Donuts cannot be stretched.

Arguments

d_shapeId	The database ID of the shape.
l_delta	List of the X and Y distances to stretch the shape. You can specify the X and Y distances in list format, list ( 0 2 ) or in coordinate format, 0:2.
l_freePoints	Boolean list indicating whether each point in the shape is free to be moved or not. The list must match the number and order of points in the shape. If all of the vertices of the shape are marked as free, the entire shape is moved. (You can use geGetSelSetFigPoint(d_shapeId) to return the list corresponding to the point list of shape d_shapeId.)
g_lockAngles	Specifies that angles of partially selected shapes should not be modified when the shapes are stretched. This option has no effect on instances or arrays. Valid Values: t or nil

Value Returned

t	The shape is stretched.
nil	The shape is not stretched.

Example

Stretches the right edge of shape shapeA 2 units in the Y direction. Two points of the shape are free to move and the angles of the shape cannot be changed.

leStretchShape( shapeA list( 0 2 ) list(nil t t nil) t )

You can also use geGetSelSet() and geGetSelSetFigPoint() to get the shape ID and Boolean list as shown here:

leStretchShape( car(geGetSelSet()) 0:2 

geGetSelSetFigPoint( car(geGetSelSet()) ) t )

Interactive Function

Enter this function with only the window ID argument; the system prompts you to point to the shape to stretch, specify the distance to stretch, and specify free points. If you do not specify w_windowId, the current window is used.

leHiStretch( [ w_windowId ] ) => t / nil

Return to top