get-shape-line

Arguments: window-or-screen 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-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 window-or-screen, the start-position, and the mouse-cursor position.

window-or-screen should be a window or the screen. The screen is the value returned by (screen *system*). See screen and *system*.

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.

See also nget-shape-line.

Copyright (c) 1998-2002, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 6.2. This page has had minimal revisions compared to the 6.1 page.
Created 2002.2.26.