get-shape-fixed-box

Function

Package: common-graphics

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

Similar to get-fixed-box, (returns a box of specific size with the user specifying the location with the mouse) except that draw-fn is called each time the shape is to be drawn and erase-fn each time it is to be erased. draw-fn and erase-fn each have two arguments: the stream and the current box. When they are called, the stream brush will be set to one pixel-width black, the stream paint operation to invert. Thus, drawing the shape twice will suffice.

(get-fixed-box s box) is equivalent to (get-shape-box s box #'draw-box #'draw-box).

If scroll-p is true, the window (identified by stream) will be scrolled if the cursor moves outside it.

Note that the resulting box may be destructively modified later by the system, so if you want to keep it around, you should make a copy of it.

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.