end-drawing-path

Generic Function

Package: common-graphics

Arguments: stream &key (draw t) (fill nil)

Stops collecting line-drawing function calls on stream into a "path", and then draws and/or fills the entire path as a unit. The path is drawn as specified in the intervening line-drawing function calls if and only if draw is true. The path is filled if and only if fill is true. Either draw or fill (or both) should be true, as otherwise any line-drawing done between the call to begin-drawing-path and the call to end-drawing-path is lost.

A path is useful for filling a collection of lines and curves as a unit. It is also needed in Windows 95/98 (as opposed to NT) in order to use line-end and line-join styles other than :round.

To ensure that end-drawing-path is always called for each call to begin-drawing-path, it is convenient to use with-drawing-path instead of separate calls to begin-drawing-path and end-drawing-path.

See also: line-end, with-line-end, line-join, with-line-join, begin-drawing-path, and with-drawing-path.

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.