get-shape-line

Function

Package: common-graphics

Arguments: stream start-position draw-fn erase-fn &optional scroll-p cursor

Performs a "rubber band" operation where the user drags a stretching line that is drawn on stream between start-position and the current mouse cursor position. If the function draw-line is passed as the draw-fn and erase-fn, then get-shape-line will act just like get-lineget-line and do a simple rubber-banding. If a fancier sort of rubber-band line is desired, custom functions can be passed in instead. The draw-fn and erase-fn should each take three arguments: the stream, the start-position, and the mouse-cursor position.

If scroll-p is true then the window will scroll if possible when the user moves the mouse cursor off the side of the window.

If cursor is true, it should either be a mouse cursor to use during the rubber banding or t to default to cross-cursor. The default is t.

Common Graphics and IDE documentation is described in About Common Graphics and IDE documentation in cgide.htm.

The documentation is described in introduction.htm and the index is in index.htm.

Copyright (c) 1998-2000, Franz Inc. Berkeley, CA., USA. All rights reserved.

Created 2000.10.5.