leStretchFig

leStretchFig(
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 figure.
l_delta	List of the X and Y distances to stretch the figure. 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 figure is free to be moved or not. The list must match the number and order of points in the figure. If all of the vertices of the figure are marked as free, the entire figure is moved. (You can use geGetSelSetFigPoint(d_shapeId) to return the list of corresponding Boolean to the point list of figure d_shapeId.)
g_lockAngles	Specifies that angles of partially selected figures should not be modified when the figures are stretched. This option has no effect on instances or arrays. Valid Values: t or nil

Value Returned

t	The figure is stretched.
nil	The figure is not stretched.

Example

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

leStretchFig( 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:

leStretchFig( 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